For that matter, why not section? You enter a title, intro paras, and
programlisting.
Also, sidebar is another candidate.
Bob Stayton
Sagehill Enterprises
DocBook Consulting
----- Original Message -----
From: "Michael(tm) Smith" <>
To: "DocBook Mailing List" <>
Sent: Wednesday, November 01, 2006 7:50 PM
Subject: Re: [docbook] why is example often used to contain programlisting?
Chris Chiasson <>, 2006-11-01 21:43 -0600:
> An example is a rather general name for something. I guess that one's
> source code could be an example of ... itself.
>
> Is there another element that would be a good/better container for
> programlisting?
>
> maybe something that accepts a title and allows for a small amount of
> introductory text
Figure. It doesn't allow introductory text (neither does Example),
but anyway that should go in the parent (Para or Section of
whatever) that contains it.
--Mike
