O'Reilly logo

DocBook 5: The Definitive Guide by Richard L. Hamilton, Norman Walsh

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

replaceable — Content that may or must be replaced by the user

Synopsis

replaceable ::= (text | co | phrase db._phrase | replaceable | Graphic inlines | Indexing inlines | Linking inlines | Ubiquitous inlines)*

Attribute synopsis

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.

class

Identifies the nature of the replaceable text

Enumerated values:
“command”

A command

“function”

A function

“option”

An option

“parameter”

A parameter

See Also

command, computeroutput, constant, literal, markup, option, optional, parameter, prompt, tag, userinput, varname

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required