1003.2 Status, manual page conventions ?

Thread View: comp.std.unix

3 messages

[T] Back to Threads [V] Tree View [G] Group Articles

3 total messages Started by Ken McLemore Thu, 28 Jan 1993 19:11

#962

Author: Ken McLemore
Date: Thu, 28 Jan 1993 19:11

12 lines
943 bytes

Submitted-by: mclemore@edsel.eng.gtefsd.com (Ken McLemore)

i may get flamed but here goes,

i'm looking for a POSIX convention for manual pages (Section 1,2,3,4,5,8)
and 1003.1 alludes to 1003.2 as possibly supplying the manual page
conventions.  does 1003.2 address this issue and what is the current status
of 1003.2 (eg. draft, being published, etc) ?

thanks in advance, ken

Volume-Number: Volume 30, Number 42

Re: 1003.2 Status, manual page conventions ?

#968

Author: Jeremy Epstein
Date: Thu, 28 Jan 1993 23:51

22 lines
1320 bytes

Submitted-by: epstein@trwacs.fp.trw.com (Jeremy Epstein)

mclemore@edsel.eng.gtefsd.com (Ken McLemore) writes:
>i'm looking for a POSIX convention for manual pages (Section 1,2,3,4,5,8)
>and 1003.1 alludes to 1003.2 as possibly supplying the manual page
>conventions.  does 1003.2 address this issue and what is the current status
>of 1003.2 (eg. draft, being published, etc) ?

1003.2 doesn't have "manual page" conventions per se, although
commands are described in a form somewhat similar to manual pages.

1003.2 is published, and available from IEEE for US$95 (request
a copy of IEEE Std 1003.2-1992).

-- 
Jeremy Epstein			Internet: epstein@trwacs.fp.trw.com
Trusted X Research Group	Voice: +1 703/803-4947
TRW Systems Division
Fairfax Virginia


Volume-Number: Volume 30, Number 48

Re: 1003.2 Status, manual page conventions ?

#969

Author: Bill Norcott
Date: Thu, 28 Jan 1993 23:52

29 lines
1966 bytes

Submitted-by: norcott_bill@tandem.com (Bill Norcott)

In article <1k9b4bINN643@ftp.UU.NET>, mclemore@edsel.eng.gtefsd.com (Ken McLemore) writes:
> i'm looking for a POSIX convention for manual pages (Section 1,2,3,4,5,8)
> and 1003.1 alludes to 1003.2 as possibly supplying the manual page
> conventions.  does 1003.2 address this issue and what is the current status
> of 1003.2 (eg. draft, being published, etc) ?

The man utility says: "The man utility shall write information about
each of the name operands.  If name is the name of a standard
utility, man shall at a minimum write a message describing the
syntax used by the standard utility, its options, and operands.  If
more information is available, the man utility shall provide it in
an implementation-defined manner".

The format of the text is implementation defined, i.e. there are no
"manual page conventions" other than for minimum content.  It is 
also interesting that man does not have to provide descriptions of
system calls or anything else that is not a POSIX.2 utility.

I believe that POSIX.2 Draft 12 has already been balloted and approved
and that it is officially an IEEE standard.
-- 
Bill Norcott			GUARDIAN POSIX project
Tandem Computers, Inc.		
10600 N. Tantau Avenue		PHONE:  (408) 285-3253
Cupertino, CA   95014		EMAIL: norcott_bill@tandem.com

Volume-Number: Volume 30, Number 49

Thread Navigation

This is a paginated view of messages in the thread with full content displayed inline.

Messages are displayed in chronological order, with the original post highlighted in green.

Use pagination controls to navigate through all messages in large threads.

Back to All Threads