ericonr
/
util-linux
mirror of https://github.com/ericonr/util-linux.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

cal: cleanup man page 

Signed-off-by: Karel Zak <kzak@redhat.com>
This commit is contained in:
Karel Zak 2016-10-07 15:44:18 +02:00
parent c49fb9cacd
commit e5927d5411
1 changed files with 22 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
misc-utils/cal.1
View File

@ -52,19 +52,6 @@ month is displayed.
.sp
The \fImonth\fR may be specified as a number (1-12) or as a month name according
to the current locales.
.sp
.B cal
accepts special placeholders when parsing \fItimestamp\fR, "now" may be used to
refer to the current time, "today", "yesterday", "tomorrow" refer to
of the current day, the day before or the next day, respectively.
.sp
The relative date specifications are also accepted, in this case "+" is
evaluated to the current time plus the specified time span. Correspondingly, a
time span that is prefixed with "-" is evaluated to the current time minus the
specified time span, for example '+2days'. Instead of prefixing the time span
with "+" or "-", it may also be suffixed with a space and the word "left" or
"ago" (for example '1 week ago').
.SH OPTIONS
.TP
\fB\-1\fR, \fB\-\-one\fR
@ -110,17 +97,32 @@ Display version information and exit.
\fB\-h\fR, \fB\-\-help\fR
Display help text and exit.
.SH PARAMETERS
A single parameter specifies the year to be displayed; note the
year must be fully specified:
.TP
\fBSingle digits-only parameter (e.g. 'cal 2020')\fR
Specifies the \fIyear\fR to be displayed; note the year must be fully specified:
.B "cal 89"
will not display a calendar for 1989.
.PP
Two parameters denote the month (1 - 12) and year.
.PP
Three parameters denote the day (1-31), month and year, and the day will be
.TP
\fBSingle string parameter (e.g. 'cal tomorrow')\fR
Specifies \fItimestamp\fR. The special placeholders are accepted when parsing timestamp, "now" may be used to
refer to the current time, "today", "yesterday", "tomorrow" refer to
of the current day, the day before or the next day, respectively.
.sp
The relative date specifications are also accepted, in this case "+" is
evaluated to the current time plus the specified time span. Correspondingly, a
time span that is prefixed with "-" is evaluated to the current time minus the
specified time span, for example '+2days'. Instead of prefixing the time span
with "+" or "-", it may also be suffixed with a space and the word "left" or
"ago" (for example '1 week ago').
.TP
\fBTwo parameters (e.g. 'cal 11 2020')\fR
Denote the \fImonth\fR (1 - 12) and \fIyear\fR.
.TP
\fBThree parameters (e.g. 'cal 25 11 2020')\fR
Denote the \fIday\fR (1-31), \fImonth and \fIyear\fR, and the day will be
highlighted if the calendar is displayed on a terminal. If no parameters are
specified, the current month's calendar is displayed.
.PP
.SH NOTES
A year starts on January 1. The first day of the week is determined by the
locale.
.PP