Bug#823898: libconfig-model-systemd-perl: Minor error in package description (a spurious "OK"?)
Dominique Dumont
dod at debian.org
Tue May 10 19:02:39 UTC 2016
On Tue, 10 May 2016 15:49:06 +0100 Justin B Rye <justin.byam.rye at gmail.com>
wrote:
> 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
ok. I also have to fix upstream.
> # 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.
Good point. Fixed.
> 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.
I'd rather keep the 2 explanations which answer 2 different questions.
The first question is, why should a user install this package ? I hope that the
first explanation answers that in the simplest possible way.
Then other user may wonder what is the content of this package, I.e. how does
it compare to libconfig-model-perl. Hence the 2nd explanation.
I've also forgotten to add a recommend field for cme and libconfig-model-tkui-
perl. Without these packages, libconfig-model-systemd-perl is pretty useless.
Thanks for the suggestions
All the best
--
https://github.com/dod38fr/ -o- http://search.cpan.org/~ddumont/
http://ddumont.wordpress.com/ -o- irc: dod at irc.debian.org
More information about the pkg-perl-maintainers
mailing list