Bug#849622: lintian: unexpected description-starts-with-leading-spaces
tags 849622 + pending thanks Fixed in Git: https://anonscm.debian.org/git/lintian/lintian.git/commit/?id=d947c8318c0e8b0cd08cda1582358558d5befccb Thanks! Regards, -- ,''`. : :' : Chris Lamb `. `'` la...@debian.org / chris-lamb.co.uk `-
Bug#849622: lintian: unexpected description-starts-with-leading-spaces
Thanks, Niels, for the awesome explanation. I was able to correct my package easily with this guidance. I think a more indicative error message, if technically feasible, might be: "The package's extended description is indented with >1 leading space (line X)"
Bug#849622: lintian: unexpected description-starts-with-leading-spaces
Taylor Kline: > Package: lintian > Version: 2.5.49 > Severity: normal > > Hi, > > Although my debian/control file looks as such: > Hi Taylor, Thanks for the report. Lintian is correct, but I appreciate your confusion here. The package "description" consists of two parts * The "synopsis" - which is the very first line * The (long/extended) "description" - which is the rest Lintian often uses the terms "synopsis" and "description" (because we have separate checks for them). That said, we probably occasionally use "description" for both "synopsis" /and/ the extended description. Concretely: > ... > Suggests: nginx > Description:front-end for the rTorrent torrent client ^ That is the synopsis, which clearly has no leading spaces (NB: a single space is acceptable and useful for readability) Below is the (extended) description. The line has 3 spaces - 1 as required by the format - 2 which are a part of the description. These are the ones causing the warning. vvv >ruTorrent is a web front-end for rTorrent designed to emulate the >... > > [...] > > Thanks for your attention, > -Taylor > > [...] I hope this clarified the issue. With that out of the way. The description of the tag says: """ > N: The package "Description:" starts with leading spaces. Usually, > N: leading spaces are used to switch "verbatim display" on (i.e., lines > N: are not wrapped) so this might be a bug in the package. """ I think this could be clarified to at least refer to the extended description. Thanks, ~Niels
Bug#849622: lintian: unexpected description-starts-with-leading-spaces
Package: lintian Version: 2.5.49 Severity: normal Hi, Although my debian/control file looks as such: ... Suggests: nginx Description:front-end for the rTorrent torrent client ruTorrent is a web front-end for rTorrent designed to emulate the ... I am getting a W: rutorrent: description-starts-with-leading-spaces I don't think this makes sense as I have zero spaces between "Description:" and "front-end" Thanks for your attention, -Taylor -- System Information: Debian Release: stretch/sid APT prefers testing APT policy: (500, 'testing') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 4.8.0-2-amd64 (SMP w/4 CPU cores) Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /usr/bin/dash Init: systemd (via /run/systemd/system) Versions of packages lintian depends on: ii binutils 2.27.51.20161201-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-perl0.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-perl0.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-db2.7.6.1-2 ii patchutils0.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 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 ii dpkg-dev 1.18.18 ii libhtml-parser-perl3.72-3 pn libtext-template-perl -- no debconf information