| calendar.1 (141846) | calendar.1 (205821) |
|---|---|
| 1.\" Copyright (c) 1989, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)calendar.1 8.1 (Berkeley) 6/29/93 | 1.\" Copyright (c) 1989, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)calendar.1 8.1 (Berkeley) 6/29/93 |
| 33.\" $FreeBSD: head/usr.bin/calendar/calendar.1 141846 2005-02-13 22:25:33Z ru $ | 33.\" $FreeBSD: head/usr.bin/calendar/calendar.1 205821 2010-03-29 06:49:20Z edwin $ |
| 34.\" 35.Dd June 13, 2002 36.Dt CALENDAR 1 37.Os 38.Sh NAME 39.Nm calendar 40.Nd reminder service 41.Sh SYNOPSIS --- 7 unchanged lines hidden (view full) --- 49.Bk -words 50.Fl t Ar dd Ns 51.Sm off 52.Op . Ar mm Op . Ar year 53.Sm on 54.Ek 55.Oc 56.Op Fl W Ar num | 34.\" 35.Dd June 13, 2002 36.Dt CALENDAR 1 37.Os 38.Sh NAME 39.Nm calendar 40.Nd reminder service 41.Sh SYNOPSIS --- 7 unchanged lines hidden (view full) --- 49.Bk -words 50.Fl t Ar dd Ns 51.Sm off 52.Op . Ar mm Op . Ar year 53.Sm on 54.Ek 55.Oc 56.Op Fl W Ar num |
| 57.Op Fl U Ar UTC-offset 58.Op Fl l Ar longitude |
|
| 57.Sh DESCRIPTION 58The 59.Nm 60utility checks the current directory for a file named 61.Pa calendar 62and displays lines that begin with either today's date 63or tomorrow's. 64On the day before a weekend (normally Friday), events for the next --- 23 unchanged lines hidden (view full) --- 88as the default calendar file. 89.It Xo Fl t 90.Sm off 91.Ar dd 92.Op . Ar mm Op . Ar year 93.Sm on 94.Xc 95For test purposes only: set date directly to argument values. | 59.Sh DESCRIPTION 60The 61.Nm 62utility checks the current directory for a file named 63.Pa calendar 64and displays lines that begin with either today's date 65or tomorrow's. 66On the day before a weekend (normally Friday), events for the next --- 23 unchanged lines hidden (view full) --- 90as the default calendar file. 91.It Xo Fl t 92.Sm off 93.Ar dd 94.Op . Ar mm Op . Ar year 95.Sm on 96.Xc 97For test purposes only: set date directly to argument values. |
| 98.It Fl l Ar longitude , Fl U Ar UTC-offset 99Only one is needed: 100Perform lunar and solar calculations from this longitude or from 101this UTC offset. 102If neither is specified, the calculations will be based on the 103difference between UTC time and localtime. |
|
| 96.It Fl W Ar num 97Print lines from today and the next 98.Ar num 99days (forward, future). 100Ignore weekends when calculating the number of days. 101.El 102.Pp 103To handle calendars in your national code table you can specify 104.Dq LANG=<locale_name> 105in the calendar file as early as possible. | 104.It Fl W Ar num 105Print lines from today and the next 106.Ar num 107days (forward, future). 108Ignore weekends when calculating the number of days. 109.El 110.Pp 111To handle calendars in your national code table you can specify 112.Dq LANG=<locale_name> 113in the calendar file as early as possible. |
| 106To handle national Easter 107names in the calendars 108.Dq Easter=<national_name> 109(for Catholic Easter) or 110.Dq Paskha=<national_name> 111(for Orthodox Easter) can be used. | |
| 112.Pp | 114.Pp |
| 115To handle the local name of sequences, you can specify them as: 116.Dq SEQUENCE=<first> <second> <third> <fourth> <fifth> <last> 117in the calendar file as early as possible. 118.Pp 119The names of the following special days are recognized: 120.Bl -tag -width 123456789012345 -compact 121.It Easter 122Catholic Easter. 123.It Paskha 124Orthodox Easter. 125.It NewMoon 126The lunar New Moon. 127.It FullMoon 128The lunar Full Moon. 129.It MarEquinox 130The solar equinox in March. 131.It JunSolstice 132The solar solstice in June. 133.It SepEquinox 134The solar equinox in March. 135.It DecSolstice 136The solar solstice in December. 137.It ChineseNewYear 138The first day of the Chinese year. 139.El 140These names may be reassigned to their local names via an assignment 141like 142.Dq Easter=Pasen 143in the calendar file. 144.Pp |
|
| 113Other lines should begin with a month and day. 114They may be entered in almost any format, either numeric or as character 115strings. 116If the proper locale is set, national month and weekday 117names can be used. 118A single asterisk (``*'') matches every month. 119A day without a month matches that day of every week. 120A month without a day matches the first of that month. 121Two numbers default to the month followed by the day. 122Lines with leading tabs default to the last entered date, allowing 123multiple line specifications for a single date. 124.Pp | 145Other lines should begin with a month and day. 146They may be entered in almost any format, either numeric or as character 147strings. 148If the proper locale is set, national month and weekday 149names can be used. 150A single asterisk (``*'') matches every month. 151A day without a month matches that day of every week. 152A month without a day matches the first of that month. 153Two numbers default to the month followed by the day. 154Lines with leading tabs default to the last entered date, allowing 155multiple line specifications for a single date. 156.Pp |
| 125``Easter'', is Easter for this year, and may be followed by a positive 126or negative integer. | 157The names of the recognized special days may be followed by a 158positive or negative integer, like: 159.Dq Easter+3 160or 161.Dq Pashka-4 . |
| 127.Pp | 162.Pp |
| 128``Paskha'', is Orthodox Easter for this year, and may be followed by a 129positive or negative integer. 130.Pp | |
| 131Weekdays may be followed by ``-4'' ...\& ``+5'' (aliases for 132last, first, second, third, fourth) for moving events like 133``the last Monday in April''. 134.Pp 135By convention, dates followed by an asterisk are not fixed, i.e., change 136from year to year. 137.Pp 138Day descriptions start after the first <tab> character in the line; --- 47 unchanged lines hidden (view full) --- 186HOME directory. 187A chdir is done into this directory if it exists. 188.It Pa ~/.calendar/calendar 189calendar file to use if no calendar file exists in the current directory. 190.It Pa ~/.calendar/nomail 191do not send mail if this file exists. 192.El 193.Pp | 163Weekdays may be followed by ``-4'' ...\& ``+5'' (aliases for 164last, first, second, third, fourth) for moving events like 165``the last Monday in April''. 166.Pp 167By convention, dates followed by an asterisk are not fixed, i.e., change 168from year to year. 169.Pp 170Day descriptions start after the first <tab> character in the line; --- 47 unchanged lines hidden (view full) --- 218HOME directory. 219A chdir is done into this directory if it exists. 220.It Pa ~/.calendar/calendar 221calendar file to use if no calendar file exists in the current directory. 222.It Pa ~/.calendar/nomail 223do not send mail if this file exists. 224.El 225.Pp |
| 194The following default calendar files are provided: | 226The following default calendar files are provided in 227.Pa /usr/share/calendars: |
| 195.Pp 196.Bl -tag -width calendar.southafrica -compact 197.It Pa calendar.all 198File which includes all the default files. 199.It Pa calendar.australia 200Calendar of events in Australia. 201.It Pa calendar.birthday 202Births and deaths of famous (and not-so-famous) people. 203.It Pa calendar.christian 204Christian holidays. 205This calendar should be updated yearly by the local system administrator 206so that roving holidays are set correctly for the current year. 207.It Pa calendar.computer 208Days of special significance to computer people. 209.It Pa calendar.croatian 210Calendar of events in Croatia. | 228.Pp 229.Bl -tag -width calendar.southafrica -compact 230.It Pa calendar.all 231File which includes all the default files. 232.It Pa calendar.australia 233Calendar of events in Australia. 234.It Pa calendar.birthday 235Births and deaths of famous (and not-so-famous) people. 236.It Pa calendar.christian 237Christian holidays. 238This calendar should be updated yearly by the local system administrator 239so that roving holidays are set correctly for the current year. 240.It Pa calendar.computer 241Days of special significance to computer people. 242.It Pa calendar.croatian 243Calendar of events in Croatia. |
| 244.It Pa calendar.dutch 245Calendar of events in the Netherlands. |
|
| 211.It Pa calendar.freebsd 212Birthdays of 213.Fx 214committers. 215.It Pa calendar.french 216Calendar of events in France. 217.It Pa calendar.german 218Calendar of events in Germany. --- 35 unchanged lines hidden (view full) --- 254.Xr cpp 1 , 255.Xr mail 1 , 256.Xr cron 8 257.Sh HISTORY 258A 259.Nm 260command appeared in 261.At v7 . | 246.It Pa calendar.freebsd 247Birthdays of 248.Fx 249committers. 250.It Pa calendar.french 251Calendar of events in France. 252.It Pa calendar.german 253Calendar of events in Germany. --- 35 unchanged lines hidden (view full) --- 289.Xr cpp 1 , 290.Xr mail 1 , 291.Xr cron 8 292.Sh HISTORY 293A 294.Nm 295command appeared in 296.At v7 . |
| 297.Sh NOTES 298Chinese New Year is calculated at 120 degrees east of Greenwich, 299which roughly corresponds with the east coast of China. 300For people west of China, this might result that the start of Chinese 301New Year and the day of the related new moon might differ. 302.Pp 303The phases of the moon and the longitude of the sun are calculated 304against the local position which corresponds with 30 degrees times 305the time-difference towards Greenwich. 306.Pp 307The new and full moons are happening on the day indicated: They 308might happen in the time period in the early night or in the late 309evening. 310It doesn't indicate that they are starting in the night on that date. 311.Pp 312Because of minor differences between the output of the formulas 313used and other sources on the Internet, Druids and Werewolves should 314double-check the start and end time of solar and lunar events. |
|
| 262.Sh BUGS 263The 264.Nm | 315.Sh BUGS 316The 317.Nm |
| 265utility does not handle Jewish holidays and moon phases. | 318utility does not handle Jewish holidays. 319.Pp 320There is no possibility to properly specify the local position 321needed for solar and lunar calculations. |