cal: improve util-linux page and split POSIX, osx and *BSD (tldr-page…

…s#12172) Co-authored-by: Juri Dispan <[email protected]> Co-authored-by: Sebastiaan Speck <[email protected]>
sebastiaanspeck · Feb 15, 2024 · 4039447 · 4039447
1 parent 0886b4c
commit 4039447
Show file tree

Hide file tree

Showing 5 changed files with 126 additions and 2 deletions.
diff --git a/pages/common/cal.md b/pages/common/cal.md
@@ -0,0 +1,16 @@
+# cal
+
+> Display a calendar with the current day highlighted.
+> More information: <https://manned.org/cal.1p>.
+
+- Display a calendar for the current month:
+
+`cal`
+
+- Display a calendar for a specific year:
+
+`cal {{year}}`
+
+- Display a calendar for a specific month and year:
+
+`cal {{month}} {{year}}`
diff --git a/pages/freebsd/cal.md b/pages/freebsd/cal.md
@@ -0,0 +1,32 @@
+# cal
+
+> Display a calendar with the current day highlighted.
+> More information: <https://man.freebsd.org/cgi/man.cgi?cal>.
+
+- Display a calendar for the current month:
+
+`cal`
+
+- Display a calendar for a specific year:
+
+`cal {{year}}`
+
+- Display a calendar for a specific month and year:
+
+`cal {{month}} {{year}}`
+
+- Display the whole calendar for the current year:
+
+`cal -y`
+
+- Don't [h]ighlight today and display [3] months spanning the date:
+
+`cal -h -3 {{month}} {{year}}`
+
+- Display the 2 months [B]efore and 3 [A]fter a specific [m]onth of the current year:
+
+`cal -A 3 -B 2 {{month}}`
+
+- Display [j]ulian days (starting from one, numbered from January 1):
+
+`cal -j`
diff --git a/pages/linux/cal.md b/pages/linux/cal.md
@@ -1,16 +1,24 @@
 # cal
 
-> Prints calendar information, with the current day highlighted.
+> Display a calendar with the current day highlighted.
 > More information: <https://manned.org/cal>.
 
 - Display a calendar for the current month:
 
 `cal`
 
-- Display previous, current and next month:
+- Display [3] months spanning the date:
 
 `cal -3`
 
+- Display the whole calendar for the current [y]ear:
+
+`cal --year`
+
+- Display the next twelve months:
+
+`cal --twelve`
+
 - Use Monday as the first day of the week:
 
 `cal --monday`

diff --git a/pages/netbsd/cal.md b/pages/netbsd/cal.md
@@ -0,0 +1,36 @@
+# cal
+
+> Display a calendar.
+> More information: <https://man.freebsd.org/cgi/man.cgi?cal>.
+
+- Display a calendar for the current month:
+
+`cal`
+
+- Display a calendar for a specific year:
+
+`cal {{year}}`
+
+- Display a calendar for a specific month and year:
+
+`cal {{month}} {{year}}`
+
+- Display the whole calendar for the current year using [j]ulian days (one-based, numbered from January 1):
+
+`cal -y -j`
+
+- [h]ighlight today and display [3] months spanning the date:
+
+`cal -h -3 {{month}} {{year}}`
+
+- Display the 2 months [B]efore and 3 [A]fter a specific [m]onth of the current year:
+
+`cal -A 3 -B 2 {{month}}`
+
+- Display a specific number of months before and after ([C]ontext) the specified month:
+
+`cal -C {{months}} {{month}}`
+
+- Specify the starting [d]ay of the week (0: Sunday, 1: Monday, ..., 6: Saturday):
+
+`cal -d {{0..6}}`
diff --git a/pages/openbsd/cal.md b/pages/openbsd/cal.md
@@ -0,0 +1,32 @@
+# cal
+
+> Display a calendar with the current day highlighted.
+> More information: <https://man.openbsd.org/cal>.
+
+- Display a calendar for the current month:
+
+`cal`
+
+- Display a calendar for a specific year:
+
+`cal {{year}}`
+
+- Display a calendar for a specific month and year:
+
+`cal {{month}} {{year}}`
+
+- Display a calendar for the current [y]ear:
+
+`cal -y`
+
+- Display [j]ulian days (starting from one, numbered from January 1):
+
+`cal -j`
+
+- Use [m]onday as week start instead of Sunday:
+
+`cal -m`
+
+- Number [w]eek numbers (incompatible with `-j`):
+
+`cal -w`