Following emerge =dev-java/blackdown-jdk-1.4.2.03-r13, the man pages installed in /opt/blackdown-jdk-1.4.2.03/man/man1/ (and any localized man pages) are doubly compressed as .gz.bz2 files, which the 'man' command cannot handle properly. Reproducible: Always Steps to Reproduce: 1. emerge =dev-java/blackdown-jdk-1.4.2.03-r13 2. ls -l /opt/blackdown-jdk-1.4.2.03/man/man1 3. man -M /opt/blackdown-jdk-1.4.2.03/man Actual Results: $ ls -l /opt/blackdown-jdk-1.4.2.03/man/man1 total 180 -rw-r--r-- 1 root root 3374 Jan 26 17:58 appletviewer.1.gz.bz2 -rw-r--r-- 1 root root 1299 Jan 26 17:58 extcheck.1.gz.bz2 -rw-r--r-- 1 root root 5727 Jan 26 17:58 idlj.1.gz.bz2 -rw-r--r-- 1 root root 4057 Jan 26 17:58 jar.1.gz.bz2 -rw-r--r-- 1 root root 10375 Jan 26 17:58 jarsigner.1.gz.bz2 -rw-r--r-- 1 root root 5560 Jan 26 17:58 java.1.gz.bz2 -rw-r--r-- 1 root root 6886 Jan 26 17:58 javac.1.gz.bz2 -rw-r--r-- 1 root root 39177 Jan 26 17:58 javadoc.1.gz.bz2 -rw-r--r-- 1 root root 2425 Jan 26 17:58 javah.1.gz.bz2 -rw-r--r-- 1 root root 2222 Jan 26 17:58 javap.1.gz.bz2 -rw-r--r-- 1 root root 1442 Jan 26 17:58 javaws.1.gz.bz2 -rw-r--r-- 1 root root 4307 Jan 26 17:58 jdb.1.gz.bz2 -rw-r--r-- 1 root root 19172 Jan 26 17:58 keytool.1.gz.bz2 -rw-r--r-- 1 root root 1913 Jan 26 17:58 kinit.1.gz.bz2 -rw-r--r-- 1 root root 1051 Jan 26 17:58 klist.1.gz.bz2 -rw-r--r-- 1 root root 1622 Jan 26 17:58 ktab.1.gz.bz2 -rw-r--r-- 1 root root 1424 Jan 26 17:58 native2ascii.1.gz.bz2 -rw-r--r-- 1 root root 2349 Jan 26 17:58 orbd.1.gz.bz2 -rw-r--r-- 1 root root 3360 Jan 26 17:58 policytool.1.gz.bz2 -rw-r--r-- 1 root root 3570 Jan 26 17:58 rmic.1.gz.bz2 -rw-r--r-- 1 root root 4211 Jan 26 17:58 rmid.1.gz.bz2 -rw-r--r-- 1 root root 1410 Jan 26 17:58 rmiregistry.1.gz.bz2 -rw-r--r-- 1 root root 1183 Jan 26 17:58 serialver.1.gz.bz2 -rw-r--r-- 1 root root 2080 Jan 26 17:58 servertool.1.gz.bz2 -rw-r--r-- 1 root root 3148 Jan 26 17:58 tnameserv.1.gz.bz2 $ /opt/blackdown-jdk-1.4.2.03/man/man1 <standard input>:2: warning: can't find character with input code 2 <standard input>:2: warning: can't find character with input code 3 <standard input>:2: warning: can't find character with input code 4 [more warnings and jibberish output skipped] Expected Results: The man pages should have been installed as .bz2 files, not .gz.bz2 files. Portage 2.1.2-r4 (default-linux/x86/2006.1/desktop, gcc-4.1.1, glibc-2.5-r0, 2.6.18-ija1 i686) ================================================================= System uname: 2.6.18-ija1 i686 AMD Duron(tm) processor Gentoo Base System version 1.12.9 Timestamp of tree: Fri, 26 Jan 2007 16:30:01 +0000 dev-java/java-config: 1.3.7, 2.0.31-r3 dev-lang/python: 2.4.4 dev-python/pycrypto: 2.0.1-r5 sys-apps/sandbox: 1.2.18.1 sys-devel/autoconf: 2.13, 2.61 sys-devel/automake: 1.4_p6, 1.5, 1.6.3, 1.7.9-r1, 1.8.5-r3, 1.9.6-r2, 1.10 sys-devel/binutils: 2.17 sys-devel/gcc-config: 1.3.14 sys-devel/libtool: 1.5.22 virtual/os-headers: 2.6.19.2-r1 ACCEPT_KEYWORDS="x86 ~x86" AUTOCLEAN="yes" CBUILD="i686-pc-linux-gnu" CFLAGS="-march=athlon -O2 -pipe" CHOST="i686-pc-linux-gnu" CONFIG_PROTECT="/etc /usr/kde/3.5/env /usr/kde/3.5/share/config /usr/kde/3.5/shutdown /usr/share/X11/xkb /usr/share/config" CONFIG_PROTECT_MASK="/etc/env.d /etc/env.d/java/ /etc/gconf /etc/java-config/vms/ /etc/revdep-rebuild /etc/terminfo /etc/texmf/web2c" CXXFLAGS="-march=athlon -O2 -pipe" DISTDIR="/work/portage/distfiles" FEATURES="autoconfig confcache distlocks metadata-transfer parallel-fetch sandbox sfperms strict" GENTOO_MIRRORS="http://www.mirrorservice.org/sites/www.ibiblio.org/gentoo http://gentoo.oregonstate.edu http://www.ibiblio.org/pub/Linux/distributions/gentoo" LINGUAS="en en_GB" PKGDIR="/work/portage/packages" PORTAGE_RSYNC_OPTS="--recursive --links --safe-links --perms --times --compress --force --whole-file --delete --delete-after --stats --timeout=180 --exclude=/distfiles --exclude=/local --exclude=/packages" PORTAGE_TMPDIR="/var/tmp" PORTDIR="/usr/portage" PORTDIR_OVERLAY="/usr/local/portage" SYNC="rsync://rsync.gentoo.org/gentoo-portage" USE="X aac adns alsa arts avahi berkdb bitmap-fonts bzip2 cairo cdr cjk cli cracklib crypt cups curl dbus dlloader doc dri dv dvd dvdr eds emboss encode esd expat fam firefox flac flash fortran gdbm gif glut gmp gnome gpm gstreamer gtk gtkhtml hal iconv idn imagemagick imap imlib ipv6 isdnlog java jpeg kde lcms ldap libg++ mad mikmod mmx mng mono motif mozsvg mp3 mpeg ncurses nls no-helper nptl nsplugin offensive ogg opengl oss pam pcre pdf perl plotutils png ppds pppd python qemu-fast qt3 qt4 quicktime readline reflection samba sdl session slang snmp softmmu spell spl sqlite ssl svg tcltk tcpd tetex threads tiff truetype truetype-fonts type1-fonts udev unicode usb vorbis win32codecs x264 x86 xine xml xorg xv zlib" ALSA_CARDS="ens1371" ALSA_PCM_PLUGINS="adpcm alaw asym copy dmix dshare dsnoop empty extplug file hooks iec958 ioplug ladspa lfloat linear meter mulaw multi null plug rate route share shm softvol" ELIBC="glibc" INPUT_DEVICES="keyboard mouse" KERNEL="linux" LCD_DEVICES="bayrad cfontz cfontz633 glk hd44780 lb216 lcdm001 mtxorb ncurses text" LINGUAS="en en_GB" USERLAND="GNU" VIDEO_CARDS="radeon ati vesa fbdev" Unset: CTARGET, EMERGE_DEFAULT_OPTS, INSTALL_MASK, LANG, LC_ALL, LDFLAGS, MAKEOPTS, PORTAGE_RSYNC_EXTRA_OPTS
I missed the subject of the man page from step 3. Any of the installed man pages will do: 3. man -M /opt/blackdown-jdk-1.4.2.03/man java (I put the -M option there in case some other java package in in the MANPATH.)
I also screwed up cutting and pasting the command for step 3 into the "actual output" section. It should have been: $ man -M /opt/blackdown-jdk-1.4.2.03/man java <standard input>:2: warning: can't find character with input code 2 ...
In portage-2.1.2-r5 the *.gz files are automatically decompressed.
This is fixed.
