Re: [docbook] why is example often used to contain programlisting?

["Bob Stayton" <bobs@sagehill.net>]

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
bobs@sagehill.net


----- Original Message ----- 
From: "Michael(tm) Smith" <smith@sideshowbarker.net>
To: "DocBook Mailing List" <docbook@lists.oasis-open.org>
Sent: Wednesday, November 01, 2006 7:50 PM
Subject: Re: [docbook] why is example often used to contain programlisting?


Chris Chiasson <chris@chiasson.name>, 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