Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 165466 - app-editors/emacs-21.4-r6: man pages not available
Summary: app-editors/emacs-21.4-r6: man pages not available
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Emacs project
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-02-05 17:25 UTC by Martin von Gagern
Modified: 2007-04-06 21:40 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Martin von Gagern 2007-02-05 17:25:16 UTC
This elog mail told me there was a problem with emacs man pages:
> WARN: postinst
> Unable to establish /usr/share/man/man1/emacsclient.1.gz symlink

I investigated and found:
# ls -l /usr/share/man/man1/ | grep emacs.emacs
lrwxrwxrwx 1 root root     19 Feb  5 16:35 emacs.1.gz -> emacs.emacs-21.1.gz
-rw-r--r-- 1 root root   5548 Feb  5 16:34 emacs.emacs-21.1.bz2

a) the symlink is broken, which is bug 164969 and which I'll report again there
b) there is only a single manual page, even though the ebuild lists four

I investigated some more, found there are more man files, especially emacsclient.1, in the work dir, and found them again in the install log:
> Copying /var/tmp/portage/app-editors/emacs-21.4-r6/work/emacs-21.4/etc to
> /var/tmp/portage/app-editors/emacs-21.4-r6/image//usr/share/emacs/21.4/etc...
...
> ./emacsclient.1

And indeed:
# cd /usr/share/emacs/21.4/etc; ls *.[1-9]
DOC-21.4.1  ONEWS.2  ONEWS.4     condom.1  emacs.1        emacstool.1  gfdl.1
ONEWS.1     ONEWS.3  celibacy.1  ctags.1   emacsclient.1  etags.1      sex.6

So the man pages are there, in uncompressed form, but not listed on the MANPATH so they are not easily accessible. I can imagine this observation might be closely related to bug 164969, but I'm not sure what kind this relationship is.
Comment 1 Christian Faulhammer (RETIRED) gentoo-dev 2007-02-05 17:33:07 UTC
Please just let bug wranglers do their work and don't add maintainers in cc.  The bug will reach the right people.
Comment 2 Ulrich Müller gentoo-dev 2007-02-05 20:36:46 UTC
(In reply to comment #0)
> # ls -l /usr/share/man/man1/ | grep emacs.emacs
> [...]
> b) there is only a single manual page, even though the ebuild lists four

If you grep for "emacs.emacs" you will of course only find this one, and you will miss "etags", "ctags", etc.

> # cd /usr/share/emacs/21.4/etc; ls *.[1-9]
> DOC-21.4.1  ONEWS.2  ONEWS.4     condom.1  emacs.1        emacstool.1  gfdl.1
> ONEWS.1     ONEWS.3  celibacy.1  ctags.1   emacsclient.1  etags.1      sex.6

Not all of these are man pages (and you would not want all of the ones that are  man pages to be installed). The main Makefile.in of the package installs just "emacs.1", "etags.1", "ctags.1", and "gfdl.1" in /usr/share/man/man1 (at the end of the install-arch-indep target).

For some reason, "emacsclient.1" is indeed missing. (This is fixed in versions 22.*.)

> So the man pages are there, in uncompressed form, but not listed on the MANPATH
> so they are not easily accessible.

/usr/share/emacs/.../etc definitely should not be included in MANPATH.
Comment 3 Martin von Gagern 2007-02-05 22:31:53 UTC
(In reply to comment #2)
> If you grep for "emacs.emacs" you will of course only find this one...

You are right. I had listed emacs* at first and then wanted to grep for *.emacs*  to find all things slotted for emacs. Mixed things up there, sorry.

> For some reason, "emacsclient.1" is indeed missing. (This is fixed in versions
> 22.*.)

So either it should be installed there for 21.4-r6 as well, or update-alternatives should expect and handle the case when this man page is missing.
Comment 4 Christian Faulhammer (RETIRED) gentoo-dev 2007-02-06 06:12:11 UTC
emacsclient is now taken out from symlink generation, gfdl has been added.
As Emacs 22 will be released soon (some weeks I hope), I won't mess around more in the 21.4 ebuild.

the suffix variable generation is niced up, thanks.
Comment 5 Ulrich Müller gentoo-dev 2007-03-24 11:55:11 UTC
The missing man page for emacsclient has been fixed in the emacs overlay, emacs-21.4-r10.
Comment 6 Ulrich Müller gentoo-dev 2007-04-06 21:40:02 UTC
(In reply to comment #0)
> DOC-21.4.1  ONEWS.2  ONEWS.4     condom.1  emacs.1        emacstool.1  gfdl.1
> ONEWS.1     ONEWS.3  celibacy.1  ctags.1   emacsclient.1  etags.1      sex.6
> 
> So the man pages are there, in uncompressed form, but not listed on the
> MANPATH so they are not easily accessible.

To come back to this again: Surprisingly, some of the "missing" man pages are available in package games-misc/funny-manpages.