sbase/cal.1

.Dd March 27, 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 num
.Op Fl s | Fl m | Fl f Ar num
.Op Fl c Ar num
.Oo Oo Ar month Oc Ar year Oc
.Sh DESCRIPTION
.Nm
writes a calendar of
.Ar month
and
.Ar year
or the current month to stdout.
If
.Ar year
is given without
.Ar month ,
.Nm
writes a 3-column calendar of the whole
year to stdout.
The date formatting is according to
.Xr localtime 3 .
.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
Print current month. This is the default.
.It Fl 3
Print previous, current and next month.
.It Fl c Ar num
Print
.Ar num
calendars in a row. The default is 3.
.It Fl f Ar num
Set
.Ar num
(0 is Sunday, 6 is Saturday) as first day of week.
.It Fl m
Set Monday as first day of week.
.It Fl n Ar num
Output
.Ar num
months starting from and including the current month.
.It Fl s
Set Sunday as first day of week.
.It Fl y
Print the entire
.Ar year
or current year.
.El
.Sh SEE ALSO
.Xr localtime 3
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The flags
.Op Fl 13cfmnsy
are an extension to that specification.
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 12:22:48 -04:00			`.Dd March 27, 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`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`.Op Fl 1 \| Fl 3 \| Fl y \| Fl n Ar num`
			`.Op Fl s \| Fl m \| Fl f Ar num`
			`.Op Fl c Ar num`
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`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`.Nm`
			`writes a calendar of`
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`
Added cal and updated Makefile Signed-off-by: Christoph Lohmann <20h@r-36.net> 2013-06-19 14:13:50 -04:00			`and`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`.Ar year`
			`or the current month to stdout.`
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 ,`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`.Nm`
			`writes a 3-column calendar of the whole`
			`year to stdout.`
			`The date formatting is according to`
			`.Xr localtime 3 .`
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			`.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`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`Print current month. This is the default.`
Make cal(1) more readable 2015-01-17 19:40:37 -05:00			`.It Fl 3`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`Print previous, current and next month.`
			`.It Fl c Ar num`
			`Print`
			`.Ar num`
			`calendars in a row. The default is 3.`
			`.It Fl f Ar num`
			`Set`
			`.Ar num`
man pages: improve consistency 2015-02-01 14:52:28 -05:00			`(0 is Sunday, 6 is Saturday) as first day of week.`
			`.It Fl m`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`Set Monday as first day of week.`
			`.It Fl n Ar num`
			`Output`
			`.Ar num`
			`months starting from and including the current month.`
man pages: improve consistency 2015-02-01 14:52:28 -05:00			`.It Fl s`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`Set Sunday as first day of week.`
			`.It Fl y`
			`Print the entire`
			`.Ar year`
			`or current 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`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 12:22:48 -04:00			`.St -p1003.1-2013`
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			`specification.`
			`.Pp`
			`The flags`
Audit cal(1) 1) Update manpage with the num-syntax. 2) Use size_t for years and derivatives. 3) Use putchar instead of printf wherever possible. 4) Update usage(). 5) Style changes. 2015-03-08 16:28:32 -04:00			`.Op Fl 13cfmnsy`
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			`are an extension to that specification.`