Package: man-db
Version: 2.5.1-3
Severity: minor

>From the man page for man:

   -f, --whatis
          Equivalent to whatis.  Display a short description from
          the manual page, if available.  See whatis(1) for
          details.

>From the man page for whatis:

    EXIT STATUS
        0    Successful program execution.
 
        1    Usage, syntax or configuration file error.
 
        2    Operational error.
 
        16   No manual pages were found that matched the criteria
             specified.

However, man -f does not use the exit status of whatis; instead, it
always returns a zero exit status:

    $ whatis man; echo $?
    man (7)              - macros to format man pages
    man (1)              - an interface to the on-line reference manuals
    0
    $ man -f man; echo $?
    man (7)              - macros to format man pages
    man (1)              - an interface to the on-line reference manuals
    0
    $ whatis foobar; echo $?
    foobar: nothing appropriate.
    16
    $ man -f foobar; echo $?
    foobar: nothing appropriate.
    0

The output of [man -f --debug foobar] is attached per the
bug-reporting note (but I expect this is a simple case of not
propagating the return code).

   ---> Drake Wilson

-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.24.2 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages man-db depends on:
ii  bsdmainutils           6.1.10            collection of more utilities from 
ii  debconf [debconf-2.0]  1.5.20            Debian configuration management sy
ii  dpkg                   1.14.18           package maintenance system for Deb
ii  groff-base             1.18.1.1-20       GNU troff text-formatting system (
ii  libc6                  2.7-10            GNU C Library: Shared libraries
ii  libgdbm3               1.8.3-3           GNU dbm database routines (runtime
ii  zlib1g                 1:1.2.3.3.dfsg-12 compression library - runtime

man-db recommends no packages.

-- debconf information:
  man-db/build-database: true
  man-db/rebuild-database: true
  man-db/install-setuid: false
ruid=1000, euid=1000
++priv_drop_count = 1
>From the config file /etc/manpath.config:

Mandatory mandir `/usr/man'.
Mandatory mandir `/usr/share/man'.
Mandatory mandir `/usr/local/man'.
Path `/bin' mapped to mandir `/usr/share/man'.
Path `/usr/bin' mapped to mandir `/usr/share/man'.
Path `/sbin' mapped to mandir `/usr/share/man'.
Path `/usr/sbin' mapped to mandir `/usr/share/man'.
Path `/usr/local/bin' mapped to mandir `/usr/local/man'.
Path `/usr/local/bin' mapped to mandir `/usr/local/share/man'.
Path `/usr/local/sbin' mapped to mandir `/usr/local/man'.
Path `/usr/local/sbin' mapped to mandir `/usr/local/share/man'.
Path `/usr/X11R6/bin' mapped to mandir `/usr/X11R6/man'.
Path `/usr/bin/X11' mapped to mandir `/usr/X11R6/man'.
Path `/usr/games' mapped to mandir `/usr/share/man'.
Path `/opt/bin' mapped to mandir `/opt/man'.
Path `/opt/sbin' mapped to mandir `/opt/man'.
Global mandir `/usr/man', catdir `/var/cache/man/fsstnd'.
Global mandir `/usr/share/man', catdir `/var/cache/man'.
Global mandir `/usr/local/man', catdir `/var/cache/man/oldlocal'.
Global mandir `/usr/local/share/man', catdir `/var/cache/man/local'.
Global mandir `/usr/X11R6/man', catdir `/var/cache/man/X11R6'.
Global mandir `/opt/man', catdir `/var/cache/man/opt'.
Added section `1'.
Added section `n'.
Added section `l'.
Added section `8'.
Added section `3'.
Added section `2'.
Added section `3posix'.
Added section `3pm'.
Added section `3perl'.
Added section `5'.
Added section `4'.
Added section `9'.
Added section `6'.
Added section `7'.
`/usr/man'      `'      `1'
`/usr/share/man'        `'      `1'
`/usr/local/man'        `'      `1'
`/bin'  `/usr/share/man'        `0'
`/usr/bin'      `/usr/share/man'        `0'
`/sbin' `/usr/share/man'        `0'
`/usr/sbin'     `/usr/share/man'        `0'
`/usr/local/bin'        `/usr/local/man'        `0'
`/usr/local/bin'        `/usr/local/share/man'  `0'
`/usr/local/sbin'       `/usr/local/man'        `0'
`/usr/local/sbin'       `/usr/local/share/man'  `0'
`/usr/X11R6/bin'        `/usr/X11R6/man'        `0'
`/usr/bin/X11'  `/usr/X11R6/man'        `0'
`/usr/games'    `/usr/share/man'        `0'
`/opt/bin'      `/opt/man'      `0'
`/opt/sbin'     `/opt/man'      `0'
`/usr/man'      `/var/cache/man/fsstnd' `-1'
`/usr/share/man'        `/var/cache/man'        `-1'
`/usr/local/man'        `/var/cache/man/oldlocal'       `-1'
`/usr/local/share/man'  `/var/cache/man/local'  `-1'
`/usr/X11R6/man'        `/var/cache/man/X11R6'  `-1'
`/opt/man'      `/var/cache/man/opt'    `-1'
`1'     `'      `-5'
`n'     `'      `-5'
`l'     `'      `-5'
`8'     `'      `-5'
`3'     `'      `-5'
`2'     `'      `-5'
`3posix'        `'      `-5'
`3pm'   `'      `-5'
`3perl' `'      `-5'
`5'     `'      `-5'
`4'     `'      `-5'
`9'     `'      `-5'
`6'     `'      `-5'
`7'     `'      `-5'
Starting pipeline: /usr/bin/whatis -d foobar [input: {0, NULL}, output: {0, 
NULL}]
>From the config file /etc/manpath.config:

Mandatory mandir `/usr/man'.
Mandatory mandir `/usr/share/man'.
Mandatory mandir `/usr/local/man'.
Path `/bin' mapped to mandir `/usr/share/man'.
Path `/usr/bin' mapped to mandir `/usr/share/man'.
Path `/sbin' mapped to mandir `/usr/share/man'.
Path `/usr/sbin' mapped to mandir `/usr/share/man'.
Path `/usr/local/bin' mapped to mandir `/usr/local/man'.
Path `/usr/local/bin' mapped to mandir `/usr/local/share/man'.
Path `/usr/local/sbin' mapped to mandir `/usr/local/man'.
Path `/usr/local/sbin' mapped to mandir `/usr/local/share/man'.
Path `/usr/X11R6/bin' mapped to mandir `/usr/X11R6/man'.
Path `/usr/bin/X11' mapped to mandir `/usr/X11R6/man'.
Path `/usr/games' mapped to mandir `/usr/share/man'.
Path `/opt/bin' mapped to mandir `/opt/man'.
Path `/opt/sbin' mapped to mandir `/opt/man'.
Global mandir `/usr/man', catdir `/var/cache/man/fsstnd'.
Global mandir `/usr/share/man', catdir `/var/cache/man'.
Global mandir `/usr/local/man', catdir `/var/cache/man/oldlocal'.
Global mandir `/usr/local/share/man', catdir `/var/cache/man/local'.
Global mandir `/usr/X11R6/man', catdir `/var/cache/man/X11R6'.
Global mandir `/opt/man', catdir `/var/cache/man/opt'.
Added section `1'.
Added section `n'.
Added section `l'.
Added section `8'.
Added section `3'.
Added section `2'.
Added section `3posix'.
Added section `3pm'.
Added section `3perl'.
Added section `5'.
Added section `4'.
Added section `9'.
Added section `6'.
Added section `7'.
`/usr/man'      `'      `1'
`/usr/share/man'        `'      `1'
`/usr/local/man'        `'      `1'
`/bin'  `/usr/share/man'        `0'
`/usr/bin'      `/usr/share/man'        `0'
`/sbin' `/usr/share/man'        `0'
`/usr/sbin'     `/usr/share/man'        `0'
`/usr/local/bin'        `/usr/local/man'        `0'
`/usr/local/bin'        `/usr/local/share/man'  `0'
`/usr/local/sbin'       `/usr/local/man'        `0'
`/usr/local/sbin'       `/usr/local/share/man'  `0'
`/usr/X11R6/bin'        `/usr/X11R6/man'        `0'
`/usr/bin/X11'  `/usr/X11R6/man'        `0'
`/usr/games'    `/usr/share/man'        `0'
`/opt/bin'      `/opt/man'      `0'
`/opt/sbin'     `/opt/man'      `0'
`/usr/man'      `/var/cache/man/fsstnd' `-1'
`/usr/share/man'        `/var/cache/man'        `-1'
`/usr/local/man'        `/var/cache/man/oldlocal'       `-1'
`/usr/local/share/man'  `/var/cache/man/local'  `-1'
`/usr/X11R6/man'        `/var/cache/man/X11R6'  `-1'
`/opt/man'      `/var/cache/man/opt'    `-1'
`1'     `'      `-5'
`n'     `'      `-5'
`l'     `'      `-5'
`8'     `'      `-5'
`3'     `'      `-5'
`2'     `'      `-5'
`3posix'        `'      `-5'
`3pm'   `'      `-5'
`3perl' `'      `-5'
`5'     `'      `-5'
`4'     `'      `-5'
`9'     `'      `-5'
`6'     `'      `-5'
`7'     `'      `-5'

path directory /usr/local/bin is in the config file
adding /usr/local/man to manpath
adding /usr/local/share/man to manpath

path directory /usr/bin is in the config file
adding /usr/share/man to manpath

path directory /bin is in the config file
/usr/share/man is already in the manpath

path directory /usr/games is in the config file
/usr/share/man is already in the manpath

path directory /home/drake/bin is not in the config file
and doesn't have ../man or man subdirectories

path directory /home/drake/bin/dwim.d is not in the config file
and doesn't have ../man or man subdirectories

path directory /sbin is in the config file
/usr/share/man is already in the manpath

path directory /usr/sbin is in the config file
/usr/share/man is already in the manpath

path directory /usr/local/sbin is in the config file
/usr/local/man is already in the manpath
/usr/local/share/man is already in the manpath

adding mandatory man directories

warning: /usr/man: No such file or directory
/usr/share/man is already in the manpath
/usr/local/man is already in the manpath
add_nls_manpath(): processing /usr/local/man:/usr/local/share/man:/usr/share/man
adding /usr/share/man/en to manpathlist
adding /usr/local/man to manpathlist
adding /usr/local/share/man to manpathlist
adding /usr/share/man to manpathlist
lower(foobar) = "foobar"
path=/usr/share/man/en
path=/usr/local/man
path=/usr/local/share/man
path=/usr/share/man
foobar: nothing appropriate.
hash_free: 0 entries, 0 (0%) unique
Started "/usr/bin/whatis", pid 31308
Waiting for pipeline: /usr/bin/whatis -d foobar [input: {0, NULL}, output: {0, 
NULL}]
Active processes (1):
  "/usr/bin/whatis" (31308) -> 4096

Reply via email to