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

errorcode — An error code

Synopsis

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

Description

An error code. Error codes are often numeric, but in some environments they may be symbolic constants.

DocBook provides four elements for identifying the parts of an error message: errorcode, for the alphanumeric error code (e.g., –2); errorname, for the symbolic name of the error (e.g., ENOENT); errortext, for the text of the error message (e.g., file not found); and errortype, for the error type (e.g., recoverable).

Processing expectations

Formatted inline.

See Also

errorname, errortext, errortype, msgset

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example errorcode</title>

<para>On most DOS-derived systems, functions signal a <errortext>File
Not Found</errortext> error by returning
<errorcode>2</errorcode> (<errorname>ENOENT</errorname>).  This is usually a
<errortype>recoverable</errortype> (nonfatal) error.
</para>

</article>
<article xmlns='http://docbook.org/ns/docbook'> <title>Example errorcode</title> <para>On most UNIX systems, functions signal a <errorname>File Not Found</errorname> error by returning <errorcode>ENOENT</errorcode>, defined in <filename>errno.h</filename>. ...

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