10564b1175
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
54 lines
1.1 KiB
Groff
54 lines
1.1 KiB
Groff
.TH CALENDAR 1
|
|
.SH NAME
|
|
calendar \- print upcoming events
|
|
.SH SYNOPSIS
|
|
.B calendar
|
|
[
|
|
.B \-y
|
|
]
|
|
[
|
|
.B \-p days
|
|
]
|
|
[
|
|
.I file ...
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Calendar
|
|
reads the named files, default
|
|
.BR $HOME/lib/calendar ,
|
|
and writes to standard output any lines
|
|
containing today's or tomorrow's date.
|
|
Examples of recognized date formats are
|
|
"4/11",
|
|
"April 11",
|
|
"Apr 11",
|
|
"11 April",
|
|
and
|
|
"11 Apr".
|
|
All comparisons are case insensitive.
|
|
.PP
|
|
If the
|
|
.B \-y
|
|
flag is given, an attempt is made to match on year too. In this case,
|
|
dates of the forms listed above will be accepted if they are followed
|
|
by the current year (or last two digits thereof) or not a year —
|
|
digits not followed by white space or non-digits.
|
|
.PP
|
|
If the
|
|
.B \-p
|
|
flag is given, its argument is the number of days ahead to match
|
|
dates. This flag is not repeatable, and it performs no special
|
|
processing at the end of the week.
|
|
.PP
|
|
On Friday and Saturday, events through Monday are printed.
|
|
.PP
|
|
To have your calendar mailed to you every day, use
|
|
.MR cron 8 .
|
|
.SH FILES
|
|
.TF $HOME/lib/calendar
|
|
.TP
|
|
.B $HOME/lib/calendar
|
|
personal calendar
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/calendar.c
|