Bug#823898: libconfig-model-systemd-perl: Minor error in package description (a spurious "OK"?)

[Justin B Rye]

Package: libconfig-model-systemd-perl
Followup-For: Bug #823898

> There's indeed an issue with the description. I've tried to simplify the text
> from upstream but something went wrong.

I noticed this bugreport and had a look for myself.  There are a
couple of other oddities in the description (inherited from the
upstream text):

# Description: Edit and validate Systemd configuration files

Well, for a start "systemd" is canonically lowercase.  Also, this is a
capitalised verb phrase (saying what the package does) instead of an
uncapitalised noun phrase (saying what it is); for enhanced DevRef
compliance you could make it:

 Description: editor and validator for systemd configuration files
or
 Description: systemd configuration file editor and validator
       
#  Config::Model::Systemd provides a configuration editor for the
#  configuration file of Systemd, i.e. all files in
#  ~/.config/systemd/user/ or all files in /etc/systemd/system/ Ok.
        
This appears to be saying that systemd has only one configuration
file, which consists of all the files in one of two places.

#  .
#  This was quite simplified. Actually, this module provides the
#  configuration models of Systemd configuration file that cme,
#  Config::Model and Config::Model::TkUI use to provide a configuration
#  editor and checker.
        
Upstream has "Ok. I simplified".  It seems a bit pointless to phrase
things in an oversimplified way when that just means you're going to
have to explain it twice.  If I'm correctly understanding this, why
not just say:

 Description: systemd configuration file editor and validator
  Config::Model::Systemd provides configuration models for systemd
  configuration files (that is, all files in /etc/systemd/system/ and
  ~/.config/systemd/user/). Config::Model, Config::Model::TkUI, and cme
  can use these models for configuration editing and validation.

-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pd.patch
Type: text/x-diff
Size: 1284 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-perl-maintainers/attachments/20160510/efeefbeb/attachment.patch>