Bug#849622: lintian: unexpected description-starts-with-leading-spaces

2017-09-01 Thread Chris Lamb
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

2016-12-29 Thread Taylor Kline
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

2016-12-28 Thread Niels Thykier
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

2016-12-28 Thread Taylor Kline
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