Your message dated Wed, 10 Jul 2024 22:01:39 +0000
with message-id <e1srfnb-00gxaq...@fasolo.debian.org>
and subject line Bug#680611: fixed in svtools 0.6-6
has caused the Debian Bug report #680611,
regarding svtools: package description review
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact ow...@bugs.debian.org
immediately.)


-- 
680611: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=680611
Debian Bug Tracking System
Contact ow...@bugs.debian.org with problems
--- Begin Message ---
Package: svtools
Version: 0.6-2
Severity: wishlist
Tags: patch

The package description for svtools has several typos and language
errors, plus a formatting problem.

The current version is:

> Description: Utilities for daemontools and multilog

This is fine, apart from the fact that DevRef prefers an uncapitalised
first word.

>  This package provides some useful utilities to maintain supervised
>  services and to handle multilog log files:

This is okay, but I've ended up reshuffling the order slightly to
match other changes below.  While I'm editing it I've also dropped the
redundant second "to"; and I prefer to avoid "useful utilities"
because of the distracting secondary meaning of "utility" (=
"usefulness"), so I've changed that to "convenient utilities".

>  .

Now we get what ought to be a (possibly bulleted) list; unfortunately
since the paragraph isn't indented the whitespace is canonically
meaningless, and displays are allowed to reflow it, which makes a mess
of it (see e.g. http://packages.debian.org/sid/svtools).

>  svdir: Find daemontools service directory.

Since the list as a whole was introduced with a colon, I would suggest
that internally they should use dashes instead (and not be punctuated 
as sentences).

>  svinfo: Get infos about a supervised process.

Plural "infos" is a giveaway of non-native-speaker English.  There's
no need to abbreviate "information" here in the first place.

>  svinitd: init.d weapper for daemontools services.

Typo: s/weapper/wrapper/.  But notice that those first two were verb
phrases ("find foo", "get bar"), while this is a noun phrase
("wrapper").  Lists read more smoothly if they're consistent.

>  svinitd-create: Create an init.d-script for a supervices process.

Typo: s/supervices/supervised/

>  svsetup: Service setup tool for daemontools.

Verbify.

>  mlcat: cat frontend for multilog files.

Surprisingly, if you do a Google image search for "cat frontend" you
get bulldozers rather than kitten noses.  But it would be clearer to
stick to the approach of describing what it does (the fact that mlcat,
mlhead, and mltail are like cat, head, and tail should be obvious).

>  mlhead: head frontend for multilog files.
>  mltail: tail frontend for multilog files.

Why are these alphabetically sorted mlfoo utilities listed after the
alphabetically sorted svfoo utilities, anyway?  (And since I change
the order I also reshuffle the introductory text to match.)

So my suggested rephrased version is:

| Description: utilities for daemontools and multilog
|  This package provides some convenient utilities to handle multilog log
|  files and maintain supervised services:
|  .
|   mlcat - output concatenated multilog files;
|   mlhead - output the first part of multilog files;
|   mltail - output the last part of multilog files;
|   svdir - find the daemontools service directory;
|   svinfo - get information about a supervised process;
|   svinitd - wrap init.d commands for daemontools services;
|   svinitd-create - create an init.d script for a supervised process;
|   svsetup - set up a service for daemontools.

-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru svtools-0.6.pristine/debian/control svtools-0.6/debian/control
--- svtools-0.6.pristine/debian/control	2011-01-09 12:10:20.000000000 +0000
+++ svtools-0.6/debian/control	2012-07-06 23:42:31.835732173 +0100
@@ -10,15 +10,15 @@
 Architecture: all
 Depends: ${misc:Depends}, bsdmainutils
 Recommends: daemontools
-Description: Utilities for daemontools and multilog
- This package provides some useful utilities to maintain supervised
- services and to handle multilog log files:
+Description: utilities for daemontools and multilog
+ This package provides some convenient utilities to handle multilog log
+ files and maintain supervised services:
  .
- svdir: Find daemontools service directory.
- svinfo: Get infos about a supervised process.
- svinitd: init.d weapper for daemontools services.
- svinitd-create: Create an init.d-script for a supervices process.
- svsetup: Service setup tool for daemontools.
- mlcat: cat frontend for multilog files.
- mlhead: head frontend for multilog files.
- mltail: tail frontend for multilog files.
+  mlcat - output concatenated multilog files;
+  mlhead - output the first part of multilog files;
+  mltail - output the last part of multilog files;
+  svdir - find the daemontools service directory;
+  svinfo - get information about a supervised process;
+  svinitd - wrap init.d commands for daemontools services;
+  svinitd-create - create an init.d script for a supervised process;
+  svsetup - set up a service for daemontools.

--- End Message ---
--- Begin Message ---
Source: svtools
Source-Version: 0.6-6
Done: Petter Reinholdtsen <p...@debian.org>

We believe that the bug you reported is fixed in the latest version of
svtools, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 680...@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Petter Reinholdtsen <p...@debian.org> (supplier of updated svtools package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmas...@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Format: 1.8
Date: Wed, 10 Jul 2024 23:17:48 +0200
Source: svtools
Architecture: source
Version: 0.6-6
Distribution: unstable
Urgency: medium
Maintainer: Debian QA Group <packa...@qa.debian.org>
Changed-By: Petter Reinholdtsen <p...@debian.org>
Closes: 680611
Changes:
 svtools (0.6-6) unstable; urgency=medium
 .
   * QA upload.
 .
   * Added d/gbp.conf to describe branch layout.
   * Updated vcs in d/control to Salsa.
   * Updated d/gbp.conf to enforce the use of pristine-tar.
   * Updated Standards-Version from 4.5.0 to 4.7.0.
   * Use wrap-and-sort -at for debian control files.
   * Remove obsolete field Name from debian/upstream/metadata (already
     present in machine-readable debian/copyright).
   * Applied suggested improved package description (Closes: #680611).
Checksums-Sha1:
 6a4b4e30bb8fe8b41e444c96bc740ad4bb09dcc3 1855 svtools_0.6-6.dsc
 7d4a8f2614c2bffff459977a6e33631a89f7c509 4260 svtools_0.6-6.debian.tar.xz
 c9cd35dd66b958e5b602a8a7ea184022508005c1 6362 svtools_0.6-6_source.buildinfo
Checksums-Sha256:
 ef96f1307a806b1bd2d6a29a6308a085ee7d98bd178fd9870fed9217e7480bb6 1855 
svtools_0.6-6.dsc
 f465e66a3ebdef03ecd54174d4161828e17c551c75ddf6376ce6886284fe0712 4260 
svtools_0.6-6.debian.tar.xz
 9bb1028c95a6e7c77b36e811578201e524e5c6175dcaa1e022e660d3d1275f95 6362 
svtools_0.6-6_source.buildinfo
Files:
 d89e224da17017a63d76557dbb25b0b2 1855 misc optional svtools_0.6-6.dsc
 253b454ff083b1e26212fb5396b65427 4260 misc optional svtools_0.6-6.debian.tar.xz
 6753d8df2013395fe782d68b8adaf616 6362 misc optional 
svtools_0.6-6_source.buildinfo

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCAAdFiEERqLf4owIeylOb9kkgSgKoIe6+w4FAmaO+r4ACgkQgSgKoIe6
+w7AEg//ezvupgAwF5r17MD4260Rh/Soucjw3P7F1/kxgQjjz9lxvnDX5AY2M5iV
E3WjTT6e0sKYUNEZe5IQsbyefu/X5Ymi0faFQrUJfu8eRXy1qJHgMYKKuYdF+y+C
Kiy5UkaAov7PFg7MeOCjpv+gTkirmzPDGP4xGQNLpTDY4DH9tg8k0Lz2spjodqu5
efta0sabrFIICd7dmqV48gUJPmB+tQJzR2+AcuHQw9iJXJWwHLhF3Wettzd9ZhOe
BlqHXzxlIsHDQyIibkwYXV+aKndNOx+/1qHS7yjfVDSbO5hRKae7RF/3XdfQ+pL4
p5UO86Kdd0yhsXJQeBtOwRNMiGFRsoLCl0zc7Y8jJ54LJn9Z3LkrWhtErjov0oeh
fnJME1Ba/n9ahMjVUA6kLp+Y8CX94UHcBPn/0NAuyAWuH5xP48+NwektIPjoZhSo
ZFkdqT2wNm8m8TT2QTHwSxDFlJu00dRI3byYOEGAnDS4Ix/JhleQg+b87dSgjgLI
dmzWtxVSQBhGwUN3SBs77N4FQOTo3BfqhbTsb4NmF7QEl+A5Aemm1qNkw67+F09p
FjD8I4+WRtnXKj63HPsJP0WIwynSgD9SOWJyFAqlWTnSjDBqP35qYeCvb/zcD50Q
gVpdwalPQWs34BkFchydHVgc49h9X7fhjyOQxXR6zQ/g1IpbGFQ=
=FsKl
-----END PGP SIGNATURE-----

Attachment: pgppznf4fepFF.pgp
Description: PGP signature


--- End Message ---

Reply via email to