This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
RE: Re: Simplified DocBook Q: Nested Section elements
- From: Peter Brooks <pbrooks at appliedsemantics dot com>
- To: 'Norman Walsh' <ndw at nwalsh dot com>
- Cc: docbook at lists dot oasis-open dot org,"Peter Brooks (E-mail)" <pcbrooks at earthlink dot net>
- Date: Tue, 10 Sep 2002 13:13:02 -0700
- Subject: RE: DOCBOOK: Re: Simplified DocBook Q: Nested Section elements
As I found out :) The originator is happy enough so I'm happy :)
Under other circumstances (say, using Word or FrameMaker), the distinction
between the last para of the subsection and the following para belonging to
the higher level section would have been signified by a change in
indentation, since I generally indent subsections:
section
para
subsection
para
end subsection
para
end section
But now I know it's a feature and not a bug (now where have I heard that
before :) ?)
Best,
Peter
> -----Original Message-----
> From: Norman Walsh [mailto:ndw@nwalsh.com]
> Sent: Tuesday, September 10, 2002 1:07 PM
> To: Peter Brooks
> Cc: docbook@lists.oasis-open.org; Peter Brooks (E-mail)
> Subject: DOCBOOK: Re: Simplified DocBook Q: Nested Section elements
>
>
> / Peter Brooks <pbrooks@appliedsemantics.com> was heard to say:
> | It does, Norm, and thank you - although it doesn't solve my
> problem that now
> | arises with the layout that is wanted :) The subsection was
> to have been
> | presented before the para belonging to the "higher" section
> that used it as
> | a reference (but wasn't a subsection in its own right).
>
> That's just not a model supported by DocBook. You'll have to move the
> paragraph that comes "after" the inner section into the end of the
> inner section.
>
> Sections in DocBook don't float. In traditional paper documentation,
> this is easy to justify: from the readers perspective, there's no way
> to tell that the section ends between the two paragraphs:
>
> Be seeing you,
> norm
>
> --
> Norman Walsh <ndw@nwalsh.com> | As we grow older we grow
> both more
> http://www.oasis-open.org/docbook/ | foolish and wiser at the same
> Chair, DocBook Technical Committee | time.--La Rochefoucauld
>