Public bug reported:

In the old days, man pages were stored under /usr/man.  Now, they are
stored under /usr/share/man.  Ubuntu systems no longer have a /usr/man,
so all our really old scripts and reflexes that look under /usr/man fail
unless you think to add the helpful symlink "ln -s share/man /usr/man".

But making that helpful symlink breaks "apropos" and "man -k" because
in /etc/manpath.config are these two different locations for the "mandb" 
index database:

    MANDB_MAP       /usr/man                /var/cache/man/fsstnd
    MANDB_MAP       /usr/share/man          /var/cache/man

If you add the symlink for /usr/man, then the index.db file created 
by "mandb" ends up under a sub-directory /var/cache/man/fsstnd where
"apropos" and "man -k" can't find it.

Of course you can add another helpful symlink "ln -s fsstnd/index.db 
/var/cache/index.db" to work-around the "apropos" problem, or you can
set your "MANPATH=/usr/man", but surely it doesn't need to be a problem
in the first place.

1. Please make "apropos" and "man -k" smarter.  Either they could look 
in both /var/cache/man and /var/cache/man/fsstnd, or else "mandb" could
resolve the symlink /usr/man to its absolute version /usr/share/man before
looking it up in the manpath.config file and thus not create the unhelpful
"/fsstnd" sub-directory that breaks "apropos".

2. The man page for "mandb" and the manpath.config file make no 
mention of the reason for the extra "/fsstnd" sub-directory.  The
manpath.config file says the "FHS compliant" index.db location should
be /var/cache/man/index.db and the "FSSTND compliant" location is under 
/var/catman  Either remove the mysterious "/fsstnd" or explain it.

ProblemType: Bug
DistroRelease: Ubuntu 20.04
Package: man-db 2.9.1-1
ProcVersionSignature: Ubuntu 5.8.0-63.71~20.04.1-generic 5.8.18
Uname: Linux 5.8.0-63-generic x86_64
ApportVersion: 2.20.11-0ubuntu27.18
Architecture: amd64
CasperMD5CheckResult: skip
Date: Mon Aug 30 04:37:46 2021
EcryptfsInUse: Yes
InstallationDate: Installed on 2020-10-07 (326 days ago)
InstallationMedia: Lubuntu 20.04.1 LTS "Focal Fossa" - Release amd64 (20200731)
SourcePackage: man-db
UpgradeStatus: No upgrade log present (probably fresh install)

** Affects: man-db (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: amd64 apport-bug focal third-party-packages

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/1942063

Title:
  /usr/man symlink breaks apropos man -k due to fsstnd

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/man-db/+bug/1942063/+subscriptions


-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to