Add new command ncal.

1 files changed, 117 insertions, 0 deletions

diff --git a/usr.bin/ncal/ncal.1 b/usr.bin/ncal/ncal.1
new file mode 100644
index 0000000..b970b61
--- /dev/null
+++ b/usr.bin/ncal/ncal.1
@@ -0,0 +1,117 @@
+/*-
+ * Copyright (c) 1997 Wolfgang Helbig
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ *	$Id$
+ */
+.Dd December 16, 1997
+.Dt CAL 1
+.Os
+.Sh NAME
+.Nm cal ,
+.Nm ncal
+.Nd displays a calendar and the date of easter
+.Sh SYNOPSIS
+.Nm cal
+.Op Fl jy
+.Op Oo Ar month Oc Ar \ year
+.Nm ncal
+.Op Fl jJpwy
+.Op Fl s Ar country code
+.Op Oo Ar month Oc Ar \ year
+.Nm ncal
+.Op Fl Jeo
+.Op Ar year
+.Sh DESCRIPTION
+.Nm Cal
+displays a simple calendar in traditional format and
+.Nm ncal
+offers an alternative layout, more options and the date of easter.
+The new format is a little cramped but it makes a year fit
+on a 25x80 terminal.
+If arguments are not specified,
+the current month is displayed.
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl J
+Display Julian Calendar, if combined with the
+.Fl e
+option, display date of easter according in the Julian Calendar.
+If not specified, the Gregorian Calendar is assumed after
+the switch date and Julian before. (See below)
+.It Fl e
+Display date of easter (for western churches).
+.It Fl j
+Display julian days (days one-based, numbered from January 1).
+.It Fl o
+Display date of orthodox easter (Greek and Russian
+Orthodox Churches).
+.It Fl p
+Print the country codes and switch dates from Julian to Gregorian
+Calendar as they are assumed by
+.Nm ncal .
+.It Fl s Ar country-code
+Assume the switch from Julian to Gregorian Calendar at the date
+associated with the
+.Ar country-code .
+If not specified,
+.Nm ncal
+assumes October 4, 1582 (on this day the Catholic Church switched to Gregorian
+Calendar) and
+.Nm cal
+thinks with Great Britain and her colonies that
+September 2, 1752 was the date to switch.
+.It Fl w
+Print the number of the week in the year below each week displayed.
+.It Fl y
+Display a calendar for the current year.
+.El
+.Pp
+A single parameter specifies the year (1 - 9999) to be displayed;
+note the year must be fully specified:
+.Dq Li cal 89
+will
+.Em not
+display a calendar for 1989.
+Two parameters denote the month (1 - 12) and year.
+.Pp
+A year starts on Jan 1.
+.Pp
+.Sh SEE ALSO
+.Xr calendar 3 ,
+.Xr strftime 3
+.Rs
+.Sh HISTORY
+A
+.Nm cal
+command appeared in
+.At v6 .
+The
+.Nm ncal
+command appeared in
+.Fx 3.0 .
+.Sh AUTHOR
+This
+manual page and the command was written by
+.An Wolfgang Helbig Aq helbig@FreeBSD.ORG .