Package: at Version: 3.1.20-5 Severity: minor Tags: patch Dear Maintainer,
* What led up to the situation? warnings from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z <at.1>:54 (macro BR): only 1 argument, but more are expected <at.1>:57 (macro BR): only 1 argument, but more are expected <at.1>:62 (macro BR): only 1 argument, but more are expected <at.1>:65 (macro BR): only 1 argument, but more are expected /home/bg/git/groff/build/../tmac/an-old.tmac:382: backtrace: macro 'B' troff: <at.1>:105: warning: escape character ignored before '+' <at.1>:156 (macro BR): only 1 argument, but more are expected <at.1>:198 (macro BR): only 1 argument, but more are expected <at.1>:219 (macro BR): only 1 argument, but more are expected The patch is in the attachment ### Summary of changes: Change ".BR <one argument>" to ".B ..." An item is not repeated in a "[...]", as the brackets indicate a possible repetition of the already named item. "...": consult a style guide concerning space or not in front of it. Change ".RI [ job... ]" to "[...\&]" (\& is for protection of an end of sentence character) Change '-' to '\-' if used before an option name. Shorten a line longer than 80 character. Add a comma in front of "or". #### DETAILS: Input file is at.1 Test nr. 2: Enable and fix warnings from 'test-groff'. Input file is /tmp/at.1 <at.1>:54 (macro BR): only 1 argument, but more are expected <at.1>:57 (macro BR): only 1 argument, but more are expected <at.1>:62 (macro BR): only 1 argument, but more are expected <at.1>:65 (macro BR): only 1 argument, but more are expected /home/bg/git/groff/build/../tmac/an-old.tmac:382: backtrace: macro 'B' troff: <at.1>:105: warning: escape character ignored before '+' <at.1>:156 (macro BR): only 1 argument, but more are expected <at.1>:198 (macro BR): only 1 argument, but more are expected <at.1>:219 (macro BR): only 1 argument, but more are expected chk_manuals: Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z and Test nr. 15: Change the name of a macro for two fonts (e.g., BR and IR) to one letter, if there is only one argument. Add the second argument if needed. It is sometimes part of the first one. 54:.BR at 57:.BR atq 62:.BR atrm 65:.BR batch 156:.BR at 198:.BR z 219:.BR atq ##### Test nr. 8: Protect a full stop (.) with "\&", if it has a blank (white-space) in front of or (ignoring characters transparent to it) after it, and it does not mean an end of a sentence. 26:.RI [ job... ] 36:.RI [ job... ] 41:.RI [ job... ] ##### Test nr. 24: Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 6:.RB [ -V ] 7:.RB [ -q 9:.RB [ -f 11:.RB [ -mMlv ] 15:.RB [ -V ] 16:.RB [ -q 18:.RB [ -f 20:.RB [ -mMkv ] 21:.RB [ -t 24:.B "at -c" 29:.RB [ -V ] 30:.RB [ -q 34:.RB [ -rd ] 39:.RB [ -V ] 45:.B "at -b" 141:.B -f 189:.B -V ##### Test nr. 27: Split lines longer than 80 characters into two or more lines. Appropriate break points are the end of a sentence and a subordinate clause. at.1: line 66 length 87 ##### Test nr. 40: Add a comma before "and", "or", or "nor" if a series contains three or more words 3:at, batch, atq, atrm \- queue, examine or delete jobs for later execution ##### -- System Information: Debian Release: buster/sid APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 4.9.88-1 (SMP w/2 CPU cores) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/dash Init: sysvinit (via /sbin/init) Versions of packages at depends on: ii libc6 2.27-3 ii libfl2 2.6.4-6.1 ii libpam-runtime 1.1.8-3.7 ii libpam0g 1.1.8-3.7 ii libselinux1 2.7-2+b2 ii lsb-base 9.20170808 Versions of packages at recommends: ii exim4-daemon-light [mail-transport-agent] 4.91-3 at suggests no packages. -- Configuration Files: /etc/at.deny [Errno 13] Permission denied: '/etc/at.deny' -- no debconf information -- Bjarni I. Gislason
--- at.1 2018-04-22 17:43:25.000000000 +0000 +++ at.1.new 2018-05-03 15:28:50.000000000 +0000 @@ -1,48 +1,48 @@ .TH AT 1 2009-11-14 .SH NAME -at, batch, atq, atrm \- queue, examine or delete jobs for later execution +at, batch, atq, atrm \- queue, examine, or delete jobs for later execution .SH SYNOPSIS .B at -.RB [ -V ] -.RB [ -q +.RB [ \-V ] +.RB [ \-q .IR queue ] -.RB [ -f +.RB [ \-f .IR file ] -.RB [ -mMlv ] -.IR timespec ... +.RB [ \-mMlv ] +.IR timespec " ...\&" .br .B at -.RB [ -V ] -.RB [ -q +.RB [ \-V ] +.RB [ \-q .IR queue ] -.RB [ -f +.RB [ \-f .IR file ] -.RB [ -mMkv ] -.RB [ -t +.RB [ \-mMkv ] +.RB [ \-t .IR time ] .br -.B "at -c" +.B "at \-c" .I job -.RI [ job... ] +[...\&] .br .B atq -.RB [ -V ] -.RB [ -q +.RB [ \-V ] +.RB [ \-q .IR queue ] .br .B at -.RB [ -rd ] +.RB [ \-rd ] .I job -.RI [ job... ] +[...\&] .br .B atrm -.RB [ -V ] +.RB [ \-V ] .I job -.RI [ job... ] +[...\&] .br .B batch .br -.B "at -b" +.B "at \-b" .SH DESCRIPTION .B at and @@ -51,20 +51,21 @@ read commands from standard input or a s be executed at a later time, using .BR /bin/sh . .TP 8 -.BR at +.B at executes commands at a specified time. .TP 8 -.BR atq +.B atq lists the user's pending jobs, unless the user is the superuser; in that case, everybody's jobs are listed. The format of the output lines (one for each job) is: Job number, date, hour, queue, and username. .TP 8 -.BR atrm +.B atrm deletes jobs, identified by their job number. .TP 8 -.BR batch -executes commands when system load levels permit; in other words, when the load average -drops below 1.5, or the value specified in the invocation of +.B batch +executes commands when system load levels permit; in other words, +when the load average drops below 1.5, or the value specified in the +invocation of .BR atd . .PP .B At @@ -102,7 +103,7 @@ The specification of a date follow the specification of the time of day. You can also give times like .B now -.B \+ +.B + .I count .I time-units, where the time-units can be @@ -138,7 +139,7 @@ For both .BR at " and " batch , commands are read from standard input or the file specified with the -.B -f +.B \-f option and executed. The working directory, the environment (except for the variables .BR BASH_VERSINFO , @@ -153,8 +154,8 @@ and and the umask are retained from the time of invocation. As -.BR at -is currently implemented as a setuid program, other environment variables (e.g. +.B at +is currently implemented as a setuid program, other environment variables (e.g., .BR LD_LIBRARY_PATH " or " LD_PRELOAD ) are also not exported. This may change in the future. As a workaround, set these variables explicitly in your job. @@ -164,7 +165,7 @@ An or .BR "batch "\- command invoked from a -.B su(1) +.BR su (1) shell will retain the current userid. The user will be mailed standard error and standard output from his commands, if any. @@ -173,7 +174,7 @@ Mail will be sent using the command If .B at is executed from a -.B su(1) +.BR su (1) shell, the owner of the login shell will receive the mail. .PP The superuser may use these commands in any case. @@ -186,7 +187,7 @@ See for details. .SH OPTIONS .TP 8 -.B -V +.B \-V prints the version number to standard error and exit successfully. .TP 8 .BI \-q " queue" @@ -195,7 +196,7 @@ A queue designation consists of a single range from .B a to -.BR z +.B z and .B A to @@ -216,7 +217,7 @@ job is treated as if it were submitted t Once the time is reached, the batch processing rules with respect to load average apply. If -.BR atq +.B atq is given a specific queue, it will only show jobs pending in that queue. .TP 8 .B \-m