Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/printerr.refentry @ 1988:b96143206d83
Added more definitions as I have worked them out :)
| author | afra |
|---|---|
| date | Mon, 30 Jan 2006 23:13:04 +0000 |
| parents | 4dae346c4969 |
| children |
| rev | line source |
|---|---|
| 138 | 1 <refentry id="printerr"> |
| 2 <refnamediv> | |
| 3 <refname>PRINTERR</refname> | |
| 4 <refpurpose>Print Full Text Error Messages</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>printerr</command> |
| 138 | 10 </cmdsynopsis> |
| 11 </refsynopsisdiv> | |
| 12 | |
| 13 <refsect1><title>Description</title> | |
| 14 <para> | |
| 1093 | 15 This command replaces the basic OS-9 error printing routine (F$Perr |
| 138 | 16 service request) which only prints error code numbers, with a |
| 17 routine the reads and displays textual error messages from the file | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
138
diff
changeset
|
18 <filename>/d0/SYS/errmsg</filename>. Printerr's effect is system-wide. |
| 138 | 19 </para> |
| 20 <para> | |
| 21 A standard error message file is supplied with OS-9. This file can | |
| 22 be edited or replaced by the system manager. The file is a normal | |
| 23 text file with variable length line. Each error message line begins | |
| 24 with the error number code (in ASCII characters), a delimiter, and | |
| 25 the error message text. The error messages need not be in any | |
| 26 particular order. Delimiters are spaces or any character numerically lower then | |
| 27 $20. Any line having a delimiter as its first | |
| 1093 | 28 character is considered a continuation of the previous line(s) which |
| 138 | 29 permits multi-line error messages. |
| 30 </para> | |
| 1093 | 31 <warning> |
| 138 | 32 <para> |
| 1093 | 33 Once the <command>printerr</command> command has been used, |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
138
diff
changeset
|
34 it can not be undone. Once |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
138
diff
changeset
|
35 installed, the <command>printerr</command> module should not be unlinked. |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
138
diff
changeset
|
36 <command>Printerr</command> uses the current user's stack for an I/O buffer, so users |
| 138 | 37 are encouraged to reserve reasonably large stacks. |
| 38 </para> | |
| 1093 | 39 </warning> |
| 138 | 40 <para> |
| 1093 | 41 For more information see: <xref linkend="sec4.7"/>, <xref linkend="sec6.2"/>. |
| 138 | 42 </para> |
| 43 </refsect1> | |
| 44 <refsect1><title>Examples</title> | |
| 45 <screen> | |
| 46 | |
| 47 OS9: printerr | |
| 48 | |
| 49 </screen> | |
| 50 </refsect1> | |
| 51 </refentry> | |
| 52 |