Search the Catalog
DocBook: The Definitive Guide

DocBook: The Definitive Guide

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

Prompt

Name

Prompt -- A character or string indicating the start of an input field in a computer display

Synopsis

Mixed Content Model

Prompt ::=
((#PCDATA|Replaceable|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 Prompt is a character or character string marking the beginning of an input field. Prompts are generally associated with command-line interfaces and not graphical user interfaces (GUIs). In GUIs, GUILabel is usually more appropriate.

Processing expectations

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

(4.0) Future Changes

Prompt was added in DocBook V3.0. It duplicates the semantics of <systemitem class="prompt">. The prompt attribute will be removed from SystemItem in the future.

Children

The following elements occur in Prompt: IndexTerm, InlineGraphic, InlineMediaObject, Replaceable.

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 Prompt.

See Also

ComputerOutput, Constant, EnVar, Filename, Literal, Markup, Option, Optional, Parameter, Replaceable, SGMLTag, SystemItem, UserInput, VarName

Examples

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<para>
Enter your user name when the system presents the 
<prompt>login:</prompt> prompt.
</para>

Enter your user name when the system presents the login: prompt.

Back to: DocBook: The Definitive Guide


oreilly.com Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies | Privacy Policy

© 2001, O'Reilly & Associates, Inc.