Ticket #266 (closed defect: fixed)

Opened 12 years ago

Last modified 12 years ago

debathena-discuss: missing manpages

Reported by: geofft Owned by: jdreed
Priority: low Milestone: Karmic Deploy (Canceled)
Component: -- Keywords:
Cc: Fixed in version:
Upstream bug:

Description

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.

Change History

comment:1 Changed 12 years ago by jdreed

  • Milestone set to IAP 2010

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.

comment:2 Changed 12 years ago by jdreed

  • Owner set to jdreed
  • Status changed from new to accepted

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.

comment:3 Changed 12 years ago by 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" ...

comment:4 follow-up: ↓ 5 Changed 12 years ago by 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.

comment:5 in reply to: ↑ 4 Changed 12 years ago by 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

comment:6 Changed 12 years ago by jdreed

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

comment:7 Changed 12 years ago by broder

  • Status changed from accepted to proposed

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.

comment:8 Changed 12 years ago by broder

  • Status changed from proposed to closed
  • Resolution set to fixed
Note: See TracTickets for help on using tickets.