summaryrefslogtreecommitdiffstats
path: root/misc-utils/cal.1
Commit message (Collapse)AuthorAgeFilesLines
* man: Use the correct macro for a font change of one argumentBjarni Ingi Gislason2018-05-231-1/+1
| | | | | | | | Use the correct macro (I, B) for the font change of one argument, not those that are used for alternating two fonts, like "BR", "IR", "RB", or "RI". Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
* cal: clean up man page synopsis syntaxKarel Zak2018-02-071-1/+1
| | | | | | | | | Let's use '[ ]' rather than '< >' to be compatible with our another man pages. Note that all time addressing on cal(1) command line is optional. Addresses: https://bugzilla.redhat.com/show_bug.cgi?id=1542883 Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: fix first week calculationJ William Piggott2018-01-221-6/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | Commit efafeaf set 1 Jan as week 1, but the change was missed in week_to_day() and in the man page. Before cal --week=40 --iso 1752 October 1752 Su Mo Tu We Th Fr Sa 41 1 2 3 4 5 6 7 42 8 9 10 11 12 13 14 43 15 16 17 18 19 20 21 44 22 23 24 25 26 27 28 45 29 30 31 Patched cal --week=40 --iso 1752 September 1752 Su Mo Tu We Th Fr Sa 36 1 2 37 3 4 5 6 7 8 9 38 10 11 12 13 14 15 16 39 17 18 19 20 21 22 23 40 24 25 26 27 28 29 30 Signed-off-by: J William Piggott <elseifthen@gmx.com>
* cal: update man pageJ William Piggott2018-01-161-9/+74
| | | | | | | | | | Update cal.1 with the new options --reform and --iso. Also add information about the calendar systems used and the difference between the --julian option and the Julian calendar system. Signed-off-by: J William Piggott <elseifthen@gmx.com>
* docs: replace FTP by HTTPS in kernel.org URLsSébastien Helleu2016-12-191-1/+1
| | | | | | | The links to ftp://ftp.kernel.org/ are replaced by https://www.kernel.org/. Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: support abbreviated month namesKarel Zak2016-10-071-3/+3
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: support alone month name parameterKarel Zak2016-10-071-5/+8
| | | | | | For example 'cal August' to print August for the current year. Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: cleanup man pageKarel Zak2016-10-071-20/+22
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: support timestampsKarel Zak2016-05-311-0/+17
| | | | | | | | For example $ cal '2 weeks ago' Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: allow to specify month by nameKarel Zak2016-05-311-0/+3
| | | | | | | | For example: $ cal August 2016 Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: miscellaneous tiny tweaks of man pagesBenno Schulenberg2016-03-171-2/+2
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* cal: Add --span optionDeiz2015-10-101-0/+3
| | | | | | | This allows the date spanning behaviour of -3 to be used with other month ranges. Signed-off-by: Deiz <silverwraithii@gmail.com>
* cal: correct the man page: the reformation eliminated eleven days, not tenBenno Schulenberg2015-06-251-7/+7
| | | | | | | Also tweak some other wordings and formatting. Reported-by: Felix Neumann <felix.neumann@inka.de> Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* cal: add -Y and -n <num>Max Klinger2015-04-071-0/+6
| | | | | | | | | | | [kzak@redhat.com: - add month_in_row to avoid extra meaning of num_month=-3, - add header_year - add long option for -Y - define conflicts between -Y, -y and -n - remove ctl.yflag] Co-Author: Karel Zak <kzak@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* colors: cleanup man pages, add hint to usage()Karel Zak2015-02-251-14/+7Star
| | | | | | | | cfdisk, fdisk, calm dmesg and hexdump Signed-off-by: Karel Zak <kzak@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: don't use bold or italics for "[option]" in synopsis of man pagesBenno Schulenberg2014-12-191-1/+2
| | | | | | | As per the convention shown in Documentation/howto-man-page.txt. Also make a few other tiny adjustments along the way. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* cal: `color` option documentation should match actual behaviourEugene Yunak2014-09-211-1/+1
|
* lib/colors: add info to man pages, add terminal-colors.d.5Karel Zak2014-03-111-0/+11
| | | | | Co-Author: Ondrej Oprala <ooprala@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: in man page improve grammar and wording of the reformation limitationBenno Schulenberg2014-01-071-5/+6
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* cal: in man page admit that any week has just one SundayBenno Schulenberg2014-01-061-5/+5
| | | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net> Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: mention where Gregorian reformation happen in September 1752Sami Kerola2014-01-061-6/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | In September 1752 the Gregorian reformation happen in Great Britain and Dominions (including what is now the USA). One could argue the cal(1) should consider locale when determining the reformation, but such is nearly impossible implement correctly. The dates when reformation happen are split by areas that cannot be expressed with current locales, for example the Netherlands is split to two and Germany three categories depending on where in the modern country one is. Secondly the track when reformation happen is lost for some countries, Lithuania or Japan are good examples of such. One of the worst for a programmer is Sweden. They got gradual calendar change which made Swedish calendar to be completely out of sync. Later the Swedish calendar jumped in 1753 to be in sync with everyone else. Notice that some countries, including Saudi Arabia, Ethiopia, Nepal, Iran and Afghanistan, still have not adopted the Gregorian calendar. Hence the output of the cal(1) cannot be considered to be correct for everyone. References: http://calendopedia.com/gregory.htm References: http://en.wikipedia.org/wiki/Gregorian_calendar#Gregorian_reform Reviewed-by: Benno Schulenberg <bensberg@justemail.net> Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* cal: remove optional from short arg -wTommi Kyntola2013-10-221-1/+1
| | | | | | | | | The long option --week still has the optional argument as --week=<wnum> This was suggested on the mailing list by Padraig Brady and I do agree with that. Actually, the whole idea of --week=<wnum> came from him. Signed-off-by: Tommi Kyntola <kynde@iki.fi>
* cal: added argument option for -w|--week to display that weekTommi Kyntola2013-10-221-1/+1
| | | | | | | | | Because many years have two sections of week 52 or 53, the week that this argument points to is the one that starts during that year (when available). The week number in argument is also highlighted in addition to possibly visible current/defined date highlighting. Signed-off-by: Tommi Kyntola <kynde@iki.fi>
* cal: added -w|--week for showing week numbersTommi Kyntola2013-10-221-0/+9
| | | | | | | | | | | | Added week numbers both in ISO-6801 and North America numbering. The mode is determined by first day of the week, Monday for ISO and Sunday for North America mode. ISO week numbers are defined as the first Thursday being part of week 1. The North America numbering is defined, at least by gcal, as first Sunday being in the first week. Signed-off-by: Tommi Kyntola <kynde@iki.fi>
* docs: standardize the phrases for --help and --version in all man pagesBenno Schulenberg2013-10-151-1/+1
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* cal: improve the help text and man pagePádraig Brady2013-10-111-2/+2
| | | | | | | | | | | | | | * misc-utils/cal.c: Add a little doc string, and mention that the current month is implicit if not specified. Also remove mention of "current" from two option descriptions as a specific date may have been specified. * misc-utils/cal.1: Likewise. [kzak@redhat.com: - use fputs and USAGE_SEPARATOR] Signed-off-by: Benno Schulenberg <bensberg@justemail.net> Signed-off-by: Pádraig Brady <P@draigBrady.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: cal: stop telling year 9999 is upper limitSami Kerola2013-05-261-1/+1
| | | | Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: cal: add --color option description to manual pageSami Kerola2013-05-261-0/+14
| | | | Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: uniformize the header and footer lines in man pagesBenno Schulenberg2011-08-221-3/+4
| | | | | | | | | | Use dates without the day, use the full month name, put "util-linux" in the lower left corner, and "User Commands" or "System Administration" at the top center. Also improve here and there the one-line program description. Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* cal: fix manpage formattingPetr Uzel2011-08-081-3/+2Star
| | | | Signed-off-by: Petr Uzel <petr.uzel@suse.cz>
* docs: inform about cal long optionsSami Kerola2011-06-251-47/+47
| | | | | | | | | The parameters section is now split per a parameter, which I found more readable than the previous layout. In addition the nroff syntax is changed to be closer what help2man is suggesting it should be. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* rename util-linux-ng back to util-linuxKarel Zak2010-11-301-2/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: remove unnecessary info from man pageKarel Zak2010-06-161-6/+0Star
| | | | | Addresses: https://bugzilla.redhat.com/show_bug.cgi?id=604238 Signed-off-by: Karel Zak <kzak@redhat.com>
* cal.1: formattingPeter Breitenlohner2009-08-171-1/+1
| | | | Signed-off-by: Peter Breitenlohner <peb@mppmu.mpg.de>
* cal: determine the first day of week from the localePádraig Brady2009-03-101-2/+1Star
| | | | | | | | | | | | | | | Previously it defaulted to Sunday rather than using the value from the locale. Lauri Nurmi <lanurmi@iki.fi> provided the detailed argument for this change while Samuel Thibault <samuel.thibault@ens-lyon.org> provided the information on how to read the first day of the week from the locale correctly. [kzak@redhat.com: - fix "cast from pointer to integer", nl_langinfo(_NL_TIME_WEEK_1STDAY) call)] Signed-off-by: Pádraig Brady <P@draigBrady.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* cal: add support for highlighting an arbitrary datePádraig Brady2007-10-111-1/+3
| | | | | | | | | | | | | | | | | This is done by calling cal with the extra day parameter like: cal 14 9 1752 Note the tests were updated to use the new syntax. Note also that this patch changes the -y option to always print a full year, even if a month or the -[13] options are specified. This matches the cal operation from bsdmainutils on debian and also allows one to print a full year while highlighting a particular date. Signed-off-by: Pádraig Brady <P@draigBrady.com>
* cal: add description about option -V to manpageLi Zefan2007-09-051-0/+2
| | | | | | | cal support option -V to display version information, but the manpage doesn't mention it. Signed-off-by: Li Zefan <lizf@cn.fujitsu.com>
* man pages: add "AVAILABILITY" sectionKarel Zak2007-07-031-0/+3
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* Imported from util-linux-2.11o tarball.Karel Zak2006-12-071-6/+13
|
* Imported from util-linux-2.11f tarball.Karel Zak2006-12-071-1/+1
|
* Imported from util-linux-2.10s tarball.Karel Zak2006-12-071-1/+7
|
* Imported from util-linux-2.10f tarball.Karel Zak2006-12-071-2/+3
|
* Imported from util-linux-2.9i tarball.Karel Zak2006-12-071-1/+3
|
* Imported from util-linux-2.2 tarball.Karel Zak2006-12-071-0/+81
generated by cgit v1.2.3-55-g7522 (git 2.39.0) at 2024-06-08 04:02:26 +0200