DocBook: The Definitive Guide

Table of content


	By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

Name

Literal -- Inline text that is some literal value

Synopsis

Mixed Content Model

Literal ::= ((#PCDATA|Link|OLink|ULink|Action|Application|ClassName|Command|   ComputerOutput|Database|Email|EnVar|ErrorCode|ErrorName|   ErrorType|Filename|Function|GUIButton|GUIIcon|GUILabel|GUIMenu|   GUIMenuItem|GUISubmenu|Hardware|Interface|InterfaceDefinition|   KeyCap|KeyCode|KeyCombo|KeySym|Literal|Constant|Markup|   MediaLabel|MenuChoice|MouseButton|MsgText|Option|Optional|   Parameter|Prompt|Property|Replaceable|ReturnValue|SGMLTag|   StructField|StructName|Symbol|SystemItem|Token|Type|UserInput|   VarName|Anchor|Comment|Subscript|Superscript|InlineGraphic|   InlineMediaObject|IndexTerm)+)

Attributes

Common attributes

Name

Type

Default

MoreInfo

Enumeration:

None
RefEntry

"None"

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities

`%cptr.char.mix;`	`%ndxterm.char.mix;`	`%para.char.mix;`
`%programlisting.content;`	`%refinline.char.mix;`	`%refname.char.mix;`
`%screen.content;`	`%tbl.entry.mdl;`	`%tech.char.class;`
`%title.char.mix;`

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 somewhat more of a general classification. The sorts of things that constitute literals varies by domain.

Processing expectations

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

The MoreInfo attribute can help generate a link or query to retrieve additional information.

Future Changes

The content model of Literal will be constrained to (#PCDATA | Replaceable | InlineGraphic) in DocBook V4.0.

Parents

These elements contain Literal: Action, Application, Attribution, BiblioMisc, BridgeHead, Citation, CiteTitle, Command, Comment, ComputerOutput, Database, Emphasis, entry, Filename, ForeignPhrase, FuncParams, FuncSynopsisInfo, Function, GlossSee, GlossSeeAlso, GlossTerm, Hardware, Interface, InterfaceDefinition, KeyCap, LineAnnotation, Link, Literal, LiteralLayout, LoTentry, Member, MsgAud, OLink, Option, Optional, Para, Parameter, Phrase, Primary, PrimaryIE, ProductName, ProgramListing, Property, Quote, RefDescriptor, RefEntryTitle, RefName, RefPurpose, Screen, ScreenInfo, Secondary, SecondaryIE, See, SeeAlso, SeeAlsoIE, SeeIE, Seg, SegTitle, SimPara, Subtitle, Synopsis, SystemItem, Term, Tertiary, TertiaryIE, Title, TitleAbbrev, ToCback, ToCentry, ToCfront, Trademark, ULink, UserInput.

Children

The following elements occur in Literal: Action, Anchor, Application, ClassName, Command, Comment, ComputerOutput, Constant, Database, Email, EnVar, ErrorCode, ErrorName, ErrorType, Filename, Function, GUIButton, GUIIcon, GUILabel, GUIMenu, GUIMenuItem, GUISubmenu, Hardware, IndexTerm, InlineGraphic, InlineMediaObject, Interface, InterfaceDefinition, KeyCap, KeyCode, KeyCombo, KeySym, Link, Literal, Markup, MediaLabel, MenuChoice, MouseButton, MsgText, OLink, Option, Optional, Parameter, Prompt, Property, Replaceable, ReturnValue, SGMLTag, StructField, StructName, Subscript, Superscript, Symbol, SystemItem, Token, Type, ULink, UserInput, VarName.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

In some contexts, the following elements are excluded: IndexTerm.

Attributes

MoreInfo: If MoreInfo is set to RefEntry, it implies that a RefEntry exists which further describes the Literal.

Examples

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <para>There are several undocumented settings for <varname>debug</varname>, 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 >edit/debug.h</filename>.</para>

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.

For additional examples, see also BookInfo, ProgramListingCO.