Package: lintian
Version: 2.5.49
Severity: normal

Dear Maintainer,
lintian has checks for binary-without-manpage tag and page
https://lintian.debian.org/tags/binary-without-manpage.html . While
this is good, it would be nice if we could also increase the
usefulness of the manpages that we have.

Many a times, the usefulness of a package remains low because the
documentation even with the manpage is not accessible to the common
user as there are no examples to get her/im understood the syntax and
how the program behaves.

This loses time and leads to more effort on both the user and the
developer to understand and would lead to less popcon scores leading
to lower adoption and lower interest to the package concerned.

It would be nicer if lintian would have such a check. Improving
documentation of a package  would not only improves usage of the
package in Debian but also the free software community as a whole.

Having packages popular, usable and stable for a long time is
something that both the project itself and users expect from Debian.

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (600, 'testing'), (500, 'unstable-debug'), (500,
'testing-debug'), (1, 'experimental-debug'), (1, 'experimental'), (1,
'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.8.0-2-amd64 (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/dash
Init: systemd (via /run/systemd/system)

Versions of packages lintian depends on:
ii  binutils                          2.27.51.20161220-1
ii  bzip2                             1.0.6-8
ii  diffstat                          1.61-1
ii  file                              1:5.29-2
ii  gettext                           0.19.8.1-1
ii  intltool-debian                   0.35.0+20060710.4
ii  libapt-pkg-perl                   0.1.30
ii  libarchive-zip-perl               1.59-1
ii  libclass-accessor-perl            0.34-1
ii  libclone-perl                     0.38-2+b1
ii  libdpkg-perl                      1.18.18
ii  libemail-valid-perl               1.202-1
ii  libfile-basedir-perl              0.07-1
ii  libipc-run-perl                   0.94-1
ii  liblist-moreutils-perl            0.416-1+b1
ii  libparse-debianchangelog-perl     1.2.0-12
ii  libperl5.24 [libdigest-sha-perl]  5.24.1~rc4-1
ii  libtext-levenshtein-perl          0.13-1
ii  libtimedate-perl                  2.3000-2
ii  liburi-perl                       1.71-1
ii  libyaml-libyaml-perl              0.63-1+b1
ii  man-db                            2.7.6.1-2
ii  patchutils                        0.3.4-2
ii  perl                              5.24.1~rc4-1
ii  t1utils                           1.39-2
ii  xz-utils                          5.2.2-1.2

Versions of packages lintian recommends:
ii  dpkg                                 1.18.18
ii  libautodie-perl                      2.29-2
ii  libperlio-gzip-perl                  0.19-1+b2
ii  perl                                 5.24.1~rc4-1
ii  perl-modules-5.24 [libautodie-perl]  5.24.1~rc4-1

Versions of packages lintian suggests:
pn  binutils-multiarch     <none>
ii  dpkg-dev               1.18.18
ii  libhtml-parser-perl    3.72-3
ii  libtext-template-perl  1.46-1

-- no debconf information

-- 
          Regards,
          Shirish Agarwal  शिरीष अग्रवाल
  My quotes in this email licensed under CC 3.0
http://creativecommons.org/licenses/by-nc/3.0/
http://flossexperiences.wordpress.com
EB80 462B 08E1 A0DE A73A  2C2F 9F3D C7A4 E1C4 D2D8

Reply via email to