diff --git a/pages/linux/cal.md b/pages/linux/cal.md
new file mode 100644
index 000000000..5377b3192
--- /dev/null
+++ b/pages/linux/cal.md
@@ -0,0 +1,23 @@
+# cal
+
+> Prints calendar information, with the current day highlighted.
+
+- Display a calendar for the current month:
+
+`cal`
+
+- Use monday as the first day of the week:
+
+`cal -m`
+
+- Display a calendar for the current year:
+
+`cal -y`
+
+- Display a calendar for a specific year (4 digits):
+
+`cal {{year}}`
+
+- Display a calendar for a specific month and year:
+
+`cal {{month}} {{year}}`
diff --git a/pages/osx/cal.md b/pages/osx/cal.md
index de90cc23b..c3ef69862 100644
--- a/pages/osx/cal.md
+++ b/pages/osx/cal.md
@@ -6,18 +6,22 @@
 
 `cal`
 
-- Display a calendar for a specific month:
+- Display a calendar for a specific month (1-12 or name):
 
-`cal -m {{month_number}}`
+`cal -m {{month}}`
 
-- Display a 12 month calendar for the current year:
+- Display a calendar for the current year:
 
 `cal -y`
 
-- Display a 12 month calendar for a specific year:
+- Display a calendar for a specific year (4 digits):
 
-`cal 2016`
+`cal {{year}}`
 
-- Display date of Easter (western churches):
+- Display a calendar for a specific month and year:
+
+`cal {{month}} {{year}}`
+
+- Display date of Easter (Western Christian churches) in a given year:
 
 `ncal -e {{year}}`