Bug#488609: rt man page

2009-06-17 Thread Dominic Hargreaves
Thanks for your proposed contribution to the rt man page. It certainly
would be nice to have something like this merged. However, I'm uneasy
about adding this now as a future maintenance burden; at the moment the
manpage is a general overview with a pointer on how to get specific
information, but adding the detailed help runs the real risk of things
becoming out of date.

I suspect the best thing to do really would be to get upstream to include
POD documentation (which is, incidentally, how the current docs are
maintained).

Cheers,
Dominic.

-- 
Dominic Hargreaves | http://www.larted.org.uk/~dom/
PGP key 5178E2A5 from the.earth.li (keyserver,web,email)



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#488609: rt man page

2009-06-17 Thread Trent W. Buck
On Wed, Jun 17, 2009 at 11:54:22PM +0100, Dominic Hargreaves wrote:
 Thanks for your proposed contribution to the rt man page. It certainly
 would be nice to have something like this merged. However, I'm uneasy
 about adding this now as a future maintenance burden; at the moment the
 manpage is a general overview with a pointer on how to get specific
 information, but adding the detailed help runs the real risk of things
 becoming out of date.

Understood; it's your call.  I won't be providing updates anytime
soon, since I no longer use request tracker.

 I suspect the best thing to do really would be to get upstream to include
 POD documentation (which is, incidentally, how the current docs are
 maintained).

Ah; last time I looked (3.8) upstream didn't use POD, but rather some
NIH approximation of it.  Obviously getting them to convert to POD
would be nice, but they might be averse to that if it involves a
run-time dependency on POD (e.g. for rt --help), due to

  # This program is intentionally written to have as few non-core module
  # dependencies as possible. It should stay that way.



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org