Skip to main content
Version: DocBook V4.5

systemitem

systemitem — A system-related item or term

Synopsis

Mixed Content Model

systemitem ::=
(#PCDATA|link|olink|ulink|action|application|classname|methodname|
interfacename|exceptionname|ooclass|oointerface|ooexception|
package|command|computeroutput|database|email|envar|errorcode|
errorname|errortype|errortext|filename|function|guibutton|
guiicon|guilabel|guimenu|guimenuitem|guisubmenu|hardware|
interface|keycap|keycode|keycombo|keysym|literal|code|constant|
markup|medialabel|menuchoice|mousebutton|option|optional|
parameter|prompt|property|replaceable|returnvalue|sgmltag|
structfield|structname|symbol|systemitem|uri|token|type|
userinput|varname|nonterminal|anchor|remark|subscript|
superscript|inlinegraphic|inlinemediaobject|indexterm|beginpage|
acronym|co)*

Attributes

Common attributes

Name

Type

Default

moreinfo

Enumeration:

none

refentry

"none"

class

Enumeration:

constant

daemon

domainname

etheraddress

event

eventhandler

filesystem

fqdomainname

groupname

ipaddress

library

macro

netmask

newsgroup

osname

process

protocol

resource

server

service

systemname

username

None

Description

A SystemItem identifies any system-related item or term. The Class attribute defines a number of common system-related terms.

Many inline elements in DocBook are, in fact, system-related. Some of the objects identified by the Class attribute on SystemItem may eventually migrate out to be inline elements of their own accord…and vice versa.

Processing expectations

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

Future Changes

In DocBook V4.0, the content model of SystemItem will be constrained to (#PCDATA | Replaceable | InlineGraphic).

Also, the EnvironVar and Prompt values of Class will be discarded (use EnVar and Prompt instead).

Future Changes

The register class value will be added to support CPU registers. The constant class value will be removed.

Attributes

class

Class indicates the type of SystemItem.

moreinfo

If MoreInfo is set to RefEntry, it implies that a RefEntry exists which further describes the SystemItem.

Examples

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<para>
For many years, O'Reilly's primary web server,
<ulink url="http://www.oreilly.com/">http://www.oreilly.com/</ulink>,
was hosted by <application>WN</application> on
<systemitem class="systemname">helio.oreilly.com</systemitem>.
</para>

For many years, O'Reilly's primary web server, http://www.oreilly.com/, was hosted by WN on helio.oreilly.com.

For additional examples, see also part.