literal

literal — Inline text that is some literal value.

Synopsis

literal ::=

Attributes

Common attributes and common linking attributes.

No additional attributes.

Description

A literal is some specific piece of data, taken literally, from a computer system. It is similar in some ways to userinput and computeroutput, but is a somewhat more general classification. The sorts of things that constitute literals vary by domain.

Processing expectations

Formatted inline. A literal is frequently distinguished typographically and literal is often used wherever that typographic presentation is desired.

Attributes

Common attributes and common linking attributes.

any attribute

Any attribute in any other explicit namespace

Parents

These elements contain literal: bridgehead, caption (db.html.caption), citation, citetitle, classsynopsisinfo, computeroutput, contrib, emphasis (db.emphasis), entry, enumitemdescription, firstterm (db.firstterm), funcsynopsisinfo, glosssee, glossseealso, glossterm (db.glossterm), initializer, link, literallayout, member, meta (db.meta.content), olink, orgdiv, para, phrase (db.phrase), primary, primaryie, programlisting, quote (db.quote), refdescriptor, refentrytitle, refname, refpurpose, remark, screen, secondary, secondaryie, see, seealso, seealsoie, seeie, seg, segtitle, simpara, subtitle, synopsis, synopsisinfo, td, term, termdef, tertiary, tertiaryie, th, title, titleabbrev, tocentry, userinput.

Children

The following elements occur in literal: text, abbrev, acronym, alt, anchor, annotation, biblioref, coref, date, emphasis (db._emphasis), firstterm (db._firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), glossterm (db._glossterm), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlinemediaobject, link, olink, phrase (db._phrase), quote (db._quote), remark, replaceable, subscript, superscript, trademark, wordasword, xref.

See Also

Related elements: command, computeroutput, constant, markup, option, optional, parameter, prompt, replaceable, tag, userinput, varname.

Examples

 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |<title>Example literal</title>
   | 
   |<para>There are several undocumented settings for <varname>debug</varname>,
 5 |among them <literal>3.27</literal> to enable a complete trace and
   |<literal>3.8</literal> to debug the spell checker. For a complete
   |list of the possible settings,
   |see <filename class="headerfile">edit/debug.h</filename>.</para>
   | 
10 |</article>

There are several undocumented settings for debug, among them 3.27 to enable a complete trace and 3.8 to debug the spell checker. For a complete list of the possible settings, see edit/debug.h.