Re: revised text and diagram

Comments inline

On Thu, 13 Jan 2022 at 11:51, Bethan Tovey-Walsh <accounts@bethan.wales> wrote:
>
> I wonder whether something like this might help with Tom’s objections? (Dave, I apologise in advance if I’ve made any awful errors in this tentative rewrite):
>
> ## ixml inputs
> -
> - The ixml grammar may [or must?] be represented in ixml format, valid to the ixml spec, or in an XML version.
> - The ixml grammar may (optionally) be modified by pragmas.
> - Pragmas can be included as part of the ixml grammar input, or be passed as an additional input to the ixml processor (for example by way of an ixml pragma file).

DP

ixml inputs.

 - ixml uses an ixml grammar to process a string and output a
structured representation of the content of that string;
(Not an input? More an overview statement)
 - The ixml grammar shall be represented in ixml format, valid to the
ixml spec, or in an XML version.
(I assume the xml version of an ixml grammar will be defined in the
spec, or referenced therefrom). So
The ixml grammar shall be represented in ixml format, valid to the ixml spec.
Seems to cover it (no mention of files or XDM etc).
 - Pragmas may be included as part of the ixml grammar, or be passed
as an additional input to the ixml processor (for example by way of an
ixml pragma file).

? No mention of the main (user) input file... text ... string...
something? 'ixml user input'?  Without suffix 'file' it reads oddly?
ixml input text stream? How does that sound.


  AFAIK (Michael, Tom?) an external file for pragmas is not on the cards? So
 - ixml Pragmas may be included as part of the ixml grammar



>
> ## ixml processor
>
> - An application taking as input an ixml grammar, (optionally) one or more ixml pragmas, and a string.
> - Its task is to validate the input string against the grammar, and (if valid) to produce the ixml output according to the rules of the grammar.
> - The processor may act on zero or more of the input pragmas (regardless of the manner in which these are input). Specifically, it may ignore those which it is unable to process.

DP
## ixml processor
 - An application taking as input an ixml grammar, (optionally) one or
more ixml pragmas, and a string.
I'm guessing someone would object to string (same rationale as files), so
 - An application taking as input an ixml grammar, (optionally) ixml
pragmas, and an ixml text stream?
(but here we're defining the processor, can we omit any reference to
its inputs, already defined? KISS principle? Omit?
- - Its task is to validate the input text stream against an ixml
grammar, and (if valid) to produce the ixml output according to the
rules of the grammar.


I'm happy with that?

Tks Bethan.

-- 
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.

Received on Thursday, 13 January 2022 12:34:10 UTC