Your message dated Thu, 13 Jul 2023 16:18:57 +0000
with message-id <[email protected]>
and subject line Bug#1040885: fixed in anacron 2.3-38
has caused the Debian Bug report #1040885,
regarding anacron.8: some remarks and editorial fixes for the manual
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 [email protected]
immediately.)


-- 
1040885: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1040885
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: anacron
Version: 2.3-37
Severity: minor
Tags: patch

Dear Maintainer,

here are some notes and editorial fixes for the man page.

The patch is in the attachment.

-.-.

The difference between the formatted outputs can be seen with:

  nroff -man <file1> > <out1>
  nroff -man <file2> > <out2>
  diff -u <out1> <out2>

and for groff, using

"groff -man -Z" instead of "nroff -man"

  Use "less -R" or similar to read the output of "diff -u".

-.-.

Output from "mandoc -T lint anacron.8":

mandoc: anacron.8:26:38: STYLE: whitespace at end of input line
mandoc: anacron.8:64:93: STYLE: input text line longer than 80 bytes: the 
address containe...
mandoc: anacron.8:107:71: STYLE: whitespace at end of input line
mandoc: anacron.8:134:2: WARNING: skipping paragraph macro: PP after SH
mandoc: anacron.8:167:2: WARNING: skipping paragraph macro: PP after SH
mandoc: anacron.8:184:100: STYLE: input text line longer than 80 bytes: Mail 
comments, sugge...
mandoc: anacron.8:190:86: STYLE: input text line longer than 80 bytes: The code 
base was ma...
mandoc: anacron.8:191:87: STYLE: input text line longer than 80 bytes: During 
2004-2006, it...

-.-.

Change '-' (\-) to '\(en' (en-dash) for a numeric range.
GNU gnulib has recently (2023-06-18) updated its
"build_aux/update-copyright" to recognize "\(en" in man pages.

anacron.8:191:During 2004-2006, it was maintained by Pascal Hakim 
<pasc@(debian.org|redellipse.net)>.
anacron.8:192:During 2009-2014, it was maintained by Peter Eisentraut 
<[email protected]>.

-.-.

Mark a full stop (.) and the exclamation mark (!) with "\&",
if it does not mean an end of a sentence.
This is a preventive action,
the paragraph could be reshaped, e.g., after changes.

When typing, one does not always notice when the line wraps after the
period.
There are too many examples of input lines in manual pages,
that end with an abbreviation point.

This marking is robust, and independent of the position on the line.

It corresponds to "\ " in TeX, and to "@:" in Texinfo.


