ALFS DTD Syntax Doc v3.1

James Robertson jwrober at linuxfromscratch.org
Thu Jun 17 18:43:57 PDT 2004


Kevin P. Fleming wrote:
> On the "XML & DTD Syntax" page, the standard entities are shown using 
> numeric definitions. I was expecting that this would show people that 
> there are some predefined (amp, lt, gt, apos) that they do not need to 
> to define at all, but this text implies that they need to define them in 
> their own documents.

I always like to define them manually myself, so I added a little 
paragraph after the list about what is predefined.

> "Element: base"
> 
> The note box last sentence ends abruptly and leaves things unclear (it 
> could be referring to relative paths being used in the base 
> element/attribute itself). I would add "in the parent element's other 
> attributes and child elements".

Fixed

> "Element: unpack"
> 
> Remove "as computed by openssl" from the digest element description, 
> it's redundant and actually not always correct (nALFS does MD5 on its 
> own, for example).

Fixed

> Otherwise it looks pretty good; I only reviewed the text, not the 
> examples, as I've seen them before and watched most of the commit 
> messages that changed them. I like the new text arrangement, with the 
> element/attribute names boldface and the wording changed around. Nice 
> work James :-)

Thanks.
James



More information about the alfs-discuss mailing list