replaceable
replaceable — Content that may or must be replaced by the user.
Synopsis
replaceable ::=
- Zero or more of:
- text
co
replaceable
- Graphic inlines
- Indexing inlines
- Linking inlines
- Ubiquitous inlines
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
subscript
superscript
trademark
wordasword
xref
Attributes
Common attributes and common linking attributes.
Additional attributes:
- class (enumeration)
- “command”
- “function”
- “option”
- “parameter”
Description
A replaceable
is used to mark text that
describes what a user is supposed to enter, but not
the actual text that the user is supposed to
enter.
It is used to identify a class of object in the document, in which the user is expected to replace the text that identifies the class with some specific instance of that class. A canonical example is:
|<replaceable>filename</replaceable>
in which the user is expected to provide the name of some specific
file to replace the text filename.
Processing expectations
Formatted inline. Usually, the text is given special typographic
treatment, such as italics, as a clue to the user that this is
replaceable text. Often the font used is described in a
conventions
section at the beginning of the
document.
Attributes
Common attributes and common linking attributes.
- any attribute
Any attribute in any other explicit namespace
- class
Identifies the nature of the replaceable text
Enumerated values: “command” A command
“function” A function
“option” An option
“parameter” A parameter
Parents
These elements contain replaceable
: abbrev
, accel
, acronym
, address
, application
, arg
, artpagenums
, attribution
, authorinitials
, bibliocoverage
, biblioid
, bibliomisc
, bibliomixed
, bibliomset
, bibliorelation
, bibliosource
, bridgehead
, buildtarget
, caption
(db.html.caption), citation
, citebiblioid
, citetitle
, city
, classname
, classsynopsisinfo
, code
, command
, computeroutput
, confdates
, confnum
, confsponsor
, conftitle
, constant
, contractnum
, contractsponsor
, contrib
, country
, database
, description
, edition
, email
, emphasis
(db._emphasis), emphasis
(db.emphasis), entry
, enumidentifier
, enumitemdescription
, enumname
, enumvalue
, envar
, errorcode
, errorname
, errortext
, errortype
, exceptionname
, fax
, filename
, firstname
, firstterm
(db._firstterm), firstterm
(db.firstterm), foreignphrase
(db._foreignphrase), funcdef
, funcparams
, funcsynopsisinfo
, function
, givenname
, glosssee
, glossseealso
, glossterm
(db._glossterm), glossterm
(db.glossterm), group
(db.group), guibutton
, guiicon
, guilabel
, guimenu
, guimenuitem
, guisubmenu
, hardware
, holder
, honorific
, initializer
, interfacename
, issuenum
, jobtitle
, keycap
, keycode
, keysym
, label
, lineage
, lineannotation
, link
, literal
, literallayout
, macroname
, manvolnum
, markup
, mathphrase
, member
, meta
(db.meta.content), methodname
, modifier
, mousebutton
, msgaud
, msglevel
, msgorig
, olink
, option
, optional
, orgdiv
, orgname
, otheraddr
, othername
, package
, pagenums
, para
, paramdef
, parameter
, personname
, phone
, phrase
(db._phrase), phrase
(db.phrase), pob
, postcode
, primary
, primaryie
, productname
, productnumber
, programlisting
, prompt
, property
, publishername
, quote
(db._quote), quote
(db.quote), refdescriptor
, refentrytitle
, refmiscinfo
, refname
, refpurpose
, releaseinfo
, remark
, replaceable
, returnvalue
, revnumber
, revremark
, screen
, secondary
, secondaryie
, see
, seealso
, seealsoie
, seeie
, seg
, segtitle
, seriesvolnums
, shortaffil
, simpara
, specializedtemplate
, state
, street
, subscript
, subtitle
, superscript
, surname
, symbol
, synopsis
, synopsisinfo
, systemitem
, tag
, td
, template
, templatename
, term
, termdef
, tertiary
, tertiaryie
, th
, title
, titleabbrev
, tocentry
, token
, trademark
, type
, typedefname
, unionname
, uri
, userinput
, varname
, volumenum
, wordasword
, year
.
Children
The following elements occur in replaceable
: text, abbrev
, acronym
, alt
, anchor
, annotation
, biblioref
, co
, 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
, literal
, markup
, option
, optional
, parameter
, prompt
, tag
, userinput
, varname
.