[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#897080: Please detect long descriptions starting with lowercase to catch short descriptions continuing into long



On Sat, Apr 28, 2018 at 08:33:55AM +0100, Chris Lamb wrote:
> tags 897080 + moreinfo
> thanks
> 
> Hi Josh,
> 
> > Description: words words words. Words words
> >  words words words. Words words words.
> 
> But would this not already be caught by:
> 
> Tag: description-synopsis-might-not-be-phrased-properly
> Severity: minor
> Certainty: possible
> Info: The package synopsis (also known as the "short" description, ie. the
>  first line in the package's "Description:" field) either ends with a full
>  stop "." character or starts another sentence.
>  .
>  This is not necessary as the synopsis does not need to be a full
>  sentence.  It is recommended that a single descriptive phrase is used
>  instead.
>  .
>  Note also that the synopsis is not part of the rest of the "long"
>  Description: field.
> 
> If not, having a good corpus of "good" and "bad" examples would be the next
> step here :)

Ah, I see; lintian doesn't display "minor/possible" by default, so when
I tested it on this description it didn't say anything:

~$ apt show postgresql-10-wal2json
Package: postgresql-10-wal2json
Version: 1.0-1
Priority: optional
Section: database
Source: wal2json
Maintainer: Debian PostgreSQL Maintainers <pkg-postgresql-public@lists.alioth.debian.org>
Installed-Size: 39.9 kB
Depends: postgresql-10, libc6 (>= 2.4)
Homepage: https://github.com/eulerto/wal2json
Download-Size: 11.6 kB
APT-Sources: https://deb.debian.org/debian unstable/main amd64 Packages
Description: wal2json is an output plugin for logical decoding. It means that
 the plugin have access to tuples produced by INSERT and UPDATE. Also,
 UPDATE/DELETE old row versions can be accessed depending on the configured
 replica identity. Changes can be consumed using the streaming protocol
 (logical replication slots) or by a special SQL API.


Reply to: