Bug 156397 - ipcs mans are not in sync with utility options.
Summary: ipcs mans are not in sync with utility options.
Status: RESOLVED WONTFIX
Alias: None
Product: SUSE LINUX 10.0
Classification: openSUSE
Component: Basesystem (show other bugs)
Version: Final
Hardware: i686 SuSE Linux 10.0
: P3 - Medium : Enhancement
Target Milestone: ---
Assignee: Mads Martin Joergensen
QA Contact: E-mail List
URL:
Whiteboard:
Keywords: documentation, UI
Depends on:
Blocks:
 
Reported: 2006-03-09 11:12 UTC by Olli Artemjev
Modified: 2006-05-10 18:18 UTC (History)
0 users

See Also:
Found By: Customer
Services Priority:
Business Priority:
Blocker: ---
Marketing QA Status: ---
IT Deployment: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Olli Artemjev 2006-03-09 11:12:52 UTC
Manual page ipcs(1p):
------------------------------------
SYNOPSIS
       ipcs [-qms][-a | -bcopt]
------------------------------------


----------------- [ 14:13:20, root@skylab, /usr/src/2Install/CURRENT/ZoneMinder-1.22.0  ]
# ipcs -b
ipcs: invalid option -- b
usage : ipcs -asmq -tclup
        ipcs [-s -m -q] -i id
        ipcs -h for help.
----------------- [ 14:17:48, root@skylab, /usr/src/2Install/CURRENT/ZoneMinder-1.22.0  ]
# ipcs -o
ipcs: invalid option -- o
usage : ipcs -asmq -tclup
        ipcs [-s -m -q] -i id
        ipcs -h for help.
----------------- [ 14:17:51, root@skylab, /usr/src/2Install/CURRENT/ZoneMinder-1.22.0  ]
# ipcs -p


For me it's major, since w/o -b option ipcs is useless in case of getting a 
clue why the getshm() returns error within zoneminder.
Comment 1 Olli Artemjev 2006-03-09 11:22:45 UTC
oops.. man pages are not in sync - next man shows '-l'.
-l helps.
Changing subject and priority.
Comment 2 Michael Gross 2006-03-09 11:42:42 UTC
Where is the exact problem/enhancement here?
Comment 3 Olli Artemjev 2006-03-09 17:38:12 UTC
man 1p ipcs should get in sync with man 8 ipcs .

----------------- [ 20:41:25, root@skylab, /usr/src/Installed/ZoneMinder-1.22.0  ]
# apropos ipcs
ipcs (1p)            - report XSI interprocess communication facilities status
ipcs (8)             - provide information on ipc facilities
----------------- [ 20:41:45, root@skylab, /usr/src/Installed/ZoneMinder-1.22.0  ]
#

the 1st declares options that are not supported by ipcs utility. The man pages on the same command are not in sync, the enhancement is to get them in sync, so that man 1p ipcs and man 8 ipcs both will provide correct options.



Comment 4 Mads Martin Joergensen 2006-05-10 18:05:46 UTC
Thorsten, the one from util-linux is fine--I don't know if we even need ipcs in man-pages then?
Comment 5 Thorsten Kukuk 2006-05-10 18:10:13 UTC
"man 1p ipcs" gives you, as clearly stated, the documentation of the POSIX version of ipcs.
So our ipcs should try to get compatible with POSIX, we will not modify or delete the POSIX documentation.
Comment 6 Mads Martin Joergensen 2006-05-10 18:18:26 UTC
Oh, I agree. This is not something I'll fix though, please talk to the upstream ipcs maintainer.