doc: misc-utils/*: Fix some warnings from "mandoc -T lint"
mandoc: ./misc-utils/cal.1:214:2: WARNING: skipping paragraph macro: br after sp mandoc: ./misc-utils/cal.1:216:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/cal.1:225:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/findfs.8:36:2: WARNING: skipping paragraph macro: br after sp mandoc: ./misc-utils/findfs.8:38:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/findfs.8:41:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/findfs.8:44:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/findfs.8:48:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/logger.1:118:15: STYLE: unterminated quoted argument mandoc: ./misc-utils/logger.1:231:2: WARNING: skipping paragraph macro: IP empty mandoc: ./misc-utils/look.1:116:2: STYLE: fill mode already disabled, skipping: nf mandoc: ./misc-utils/hardlink.1:1:5: STYLE: lower case character in document title: TH hardlink mandoc: ./misc-utils/hardlink.1:1:2: WARNING: missing date, using today's date: TH mandoc: ./misc-utils/hardlink.1:9:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/hardlink.1:52:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/hardlink.1:65:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/rename.1:65:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:65:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:97:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:107:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:116:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/whereis.1:82:2: WARNING: line scope broken: IP breaks TP mandoc: ./misc-utils/whereis.1:152:2: WARNING: skipping paragraph macro: PP empty #### There is no change in the ouput of "nroff" or "groff", except for 1) a very long line in "logger.1". 2) '-' changed to '\-' for a option in "logger.1". Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
This commit is contained in:
parent
54cbc11fe3
commit
8292383df7
|
@ -211,9 +211,7 @@ numbering is used, where the first Thursday is in week number 1.
|
||||||
Implicit coloring can be disabled as follows:
|
Implicit coloring can be disabled as follows:
|
||||||
.RS
|
.RS
|
||||||
|
|
||||||
.br
|
|
||||||
.B touch /etc/terminal-colors.d/cal.disable
|
.B touch /etc/terminal-colors.d/cal.disable
|
||||||
.br
|
|
||||||
|
|
||||||
.RE
|
.RE
|
||||||
See
|
See
|
||||||
|
@ -222,7 +220,6 @@ for more details about colorization configuration.
|
||||||
.SH HISTORY
|
.SH HISTORY
|
||||||
A cal command appeared in Version 6 AT&T UNIX.
|
A cal command appeared in Version 6 AT&T UNIX.
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
.PP
|
|
||||||
The default
|
The default
|
||||||
.B cal
|
.B cal
|
||||||
output uses 3 September 1752 as the Gregorian calendar reform date. The
|
output uses 3 September 1752 as the Gregorian calendar reform date. The
|
||||||
|
|
|
@ -33,19 +33,14 @@ The complete overview about filesystems and partitions you can get for example
|
||||||
by
|
by
|
||||||
.RS
|
.RS
|
||||||
|
|
||||||
.br
|
|
||||||
.B lsblk \-\-fs
|
.B lsblk \-\-fs
|
||||||
.br
|
|
||||||
|
|
||||||
.B partx --show <disk>
|
.B partx --show <disk>
|
||||||
.br
|
|
||||||
|
|
||||||
.B blkid
|
.B blkid
|
||||||
.br
|
|
||||||
|
|
||||||
.RE
|
.RE
|
||||||
|
|
||||||
.PP
|
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
.RS
|
.RS
|
||||||
.PD 0
|
.PD 0
|
||||||
|
|
|
@ -6,7 +6,6 @@ hardlink \- Consolidate duplicate files via hardlinks
|
||||||
[options]
|
[options]
|
||||||
.RI [ directory ...]
|
.RI [ directory ...]
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.PP
|
|
||||||
This manual page documents \fBhardlink\fR, a
|
This manual page documents \fBhardlink\fR, a
|
||||||
program which consolidates duplicate files in one or more directories
|
program which consolidates duplicate files in one or more directories
|
||||||
using hardlinks.
|
using hardlinks.
|
||||||
|
@ -49,7 +48,6 @@ Display help text and exit.
|
||||||
.BR \-V , " \-\-version"
|
.BR \-V , " \-\-version"
|
||||||
Display version information and exit.
|
Display version information and exit.
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
.PP
|
|
||||||
\fBhardlink\fR assumes that its target directory trees do not change from under
|
\fBhardlink\fR assumes that its target directory trees do not change from under
|
||||||
it. If a directory tree does change, this may result in \fBhardlink\fR
|
it. If a directory tree does change, this may result in \fBhardlink\fR
|
||||||
accessing files and/or directories outside of the intended directory tree.
|
accessing files and/or directories outside of the intended directory tree.
|
||||||
|
@ -62,7 +60,6 @@ other characters. That prior behavior can be achieved by specifying
|
||||||
.br
|
.br
|
||||||
\-x '^(\\.in\\.|\\.[^.]{6}$)'
|
\-x '^(\\.in\\.|\\.[^.]{6}$)'
|
||||||
.SH AUTHORS
|
.SH AUTHORS
|
||||||
.PP
|
|
||||||
\fBhardlink\fR was written by Jakub Jelinek <jakub@redhat.com> and later modified by
|
\fBhardlink\fR was written by Jakub Jelinek <jakub@redhat.com> and later modified by
|
||||||
Ruediger Meier <ruediger.meier@ga-group.nl> and Karel Zak <kzak@redhat.com> for util-linux.
|
Ruediger Meier <ruediger.meier@ga-group.nl> and Karel Zak <kzak@redhat.com> for util-linux.
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -115,7 +115,7 @@ To include newlines in MESSAGE, specify MESSAGE several times. This is
|
||||||
handled as a special case, other fields will be stored as an array in
|
handled as a special case, other fields will be stored as an array in
|
||||||
the journal if they appear multiple times.
|
the journal if they appear multiple times.
|
||||||
.TP
|
.TP
|
||||||
.BR \-\-msgid " \fImsgid
|
.BI \-\-msgid " msgid"
|
||||||
Sets the RFC5424 MSGID field. Note that the space character is not permitted
|
Sets the RFC5424 MSGID field. Note that the space character is not permitted
|
||||||
inside of \fImsgid\fR. This option is only used if \fB\-\-rfc5424\fR is
|
inside of \fImsgid\fR. This option is only used if \fB\-\-rfc5424\fR is
|
||||||
specified as well; otherwise, it is silently ignored.
|
specified as well; otherwise, it is silently ignored.
|
||||||
|
@ -225,12 +225,13 @@ than once for the same element. Note that the quotation marks around
|
||||||
.IP
|
.IP
|
||||||
produces:
|
produces:
|
||||||
.IP
|
.IP
|
||||||
.nf
|
.\".nf
|
||||||
|
.\" this long line gets cut of in the output of "troff", and wraps
|
||||||
|
.\" in "nroff"
|
||||||
\fB <13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][zoo@123 tiger="hungry" zebra="running"][manager@123 onMeeting="yes"] this is message
|
\fB <13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][zoo@123 tiger="hungry" zebra="running"][manager@123 onMeeting="yes"] this is message
|
||||||
.fi
|
.\".fi
|
||||||
.IP
|
|
||||||
.TP
|
.TP
|
||||||
.BR \-S , " -\-size " \fIsize
|
.BR \-S , " \-\-size " \fIsize
|
||||||
Sets the maximum permitted message size to \fIsize\fR. The default
|
Sets the maximum permitted message size to \fIsize\fR. The default
|
||||||
is 1KiB characters, which is the limit traditionally used and specified
|
is 1KiB characters, which is the limit traditionally used and specified
|
||||||
in RFC 3164. With RFC 5424, this limit has become flexible. A good assumption
|
in RFC 3164. With RFC 5424, this limit has become flexible. A good assumption
|
||||||
|
|
|
@ -113,7 +113,7 @@ utility appeared in Version 7 AT&T Unix.
|
||||||
.nf
|
.nf
|
||||||
sort \-d /etc/passwd \-o /tmp/look.dict
|
sort \-d /etc/passwd \-o /tmp/look.dict
|
||||||
look \-t: root:foobar /tmp/look.dict
|
look \-t: root:foobar /tmp/look.dict
|
||||||
.nf
|
.fi
|
||||||
.RE
|
.RE
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR grep (1),
|
.BR grep (1),
|
||||||
|
|
|
@ -57,12 +57,11 @@ short) in canonical mode, where the line is buffered by the tty and you press
|
||||||
ENTER to validate the user input. If you put your tty in cbreak mode however,
|
ENTER to validate the user input. If you put your tty in cbreak mode however,
|
||||||
rename requires only a single key press to answer the prompt. To set cbreak
|
rename requires only a single key press to answer the prompt. To set cbreak
|
||||||
mode, run for example:
|
mode, run for example:
|
||||||
.RS
|
|
||||||
.PP
|
.PP
|
||||||
|
.RS
|
||||||
.nf
|
.nf
|
||||||
sh \-c 'stty \-icanon min 1; "$0" "$@"; stty icanon' rename \-i from to files
|
sh \-c 'stty \-icanon min 1; "$0" "$@"; stty icanon' rename \-i from to files
|
||||||
.fi
|
.fi
|
||||||
.PP
|
|
||||||
.RE
|
.RE
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
.RS
|
.RS
|
||||||
|
@ -88,33 +87,33 @@ unanticipated error occurred
|
||||||
Given the files
|
Given the files
|
||||||
.IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 ,
|
.IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 ,
|
||||||
the commands
|
the commands
|
||||||
.RS
|
|
||||||
.PP
|
.PP
|
||||||
|
.RS
|
||||||
.nf
|
.nf
|
||||||
rename foo foo00 foo?
|
rename foo foo00 foo?
|
||||||
rename foo foo0 foo??
|
rename foo foo0 foo??
|
||||||
.fi
|
.fi
|
||||||
.PP
|
|
||||||
.RE
|
.RE
|
||||||
|
.PP
|
||||||
will turn them into
|
will turn them into
|
||||||
.IR foo001 ", ..., " foo009 ", " foo010 ", ..., " foo278 .
|
.IR foo001 ", ..., " foo009 ", " foo010 ", ..., " foo278 .
|
||||||
And
|
And
|
||||||
.RS
|
|
||||||
.PP
|
.PP
|
||||||
|
.RS
|
||||||
.nf
|
.nf
|
||||||
rename .htm .html *.htm
|
rename .htm .html *.htm
|
||||||
.fi
|
.fi
|
||||||
.PP
|
|
||||||
.RE
|
.RE
|
||||||
|
.PP
|
||||||
will fix the extension of your html files.
|
will fix the extension of your html files.
|
||||||
Provide an empty string for shortening:
|
Provide an empty string for shortening:
|
||||||
.RS
|
|
||||||
.PP
|
.PP
|
||||||
|
.RS
|
||||||
.nf
|
.nf
|
||||||
rename '_with_long_name' '' file_with_long_name.*
|
rename '_with_long_name' '' file_with_long_name.*
|
||||||
.fi
|
.fi
|
||||||
.PP
|
|
||||||
.RE
|
.RE
|
||||||
|
.PP
|
||||||
will remove the substring in the filenames.
|
will remove the substring in the filenames.
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR mv (1)
|
.BR mv (1)
|
||||||
|
|
|
@ -79,7 +79,6 @@ searches for "ls" man pages in all default paths, but for "cal" in
|
||||||
the /usr/share/man/man1 directory only.
|
the /usr/share/man/man1 directory only.
|
||||||
|
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
.TP
|
|
||||||
.IP \fB\-b\fP
|
.IP \fB\-b\fP
|
||||||
Search for binaries.
|
Search for binaries.
|
||||||
.IP \fB\-m\fP
|
.IP \fB\-m\fP
|
||||||
|
@ -149,7 +148,6 @@ and
|
||||||
.B \-S
|
.B \-S
|
||||||
are displayed with
|
are displayed with
|
||||||
.BR \-l .
|
.BR \-l .
|
||||||
.PP
|
|
||||||
.SH ENVIRONMENT
|
.SH ENVIRONMENT
|
||||||
.IP WHEREIS_DEBUG=all
|
.IP WHEREIS_DEBUG=all
|
||||||
enables debug output.
|
enables debug output.
|
||||||
|
|
Loading…
Reference in New Issue