More Man Page Patches

Geoff Burling (llywrch@agora.rdrop.com)
Wed, 12 Dec 2001 17:20:04 -0800 (PST)


  This message is in MIME format.  The first part should be readable text,
  while the remaining parts are likely unreadable without MIME-aware tools.
  Send mail to mime@docserver.cac.washington.edu for more info.

--8323328-684677620-1008206404=:5790
Content-Type: TEXT/PLAIN; charset=US-ASCII

These go against the man pages for Audio, Pager, Wharf, WinList
& Zharf. And there are still errors or bugs in the man pages . . .

<mode=trying not to rant>
Yesterday, when I pointed out that there was a problem with the
documented switches to Tile, I thought this was probably due to the
fact that the Tile module doesn't seem to see much use -- if any --
& that a little QA'ing would fix an embarassing but otherwise
minor bug.

However, after spending a few hours comparing what is stated in
the man pages with what usage() reports, & looking at the source
code for the 19 modules & the afterstep binary, I have found that
things have gotten seriously out of sync. At some points the man
page is correct, at other points what usage() reports is correct,
& at still others one has to read the source code -- even when the
source code *should* conform to what the man page says.

As long as I'm not stepping on anyone's toes here, what I'd like to
do is play janitor & clean this part of the code up. It looks to
me that someone tried to make usage() compliant with what the
GNU standard is for command line interfaces (section 18, if you're
curious) with a quick sed insert, but didn't go back & confirm that
the --help|-h, --version|-v, -f switches *actually* worked.

I'm not claiming that I'm a C programming guru; just an unemployed
QA guy who wants to help make AfterStep a better application.

Geoff


--8323328-684677620-1008206404=:5790
Content-Type: TEXT/PLAIN; charset=US-ASCII; name="Audio.man.diff"
Content-Transfer-Encoding: BASE64
Content-ID: <Pine.LNX.4.33.0112121720040.5790@joan.burling.com>
Content-Description: 
Content-Disposition: attachment; filename="Audio.man.diff"

LS0tIEF1ZGlvLm1hbi5vcmlnCVdlZCBEZWMgMTIgMTM6NDI6MzAgMjAwMQ0K
KysrIEF1ZGlvLm1hbglXZWQgRGVjIDEyIDE1OjQ1OjM4IDIwMDENCkBAIC0z
OCw3ICszOCw3IEBADQogQXVkaW9QbGF5IHR5cGUuDQogDQogSW4gYWRkaXRp
b24gQXVkaW8gY2FuIGNvcHkgQXVkaW9uIHNhbXBsZXMgZnJvbSAuYXUgZmls
ZXMgaW50byAvZGV2L2F1ZGlvDQotb24gaXRzZWxmLCBvciBpdCBjYW4gZHVt
cCBjb250ZW50cyBvZiB0aGUgc3BlY2lmeWVkIGZpbGVzIGludG8gU1RET1VU
LCANCitvbiBpdHNlbGYsIG9yIGl0IGNhbiBkdW1wIGNvbnRlbnRzIG9mIHRo
ZSBzcGVjaWZpZWQgZmlsZXMgaW50byBTVERPVVQsIA0KIHNvIHlvdSBjYW4g
cmVkaXJlY3QgaXQgYW55d2hlcmUgeW91IHdhbnQuDQogDQogLlNIIE9QVElP
TlMNCkBAIC05MSw3ICs5MSw3IEBADQogLklQICIiDQogQW55dGhpbmcgb3Ro
ZXIgdGhlbiB0aGVzZSBidWlsdCBpbiBvcHRpb25zIHdpbGwgYmUgY29uc2lk
ZXJlZCBhIGNvbW1hbmQgDQogbGluZSBwYXJhbWV0ZXJzIGZvciB0aGUgZXh0
ZXJuYWwgcGxheWVyLiBFeHRlcm5hbCBwbGF5ZXIgaXRzZWxmIGhhcyB0byAN
Ci1iZSBzcGVjaWZ5ZWQgYXQgY29tcGlsZSB0aW1lIHVzaW5nIC0td2l0aC1z
b3VuZHBsYXllciBvcHRpb24gZm9yIGNvbmZpZ3VyZS4NCitiZSBzcGVjaWZp
ZWQgYXQgY29tcGlsZSB0aW1lIHVzaW5nIC0td2l0aC1zb3VuZHBsYXllciBv
cHRpb24gZm9yIGNvbmZpZ3VyZS4NCiBEZWZhdWx0IGlzICJwbGF5IiB1dGls
aXR5IGZyb20gdGhlIFNvWCBwYWNrYWdlLg0KIElmIHRoaXMgb3B0aW9uIGlz
IG9tbWl0ZWQgdGhlbiBleHRlcm5hbCBwbGF5ZXIgaXMgdXNlZCB3aXRoIG5v
IHBhcmFtZXRlcnMuDQogLklQICIiDQo=
--8323328-684677620-1008206404=:5790
Content-Type: TEXT/PLAIN; charset=US-ASCII; name="Pager.man.diff"
Content-Transfer-Encoding: BASE64
Content-ID: <Pine.LNX.4.33.0112121720041.5790@joan.burling.com>
Content-Description: 
Content-Disposition: attachment; filename="Pager.man.diff"

