summaryrefslogtreecommitdiffstats
path: root/misc-utils/cal.1
diff options
context:
space:
mode:
authorPádraig Brady2007-10-02 01:22:45 +0200
committerKarel Zak2007-10-11 14:19:39 +0200
commitd7a92b89944d16410c03bfc58f360f783cc435c4 (patch)
treef2be51e34688df4d0b1c5f83fb1768df6ab8f18f /misc-utils/cal.1
parenttailf: add option -n to specifying output lines (diff)
downloadkernel-qcow2-util-linux-d7a92b89944d16410c03bfc58f360f783cc435c4.tar.gz
kernel-qcow2-util-linux-d7a92b89944d16410c03bfc58f360f783cc435c4.tar.xz
kernel-qcow2-util-linux-d7a92b89944d16410c03bfc58f360f783cc435c4.zip
cal: add support for highlighting an arbitrary date
This is done by calling cal with the extra day parameter like: cal 14 9 1752 Note the tests were updated to use the new syntax. Note also that this patch changes the -y option to always print a full year, even if a month or the -[13] options are specified. This matches the cal operation from bsdmainutils on debian and also allows one to print a full year while highlighting a particular date. Signed-off-by: Pádraig Brady <P@draigBrady.com>
Diffstat (limited to 'misc-utils/cal.1')
-rw-r--r--misc-utils/cal.14
1 files changed, 3 insertions, 1 deletions
diff --git a/misc-utils/cal.1 b/misc-utils/cal.1
index 8ec44b047..53a629928 100644
--- a/misc-utils/cal.1
+++ b/misc-utils/cal.1
@@ -43,7 +43,7 @@
.Sh SYNOPSIS
.Nm cal
.Op Fl smjy13
-.Op [ Ar month ] Ar year
+.Op [ [ Ar day] Ar month ] Ar year
.Sh DESCRIPTION
.Nm Cal
displays a simple calendar.
@@ -76,6 +76,8 @@ will
.Em not
display a calendar for 1989.
Two parameters denote the month (1 - 12) and year.
+Three parameters denote the day (1-31), month and year,
+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