debathena-discuss: missing manpages

[geofft]

The crmtgs, dsc_setup, dspipe, mkds, pmtg, and rmds commands in the debathena-discuss package are all missing manpages.

I don't know what they do, because they don't have manpages, but I suspect some of them belong in /usr/sbin instead of /usr/bin because they're only useful for the local discuss administrator.

[jdreed]

Indeed, everything except dsc_setup and pmtg probably want to move to /usr/sbin.

I don't think I've ever seen anyone use crmtgs...

I can write manpages for most of them, but not anytime soon.

[jdreed]

Draft manpages for all the commands (including ones like pmtg, which have apparently never worked) are in /mit/jdreed/debathena/discuss/

dspipe should clearly be in section 8. It's unclear to me where mkds and rmds should go. I put them in section 8 because they're superuser-ish commands, but they don't actually require root (they require you to be in the cacl on the server in question).

AUTHOR is "Unknown" for most of these, as I'm not sure who wrote them. I assume they're the same as the authors for discuss(1), but who knows.

[kaduk]

In my BSD system manpages, the author of the document is acknowledged, as well as the author of the software. This could avoid the aesthetic displeasure of just having "AUTHORS: Unknown" ...

[broder]

Also, we have this thing called version control...that knows the history of all the files in our repository.

Browsing the history, it looks like

crmtgs - created by wesommer
dsc_setup - created by spook
dspipe - created by srz
mkds - created by rfrench, heavily edited by spook
pmtg - spook
rmds - same as mkds

With the exception of mkds, it doesn't look like anybody really ever edited the source for these enough that they would deserve shared credit, although I was just looking at commit logs.

[kcr]

Replying to broder:

dsc_setup - created by spook
mkds - created by rfrench, heavily edited by spook
pmtg - spook
rmds - same as mkds

spook being spelled raeburn these days

[jdreed]

I've updated the man pages in /mit/jdreed/debathena/discuss to reflect the version control information.

[broder]

Committed in r24181 and uploaded to -proposed.

I opted not to move dspipe, mkds, and rmds into /usr/sbin, since Debian and Ubuntu don't put it in non-root users' paths, and they can be used by non-root users. I think it's still OK for their manpages to go in section 8.