OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: DOCBOOK-APPS: sgml auto-indenter


/ "Kevin M. Dunn" <kdunn@hsc.edu> was heard to say:
| Does this style break anything?

Yes, if you have a nested set of tags that can contain #PCDATA. The
list example is OK because all of those elements have element content,
but

<filename>
    <replaceable>
         <ulink url="xxx">...</ulink>
    </replaceable>
</filename>

would be a problem because it introduces whitespace into mixed content.

| Can anyone suggest a useful indentation style which would be completely
| benign?

Not without reading the DTD or Schema and making sure that you only add
whitespace to elements that don't have mixed content.

On the subject of whitespace, note that the carriage return after the
<para> start tag is significant in XML.

<para>
Some sentence.

It's better to use either

<para>Some sentence

or

<para
>Some sentence

Although the latter confuses some simple parsing tools.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | Simplicity is always a
http://www.oasis-open.org/docbook/ | virtue.--Edward Abbey
Chair, DocBook Technical Committee |


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC