RE: [docbook] figure in example

["Dick Hamilton" <rlhamilton@frii.com>]

Chris,

> 
> Why is figure allowed in para, which in turn is allowed in example,
> when figure is not allowed in example? I feel sorta strange wrapping
> my figures in paras...
>
I don't know the exact reason, but my best guess is that it has to
do with titling and numbering.  I.e., to avoid a situation where
you have a titled and numbered figure inside a titled and numbered
example.  Since informalfigure IS allowed in example, that's about
the only reason I can think of.

Of course, as you note, it is possible to nest figure in example through
para, but I'll bet that was not contemplated when DocBook was designed.

I'd be interested in getting Norm's view on this, especially because
he seems to have plugged this hole in DocBook V5.0 (that's if I read
the Schematron assertions correctly, which I don't guarantee:).  The
description of example http://docbook.org/tdg5/en/html/example.html
contains a set of "Additional Constraints" including one that states
that "figure must not occur in the descendants of example."  That would
preclude your use of <example><para><figure>...

BTW, if you don't need titles and numbering, you can put informalfigure
in example.  This is permitted in both 4.x and 5.0.

Regards,

Dick Hamilton
rlhamilton@frii.com

> -----Original Message-----
> From: chris.chiasson@gmail.com 
> [mailto:chris.chiasson@gmail.com] On Behalf Of Chris Chiasson
> Sent: Wednesday, March 15, 2006 5:03 PM
> To: docbook@lists.oasis-open.org
> Subject: [docbook] figure in example
> 
> 
> Why is figure allowed in para, which in turn is allowed in example,
> when figure is not allowed in example? I feel sorta strange wrapping
> my figures in paras...
> 
> ??
> 
> Thanks,
> 
> --
> http://chris.chiasson.name/
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
> 
>