DocBook: The Definitive GuideBy Norman Walsh & Leonard Muellner1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM |
Replaceable
Synopsis
Mixed Content Model
Replaceable ::= ((#PCDATA|Link|OLink|ULink|Optional|Anchor|Comment|Subscript| Superscript|InlineGraphic|InlineMediaObject)+)Attributes
Name
Type
Default
Class Enumeration:
Command
Function
Option
ParameterNone Tag Minimization
Both the start- and end-tags are required for this element.
Parameter Entities
Description
Replaceable is used to mark text that describes what a user is supposed to enter, but not the actual text that they are 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.
Parents
These elements contain Replaceable: Accel, Ackno, Action, Application, Arg, ArtPageNums, Attribution, AuthorInitials, BiblioMisc, BridgeHead, Citation, CiteTitle, City, ClassName, CollabName, Command, Comment, ComputerOutput, ConfDates, ConfNum, ConfSponsor, ConfTitle, Constant, ContractNum, ContractSponsor, Contrib, CorpAuthor, CorpName, Country, Database, Date, Edition, Email, Emphasis, entry, EnVar, ErrorCode, ErrorName, ErrorType, Fax, Filename, FirstName, ForeignPhrase, FuncDef, FuncParams, FuncSynopsisInfo, Function, GlossSee, GlossSeeAlso, GlossTerm, Group, GUIButton, GUIIcon, GUILabel, GUIMenu, GUIMenuItem, GUISubmenu, Hardware, Holder, Honorific, Interface, InterfaceDefinition, InvPartNumber, ISBN, ISSN, IssueNum, JobTitle, KeyCap, KeyCode, KeySym, Lineage, LineAnnotation, Link, Literal, LiteralLayout, LoTentry, Markup, MediaLabel, Member, ModeSpec, MouseButton, MsgAud, MsgLevel, MsgOrig, OLink, Option, Optional, OrgDiv, OrgName, OtherAddr, OtherName, PageNums, Para, ParamDef, Parameter, Phone, Phrase, POB, Postcode, Primary, PrimaryIE, ProductName, ProductNumber, ProgramListing, Prompt, Property, PubDate, PublisherName, PubsNumber, Quote, RefDescriptor, RefEntryTitle, RefMiscInfo, RefName, RefPurpose, ReleaseInfo, ReturnValue, RevNumber, RevRemark, Screen, ScreenInfo, Secondary, SecondaryIE, See, SeeAlso, SeeAlsoIE, SeeIE, Seg, SegTitle, SeriesVolNums, SGMLTag, ShortAffil, SimPara, State, Street, StructField, StructName, Subscript, Subtitle, Superscript, Surname, Symbol, Synopsis, SystemItem, Term, Tertiary, TertiaryIE, Title, TitleAbbrev, ToCback, ToCentry, ToCfront, Token, Trademark, Type, ULink, UserInput, VarName, VolumeNum, Year.
Children
The following elements occur in Replaceable: Anchor, Comment, InlineGraphic, InlineMediaObject, Link, OLink, Optional, Subscript, Superscript, ULink.
In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.
Back to: DocBook: The Definitive Guide
© 2001, O'Reilly & Associates, Inc.