Package: lintian Version: 2.5.94 Severity: normal Hi,
the phrase "Please move this files to /usr/share/doc/ or remove it." sounds very final, but completely ignores that there are quite a lot of files (often named README or so) documenting the purpose or contents of the directory they're in. Examples: --------------------------------------------------------------------------- $ cat /usr/lib/xymon/client/local/README This directory - the client/local/ directory - can be used to install Xymon client add-on scripts. The Xymon client will run all files in this directory that are executable, and include the output from each script in a separate section in the Xymon client message which is sent to the Xymon server. This output will have to be processed on the Xymon server; there is no default processing done by Xymon on the output from these scripts. They are merely added to the client data. If you want to install an add-on script that direcly generates a status column in Xymon, this should go in the client/ext/ directory instead. --------------------------------------------------------------------------- $ cat /etc/sudoers.d/README # # As of Debian version 1.7.2p1-1, the default /etc/sudoers file created on # installation of the package now includes the directive: # # #includedir /etc/sudoers.d # # This will cause sudo to read and parse any files in the /etc/sudoers.d # directory that do not end in '~' or contain a '.' character. # # Note that there must be at least one file in the sudoers.d directory (this # one will do), and all files in this directory should be mode 0440. # # Note also, that because sudoers contents can vary widely, no attempt is # made to add this directive to existing sudoers files on upgrade. Feel free # to add the above directive to the end of your /etc/sudoers file to enable # this functionality for existing installations if you wish! # # Finally, please note that using the visudo command is the recommended way # to update sudoers content, since it protects against many failure modes. # See the man page for visudo for more information. --------------------------------------------------------------------------- $ cat /usr/share/rlwrap/filters/README The filters in this directory have been written to test rlwrap, not to be practical. --------------------------------------------------------------------------- If you do a "find /etc /var /usr -name README -not -path '/usr/share/doc/*'" you'll find tons more of such cases, but also cases like these, where it definitely doesn't make sense to rename (!) all these files and put them elsewhere (didn't check if lintian complains about them, but according to the tag description it probably will): /usr/share/themes/Agualemon/xfwm4/README /usr/share/themes/BlackMATE/README /usr/share/themes/Moheli/xfwm4/README /usr/share/themes/Daloa/xfwm4/README /usr/share/themes/Default-4.2/xfwm4/README /usr/share/themes/Xfce/xfwm4/README /usr/share/themes/Perl/xfwm4/README /usr/share/themes/Tgc-large/xfwm4/README /usr/share/themes/Curve/xfwm4/README /usr/share/themes/Eazel-blue/xfwm4/README /usr/share/themes/ukui-theme-jun/gtk-2.0/widgets/README /usr/share/themes/Wallis/xfwm4/README /usr/share/themes/TraditionalOk/xfwm4/README /usr/share/themes/Defcon-IV/xfwm4/README /usr/share/themes/TUX/xfwm4/README /usr/share/themes/Tabs/xfwm4/README /usr/share/themes/Redmond/xfwm4/README /usr/share/themes/Kokodi/xfwm4/README /usr/share/themes/Retro/xfwm4/README /usr/share/themes/Alternate/xfwm4/README /usr/share/themes/Default/xfwm4/README /usr/share/themes/Gnububble/xfwm4/README /usr/share/themes/MurrinaBlue/xfwm4/README /usr/share/themes/Exocet/xfwm4/README /usr/share/themes/Platinum/xfwm4/README /usr/share/themes/Tubular/xfwm4/README /usr/share/themes/R9X/xfwm4/README /usr/share/themes/CortlandChicken/README /usr/share/themes/Microcurve/xfwm4/README /usr/share/themes/Symphony/xfwm4/README /usr/share/themes/Prune/xfwm4/README /usr/share/themes/RedmondXP/xfwm4/README /usr/share/themes/Wildbush/xfwm4/README /usr/share/themes/MurrinaAzul/xfwm4/README /usr/share/themes/Biz/xfwm4/README /usr/share/themes/Meenee/xfwm4/README /usr/share/themes/Slimline/xfwm4/README /usr/share/themes/BBS/xfwm4/README /usr/share/themes/Kde/xfwm4/README /usr/share/themes/Keramik/xfwm4/README /usr/share/themes/MurrinaBleu/xfwm4/README /usr/share/themes/Gtk/xfwm4/README /usr/share/themes/Coolclean/xfwm4/README /usr/share/themes/Default-4.0/xfwm4/README /usr/share/themes/Ops/xfwm4/README /usr/share/themes/Crux/xfwm4/README /usr/share/themes/Tgc/xfwm4/README /usr/share/themes/Elberg/xfwm4/README /usr/share/themes/Default-4.6/xfwm4/README /usr/share/themes/ukui-theme-black/gtk-2.0/widgets/README /usr/share/themes/Synthetic/xfwm4/README /usr/share/themes/MurrinaDark/xfwm4/README /usr/share/themes/Linea/xfwm4/README /usr/share/themes/Cruxish/xfwm4/README /usr/share/themes/Quiet-purple/xfwm4/README /usr/share/themes/Beastie/xfwm4/README /usr/share/themes/Kiwi/xfwm4/README /usr/share/themes/Galaxy/xfwm4/README /usr/share/themes/Coldsteel/xfwm4/README /usr/share/themes/ukui-theme-red/gtk-2.0/widgets/README /usr/share/themes/Iceg/xfwm4/README /usr/share/themes/Buzz/xfwm4/README /usr/share/themes/B6/xfwm4/README /usr/share/themes/ukui-theme-orange/gtk-2.0/widgets/README /usr/share/themes/Mofit/xfwm4/README /usr/share/themes/Agua/xfwm4/README /usr/share/themes/Microdeck/xfwm4/README /usr/share/themes/Quinx/xfwm4/README /usr/share/themes/Gorilla/xfwm4/README /usr/share/themes/Koynacity/xfwm4/README /usr/share/themes/Gelly/xfwm4/README /usr/share/themes/Basix/xfwm4/README /usr/share/themes/Triviality/xfwm4/README [...] /usr/share/emacs/25.2/lisp/international/README /usr/share/emacs/25.2/lisp/README /usr/share/emacs/25.2/lisp/term/README /usr/share/emacs/25.2/etc/forms/README /usr/share/emacs/25.2/etc/README /usr/share/emacs/25.2/etc/nxml/README /usr/share/emacs/25.2/etc/schema/README /usr/share/emacs/25.2/etc/org/README /usr/share/emacs/25.2/etc/e/README /usr/share/emacs/25.2/etc/charsets/README /usr/share/emacs/25.2/etc/refcards/README /usr/share/emacs/25.2/etc/images/README /usr/share/emacs/25.2/etc/images/low-color/README /usr/share/emacs/25.2/etc/images/gnus/README /usr/share/emacs/25.2/etc/images/tree-widget/default/README /usr/share/emacs/25.2/etc/images/tree-widget/folder/README /usr/share/emacs/25.2/etc/images/icons/README /usr/share/emacs/25.2/etc/images/mail/README /usr/share/emacs/25.2/etc/images/gud/README /usr/share/emacs/25.2/etc/images/newsticker/README /usr/share/emacs/25.2/etc/images/mpc/README /usr/share/emacs/25.2/etc/images/smilies/README /usr/share/emacs/25.2/etc/images/smilies/grayscale/README /usr/share/emacs/25.2/etc/images/smilies/medium/README /usr/share/emacs/25.2/etc/images/custom/README /usr/share/emacs/25.2/etc/images/ezimage/README /usr/share/inkscape/fonts/README /usr/share/inkscape/examples/README /usr/share/inkscape/filters/README /usr/share/inkscape/gradients/README /usr/share/inkscape/screens/README /usr/share/inkscape/icons/README /usr/share/inkscape/patterns/README /usr/share/inkscape/attributes/README /usr/share/inkscape/extensions/README /usr/share/inkscape/tutorials/README /usr/share/inkscape/templates/README /usr/share/inkscape/symbols/README /usr/share/inkscape/palettes/README /usr/share/inkscape/branding/README /usr/share/texlive/texmf-dist/fonts/vf/cs/cs-a35/README /usr/share/texlive/texmf-dist/fonts/source/public/semaphor/README /usr/share/texlive/texmf-dist/fonts/tfm/cs/cs-a35/README /usr/share/texlive/texmf-dist/fonts/misc/xetex/fontmapping/xetex-devanagari/README /usr/share/texlive/texmf-dist/fonts/cmap/dvipdfmx/README /usr/share/texlive/texmf-dist/fonts/map/dvips/tetex/README /usr/share/texlive/texmf-dist/fonts/type1/public/cs/README /usr/share/texlive/texmf-dist/mft/base/README /usr/share/texlive/texmf-dist/tex/fontinst/afm2pl/README /usr/share/texlive/texmf-dist/tex/plain/cyrplain/README /usr/share/texlive/texmf-dist/tex/latex/lhcyr/lhcyrkoi/README /usr/share/texlive/texmf-dist/tex/latex/lhcyr/lhcyralt/README /usr/share/texlive/texmf-dist/tex/latex/lhcyr/lhcyrwin/README /usr/share/texlive/texmf-dist/tex/generic/pst-geo/data/README /usr/share/texlive/texmf-dist/tex/generic/t2/cyrfinst/README /usr/share/texlive/texmf-dist/dvips/dvipsconfig/README /usr/share/fvwm-crystal/fvwm/decorations/Dawn of a Terminal/Red/README /usr/share/fvwm-crystal/fvwm/decorations/Dawn of a Terminal/Blue/README /usr/share/fvwm-crystal/fvwm/decorations/Dawn of a Terminal/Green/README /usr/share/fvwm-crystal/fvwm/decorations/Dawn of a Terminal/Purple/README /usr/share/fvwm-crystal/fvwm/decorations/Aqua/Blank buttons/README /usr/share/fvwm-crystal/fvwm/decorations/Aqua/Buttons with icons/README /usr/share/fvwm-crystal/fvwm/decorations/Mist/Default/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Aqua/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Pink/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Red/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Black/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Lite/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Blue/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Green/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Purple/README /usr/share/fvwm-crystal/fvwm/decorations/Ish/Orange/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/RedDesktop/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/Red - Cyan/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/IrishDesktop/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/DarkGreen/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/Original/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/CIOS-blue/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/CIOS/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/WhiteDesktop/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/CrystalZono/README /usr/share/fvwm-crystal/fvwm/decorations/Crystal/DarkDesktop/README /usr/share/fvwm-crystal/fvwm/decorations/Elberg/Default/README /usr/share/fvwm-crystal/fvwm/decorations/Amiga/Aqua/README /usr/share/fvwm-crystal/fvwm/decorations/Amiga/DarkAqua/README /usr/share/fvwm-crystal/fvwm/decorations/Amiga/AmigaOS 4/README /usr/share/fvwm-crystal/fvwm/decorations/MicroClear/Default/README /usr/share/fvwm-crystal/fvwm/decorations/Clearlooks/Default/README /usr/share/fvwm-crystal/fvwm/decorations/Clearlooks/DeepSky/README /usr/share/fvwm-crystal/fvwm/decorations/Clearlooks/Olive/README /usr/share/fvwm-crystal/fvwm/decorations/DawnSky/Default/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Red/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Blue/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Violet/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Green/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Mono/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Navy/README /usr/share/fvwm-crystal/fvwm/decorations/Clear/Orange/README /usr/share/fvwm-crystal/fvwm/decorations/Gentoo/Alternative/README /usr/share/fvwm-crystal/fvwm/decorations/Gentoo/Default/README /usr/share/fvwm-crystal/fvwm/decorations/Gentoo/Gray/README /usr/share/fvwm-crystal/fvwm/decorations/Motif/Pink Navy/README /usr/share/fvwm-crystal/fvwm/decorations/Motif/Cyan Gray/README /usr/share/fvwm-crystal/fvwm/decorations/Winter/Default/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/Default/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/Dusk/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/Crux/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/Dawn/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/SaltLake/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/Debian/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/BlueCurve/README /usr/share/fvwm-crystal/fvwm/decorations/SystemG/Geramik/README /usr/share/fvwm-crystal/fvwm/decorations/Fear/Default/README /usr/share/fvwm-crystal/fvwm/decorations/DarkSky/Black/README /usr/share/fvwm-crystal/fvwm/decorations/DarkSky/Gray/README /usr/share/games/flightgear/Input/Joysticks/ThrustMaster/Warthog/README /usr/share/games/flightgear/Aircraft/Instruments-3d/chronograph/README /usr/share/games/flightgear/Aircraft/Instruments-3d/cdu/README /usr/share/games/flightgear/Aircraft/Instruments-3d/mk-viii/README /usr/share/games/flightgear/Aircraft/Instruments-3d/mk-viii/assembly/README /usr/share/games/flightgear/Aircraft/Instruments-3d/RAF_Mk9_bubble_sextant/README /usr/share/games/flightgear/Aircraft/Instruments-3d/SCR-522C/README /usr/share/games/flightgear/Aircraft/Instruments-3d/garmin196/README /usr/share/games/flightgear/Aircraft/Instruments-3d/FG1000/README /usr/share/games/flightgear/Aircraft/Generic/README /usr/share/games/flightgear/Aircraft/Generic/Engines/README /usr/share/games/flightgear/Aircraft/c172p/dev/fdm/gerris/README /usr/share/games/flightgear/Fonts/README /usr/share/games/flightgear/Fonts/DSEG/README /usr/share/games/micropolis/manual/README etc. And if I look at https://lintian.debian.org/tags/package-contains-documentation-outside-usr-share-doc.html nearly every package I checked which is listed there with the same file name in multiple directories is is obviously a false positive of the "describes the directory" case. So please ignore at least _all_ such files which contain phrases like "this directory" and replace the phrase > Please move this files to /usr/share/doc/ or remove it. with e.g. > If this file doesn't describe the contents or purpose of the directory > it is in, please consider moving this file to /usr/share/doc/ or maybe > even removing it. If this file does describe the contents or purpose > of the directory it is in, please add a lintian override. -- System Information: Debian Release: buster/sid APT prefers unstable APT policy: (990, 'unstable'), (600, 'testing'), (500, 'unstable-debug'), (500, 'buildd-unstable'), (110, 'experimental'), (1, 'experimental-debug'), (1, 'buildd-experimental') Architecture: amd64 (x86_64) Kernel: Linux 4.17.0-1-amd64 (SMP w/8 CPU cores) Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE=C.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Init: sysvinit (via /sbin/init) LSM: AppArmor: enabled Versions of packages lintian depends on: ii binutils 2.31.1-2 ii bzip2 1.0.6-8.1 ii diffstat 1.61-1+b1 ii dpkg 1.19.0.5+b1 ii file 1:5.33-3 ii gettext 0.19.8.1-6+b1 ii intltool-debian 0.35.0+20060710.4 ii libapt-pkg-perl 0.1.34 ii libarchive-zip-perl 1.60-1 ii libclass-accessor-perl 0.51-1 ii libclone-perl 0.39-1 ii libdigest-sha-perl 6.02-1 ii libdpkg-perl 1.19.0.5 ii libemail-valid-perl 1.202-1 ii libfile-basedir-perl 0.08-1 ii libipc-run-perl 20180523.0-1 ii liblist-moreutils-perl 0.416-1+b3 ii libparse-debianchangelog-perl 1.2.0-12 ii libtext-levenshtein-perl 0.13-1 ii libtimedate-perl 2.3000-2 ii liburi-perl 1.74-1 ii libxml-simple-perl 2.25-1 ii libyaml-libyaml-perl 0.72+repack-1 ii man-db 2.8.4-1 ii patchutils 0.3.4-2 ii perl [libdigest-sha-perl] 5.26.2-6 ii t1utils 1.41-2 ii xz-utils 5.2.2-1.3 Versions of packages lintian recommends: ii libperlio-gzip-perl 0.19-1+b4 Versions of packages lintian suggests: ii binutils-multiarch 2.31.1-2 ii dpkg-dev 1.19.0.5 ii libhtml-parser-perl 3.72-3+b2 ii libtext-template-perl 1.53-1 -- no debconf information
