Bug 10814 - buggy man pages
Summary: buggy man pages
Status: CLOSED DUPLICATE of bug 19555
Alias: None
Product: Red Hat Linux
Classification: Retired
Component: groff
Version: 6.2
Hardware: All
OS: Linux
Target Milestone: ---
Assignee: Florian La Roche
QA Contact:
Depends On:
TreeView+ depends on / blocked
Reported: 2000-04-14 11:31 UTC by Michael Redinger
Modified: 2008-05-01 15:37 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Last Closed: 2001-04-03 00:00:15 UTC

Attachments (Terms of Use)

Description Michael Redinger 2000-04-14 11:31:03 UTC
There's a file called :.1.gz in /usr/man (being part of the bash2 package).
However, if you try something like this on that file:

zcat :.1.gz |nroff -man

You get an error:

realpath on `man1/builtins2.1' failed: No such file or directory

This is because this file is now called builtins2.1.gz (as all man pages
are compressed now). This is caused by the following line in :.1.gz:

.so man1/builtins2.1

so, probably unzip builtins2 or make : a link to that file ...

This posting goes to you as your package was one of the first ones I found
... a quick check (which might be wrong, but I found that it was always
true for those files I examined manually) showed 750 buggy files.

I used a simple script that I did execute in every directory (there might
be more simple methods, but it happened that I needed something like this
by accident):

for i in *.gz ; do
   zcat $i | man2html 2>/dev/null | \
   grep "^<H1>.*</H1>$"
done | grep "Invalid Manpage" | wc -l


I think this is a _very_ bad thing. The bug is not big enough to update
every single package, but if you sum this up, it's quite a big mistake ...
(anyway, there are some packages - like bash2 - where this .so syntax is
used in quite a few files. So, maybe change those ...

Comment 1 Denice 2000-05-17 09:05:59 UTC
There is also a file called  ..1.gz in /usr/man/man1 which also comes
from bash2-2.03-8:

  $ cd /usr/man/man1
  $ gunzip -c ..1.gz
  .so man1/builtins2.1

Comment 2 Bernhard Rosenkraenzer 2000-08-23 18:38:04 UTC
Looks like nroff doesn't handle .so correctly (it should automatically try
adding .gz, the way man does).

Comment 3 Trond Eivind Glomsrxd 2001-04-03 00:00:11 UTC
Still a problem.

Comment 4 Trond Eivind Glomsrxd 2002-05-14 20:53:39 UTC

*** This bug has been marked as a duplicate of 19555 ***

Note You need to log in before you can comment on or make changes to this bug.