Re: [docbook] figure in example

["Chris Chiasson" <chris@chiasson.name>]

Would anyone be opposed to an RFE to allow <figure> in <example>? I
kinda like my pictures in examples to have titles.

On 3/15/06, Dick Hamilton <rlhamilton@frii.com> wrote:
> 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
> >
> >
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>
>


--
http://chris.chiasson.name/