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"
Read the output of "diff -u" with "less -R" or similar.
-.-.
Output from "mandoc -T lint anacrontab.5":
mandoc: anacrontab.5:14:2: WARNING: skipping paragraph macro: PP empty
-.-.
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.
28:can be any shell command. The fields can be separated by blank spaces or
tabs.
31:can only be set to monthly at the present time. This will ensure jobs
-.-.
The section part for a manual page is set in roman font.
52:.B anacron(8)
-.-.
Test nr. 55:
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).
48:lines with white-space followed by a '#' followed by an arbitrary comment.
50:You can continue a line onto the next line by ending it with a '\e'.
-.-.
Name of a manual is set in bold, the section in roman.
See man-pages(7).
7:describes the jobs controlled by \fBanacron(8)\fR. Its lines can be of
-.-.
Output from "test-nroff -man -b -ww -z -rCHECKSTYLE=3":
[ "test-groff" is a developmental version of "groff" ]
Input file is ./anacrontab.5
Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z
-rSTYLECHECK=3":
an.tmac:<stdin>:13: style: 3 leading space(s) on input line
an.tmac:<stdin>:16: style: 3 leading space(s) on input line
an.tmac:<stdin>:37: style: 3 leading space(s) on input 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"
Read the output of "diff -u" with "less -R" or similar.
-.-.
Output from "mandoc -T lint anacrontab.5":
mandoc: anacrontab.5:14:2: WARNING: skipping paragraph macro: PP empty
-.-.
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.
28:can be any shell command. The fields can be separated by blank spaces or
tabs.
31:can only be set to monthly at the present time. This will ensure jobs
-.-.
The section part for a manual page is set in roman font.
52:.B anacron(8)
-.-.
Test nr. 55:
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).
48:lines with white-space followed by a '#' followed by an arbitrary comment.
50:You can continue a line onto the next line by ending it with a '\e'.
-.-.
Name of a manual is set in bold, the section in roman.
See man-pages(7).
7:describes the jobs controlled by \fBanacron(8)\fR. Its lines can be of
-.-.
Output from "test-nroff -man -b -ww -z -rCHECKSTYLE=3":
[ "test-groff" is a developmental version of "groff" ]
Input file is ./anacrontab.5
Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z
-rSTYLECHECK=3":
an.tmac:<stdin>:13: style: 3 leading space(s) on input line
an.tmac:<stdin>:16: style: 3 leading space(s) on input line
an.tmac:<stdin>:37: style: 3 leading space(s) on input line
-.-.
