Re: Undocumented binary
On Tue, Apr 03, 2001 at 09:00:31AM -0700, John H. Robinson, IV wrote: can't file a bug, since the package is not in debian[1] not true; you can file bugs against non-existent packages. IIRC. hamish -- Hamish Moffatt VK3SB [EMAIL PROTECTED] [EMAIL PROTECTED] -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
On Tue, Apr 03, 2001 at 09:00:31AM -0700, John H. Robinson, IV wrote: can't file a bug, since the package is not in debian[1] not true; you can file bugs against non-existent packages. IIRC. hamish -- Hamish Moffatt VK3SB [EMAIL PROTECTED] [EMAIL PROTECTED]
Re: Undocumented binary
On Tue, 3 Apr 2001, peter karlsson wrote: Steve M. Robbins: The undocumented page provides no more information than No manual entry for foo (but the former is much longer to read). What is the point? Personally, I reason that if I get No manual entry, it is a program that probably shouldn't have entered myself, but if I get undocumented, it's something that I can use, but no-one has ever bothered informing me of it. I have a different point of view. If I get No manual entry for foo I know at once that nobody has written a man page. (I know the program is there because I have run it already but had some problems). When there is an undocumented manpage instead, man tells me Reformatting foo(1), please wait... and I think Aah lets see how ... f*$! Another lazy maintainer again! It really is annoying! And back to the first post. If you don't want to write 100 manpages for your 100 programs in the package you can at least write one and symlink it to the other 99 names. -- Manfred Wassmann PGP and GnuPG public keys available at http://germany.keyserver.net PGP: 24B81049 Fingerprint: D7 10 EE 2B 74 16 C0 64 B4 5F BA B2 90 29 3D AF GPG: 6B299971 Fingerprint: A598 A41F 57A3 5D69 83D2 8027 1274 F8CD 6B29 9971 +++ I18N ? For international language set LANG=POSIX +++
Re: Undocumented binary
Karel Gardas wrote: I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? with dh_undocumented. A quote from its manpage: Note that Debian policy prohibits links to undocumented(7) unless the package has an open bug report stating that it has no man page. You should really just write a man page instead; this program is an easy way out. -- Ivo Timmermans -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: On Tue, Apr 03, 2001 at 03:23:59PM +0200, Karel Gardas wrote: Hi, I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? Aigh, no, please don't do that! Those drive me crazy!! The undocumented page provides no more information than "No manual entry for foo" (but the former is much longer to read). What is the point? policy :) Dennis -- "Contrary to popular belief, UNIX is a user-friendly Operating System. It's just choosy about who its friends are." -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
On Tue, Apr 03, 2001 at 04:28:37PM +0200, Dennis Schoen wrote: On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: On Tue, Apr 03, 2001 at 03:23:59PM +0200, Karel Gardas wrote: Hi, I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? Aigh, no, please don't do that! Those drive me crazy!! The undocumented page provides no more information than "No manual entry for foo" (but the former is much longer to read). What is the point? policy :) Does the policy not say that all binaries should have a manpage. having a manpage saying that there is no manpage is the same as having non, and i think it is not in the spirit of the policy. Maybe all manpage needing binaries could be listed somewhere, and we could have a manpage writing task ? Friendly, Sven Luther -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
On Tue, Apr 03, 2001 at 04:28:37PM +0200, Dennis Schoen wrote: On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: What is the point? policy :) i hate that catch 22. can't file a bug, since the package is not in debian[1] can't use undocumented, unless you have a bug against it, can't leave a manpage out entirely, since it would fail lintian, can't get into the archive, unless it is lintian clean -john [1] okay, you do file a bug against it with the ITP, but that bug is against wnpp. somehow, filing a bug against a package that does not yet exist seems wrong to me. i end up writing a small man page. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
On Tue, Apr 03, 2001 at 09:00:31AM -0700, John H. Robinson, IV wrote: On Tue, Apr 03, 2001 at 04:28:37PM +0200, Dennis Schoen wrote: On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: What is the point? policy :) i hate that catch 22. can't file a bug, since the package is not in debian[1] can't use undocumented, unless you have a bug against it, can't leave a manpage out entirely, since it would fail lintian, can't get into the archive, unless it is lintian clean -john [1] okay, you do file a bug against it with the ITP, but that bug is against wnpp. somehow, filing a bug against a package that does not yet exist seems wrong to me. i end up writing a small man page. ^ Precisely: "undocumented" is not a solution, writing the man page is the solution. -S -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
Steve M. Robbins: The undocumented page provides no more information than "No manual entry for foo" (but the former is much longer to read). What is the point? Personally, I reason that if I get "No manual entry", it is a program that probably shouldn't have entered myself, but if I get undocumented, it's something that I can use, but no-one has ever bothered informing me of it. -- \\// peter - http://www.softwolves.pp.se/ Statement concerning unsolicited e-mail according to Swedish law: http://www.softwolves.pp.se/peter/reklampost.html -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Re: Undocumented binary
* Tollef Fog Heen [EMAIL PROTECTED] [20010403 18:45]: Maybe all manpage needing binaries could be listed somewhere, and we could | have a manpage writing task ? http://qa.debian.org/man-pages.html The web page now shows who is working on the man pages for a package, so we can coordinate our efforts better. Jrme Marant has agreed to maintain the database on who is working on what. If you want to work on a package, please email [EMAIL PROTECTED] and your name will be listed on the web site. (We consider making it automatic, e.g. by signing up on the web page, but let's see first how it works out). -- Martin Michlmayr [EMAIL PROTECTED] -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
Undocumented binary
Hi, I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? Thanks, Karel -- Karel Gardas e-mail: [EMAIL PROTECTED]
Re: Undocumented binary
Karel Gardas wrote: I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? with dh_undocumented. A quote from its manpage: Note that Debian policy prohibits links to undocumented(7) unless the package has an open bug report stating that it has no man page. You should really just write a man page instead; this program is an easy way out. -- Ivo Timmermans
Re: Undocumented binary
On Tue, Apr 03, 2001 at 03:23:59PM +0200, Karel Gardas wrote: Hi, I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? Aigh, no, please don't do that! Those drive me crazy!! The undocumented page provides no more information than No manual entry for foo (but the former is much longer to read). What is the point? -S
Re: Undocumented binary
On Tue, Apr 03, 2001 at 04:28:37PM +0200, Dennis Schoen wrote: On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: On Tue, Apr 03, 2001 at 03:23:59PM +0200, Karel Gardas wrote: Hi, I have many binaries compiled from my source package and I would like to attach 'undocumented' man page to these files. How can I do it? Aigh, no, please don't do that! Those drive me crazy!! The undocumented page provides no more information than No manual entry for foo (but the former is much longer to read). What is the point? policy :) Does the policy not say that all binaries should have a manpage. having a manpage saying that there is no manpage is the same as having non, and i think it is not in the spirit of the policy. Maybe all manpage needing binaries could be listed somewhere, and we could have a manpage writing task ? Friendly, Sven Luther
Re: Undocumented binary
On Tue, Apr 03, 2001 at 04:28:37PM +0200, Dennis Schoen wrote: On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: What is the point? policy :) i hate that catch 22. can't file a bug, since the package is not in debian[1] can't use undocumented, unless you have a bug against it, can't leave a manpage out entirely, since it would fail lintian, can't get into the archive, unless it is lintian clean -john [1] okay, you do file a bug against it with the ITP, but that bug is against wnpp. somehow, filing a bug against a package that does not yet exist seems wrong to me. i end up writing a small man page.
Re: Undocumented binary
* Sven LUTHER | Maybe all manpage needing binaries could be listed somewhere, and we could | have a manpage writing task ? http://qa.debian.org/man-pages.html :) -- Tollef Fog Heen Unix _IS_ user friendly... It's just selective about who its friends are.
Re: Undocumented binary
On Tue, Apr 03, 2001 at 09:00:31AM -0700, John H. Robinson, IV wrote: On Tue, Apr 03, 2001 at 04:28:37PM +0200, Dennis Schoen wrote: On Tue, Apr 03, 2001 at 09:49:41AM -0400, Steve M. Robbins wrote: What is the point? policy :) i hate that catch 22. can't file a bug, since the package is not in debian[1] can't use undocumented, unless you have a bug against it, can't leave a manpage out entirely, since it would fail lintian, can't get into the archive, unless it is lintian clean -john [1] okay, you do file a bug against it with the ITP, but that bug is against wnpp. somehow, filing a bug against a package that does not yet exist seems wrong to me. i end up writing a small man page. ^ Precisely: undocumented is not a solution, writing the man page is the solution. -S
Re: Undocumented binary
Steve M. Robbins: The undocumented page provides no more information than No manual entry for foo (but the former is much longer to read). What is the point? Personally, I reason that if I get No manual entry, it is a program that probably shouldn't have entered myself, but if I get undocumented, it's something that I can use, but no-one has ever bothered informing me of it. -- \\// peter - http://www.softwolves.pp.se/ Statement concerning unsolicited e-mail according to Swedish law: http://www.softwolves.pp.se/peter/reklampost.html
Re: Undocumented binary
* Tollef Fog Heen [EMAIL PROTECTED] [20010403 18:45]: Maybe all manpage needing binaries could be listed somewhere, and we could | have a manpage writing task ? http://qa.debian.org/man-pages.html The web page now shows who is working on the man pages for a package, so we can coordinate our efforts better. Jérôme Marant has agreed to maintain the database on who is working on what. If you want to work on a package, please email [EMAIL PROTECTED] and your name will be listed on the web site. (We consider making it automatic, e.g. by signing up on the web page, but let's see first how it works out). -- Martin Michlmayr [EMAIL PROTECTED]