This is the mail archive of the davenport@berkshire.net mailing list for the Davenport project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: DAVENPORT: Indent equivalent for DocBook


/ "Steve Greenland" <greenland@ellipsysconsulting.com> was heard to say:
| Indent is a program that formats C and C++ source code according to
| a variety of user specified options; is there an equivalent for DocBook?

I don't know of one, but on the topic of indentation, I have to say,
"be aware of whitespace".

<para>
My own style has always been to write things like this.
</para>

But in mixed-content elements (any element that can contain
character data is "mixed-content" as opposed to
"element-content" where only elements are allowed), that
carriage return may be significant. SGML has some interesting
rules about this, but XML does not. In XML, that space is
significant.

If your processor doesn't do the right thing with leading and
embedded whitespace, you might not get happy results.

<para>I'm now trying to train myself to type like this.
</para>

(The trailing space is probably never going to be a problem.)

                                        Cheers,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | If you understand: things are as
http://www.oasis-open.org/docbook/ | they are. If you do not
Member, DocBook Editorial Board    | understand: things are as they are.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]