[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#348864: marked as done (lintian: Check that manual pages are in the right section)

Your message dated Sat, 3 Jul 2021 22:15:07 -0700
with message-id <CAFHYt54AsS-yFpxc8vBmex5YX4Fgu7cCGmm+k_viF_BksGNc1A@mail.gmail.com>
and subject line Re: lintian: Check that manual pages are in the right section
has caused the Debian Bug report #348864,
regarding lintian: Check that manual pages are in the right section
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
348864: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348864
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: lintian
Version: 1.23.14
Severity: wishlist

It would be nice if lintian would check whether the man page for a
program is in the right section, i.e. for stuff in /usr/bin and /bin
it should be in section 1 and for /usr/sbin and /sbin in section 8.
I had the following package and lintian didn't say anything:

drwxr-xr-x root/root         0 2006-01-19 13:32:34 ./
drwxr-xr-x root/root         0 2006-01-19 13:32:33 ./usr/
drwxr-xr-x root/root         0 2006-01-19 13:32:33 ./usr/bin/
-rwxr-xr-x root/root     26872 2006-01-19 13:32:33 ./usr/bin/devio
drwxr-xr-x root/root         0 2006-01-19 13:32:33 ./usr/share/
drwxr-xr-x root/root         0 2006-01-19 13:32:33 ./usr/share/man/
drwxr-xr-x root/root         0 2006-01-19 13:32:33 ./usr/share/man/man8/
-rw-r--r-- root/root       856 2006-01-19 13:32:24 ./usr/share/man/man8/devio.8.gz



-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.12-1-686
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)

Versions of packages lintian depends on:
ii  binutils             2.16.1cvs20051214-1 The GNU assembler, linker and bina
ii  diffstat             1.41-1              produces graph of changes introduc
ii  dpkg-dev             1.13.11             package building tools for Debian
ii  file                 4.15-2              Determines file type using "magic"
ii  gettext              0.14.5-2            GNU Internationalization utilities
ii  intltool-debian      0.34.1+20050828     Help i18n of RFC822 compliant conf
ii  libparse-debianchang 1.0-1               parse Debian changelogs and output
ii  man-db               2.4.3-3             The on-line manual pager
ii  perl [libdigest-md5- 5.8.7-10            Larry Wall's Practical Extraction 

lintian recommends no packages.

-- no debconf information

-- 
Martin Michlmayr
http://www.cyrius.com/

--- End Message ---
--- Begin Message --- 
Hi Martin,

> while I can think of valid examples where a program is in
> bin with a man page in section 8, I can't think of any valid examples
> where a program is in sbin with a man page in section 1.

At some point since you filed your bug in 2006, that compromise was
implemented. It has been around for a while.

Lintian warns when a system command in (?:/usr)?/sbin ships with a
manual page in section 1—but not the other way round. You can find all
occurrences on Lintian's website:

    https://lintian.debian.org/tags/manual-page-for-system-command

With only six overrides in 483 occurrences overall, the tag meets our
quality assurance standards for low false positives. (We use overrides
as a proxy for same.)

On a side note, the supporting reference on the web site currently
reads as "1" due to a new bug fixed in Git. Please click on any tag
version other than 2.104.275 to see the actual reference to 'hier(7)'.
To be more helpful, I furthermore added this bug number and Bug#253011
as references:

    https://salsa.debian.org/lintian/lintian/-/commit/3b18988ebe385c26c5e2b09d2f3bacd23a53af3c

Thanks for helping to make Lintian better! Closing this bug.

Kind regards
Felix Lechner

--- End Message ---
Reply to: