summaryrefslogtreecommitdiff
path: root/Base/usr/share/man/man1/cal.md
diff options
context:
space:
mode:
authorKarol Baraniecki <karol@baraniecki.eu>2023-04-05 17:11:22 +0200
committerAndrew Kaster <andrewdkaster@gmail.com>2023-04-25 01:54:53 -0600
commitdab82e1531e081de4348b6ca87b4019440453faa (patch)
tree189930de17264f4a8fad104d9bf99ab85a80fa53 /Base/usr/share/man/man1/cal.md
parent94e14bbe659174e11bed9bb36740e3ef5c9b05ca (diff)
downloadserenity-dab82e1531e081de4348b6ca87b4019440453faa.zip
cal: Add the `-3` option
This allows to view just the previous, current, and next month simultaneously. The idea for this is shamelessly stolen from FreeBSD :^)
Diffstat (limited to 'Base/usr/share/man/man1/cal.md')
-rw-r--r--Base/usr/share/man/man1/cal.md13
1 files changed, 12 insertions, 1 deletions
diff --git a/Base/usr/share/man/man1/cal.md b/Base/usr/share/man/man1/cal.md
index 0be41ad8cc..bdfde3d356 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] [[month] year]
+$ cal [--starting-day weekday] [--three-month-view] [[month] year]
```
## Description
@@ -23,6 +23,7 @@ Days, months and years are specified with numbers. Week starts at Sunday.
## Options
* `-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.
## Examples
@@ -48,6 +49,16 @@ Su Mo Tu We Th Fr Sa
24 25 26 27 28 29 30
31
+# Display three months side-by-side
+$ cal -3 3 2023
+ February - 2023 March - 2023 April - 2023
+Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
+ 1 2 3 4 1 2 3 4 1
+ 5 6 7 8 9 10 11 5 6 7 8 9 10 11 2 3 4 5 6 7 8
+12 13 14 15 16 17 18 12 13 14 15 16 17 18 9 10 11 12 13 14 15
+19 20 21 22 23 24 25 19 20 21 22 23 24 25 16 17 18 19 20 21 22
+26 27 28 26 27 28 29 30 31 23 24 25 26 27 28 29
+
# Display an entire year
$ cal 2023
Year 2023