Package: systemd
Version: 255.5-1
Severity: minor
Tags: patch
Dear Maintainer,
here are some notes and editorial fixes for the manual 'loginctl.1'.
The patch is in the attachment.
-.-
The difference between the formatted outputs can be seen with:
nroff -man >
nroff -man >
diff -u
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "
instead of "nroff -man"
Add the option "-t", if the file contains a table.
Read the output of "diff -u" with "less -R" or similar.
-.-.
If "man" (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint loginctl.1": (possibly shortened list)
mandoc: loginctl.1:2:20: WARNING: missing date, using "": TH
mandoc: loginctl.1:28:2: WARNING: skipping paragraph macro: PP after SH
mandoc: loginctl.1:35:2: WARNING: skipping paragraph macro: PP after SH
mandoc: loginctl.1:38:2: WARNING: skipping paragraph macro: PP after SS
mandoc: loginctl.1:46:384: STYLE: input text line longer than 80 bytes: Show
terse runtime s...
mandoc: loginctl.1:55:235: STYLE: input text line longer than 80 bytes: Show
properties of o...
mandoc: loginctl.1:61:123: STYLE: input text line longer than 80 bytes: if
exists, and falls...
mandoc: loginctl.1:73:262: STYLE: input text line longer than 80 bytes:
Activate a session\&...
mandoc: loginctl.1:80:223: STYLE: input text line longer than 80 bytes:
Activates/deactivate...
mandoc: loginctl.1:94:215: STYLE: input text line longer than 80 bytes:
Terminates a session...
mandoc: loginctl.1:105:134: STYLE: input text line longer than 80 bytes: to
select the signal...
mandoc: loginctl.1:110:2: WARNING: skipping paragraph macro: PP after SS
mandoc: loginctl.1:118:407: STYLE: input text line longer than 80 bytes: Show
terse runtime s...
mandoc: loginctl.1:127:244: STYLE: input text line longer than 80 bytes: Show
properties of o...
mandoc: loginctl.1:139:400: STYLE: input text line longer than 80 bytes:
Enable/disable user ...
mandoc: loginctl.1:151:260: STYLE: input text line longer than 80 bytes:
Terminates all sessi...
mandoc: loginctl.1:160:147: STYLE: input text line longer than 80 bytes: to
select the signal...
mandoc: loginctl.1:165:2: WARNING: skipping paragraph macro: PP after SS
mandoc: loginctl.1:173:318: STYLE: input text line longer than 80 bytes: Show
terse runtime s...
mandoc: loginctl.1:182:244: STYLE: input text line longer than 80 bytes: Show
properties of o...
mandoc: loginctl.1:194:108: STYLE: input text line longer than 80 bytes:
Persistently attach ...
mandoc: loginctl.1:196:161: STYLE: input text line longer than 80 bytes: file
system\&. To cr...
mandoc: loginctl.1:201:105: STYLE: input text line longer than 80 bytes:
"seat"\&. To drop as...
mandoc: loginctl.1:215:147: STYLE: input text line longer than 80 bytes:
Terminates all sessi...
mandoc: loginctl.1:220:2: WARNING: skipping paragraph macro: PP after SH
mandoc: loginctl.1:230:204: STYLE: input text line longer than 80 bytes: When
showing session...
mandoc: loginctl.1:231:95: STYLE: input text line longer than 80 bytes:
"Sessions"\&. If spe...
mandoc: loginctl.1:236:95: STYLE: input text line longer than 80 bytes: When
showing session...
mandoc: loginctl.1:244:107: STYLE: input text line longer than 80 bytes: When
showing session...
mandoc: loginctl.1:260:130: STYLE: input text line longer than 80 bytes: "all",
to select whe...
mandoc: loginctl.1:280:87: STYLE: input text line longer than 80 bytes: will
list the known ...
mandoc: loginctl.1:282:103: STYLE: input text line longer than 80 bytes: will
list known valu...
mandoc: loginctl.1:309:93: STYLE: input text line longer than 80 bytes: Execute
the operatio...
mandoc: loginctl.1:310:105: STYLE: input text line longer than 80 bytes: "@",
to connect to\&...
mandoc: loginctl.1:312:184: STYLE: input text line longer than 80 bytes: "/",
which connects ...
mandoc: loginctl.1:318:147: STYLE: input text line longer than 80 bytes:
Execute operation on...
mandoc: loginctl.1:322:143: STYLE: input text line longer than 80 bytes: is
used in place of ...
mandoc: loginctl.1:327:131: STYLE: input text line longer than 80 bytes: syntax
is used eithe...
mandoc: loginctl.1:352:2: WARNING: skipping paragraph macro: PP after SH
mandoc: loginctl.1:355:2: WARNING: skipping paragraph macro: PP after SH
mandoc: loginctl.1:384:196: STYLE: input text line longer than 80 bytes: There
are two sessio...
mandoc: loginctl.1:386:2: WARNING: skipping paragraph macro: PP after SH
mandoc: loginctl.1:389:179: STYLE: input text line longer than 80 bytes: The
maximum log leve...
mandoc: loginctl.1:404:90: STYLE: input text line longer than 80 bytes: A
boolean\&. If true...
mandoc: loginctl.1:406:87: STYLE: input