OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: Equations and figures as descendants of an example

Erik Leunissen <e.leunissen@hccnet.nl> writes:
> First off: I feel a bit uncomfortable that I don't quite grasp the
> reason that you asking these questions. Maybe there is an implicit
> misunderstanding. I'm going to try to be explicit ...

Sorry. I wasn't trying to make you uncomfortable. I'm absolutely
not suggesting that you're wrong or that you don't have a good use
case, it's just not one that I understand yet.

>> What's your motivation for putting figures and equations inside an
>> example?
> I've got the feeling that asking for a motivation is like turning the
> world upside down. Have you never seen a theoretical exposition in a
> textbook that clarifies it's theory with an example, where a figure is
> used (regardless titles, regardless figure labels)?

I can't think of one where the figure was nested inside the example, but
I'm not disputing that it's a logical possibility.

> Before I continue, I'd like to check whether there is anything wrong
> with my understanding. Maybe it's the case that you mean something
> quite different with an <example> than I do?

Part of our miscommunication may be a question of perspective. I tend
to think of figure, table, example, and equation as all members of a
class of thing (which we call "formal" objects because they have a

So I see "allow figure in example" as naturally leading to "allow
figure in table" and "allow table in equation". Historically, DocBook
has not allowed "formal objects" to nest.

However, they aren't really all exactly uniform. For even more distant
historical reasons, the title on equation is optional. And I can see
that "example" can easily be taken as broader than figure, table, or

That said, this still feels a bit weird to me:

  <title>Example of something</title>

  <para>Some prose.</para>

    <title>Figure title</title>

I'd still like to better understand what your examples actually look
like and what your rendering expectations are. Again, not because I
think they're wrong, just because it would help me understand.

                                        Be seeing you,

Norman Walsh <ndw@nwalsh.com>      | Reason's last step is the
http://www.oasis-open.org/docbook/ | recognition that there are an
Chair, DocBook Technical Committee | infinite number of things which
                                   | are beyond it.-- Pascal

Attachment: signature.asc
Description: PGP signature

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]