LS0tIFBhZ2VyLm1hbi5vcmlnCVdlZCBEZWMgMTIgMTU6MzM6NTggMjAwMQ0K
KysrIFBhZ2VyLm1hbglXZWQgRGVjIDEyIDE1OjQ2OjE4IDIwMDENCkBAIC0y
NDksMTUgKzI0OSwxNSBAQA0KIFRoYXQgd2lsbCBwbGFjZSBsYWJlbCBiZWxv
dyB0aGUgZGVzayBpbnN0ZWFkIG9mIGFib3ZlIHRoZSBkZXNrLiBOb3RlOg0K
IHVzaW5nIGdyYWRpZW50cyB3aXRoIHRoaXMgb3B0aW9uIHdpbGwgcHJvZHVj
ZSBmdW5reSBlZmZlY3QuDQogLklQICJIaWRlSW5hY3RpdmVMYWJlbCINCi1X
aGVuIHRoaXMgb3B0aW9uIGlzIHNwZWNpZnllZCAtIFBhZ2VyIHdpbGwgdXNl
IHNoYXBlZCBleHRlbnNpb25zIHRvDQorV2hlbiB0aGlzIG9wdGlvbiBpcyBz
cGVjaWZpZWQgLSBQYWdlciB3aWxsIHVzZSBzaGFwZWQgZXh0ZW5zaW9ucyB0
bw0KIG1ha2UgbGFiZWwgb2YgYWxsIGluYWN0aXZlIGRlc2tzIHRyYW5zcGFy
ZW50Lg0KIC5SRQ0KIA0KIC5JUCAiKlBhZ2VyU21hbGxGb250IFxmSWZvbnQt
bmFtZVxmUCINCiBTcGVjaWZpZXMgYSBmb250IHRvIHVzZSB0byBsYWJlbCB0
aGUgd2luZG93IG5hbWVzIGluIHRoZSBwYWdlci4gDQotSXQgb3ZlcnJpZGVz
IGZvbnQgc3BlY2lmeWVkIGluIEZvY3VzZWQvVW5mb2N1c2VkL1N0aWNreSB3
aW5kb3cgc3R5bGUNCitJdCBvdmVycmlkZXMgZm9udCBzcGVjaWZpZWQgaW4g
Rm9jdXNlZC9VbmZvY3VzZWQvU3RpY2t5IHdpbmRvdyBzdHlsZQ0KIGluIGxv
b2sgZmlsZS4gSXQgYWxzbyBkaXNwbGF5cyB0ZXh0IG9uIGJhY2tncm91bmQg
Y29sb3IgLSB3aGljaA0KLWNhbiBiZSB1c2VmdWxsIGlmIEJhY2tQaXhtYXAg
aXMgc3BlY2lmeWVkIGluIHdpbmRvdyBzdHlsZS4NCitjYW4gYmUgdXNlZnVs
bCBpZiBCYWNrUGl4bWFwIGlzIHNwZWNpZmllZCBpbiB3aW5kb3cgc3R5bGUu
DQogV2luZG93IGxhYmVscyBzZWVtIHRvIGJlIGZhaXJseSB1c2VsZXNzIGZv
ciBkZXNrdG9wIHNjYWxlcyBvZiAzMg0KIG9yIGdyZWF0ZXIuDQogDQpAQCAt
MjkyLDcgKzI5Miw3IEBADQogVXNlZnVsIGZvciBhc3NpZ25pbmcgc3ltYm9s
aWMgbmFtZXMgdG8gZGVza3RvcHMsIGllDQogDQogLklQICIqUGFnZXJEb250
RHJhd0JnIg0KLUlmIHNwZWNpZnllZCwgd2lsbCBub3QgZGlzcGxheSBiYWNr
Z3JvdW5kIGltYWdlLCB1c2UgdGhpcyB3aXRoIHhlYXJ0aCBvciANCitJZiBz
cGVjaWZpZWQsIHdpbGwgbm90IGRpc3BsYXkgYmFja2dyb3VuZCBpbWFnZSwg
dXNlIHRoaXMgd2l0aCB4ZWFydGggb3IgDQogeGZpc2h0YW5rLCBvciB3aXRo
IGFzZXRyb290LiANCiANCiAuSVAgIipQYWdlclJvd3MgXGZJcm93c1xmUCIN
Cg==
--8323328-684677620-1008206404=:5790
Content-Type: TEXT/PLAIN; charset=US-ASCII; name="Wharf.man.diff"
Content-Transfer-Encoding: BASE64
Content-ID: <Pine.LNX.4.33.0112121720042.5790@joan.burling.com>
Content-Description: 
Content-Disposition: attachment; filename="Wharf.man.diff"

