home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / std_unix / volume.30 / text0047.txt < prev    next >
Encoding:
Text File  |  1993-03-11  |  1.3 KB  |  31 lines
  1. Submitted-by: norcott_bill@tandem.com (Bill Norcott)
  2.  
  3. In article <1k9b4bINN643@ftp.UU.NET>, mclemore@edsel.eng.gtefsd.com (Ken McLemore) writes:
  4. > i'm looking for a POSIX convention for manual pages (Section 1,2,3,4,5,8)
  5. > and 1003.1 alludes to 1003.2 as possibly supplying the manual page
  6. > conventions.  does 1003.2 address this issue and what is the current status
  7. > of 1003.2 (eg. draft, being published, etc) ?
  8.  
  9. The man utility says: "The man utility shall write information about
  10. each of the name operands.  If name is the name of a standard
  11. utility, man shall at a minimum write a message describing the
  12. syntax used by the standard utility, its options, and operands.  If
  13. more information is available, the man utility shall provide it in
  14. an implementation-defined manner".
  15.  
  16. The format of the text is implementation defined, i.e. there are no
  17. "manual page conventions" other than for minimum content.  It is 
  18. also interesting that man does not have to provide descriptions of
  19. system calls or anything else that is not a POSIX.2 utility.
  20.  
  21. I believe that POSIX.2 Draft 12 has already been balloted and approved
  22. and that it is officially an IEEE standard.
  23. -- 
  24. Bill Norcott            GUARDIAN POSIX project
  25. Tandem Computers, Inc.        
  26. 10600 N. Tantau Avenue        PHONE:  (408) 285-3253
  27. Cupertino, CA   95014        EMAIL: norcott_bill@tandem.com
  28.  
  29. Volume-Number: Volume 30, Number 49
  30.  
  31.