IEEE Standards Interpretation for IEEE Std 1003.1™-2001 IEEE Standard Standard for Information Technology -- Portable Operating System Interface (POSIX®)
Copyright © 2006 by the Institute of Electrical and Electronics Engineers, Inc. 3 Park Avenue New York, New York 10016-5997 USA All Rights Reserved.
Interpretations are issued to explain and clarify the intent of a standard and do not constitute an alteration to the original standard. In addition, interpretations are not intended to supply consulting information. Permission is hereby granted to download and print one copy of this document. Individuals seeking permission to reproduce and/or distribute this document in its entirety or portions of this document must contact the IEEE Standards Department for the appropriate license. Use of the information contained in this document is at your own risk.
IEEE Standards Department Copyrights and Permissions 445 Hoes Lane, Piscataway, New Jersey 08855-1331, USA
Interpretation Request #108
Topic: man standard error Relevant Sections: XCU man
The standard currently specifies that the man command must not use standard error for other than diagnostic messages. However, historic implementations have written a message "Reformatting page. Wait..." when they started to reformat the nroff source for a page, and have followed this by " done" when finished. These messages had originally been written to standard output in 4BSD, but later, SunOS and SVR4 derivatives, whose implementations of /usr/ucb/man seem to be of BSD origin, have been writing it to standard error. These are not diagnostic messages, though, since they do not indicate an error but just a processing delay.
Now a) it makes sense to write such a message, since the user must sometimes wait several seconds for nroff even on moderately modern machines, and b) it makes sense to write it to standard error, since the message should not appear in the regular output e.g. if the user invokes something like "man utility | col -b >utility.txt". POSIX should thus not disallow such messages.
Change line 24571 to "The standard error shall be used for diagnostic messages, and may also be used for optional informational messages of unspecified format."
The standards states the requirements for the man utility, and conforming implementations must conform to this. However, concerns have been raised about this which are being referred to the sponsor.
Rationale for Interpretation