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


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

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

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

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

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.

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