man-pages.7: Note preferred approach for 'duplicate' errors

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2017-04-21 15:39:23 +02:00
parent 9152b8c9cf
commit 520caa5540
1 changed files with 8 additions and 0 deletions

View File

@ -316,6 +316,14 @@ values that may be placed in
in the event of an error, along with information about the cause
of the errors.
Where several different conditions produce the same error,
the preferred approach is to create separate list entries
(with duplicate error names) for each of the conditions.
This makes the separate conditions clear, may make the list easier to read,
and allows metainformation
(e.g., kernel version number where the condition first became applicable)
to be more easily marked for each condition.
.IR "The error list should be in alphabetical order" .
.TP
.B ENVIRONMENT