Name
programlisting — A literal listing of all or part of a program
Synopsis
programlisting ::=
(info? db.titleforbidden.info, ((text |
lineannotation | Bibliography inlines | Computer-output inlines | Error inlines | Graphic inlines | GUI inlines | Indexing inlines | Keyboard inlines | Linking inlines | Markup inlines | Math inlines | Object-oriented programming inlines
| Operating system inlines |
Product inlines | Programming inlines | Publishing inlines | Technical inlines | Ubiquitous inlines | User-input inlines)* |
textobject))
Attribute synopsis
Common attributes and common linking attributes.
Additional attributes:
continuation(enumeration) = “continues” | “restarts”linenumbering(enumeration) = “numbered” | “unnumbered”startinglinenumber(integer)languagexml:space(enumeration) = “preserve”width(nonNegativeInteger)
Description
A programlisting is a verbatim environment for
program source or source fragment listings. The
programlistings are often placed in
examples or figures so that they
can be cross-referenced from the text.
Processing expectations
Formatted as a displayed block. This element is displayed
“verbatim”; whitespace and line breaks within this element are
significant. The programlistings are usually
displayed in a fixed-width font.
Other markup within a programlisting is
recognized. Contrast this with systems like LaTeX, in which verbatim
environments disable markup recognition. If you want to disable markup
recognition, you must use a CDATA
section:
<programlisting> ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access