Skip to content

Commit

Permalink
mdoc(7) police:
Browse files Browse the repository at this point in the history
Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.
  • Loading branch information
ru authored and ru committed Aug 7, 2001
1 parent 6b00d6a commit 4345758
Show file tree
Hide file tree
Showing 119 changed files with 652 additions and 756 deletions.
26 changes: 11 additions & 15 deletions bin/date/date.1
Original file line number Diff line number Diff line change
Expand Up @@ -160,13 +160,11 @@ The date can be adjusted as many times as required using these flags.
Flags are processed in the order given.
.Pp
When setting values
.Pq rather than adjusting them ,
(rather than adjusting them),
seconds are in the range 0-59, minutes are in the range 0-59, hours are
in the range 1-12, month days are in the range 1-31, week days are in the
range 0-6
.Pq Sun-Sat ,
months are in the range 1-12
.Pq Jan-Dec
range 0-6 (Sun-Sat),
months are in the range 1-12 (Jan-Dec)
and years are in the range 80-38 or 1980-2038.
.Pp
If
Expand All @@ -185,11 +183,11 @@ must be used to specify which part of the date is to be adjusted.
The week day or month may be specified using a name rather than a
number.
If a name is used with the plus
.Pq or minus
(or minus)
sign, the date will be put forwards
.Pq or backwards
(or backwards)
to the next
.Pq previous
(previous)
date that matches the given week day or month.
This will not adjust the date,
if the given week day or month is the same as the current one.
Expand All @@ -207,13 +205,11 @@ the clock goes back at 02:00 to 01:00, using
will be necessary to reach October 29, 2:30.
.Pp
When the date is adjusted to a specific value that doesn't actually exist
.Po
for example March 26, 1:30 BST 2000 in the Europe/London timezone
.Pc ,
(for example March 26, 1:30 BST 2000 in the Europe/London timezone),
the date will be silently adjusted forwards in units of one hour until it
reaches a valid time.
When the date is adjusted to a specific value that occurs twice
.Pq for example October 29, 1:30 2000 ,
(for example October 29, 1:30 2000),
the resulting timezone will be set so that the date matches the earlier of
the two times.
.Pp
Expand Down Expand Up @@ -242,11 +238,11 @@ The canonical representation for setting the date and time is:
.Bl -tag -width Ds -compact -offset indent
.It Ar cc
Century
.Pq either 19 or 20
(either 19 or 20)
prepended to the abbreviated year.
.It Ar yy
Year in abbreviated form
.Pq e.g. 89 for 1989, 06 for 2006 .
(e.g. 89 for 1989, 06 for 2006).
.It Ar mm
Numeric month, a number from 1 to 12.
.It Ar dd
Expand All @@ -257,7 +253,7 @@ Hour, a number from 0 to 23.
Minutes, a number from 0 to 59.
.It Ar ss
Seconds, a number from 0 to 61
.Pq 59 plus a maximum of two leap seconds .
(59 plus a maximum of two leap seconds).
.El
.Pp
Everything but the minutes is optional.
Expand Down
9 changes: 4 additions & 5 deletions bin/sh/sh.1
Original file line number Diff line number Diff line change
Expand Up @@ -191,11 +191,11 @@ Flag variables for export when assignments are made to them.
.It Fl b Li notify
Enable asynchronous notification of background job
completion.
.Pq UNIMPLEMENTED
(UNIMPLEMENTED)
.It Fl C Li noclobber
Do not overwrite existing files with
.Dq Li > .
.Pq UNIMPLEMENTED
(UNIMPLEMENTED)
.It Fl E Li emacs
Enable the builtin
.Xr emacs 1
Expand Down Expand Up @@ -265,7 +265,7 @@ sh -T -c "trap 'exit 1' 2 ; some-blocking-program"
Write a message to standard error when attempting
to expand a variable that is not set, and if the
shell is not interactive, exit immediately.
.Pq UNIMPLEMENTED
(UNIMPLEMENTED)
.It Fl V Li vi
Enable the builtin
.Xr vi 1
Expand Down Expand Up @@ -364,8 +364,7 @@ meaning of all characters except dollarsign
backquote
.Pq Li ` ,
and backslash
.Po Li \e\"
.Pc .
.Pq Li \e .
The backslash inside double quotes is historically weird.
It remains literal unless it precedes the following characters,
which it serves to quote:
Expand Down
6 changes: 2 additions & 4 deletions bin/sleep/sleep.1
Original file line number Diff line number Diff line change
Expand Up @@ -62,11 +62,9 @@ signal is not handled specially by this implementation.
The
.Nm
command will accept and honor a non-integer number of specified seconds
.Po
with a
(with a
.Ql .\&
character as a decimal point
.Pc .
character as a decimal point).
.Bf Sy
This is a non-portable extension, and its use will nearly guarantee that
a shell script will not execute properly on another system.
Expand Down
2 changes: 1 addition & 1 deletion bin/test/test.1
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ is nonzero.
True if
.Ar file
is a named pipe
.Po Tn FIFO Pc .
.Pq Tn FIFO .
.It Fl r Ar file
True if
.Ar file
Expand Down
2 changes: 1 addition & 1 deletion contrib/amd/amd/amd.8
Original file line number Diff line number Diff line change
Expand Up @@ -270,7 +270,7 @@ process as needed. This tends to improve
performance, at the cost of reserving the memory used by the
.Nm amd
process
.Pq making it unavailable for other processes .
(making it unavailable for other processes).
If this behavior is not desired, use the
.Fl S
option.
Expand Down
6 changes: 3 additions & 3 deletions contrib/amd/hlfsd/hlfsd.8
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ will re-verify the validity of the user's home directory, and
reset the cache time-counter. The default value for
.Ar cache-interval
is 300 seconds
.Pq 5 minutes .
(5 minutes).
.It Fl f
Force fast startup. This option tells
.Nm
Expand All @@ -146,7 +146,7 @@ to
.Ar group .
Programs such as
.Ic comsat ,
.Pq which access the mailboxes of other users
(which access the mailboxes of other users)
must be setgid
.Va HLFS_GID
to work properly. The default group is
Expand Down Expand Up @@ -174,7 +174,7 @@ sent to
will force it to reload the maps immediately. The default value for
.Ar reload-interval
is 900 seconds
.Pq 15 minutes .
(15 minutes).
.It Fl l Ar logfile
Specify a log file to which
.Nm
Expand Down
Loading

0 comments on commit 4345758

Please sign in to comment.