From b3654135a86e75ab5edbc322452c93dad7dad2c0 Mon Sep 17 00:00:00 2001
From: Waldir Pimenta <waldyrious@gmail.com>
Date: Mon, 1 May 2017 14:17:01 +0100
Subject: [PATCH] cal: adjust osx version to make it more useful, and add linux
 version along the same lines

---
 pages/linux/cal.md | 23 +++++++++++++++++++++++
 pages/osx/cal.md   | 16 ++++++++++------
 2 files changed, 33 insertions(+), 6 deletions(-)
 create mode 100644 pages/linux/cal.md

diff --git a/pages/linux/cal.md b/pages/linux/cal.md
new file mode 100644
index 0000000000..5377b31922
--- /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 de90cc23b5..c3ef698621 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}}`