LS0tIFdoYXJmLm1hbi5vcmlnCVdlZCBEZWMgMTIgMTU6MzQ6NDUgMjAwMQ0K
KysrIFdoYXJmLm1hbglXZWQgRGVjIDEyIDE1OjQzOjIwIDIwMDENCkBAIC0x
Miw3ICsxMiw3IEBADQogc3Bhd25lZCBieSBhZnRlcnN0ZXAgaW4gdGhlIFxm
SWF1dG9leGVjXGZQIGZpbGUsIGluIHRoZSBmb2xsb3dpbmcgbWFubmVyOg0K
IC5uZg0KIC5zcA0KLQlNb2R1bGUJIkkiCVdoYXJmDQorCU1vZHVsZQkJIkki
CVdoYXJmDQogCVdhaXQJCSJJIglXaGFyZg0KIC5zcA0KIC5maQ0KQEAgLTM4
MSw0ICszODEsNSBAQA0KIC5TSCBTRUUgQUxTTw0KIC5CUiBhZnRlcnN0ZXAg
KDEpLA0KIC5CUiBQYWdlciAoMSksDQotLkJSIFggKDEpDQorLkJSIFggKDEp
LA0KKy5CUiBaaGFyZiAoMSkNCg==
--8323328-684677620-1008206404=:5790
Content-Type: TEXT/PLAIN; charset=US-ASCII; name="WinList.man.diff"
Content-Transfer-Encoding: BASE64
Content-ID: <Pine.LNX.4.33.0112121720043.5790@joan.burling.com>
Content-Description: 
Content-Disposition: attachment; filename="WinList.man.diff"

