[Git][debian-gis-team/pyorbital][master] 6 commits: New upstream version 1.7.3

[Sebastiaan Couwenberg]

On 7/12/22 08:49, Antonio Valentino (@antonio.valentino) wrote:
> - - - - -
> 50573d52 by Antonio Valentino at 2022-07-12T06:45:38+00:00
> Update lintian overrides
> 
> 
> =====================================
> debian/python3-pyorbital.lintian-overrides
> =====================================
> @@ -1,3 +1,4 @@
> -application-in-library-section python usr/bin/fetch_tles
> -library-package-name-for-application usr/bin/fetch_tles
> -package-contains-documentation-outside-usr-share-doc usr/lib/python3/dist-packages/pyorbital/etc/platforms.txt
> +# helper tool for downloading data needed by the Python package
> +application-in-library-section python [usr/bin/fetch_tles]
> +library-package-name-for-application [usr/bin/fetch_tles]
> +package-contains-documentation-outside-usr-share-doc [usr/lib/python3/dist-packages/pyorbital/etc/platforms.txt]
Because there is no empty line before the
package-contains-documentation-outside-usr-share-doc override the 
comment applies to that override too.

But the comment is only appropriate for the first two overrides.

Something like the following is more appropriate:

  # helper tool for downloading data needed by the Python package
  application-in-library-section python [usr/bin/fetch_tles]
  library-package-name-for-application [usr/bin/fetch_tles]

  # False positive, not documentation
  package-contains-documentation-outside-usr-share-doc 
[usr/lib/python3/dist-packages/pyorbital/etc/platforms.txt]

See: 2.4.2 Documenting overrides in /usr/share/doc/lintian/lintian.html

"
  Comments directly above an override will be shown next to all tags it
  overrides. If an override for the same tags appears on the very next
  line, it will inherit the comment from the override above it.

  [...]

  Empty lines can be used to disassociate a comment from an override
  following it. This can also be used to make a general comment about the
  overrides that will not be displayed.
"

Kind Regards,

Bas

-- 
  GPG Key ID: 4096R/6750F10AE88D4AF1
Fingerprint: 8182 DE41 7056 408D 6146  50D1 6750 F10A E88D 4AF1