summaryrefslogtreecommitdiff
path: root/Base/usr/share/man
diff options
context:
space:
mode:
authorKarol Baraniecki <karol@baraniecki.eu>2023-03-04 14:03:05 +0100
committerAndrew Kaster <andrewdkaster@gmail.com>2023-04-25 01:54:53 -0600
commit190a6650bdac4dbc23cabcbf4bbeefc8ad35b279 (patch)
treef79a47e4168713076c5eb1191be26ae3067f10eb /Base/usr/share/man
parentdab82e1531e081de4348b6ca87b4019440453faa (diff)
downloadserenity-190a6650bdac4dbc23cabcbf4bbeefc8ad35b279.zip
cal: Add the `-y` option to show the current year
Without `-y`, to show the current full year you'd have to specify which one: `cal 2023`. Adding `-y` makes it possible to see the full current year without remembering what year we are in. This option is also stolen from FreeBSD :^) Additionally, validate args: prevent passing both -3 and -y at the same time. Passing both `--three-month-mode` and `--year` to `cal` doesn't make sense. You'd either want the one or the other.
Diffstat (limited to 'Base/usr/share/man')
-rw-r--r--Base/usr/share/man/man1/cal.md3
1 files changed, 2 insertions, 1 deletions
diff --git a/Base/usr/share/man/man1/cal.md b/Base/usr/share/man/man1/cal.md
index bdfde3d356..409a4e6d54 100644
--- a/Base/usr/share/man/man1/cal.md
+++ b/Base/usr/share/man/man1/cal.md
@@ -5,7 +5,7 @@ cal - Display a calendar
## Synopsis
```**sh
-$ cal [--starting-day weekday] [--three-month-view] [[month] year]
+$ cal [--starting-day weekday] [--three-month-view] [--year] [[month] year]
```
## Description
@@ -24,6 +24,7 @@ Days, months and years are specified with numbers. Week starts at Sunday.
* `-s`, `--starting-day`: Specify which day should start the week. Accepts either short or long weekday names or indexes (0 being Sunday).
* `-3`, `--three-month-view`: Display the previous, current, and next months side-by-side.
+* `-y`, `--year`: Display an entire year by laying out months on a grid. If no year number is specified, the current year is used as a default.
## Examples