cal: improve util-linux page and split POSIX, osx and *BSD (#12172)

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>
Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

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}}`

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`

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`

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}}`

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`