71:"Active" jobs (i.e. jobs that Anacron already decided

-.-.

Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.

5:.B anacron \fR[\fB-s\fR] [\fB-f\fR] [\fB-n\fR] [\fB-d\fR] [\fB-q\fR]
6:[\fB-t anacrontab\fR] [\fB-S spooldir\fR] [\fIjob\fR] ...
8:.B anacron [\fB-S spooldir\fR] -u [\fB-t anacrontab\fR] \fR[\fIjob\fR] ...
10:.B anacron \fR[\fB-V\fR|\fB-h\fR]
12:.B anacron -T [\fB-t anacrontab\fR]
54:Unless the \fB-d\fR option is given (see below), Anacron forks to the
58:Unless the \fB-s\fR or \fB-n\fR options are given, Anacron starts jobs
78:.B -f
81:.B -u
85:.B -s
89:.B -n
92:file.  This options implies \fB-s\fR.
94:.B -d
99:.B -q
100:Suppress messages to standard error.  Only applicable with \fB-d\fR.
102:.B -t anacrontab
105:.B -T
110:.B -S spooldir
114:.B -V
117:.B -h

-.-.

Add a comma (or \&) after "e.g." and "i.e.", or use English words
(man-pages(7).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.

71:"Active" jobs (i.e. jobs that Anacron already decided

-.-.

Wrong distance between sentences.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.


106:Anacrontab testing. The configuration file will be tested for validity. If
108:return 1. Valid anacrontabs will return 0.
111:Use the specified spooldir to store timestamps in. This option is required 
for
138:On activation, anacron will check if it missed some jobs. If yes, it will 
start
144:connected to the computer. It is meant to reduce power usage and extend
148:supply. Please read Debian-specific documentation in
164:This file provides systemd timer for anacron. Currently the service is
187:<[email protected]>. The current implementation is a complete rewrite 
by

-.-.

Protect a period (.) or a apostrophe (') with '\&' from becoming a
control character, if it could end up at the start of a line (by
splitting the line into more lines).

184:Mail comments, suggestions and bug reports to Sean 'Shaleh' Perry 
<shaleh@(debian.org|valinux.com)>.
190:The code base was maintained by Sean 'Shaleh' Perry 
<shaleh@(debian.org|valinux.com)>.

-.-.

SYNOPSIS: variable (replaceable) text is typeset in italic, see man-page(7).

-.-.

Spelling:

the Debian Project -> The Deb...

-.-.

Avoid a hyphenation in an email address by using '\%' in front of it.

-.-.

Output from "test-nroff -man -b -ww -z -rCHECKSTYLE=3":


[ "test-groff" is a developmental version of "groff" ]

Input file is ./anacron.8

Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z 
-rSTYLECHECK=3":
troff: backtrace: file '<stdin>':26
troff:<stdin>:26: warning: trailing space in the line
troff: backtrace: file '<stdin>':107
troff:<stdin>:107: warning: trailing space in the line

-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 6.3.7-1 (SMP w/2 CPU threads; PREEMPT)
Kernel taint flags: TAINT_WARN
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), 
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages anacron depends on:
ii  libc6                      2.37-5
ii  lsb-base                   11.6
ii  sysvinit-utils [lsb-base]  3.07-1

Versions of packages anacron recommends:
ii  cron [cron-daemon]  3.0pl1-162

Versions of packages anacron suggests:
ii  exim4-daemon-light [mail-transport-agent]  4.96-16
pn  powermgmt-base                             <none>
ii  rsyslog [system-log-daemon]                8.2306.0-1

-- no debconf information
The difference between the formatted outputs can be seen with:

  nroff -man <file1> > <out1>
  nroff -man <file2> > <out2>
  diff -u <out1> <out2>

and for groff, using

"groff -man -Z" instead of "nroff -man"

  Use "less -R" or similar to read the output from "diff -u".

-.-.

Output from "mandoc -T lint anacron.8":

mandoc: anacron.8:26:38: STYLE: whitespace at end of input line
mandoc: anacron.8:64:93: STYLE: input text line longer than 80 bytes: the 
address containe...
mandoc: anacron.8:107:71: STYLE: whitespace at end of input line
mandoc: anacron.8:134:2: WARNING: skipping paragraph macro: PP after SH
mandoc: anacron.8:167:2: WARNING: skipping paragraph macro: PP after SH
mandoc: anacron.8:184:100: STYLE: input text line longer than 80 bytes: Mail 
comments, sugge...
mandoc: anacron.8:190:86: STYLE: input text line longer than 80 bytes: The code 
base was ma...
mandoc: anacron.8:191:87: STYLE: input text line longer than 80 bytes: During 
2004-2006, it...

-.-.

Change '-' (\-) to '\(en' (en-dash) for a numeric range.
GNU gnulib has recently (2023-06-18) updated its
"build_aux/update-copyright" to recognize "\(en" in man pages.

anacron.8:191:During 2004-2006, it was maintained by Pascal Hakim 
<pasc@(debian.org|redellipse.net)>.
anacron.8:192:During 2009-2014, it was maintained by Peter Eisentraut 
<[email protected]>.

-.-.

Mark a full stop (.) and the exclamation mark (!) with "\&",
if it does not mean an end of a sentence.
This is a preventive action,
the paragraph could be reshaped, e.g., after changes.

When typing, one does not always notice when the line wraps after the
period.
There are too many examples of input lines in manual pages,
that end with an abbreviation point.

This marking is robust, and independent of the position on the line.

It corresponds to "\ " in TeX, and to "@:" in Texinfo.


71:"Active" jobs (i.e. jobs that Anacron already decided

-.-.

Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a
name for an option.

5:.B anacron \fR[\fB-s\fR] [\fB-f\fR] [\fB-n\fR] [\fB-d\fR] [\fB-q\fR]
6:[\fB-t anacrontab\fR] [\fB-S spooldir\fR] [\fIjob\fR] ...
8:.B anacron [\fB-S spooldir\fR] -u [\fB-t anacrontab\fR] \fR[\fIjob\fR] ...
10:.B anacron \fR[\fB-V\fR|\fB-h\fR]
12:.B anacron -T [\fB-t anacrontab\fR]
54:Unless the \fB-d\fR option is given (see below), Anacron forks to the
58:Unless the \fB-s\fR or \fB-n\fR options are given, Anacron starts jobs
78:.B -f
81:.B -u
85:.B -s
89:.B -n
92:file.  This options implies \fB-s\fR.
94:.B -d
99:.B -q
100:Suppress messages to standard error.  Only applicable with \fB-d\fR.
102:.B -t anacrontab
105:.B -T
110:.B -S spooldir
114:.B -V
117:.B -h

-.-.

Add a comma (or \&) after "e.g." and "i.e.", or use English words
(man-pages(7).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.

71:"Active" jobs (i.e. jobs that Anacron already decided

-.-.

Wrong distance between sentences.

  Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.


106:Anacrontab testing. The configuration file will be tested for validity. If
108:return 1. Valid anacrontabs will return 0.
111:Use the specified spooldir to store timestamps in. This option is required 
for
138:On activation, anacron will check if it missed some jobs. If yes, it will 
start
144:connected to the computer. It is meant to reduce power usage and extend
148:supply. Please read Debian-specific documentation in
164:This file provides systemd timer for anacron. Currently the service is
187:<[email protected]>. The current implementation is a complete rewrite 
by

-.-.

Protect a period (.) or a apostrophe (') with '\&' from becoming a
control character, if it could end up at the start of a line (by
splitting the line into more lines).

184:Mail comments, suggestions and bug reports to Sean 'Shaleh' Perry 
<shaleh@(debian.org|valinux.com)>.
190:The code base was maintained by Sean 'Shaleh' Perry 
<shaleh@(debian.org|valinux.com)>.

-.-.

SYNOPSIS: variable (replaceable) text is typeset in italic, see man-page(7).

-.-.

Spelling:

the Debian Project -> The Deb...

-.-.

Avoid a hyphenation in an email address by using '\%' in front of it.

-.-.

Output from "test-nroff -man -b -ww -z -rCHECKSTYLE=3":


[ "test-groff" is a developmental version of "groff" ]

Input file is ./anacron.8

Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z 
-rSTYLECHECK=3":
troff: backtrace: file '<stdin>':26
troff:<stdin>:26: warning: trailing space in the line
troff: backtrace: file '<stdin>':107
troff:<stdin>:107: warning: trailing space in the line

-.-.


--- End Message ---
--- Begin Message ---
Source: anacron
Source-Version: 2.3-38
Done: Lance Lin <[email protected]>

We believe that the bug you reported is fixed in the latest version of
anacron, 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 [email protected],
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Lance Lin <[email protected]> (supplier of updated anacron 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 [email protected])


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 1.8
Date: Thu, 13 Jul 2023 22:21:18 +0700
Source: anacron
Architecture: source
Version: 2.3-38
Distribution: unstable
Urgency: medium
Maintainer: Lance Lin <[email protected]>
Changed-By: Lance Lin <[email protected]>
Closes: 1040885 1040887
Changes:
 anacron (2.3-38) unstable; urgency=medium
 .
   * anacron.8: Editorial fixes (Closes: #1040885)
   * anacrontab.5: Editorial fixes (Closes: #1040887)
Checksums-Sha1:
 08aec1fb832988d514476f683284181797f7aacf 1803 anacron_2.3-38.dsc
 202c3b80138018ca2899f7975c4224d63396ff5f 23420 anacron_2.3-38.debian.tar.xz
 4580e85d37b40052b738815126b000cdae7aa04b 6341 anacron_2.3-38_amd64.buildinfo
Checksums-Sha256:
 b6a856cb70a2e8c677fc5c95c11406fe41c4473fb5650260eecf58ec4126779d 1803 
anacron_2.3-38.dsc
 a64aee59c569aaad72770b10627ed716fea19e080c1e7e78e2aef2b0cbe24c59 23420 
anacron_2.3-38.debian.tar.xz
 77455b7dae752ec36307a873ce06438f12fa5c60b7876ebc369fed3c2311c424 6341 
anacron_2.3-38_amd64.buildinfo
Files:
 77fb64e6ac6c2115e7cecb61c4077d68 1803 admin optional anacron_2.3-38.dsc
 108fa9e11427f86e52f87b3f0a510a47 23420 admin optional 
anacron_2.3-38.debian.tar.xz
 e4ddebe4f126911a1d7c5d5e33e58aba 6341 admin optional 
anacron_2.3-38_amd64.buildinfo

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

iQIzBAEBCgAdFiEESjHbWh7kCWyHOZiAkDZJKUwz+bcFAmSwHugACgkQkDZJKUwz
+bfxAQ//fp7zetB4vcSuCut1kQEzTIPm/XvFo+z8VfRY55yyHQezo9weaFkKLHec
aLUJ97NbpMFsRyq8Mq3qcdBtSo5/CL0DiN1CbdcvedKjxlN3l9D8WdseXdkdo7jt
sDMVQ1OkSrBD/a5tvQo7qS7wJ7JQJ2KzQvI4aZW0J4St/UHEjnSGgViXxKbS/NvZ
k6Ucz6GJqGpcelthS06b9FLOaaHHuACoqPnJhFHgxcUahCEKu8QB8z5gnSo2sEqZ
OLNd7JScPSeXDWgef4t7DHsjmGOQrswQ2w5lhWc5W3byD4UBM3+cXWnN6fZeNwW+
u9pJ8cF3OuejvXAxsO0qSyuZrHJ2sI+QeMxSPAG+a9++WRx+SVPB1Uc7j0Q15bVX
NRTnoyDxCkHw+Xdrnou54/fZU9sPDMBhs0MlBdte9dDOZ+YOBY4iEc6YWArCzzuq
DrrFwUSCc2CUgOE+MVlf/rXi+fZ7IBlBDNrGk3UbjPGS4MoRGvZIcl2Q2HbdZw3h
QwSGXUMaHzodO/Xj8ucVgnR6xMVv+Yu4VX7G3lDrCMTcocPd8PzAN+enAzOxCMUM
murY34nGpDIy48KVXzai7SH6FKWcThPapvUixh+Jx0uQcAhU2TzBfY2E3xBCqOi7
uv97oOzgj+7whaRuemV0KNX/t1b0d3nZDC1esONlhCUc25tguB0=
=jAzR
-----END PGP SIGNATURE-----

--- End Message ---

Reply via email to