Bug#511522: general: Man pages should say what package a program belongs to

2009-01-15 Thread Jack Grahl
As several people have pointed out, there is already a good way (that I was not 
aware of) to find out this information, therefore I agree that this bug should 
be closed.

Jack







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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-12 Thread Vincent Lefevre
I'm not the bug reporter, but...

On 2009-01-11 20:21:59 +, Roger Leigh wrote:
 % dpkg -S /usr/bin/basename
 coreutils: /usr/bin/basename

This may be a bit more complex when the file is a symlink to an
alternative. Concerning the man pages, packages sometimes install
symlinks, and it isn't always easy to find what package installed
them, in particular when they became dangling symlinks due to some
bug.

-- 
Vincent Lefèvre vinc...@vinc17.org - Web: http://www.vinc17.org/
100% accessible validated (X)HTML - Blog: http://www.vinc17.org/blog/
Work: CR INRIA - computer arithmetic / Arenaire project (LIP, ENS-Lyon)



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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Jack Grahl
Package: general
Severity: wishlist


If some program belongs to a package which does not have the same name 
as the program, the man page for that command should say which package 
the program is part of.
This is not the case in, for instance, coreutils or util-linux.
This information is needed, even for packages that are always installed 
as part of the base distribution, since to get source code for a program 
in coreutils one needs to know that it is part of that package.

Jack

-- System Information:
Debian Release: 4.0
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18jack1
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)






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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Roger Leigh
On Sun, Jan 11, 2009 at 07:56:52PM +, Jack Grahl wrote:
 If some program belongs to a package which does not have the same name 
 as the program, the man page for that command should say which package 
 the program is part of.
 This is not the case in, for instance, coreutils or util-linux.
 This information is needed, even for packages that are always installed 
 as part of the base distribution, since to get source code for a program 
 in coreutils one needs to know that it is part of that package.

% dpkg -S /usr/bin/basename
coreutils: /usr/bin/basename
% man basename | tail -n 1
GNU coreutils 6.9.92.4-f088d-dirtJanuary 2008  BASENAME(1)

It's always trivial to determine which program belongs to a particular
package--this is the job of the package manager, dpkg, whose job is to
track which files are in which package.  It does not need to be in the
documentation (though it often is, albeit with a screwy version in this
case).


Regards,
Roger

-- 
  .''`.  Roger Leigh
 : :' :  Debian GNU/Linux http://people.debian.org/~rleigh/
 `. `'   Printing on GNU/Linux?   http://gutenprint.sourceforge.net/
   `-GPG Public Key: 0x25BFB848   Please GPG sign your mail.



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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Adeodato Simó
* Jack Grahl [Sun, 11 Jan 2009 19:56:52 +]:

 Package: general
 Severity: wishlist

Hello, Jack.

 If some program belongs to a package which does not have the same name 
 as the program, the man page for that command should say which package 
 the program is part of.
 This is not the case in, for instance, coreutils or util-linux.
 This information is needed, even for packages that are always installed 
 as part of the base distribution, since to get source code for a program 
 in coreutils one needs to know that it is part of that package.

I understand what you're asking, but I don't think modifying every man
page in Debian to say what package the binary comes from is a good idea.
In particular, man pages come from upstream, and we'd be carrying an
unnecessary diff in *every* package. (Except, heh, for those binaries
without a man page).

I'm closing this bug, because there *is* a standard and more scalable
way in Debian to achieve what you want: dpkg -S. You can run that
command to know what package a binary (or, in general, any file) belongs
to. For example:

% dpkg -S /bin/ls
coreutils: /bin/ls

Hope this helps.

-- 
Adeodato Simó dato at net.com.org.es
Debian Developer  adeodato at debian.org
 
— Oh, George, you didn't jump into the river. How sensible of you! 
-- Mrs Banks in “Mary Poppins”




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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Samuel Thibault
Jack Grahl, le Sun 11 Jan 2009 19:56:52 +, a écrit :
 If some program belongs to a package which does not have the same name 
 as the program, the man page for that command should say which package 
 the program is part of.

Mmm, usually I just run dpkg -S bin/command, or better, dlocate
bin/command

Samuel



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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Eugene V. Lyubimkin
Jack Grahl wrote:
 Package: general
 Severity: wishlist
Hello Jack,

 If some program belongs to a package which does not have the same name 
 as the program, the man page for that command should say which package 
 the program is part of.
 This is not the case in, for instance, coreutils or util-linux.
 This information is needed, even for packages that are always installed 
 as part of the base distribution, since to get source code for a program 
 in coreutils one needs to know that it is part of that package.
'dpkg -S name.number', can explicitly say which package man page belongs to.
Example for coreutils:

$ dpkg -S mv.1
coreutils: /usr/share/man/man1/mv.1.gz
git-core: /usr/share/man/man1/git-mv.1.gz

Look, first package is what you want.

Is this approach acceptable for your needs?

-- 
Eugene V. Lyubimkin aka JackYF, JID: jackyf.devel(maildog)gmail.com
Ukrainian C++ developer, Debian Maintainer, APT contributor



signature.asc
Description: OpenPGP digital signature


Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Neil Williams
On Sun, 11 Jan 2009 19:56:52 + (GMT)
Jack Grahl mnv...@yahoo.co.uk wrote:

 If some program belongs to a package which does not have the same name 
 as the program, the man page for that command should say which package 
 the program is part of.
 This is not the case in, for instance, coreutils or util-linux.
 This information is needed, even for packages that are always installed 
 as part of the base distribution, since to get source code for a program 
 in coreutils one needs to know that it is part of that package.

Alternatively, look up the package concerned using dpkg -S:

$ dpkg -S ls.1.gz

To make this a requirement for *all* manpages seems like
massive overkill.

Maybe this bug could be reassigned to coreutils and possibly cloned for
util-linux that each manpage in the base packages at least contain a
See also:  comment, if only because there are so many.

If you want this information in order to file a bug against the package
containing the manpage, reportbug will do the lookup for you and give
you the chance to choose which package relates to the file you wanted.

If the syntax for dpkg -S is unfamiliar, reportbug is a suitable
wrapper.

A final alternative is the packages.debian.org website (has the
advantage that it also allows looking up files within packages that are
not currently installed).

-- 


Neil Williams
=
http://www.data-freedom.org/
http://www.linux.codehelp.co.uk/
http://e-mail.is-not-s.ms/



pgpWhKvOP7R1m.pgp
Description: PGP signature


Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Frank Lin PIAT
Hi,

On Sun, 2009-01-11 at 19:56 +, Jack Grahl wrote:
 If some program belongs to a package which does not have the same name 
 as the program, the man page for that command should say which package 
 the program is part of.

Assuming that one can run:

  dpkg -S $(man -w hostname)
  manpages: /usr/share/man/man1/hostname.1.gz

or

  dpkg -S $(man -s 7 -w hostname)
  manpages: /usr/share/man/man7/hostname.7.gz


What would be the benefit of writing this information in each and every
page? (with the risk of errors)
Of course, man could be modified to look for that information, but I
wonder if that's so useful.

Franklin




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



Bug#511522: general: Man pages should say what package a program belongs to

2009-01-11 Thread Eugene V. Lyubimkin
Neil Williams wrote:
 A final alternative is the packages.debian.org website (has the
 advantage that it also allows looking up files within packages that are
 not currently installed).
We also have apt-file utility, which does the same without looking to the site.

-- 
Eugene V. Lyubimkin aka JackYF, JID: jackyf.devel(maildog)gmail.com
Ukrainian C++ developer, Debian Maintainer, APT contributor



signature.asc
Description: OpenPGP digital signature