DocBook: The Definitive Guide
PrevVersion 1.0.3.Next

Arg

Name

Arg -- An argument in a CmdSynopsis

Synopsis

Mixed Content Model

Arg ::=
((#PCDATA|Arg|Group|Option|SynopFragmentRef|Replaceable|SBR)+)

Attributes

Common attributes

Name

Type

Default

Rep

Enumeration:

Norepeat
Repeat

"Norepeat"
Choice

Enumeration:

Opt
Plain
Req

"Opt"

Tag Minimization

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

Description

See CmdSynopsis for more information.

Processing expectations

May be formatted inline or as a displayed block, depending on context.

Parents

These elements contain Arg: Arg, CmdSynopsis, Group, SynopFragment.

Children

The following elements occur in Arg: Arg, Group, Option, Replaceable, SBR, SynopFragmentRef.

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

Attributes

Choice

Choice indicates whether the Arg is required (Req or Plain) or optional (Opt). Arguments identified as Plain are required, but are shown without additional decoration.

Rep

A Rep value of Repeat indicates that the Arg is reapeatable. This is frequently rendered with an ellipsis.

See Also

CmdSynopsis, Group, RefSynopsisDiv, SBR, SynopFragment, SynopFragmentRef

Examples

For examples, see CmdSynopsis, SynopFragment.

PrevHomeNext
AreaSpecUpArtHeader

Copyright © 1999 O'Reilly & Associates, Inc. All rights reserved.