home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / comp / std / unix / 539 < prev    next >
Encoding:
Internet Message Format  |  1993-01-28  |  1.9 KB
  1. Path: sparky!uunet!not-for-mail
  2. From: norcott_bill@tandem.com (Bill Norcott)
  3. Newsgroups: comp.std.unix
  4. Subject: Re: 1003.2 Status, manual page conventions ?
  5. Date: 28 Jan 1993 15:52:56 -0800
  6. Organization: Tandem Computers, Inc.
  7. Lines: 29
  8. Sender: sef@ftp.UU.NET
  9. Approved: sef@ftp.uucp (Moderator, Sean Eric Fagan)
  10. Message-ID: <1k9rkoINNj62@ftp.UU.NET>
  11. References: <1k9b4bINN643@ftp.UU.NET> <1k9b4bINN643@ftp.UU.NET>,
  12. Reply-To: norcott_bill@tandem.com (Bill Norcott)
  13. NNTP-Posting-Host: ftp.uu.net
  14. Keywords: POSIX, 1003.2
  15. X-Submissions: std-unix@uunet.uu.net
  16.  
  17. Submitted-by: norcott_bill@tandem.com (Bill Norcott)
  18.  
  19. In article <1k9b4bINN643@ftp.UU.NET>, mclemore@edsel.eng.gtefsd.com (Ken McLemore) writes:
  20. > i'm looking for a POSIX convention for manual pages (Section 1,2,3,4,5,8)
  21. > and 1003.1 alludes to 1003.2 as possibly supplying the manual page
  22. > conventions.  does 1003.2 address this issue and what is the current status
  23. > of 1003.2 (eg. draft, being published, etc) ?
  24.  
  25. The man utility says: "The man utility shall write information about
  26. each of the name operands.  If name is the name of a standard
  27. utility, man shall at a minimum write a message describing the
  28. syntax used by the standard utility, its options, and operands.  If
  29. more information is available, the man utility shall provide it in
  30. an implementation-defined manner".
  31.  
  32. The format of the text is implementation defined, i.e. there are no
  33. "manual page conventions" other than for minimum content.  It is 
  34. also interesting that man does not have to provide descriptions of
  35. system calls or anything else that is not a POSIX.2 utility.
  36.  
  37. I believe that POSIX.2 Draft 12 has already been balloted and approved
  38. and that it is officially an IEEE standard.
  39. -- 
  40. Bill Norcott            GUARDIAN POSIX project
  41. Tandem Computers, Inc.        
  42. 10600 N. Tantau Avenue        PHONE:  (408) 285-3253
  43. Cupertino, CA   95014        EMAIL: norcott_bill@tandem.com
  44.  
  45. Volume-Number: Volume 30, Number 49
  46.