DOCBOOK-APPS: Re: Using block elements inside para elements

[Norman Walsh <ndw@nwalsh.com>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

/ ion <vnhu38f93@subdimension.com> was heard to say:
| Personally I always separate block elements and para elements
| so that I never use block elements inside para elements, I am
| interested in what other people do here, well more specifically
| what the main docbook people advocate.

There are clearly two styles. I don't think there's a right answer.
Some people don't like blocks in paragraphs, so they write:

<para>Consider the following program fragment:</para>
<programlisting>...</programlisting>
<para>It consists of...</para>

Others recall their gradeschool english teachers definition of a
paragraph and think those three things are all one thought so they
write:

<para>Consider the following program fragment:
<programlisting>...</programlisting>
It consists of...</para>

With $html.cleanup=1 and an XSL processor that understands exsl:node-set,
the markup comes out the same either way. Without the cleanup, the latter
leads to invalid HTML.

| If this topic should be moved to the docbook list then OK but
| I am not currently subscribed to the docbook list, only the
| docbook-apps so I would have to go and subscibe.

Yes, it's probably a topic that belongs on the docbook list.

                                        Be seeing you,
                                          norm

- -- 
Norman Walsh <ndw@nwalsh.com>      | A man is not necessarily
http://www.oasis-open.org/docbook/ | intelligent because he has plenty
Chair, DocBook Technical Committee | of ideas, any more than he is a
                                   | good general because he has plenty
                                   | of soldiers.--Chamfort
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE9qCCHOyltUcwYWjsRAjfoAJ9DfewXnRO16vOHU0RD4h03mcEl0gCcCz8A
0cxvmbpHR+RcnSAzr/cqfek=
=c30q
-----END PGP SIGNATURE-----