Stephen Warren wrote:
>> And also, you probably want a man page so the debian folks don't have to
>> write one for you when they package it.
> 
> Does Debian have a policy that apps have to have man-pages then? This
> should be pretty easy, so I'll knock it out soon...

Forgot to reply to this part. Yes, they do. So part of the policy is the
packager has to write one if one is not provided, so you run into all sorts
of "This man page was written by Debian since the package does not provide
one. It may not be complete, and it may have Debian specific parts to it."
I'm not a DD, but I hear that quite a few get sent back upstream and
dropped/rejected/ignored...

If a package lacks a man page and slips through, and you run man on
something that it detects could potentially need a man page (I don't know
what this criteria is), it'll tell you to see man (7) undocumented, and
report it as a bug.

(I still have congruity 6 installed):

[EMAIL PROTECTED] ~]$ man foo
No manual entry for foo
[EMAIL PROTECTED] ~]$ man congruity
No manual entry for congruity
See 'man 7 undocumented' for help when manual pages are not available.
[EMAIL PROTECTED] ~]$

I'm guessing here that it notes there's a /usr/bin/congruity - but I suspect
there are other ways to trigger it, but I'm too lazy to go download Debian's
source patch for man :)

-- 
Phil Dibowitz                             [EMAIL PROTECTED]
Open Source software and tech docs        Insanity Palace of Metallica
http://www.phildev.net/                   http://www.ipom.com/

"Never write it in C if you can do it in 'awk';
 Never do it in 'awk' if 'sed' can handle it;
 Never use 'sed' when 'tr' can do the job;
 Never invoke 'tr' when 'cat' is sufficient;
 Avoid using 'cat' whenever possible" -- Taylor's Laws of Programming


Attachment: signature.asc
Description: OpenPGP digital signature

-------------------------------------------------------------------------
This SF.net email is sponsored by the 2008 JavaOne(SM) Conference 
Don't miss this year's exciting event. There's still time to save $100. 
Use priority code J8TL2D2. 
http://ad.doubleclick.net/clk;198757673;13503038;p?http://java.sun.com/javaone
_______________________________________________
concordance-devel mailing list
concordance-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/concordance-devel

Reply via email to