LS0tIFdpbkxpc3QubWFuLm9yaWcJV2VkIERlYyAxMiAxNTozNDoxMyAyMDAx
DQorKysgV2luTGlzdC5tYW4JV2VkIERlYyAxMiAxNTo0NzowMSAyMDAxDQpA
QCAtMTg2LDcgKzE4Niw3IEBADQogaG9yaXpvbnRhbCAidGFza2JhciIuDQog
DQogLklQICIqV2luTGlzdEp1c3RpZnkgXGZJPExlZnR8Q2VudGVyfFJpZ2h0
PlxmUCINCi1JZiB1c2VkLCB3aWxsIGp1c3RpZnkgdGhlIHRleHQgYXMgc3Bl
Y2lmeWVkLiBJZiB1bnNwZWNpZmllZCwgdGhlIGRlZmF1bHQgaXMNCitJZiB1
c2VkLCB3aWxsIGp1c3RpZnkgdGhlIHRleHQgYXMgc3BlY2lmaWVkLiBJZiB1
bnNwZWNpZmllZCwgdGhlIGRlZmF1bHQgaXMNCiB0byBjZW50ZXIgdGV4dC4N
CiANCiAuSVAgIipXaW5MaXN0QXV0b0hpZGUgXGZJbnVtYmVyXGZQIg0K
--8323328-684677620-1008206404=:5790
Content-Type: TEXT/PLAIN; charset=US-ASCII; name="Zharf.man.diff"
Content-Transfer-Encoding: BASE64
Content-ID: <Pine.LNX.4.33.0112121720044.5790@joan.burling.com>
Content-Description: 
Content-Disposition: attachment; filename="Zharf.man.diff"

LS0tIFpoYXJmLm1hbi5vcmlnCVdlZCBEZWMgMTIgMTU6MzQ6MjcgMjAwMQ0K
KysrIFpoYXJmLm1hbglXZWQgRGVjIDEyIDE1OjQ0OjU4IDIwMDENCkBAIC0x
Miw3ICsxMiw3IEBADQogc3Bhd25lZCBieSBhZnRlcnN0ZXAgaW4gdGhlIFxm
SWF1dG9leGVjXGZQIGZpbGUsIGluIHRoZSBmb2xsb3dpbmcgbWFubmVyOg0K
IC5uZg0KIC5zcA0KLQlNb2R1bGUJIkkiCVpoYXJmDQorCU1vZHVsZQkJIkki
CVpoYXJmDQogCVdhaXQJCSJJIglaaGFyZg0KIC5zcA0KIC5maQ0KQEAgLTQw
LDcgKzQwLDcgQEANCiBUaGUgXGZCWmhhcmZcZlAgbW9kdWxlIGlzIGEgZnJl
ZSBmbG9hdGluZyBhcHBsaWNhdGlvbiBsb2FkZXIvYnV0dG9uIHBhbmVsDQog
c2ltaWxhciB0byB0aGUgXGZCV2hhcmZcZlAgdGhhdCBjYW4gZXhlY3V0ZSBw
cm9ncmFtcyBvciAiU3dhbGxvdyIgcnVubmluZw0KIHByb2dyYW1zLCAgYnV0
IGFsc28gZGlzcGxheXMgYSBsYWJlbCB1bmRlciB0aGUgaWNvbiAoaWYgc3Bl
Y2lmaWVkKS4NCi1cZkJad2hhcmZcZlAgY291bGQgYWxzbyBiZSB1c2VkIGFz
IHNpbXBseSBhIHRleHQgdmVyc2lvbiBvZiBcZkJXaGFyZlxmUC4NCitcZkJa
aGFyZlxmUCBjb3VsZCBhbHNvIGJlIHVzZWQgYXMgc2ltcGx5IGEgdGV4dCB2
ZXJzaW9uIG9mIFxmQldoYXJmXGZQLg0KIEZvbGRlcnMgYXJlIG5vdCBzdXBw
b3J0ZWQuDQogDQogQWxsIG1vdXNlIGJ1dHRvbnMgYXJlIGNhcHR1cmVkIHRv
IGluaXRpYXRlIHRoZSBjb21tYW5kIHNwZWNpZmllZCwgaG93ZXZlcg0KQEAg
LTIwMyw1ICsyMDMsNSBAQA0KIA0KIC5TSCBTRUUgQUxTTw0KIC5CUiBhZnRl
cnN0ZXAgKDEpLA0KLS5CUiBXaGFyZiAoMSksDQotLkJSIFBhZ2VyICgxKQ0K
Ky5CUiBQYWdlciAoMSksDQorLkJSIFdoYXJmICgxKQ0K
--8323328-684677620-1008206404=:5790--
_______________________________________________
The AfterStep Window Manager for X User's Mailing List
http://mail.afterstep.org/mailman/listinfo/as-users