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

["Colin Shapiro" <cmshapiro@gmail.com>]

On 11/1/06, Chris Chiasson <chris@chiasson.name> wrote:

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

Keep in mind that Examples can be automatically numbered and indexed in a list of examples with the default stylesheets.

If you're using a ProgramListing as a formal example, which you want to be numbered and included in a list of examples, then I think it's perfectly appropriate to contain it within an Example element.