On Thu, 2007-11-01 at 11:57 -0400, Robert P. J. Day wrote: > On Fri, 2 Nov 2007, Tim wrote: > > > On Thu, 2007-11-01 at 14:49 +0000, Chris G wrote: > > > So what is the point of these (rpm) entries? Do they somehow indicate > > > that there is some sort of documentation there, if so how do I get at > > > it? > > > > I would *guess* so. You'd usually find non-man file documentation > > in: /usr/share/doc/<name-of-package-probably-with-version-numbers>/ > > > > You could always use the rpm -ql command to see what's included in a > > package, and installed where. > > > > [tim@suspishus ~]$ apropos yelp > > yelp (rpm) - A system documentation reader from the Gnome project > > > > [tim@suspishus ~]$ man yelp > > No manual entry for yelp > > > > [tim@suspishus ~]$ rpm -ql yelp > > /etc/gconf/schemas/yelp.schemas > > /usr/bin/gnome-help > > /usr/bin/yelp > > /usr/share/applications/gnome-yelp.desktop > > /usr/share/doc/yelp-2.18.1 > > /usr/share/doc/yelp-2.18.1/AUTHORS > > /usr/share/doc/yelp-2.18.1/COPYING > > /usr/share/doc/yelp-2.18.1/ChangeLog > > /usr/share/doc/yelp-2.18.1/MAINTAINERS > > /usr/share/doc/yelp-2.18.1/NEWS > > /usr/share/doc/yelp-2.18.1/README > > /usr/share/gnome/help > > /usr/share/icons/hicolor/192x192/apps/yelp-icon-big.png > > /usr/share/locale/af/LC_MESSAGES/yelp.mo > > /usr/share/locale/am/LC_MESSAGES/yelp.mo > > /usr/share/locale/ar/LC_MESSAGES/yelp.mo > > /usr/share/locale/az/LC_MESSAGES/yelp. ...[snipped]... > > upon closer inspection, any man entry claiming to be part of (rpm) > would seem to be just plain broken. > > typically, that identifier represents the section of the > documentation under which you'd find the man page, which would be a > subdirectory of /usr/share/man, below: > > bg fr ja man3 man7 pl.ISO8859-2 sl > cs fr.ISO8859-1 ko man3p man7x pl.UTF-8 sv > da fr.UTF-8 man man3x man8 pt tr > de hr man0p man4 man8x pt_BR zh_CN > el hu man1 man4x man9 ro zh_TW > en id man1p man5 man9x ru > eo it man1x man5x mann ru.KOI8-R > es it.ISO8859-1 man2 man6 nl ru.UTF-8 > fi it.UTF-8 man2x man6x pl sk > > but, as you can see, there's nothing that appears to correspond to > the "rpm" section, which makes me believe that the "yelp" package > *internally* has something that (mistakenly) claims that its man page > is in that non-existent section. > > easy enough to check: > > $ yumdownloader --source yelp > ... install, build prep, cd BUILD/yelp > $ grep -rw rpm * > src/yelp-search-parser.c: /* RH man inserts rpm references into the whatis database */ > src/yelp-search-parser.c: if (g_str_has_prefix (line[1], "rpm)")) > $ > > aha! j'accuse! without looking any further, it sure seems like > there's something there that claims to be affiliated with "rpm". at > first glance, that would seem to be a bugzilla-able bug, but i'll > leave that up to someone else. > > rday > > p.s. looking at the actual file list with "rpm -ql yelp" leads one to > believe that that package doesn't even *come* with a man page. If you add the -n argument to grep, you will see the line numbers where the match occurred. Regards, Les H
