sbase/cal.1

.Dd January 18, 2015
.Dt CAL 1
.Os sbase
.Sh NAME
.Nm cal
.Nd show calendar
.Sh SYNOPSIS
.Nm
.Op Fl 1 | Fl 3 | Fl y | Fl n Ar nmonths
.Op Fl s | Fl m | Fl f Ar firstday
.Op Fl c Ar columns
.Oo Oo Ar month Oc Ar year Oc
.Sh DESCRIPTION
Print
.Ar nmonths
calendars side by side beginning with
.Ar month
and
.Ar year .
Each row of calendars contains at most
.Ar columns
calendars. The date formatting is obtained using
.Xr localtime 3 .
.Pp
If
.Ar year
is given without
.Ar month ,
print the whole year, unless overridden by other options.
.Pp
The Julian calendar is used until Sep 2, 1752. The Gregorian calendar is used
starting the next day on Sep 14, 1752.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl 1
Output current month. This is the default.
.It Fl 3
Output previous, current and next month.
.It Fl c Ar columns
Set number of calendars in a row. The default is 3.
.It Fl f Ar firstday
Output
.Ar firstday
(0 is Sunday, 6 is Saturday) as first day of week.
.It Fl m
Output Monday as first day of week.
.It Fl n Ar nmonths
Output in total
.Ar nmonths
starting from the current month.
.It Fl s
Output Sunday as first day of week.
.It Fl y Ar year
Output an entire
.Ar year .
.El
.Sh SEE ALSO
.Xr localtime 3
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2008
specification.
.Pp
The flags
.Op Fl 13ynsmfc
are an extension to that specification.
Update date in cal.1 2015-01-17 19:42:26 -05:00			`.Dd January 18, 2015`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 08:20:02 -05:00			`.Dt CAL 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 14:37:03 -05:00			`.Os sbase`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Sh NAME`
			`.Nm cal`
			`.Nd show calendar`
			`.Sh SYNOPSIS`
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. 2015-01-30 15:17:58 -05:00			`.Nm`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Op Fl 1 \| Fl 3 \| Fl y \| Fl n Ar nmonths`
			`.Op Fl s \| Fl m \| Fl f Ar firstday`
			`.Op Fl c Ar columns`
Fix a small error in cal(1) manpage The current implementation doesn't implement the day-variable. 2015-01-16 16:46:37 -05:00			`.Oo Oo Ar month Oc Ar year Oc`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Sh DESCRIPTION`
			`Print`
			`.Ar nmonths`
			`calendars side by side beginning with`
			`.Ar month`
Added cal and updated Makefile Signed-off-by: Christoph Lohmann <20h@r-36.net> 2013-06-19 14:13:50 -04:00			`and`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Ar year .`
			`Each row of calendars contains at most`
			`.Ar columns`
			`calendars. The date formatting is obtained using`
			`.Xr localtime 3 .`
			`.Pp`
If only the year operand is given, cal shall produce a calendar for all twelve months in the given calendar year. 2015-01-08 14:21:37 -05:00			`If`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Ar year`
If only the year operand is given, cal shall produce a calendar for all twelve months in the given calendar year. 2015-01-08 14:21:37 -05:00			`is given without`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Ar month ,`
			`print the whole year, unless overridden by other options.`
			`.Pp`
			`The Julian calendar is used until Sep 2, 1752. The Gregorian calendar is used`
			`starting the next day on Sep 14, 1752.`
			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
Make cal(1) more readable 2015-01-17 19:40:37 -05:00			`.It Fl 1`
			`Output current month. This is the default.`
			`.It Fl 3`
			`Output previous, current and next month.`
man pages: improve consistency 2015-02-01 14:52:28 -05:00			`.It Fl c Ar columns`
			`Set number of calendars in a row. The default is 3.`
			`.It Fl f Ar firstday`
			`Output`
			`.Ar firstday`
			`(0 is Sunday, 6 is Saturday) as first day of week.`
			`.It Fl m`
			`Output Monday as first day of week.`
Make cal(1) more readable 2015-01-17 19:40:37 -05:00			`.It Fl n Ar nmonths`
			`Output in total`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.Ar nmonths`
Make cal(1) more readable 2015-01-17 19:40:37 -05:00			`starting from the current month.`
man pages: improve consistency 2015-02-01 14:52:28 -05:00			`.It Fl s`
			`Output Sunday as first day of week.`
Make cal(1) more readable 2015-01-17 19:40:37 -05:00			`.It Fl y Ar year`
			`Output an entire`
			`.Ar year .`
Add mandoc-manpage for cal(1) Grouping semi-exclusive flags makes it easier to understand what you can do. 2015-01-16 15:50:34 -05:00			`.El`
			`.Sh SEE ALSO`
			`.Xr localtime 3`
			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the`
			`.St -p1003.1-2008`
			`specification.`
			`.Pp`
			`The flags`
			`.Op Fl 13ynsmfc`
			`are an extension to that specification.`