midfavila/sbase
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity
039b54aa51
sbase/cal.1

73 lines
1.2 KiB
Groff
Raw Normal View History

Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
2015-10-08 11:15:08 -04:00
.Dd 2015-10-08
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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 17:37:31 -05:00
The Julian calendar is used until Sep 2, 1752.
The Gregorian calendar is used starting the next day on Sep 14, 1752.
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 OPTIONS
.Bl -tag -width Ds
Make cal(1) more readable
2015-01-17 19:40:37 -05:00
.It Fl 1
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 17:37:31 -05: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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 17:37:31 -05:00
calendars in a row.
The default is 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
.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.
Reference in New Issue Copy Permalink