[BACK]Return to calendar.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / calendar

Diff for /src/usr.bin/calendar/calendar.1 between version 1.9 and 1.43

version 1.9, 1998/12/13 07:31:07 version 1.43, 2018/06/03 06:50:35
Line 11 
Line 11 
 .\" 2. Redistributions in binary form must reproduce the above copyright  .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the  .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.  .\"    documentation and/or other materials provided with the distribution.
 .\" 3. All advertising materials mentioning features or use of this software  .\" 3. Neither the name of the University nor the names of its contributors
 .\"    must display the following acknowledgement:  
 .\"     This product includes software developed by the University of  
 .\"     California, Berkeley and its contributors.  
 .\" 4. Neither the name of the University nor the names of its contributors  
 .\"    may be used to endorse or promote products derived from this software  .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.  .\"    without specific prior written permission.
 .\"  .\"
Line 33 
Line 29 
 .\"  .\"
 .\"     @(#)calendar.1  8.1 (Berkeley) 6/29/93  .\"     @(#)calendar.1  8.1 (Berkeley) 6/29/93
 .\"  .\"
 .Dd June 29, 1993  .Dd $Mdocdate$
 .Dt CALENDAR 1  .Dt CALENDAR 1
 .Os  .Os
 .Sh NAME  .Sh NAME
 .Nm calendar  .Nm calendar
 .Nd reminder service  .Nd reminder service
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm  .Nm calendar
 .Op Fl a  .Op Fl abw
 .Op Fl A Ar num  .Op Fl A Ar num
 .Op Fl B Ar num  .Op Fl B Ar num
 .Op Fl t Ar [[[cc]yy][mm]]dd  
 .Op Fl f Ar calendarfile  .Op Fl f Ar calendarfile
   .Op Fl t Oo Oo Oo Ar cc Oc Ns Ar yy Oc Ns Ar mm Oc Ns Ar dd
 .Sh DESCRIPTION  .Sh DESCRIPTION
 The  The
 .Nm  .Nm
Line 57 
Line 53 
 or tomorrow's.  or tomorrow's.
 On Fridays, events on Friday through Monday are displayed.  On Fridays, events on Friday through Monday are displayed.
 .Pp  .Pp
 The following options are available:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
   .It Fl A Ar num
   Print lines from today and next
   .Ar num
   days (forward, future).
 .It Fl a  .It Fl a
 Process the  Process the
 .Dq calendar  .Dq calendar
 files of all users and mail the results  files of all users and mail the results
 to them.  to them.
 This requires super-user privileges.  This requires superuser privileges.
 .It Fl A Ar num  
 Print lines from today and next  
 .Ar num  
 days (forward, future).  
 .It Fl B Ar num  .It Fl B Ar num
 Print lines from today and previous  Print lines from today and previous
 .Ar num  .Ar num
 days (backward, past).  days (backward, past).
 .It Fl f Pa calendarfile  .It Fl b
   Enforce special date calculation mode for Cyrillic calendars.
   .It Fl f Ar calendarfile
 Use  Use
 .Pa calendarfile  .Ar calendarfile
 as the default calendar file.  as the default calendar file.
 .It Fl t Ar [[[cc]yy][mm]]dd  .It Fl t Oo Oo Oo Ar cc Oc Ns Ar yy Oc Ns Ar mm Oc Ns Ar dd
 Act like the specified value is  Act like the specified value is
 .Dq today  .Dq today
 instead of using the current date.  instead of using the current date.
   If yy is specified, but cc is not,
   a value for yy between 69 and 99 results in a cc value of 19.
   Otherwise, a cc value of 20 is used.
   .It Fl w
   Print day of the week name in front of each event.
 .El  .El
 .Pp  .Pp
 To handle calendars in your national code table you can specify  To handle calendars in your national code table you can specify
 .Dq LANG=<locale_name>  .Dq LANG=<locale_name>
 in the calendar file as early as possible. To handle national Easter  in the calendar file as early as possible.
 names in the calendars,  To handle national Easter names in the calendars,
 .Dq Easter=<national_name>  .Dq Easter=<national_name>
 (for Catholic Easter) or  (for Catholic Easter) or
 .Dq Paskha=<national_name>  .Dq Paskha=<national_name>
 (for Orthodox Easter) can be used.  (for Orthodox Easter) can be used.
 .Pp  .Pp
   The
   .Dq CALENDAR
   variable can be used to specify the style.
   Only
   .Sq Julian
   and
   .Sq Gregorian
   styles are currently supported.
   Use
   .Dq CALENDAR=
   to return to the default (Gregorian).
   .Pp
   To enforce special date calculation mode for Cyrillic calendars
   you should specify
   .Dq LANG=<local_name>
   and
   .Dq BODUN=<bodun_prefix>
   where <local_name> can be ru_RU.UTF-8, uk_UA.UTF-8 or by_BY.UTF-8.
   .Pp
 Other lines should begin with a month and day.  Other lines should begin with a month and day.
 They may be entered in almost any format, either numeric or as character  They may be entered in almost any format, either numeric or as character
 strings.  strings.
Line 138 
Line 160 
 .Pq Li /* ... */  .Pq Li /* ... */
 are ignored.  are ignored.
 .Pp  .Pp
 Some possible calendar entries (<tab> characters are highlighted by a  Some possible calendar entries
 \fB\et\fR sequence):  (a \fB\et\fR sequence denotes a <tab> character):
 .Bd -unfilled -offset indent  .Bd -unfilled -offset indent
 LANG=C  LANG=C
 Easter=Ostern  Easter=Ostern
Line 151 
Line 173 
 Jun. 15\fB\et\fRJune 15.  Jun. 15\fB\et\fRJune 15.
 15 June\fB\et\fRJune 15.  15 June\fB\et\fRJune 15.
 Thursday\fB\et\fREvery Thursday.  Thursday\fB\et\fREvery Thursday.
 June\fB\et\fREvery June 1st.  June\fB\et\fREvery June 1st.
 15 *\fB\et\fR15th of every month.  15 *\fB\et\fR15th of every month.
   
 May Sun+2\fB\et\fRsecond Sunday in May (Muttertag)  May Sun+2\fB\et\fRsecond Sunday in May (Muttertag)
 04/SunLast\fB\et\fRlast Sunday in April,  04/SunLast\fB\et\fRlast Sunday in April,
 \fB\et\fRsummer time in Europe  \fB\et\fRsummer time in Europe
 Easter\fB\et\fREaster  Easter\fB\et\fREaster
 Ostern-2\fB\et\fRGood Friday (2 days before Easter)  Ostern-2\fB\et\fRGood Friday (2 days before Easter)
 Paskha\fB\et\fROrthodox Easter  Paskha\fB\et\fROrthodox Easter
 .Ed  .Ed
 .Sh FILES  .Sh FILES
 .Bl -tag -width ~/.calendar/calendar -compact  .Bl -tag -width ~/.calendar/calendar -compact
 .It Pa calendar  .It Pa calendar
 file in current directory  File in current directory.
 .It Pa ~/.calendar  .It Pa ~/.calendar
 file in home directory (which  Directory in the user's home directory (which
 .Nm  .Nm
 .Xr chdir 1 's  changes into, if it exists).
 into if it exists)  
 .It Pa ~/.calendar/calendar  .It Pa ~/.calendar/calendar
 file to use if no calendar file exists in the current directory  File to use if no calendar file exists in the current directory.
 .It Pa ~/.calendar/nomail  .It Pa ~/.calendar/nomail
 .Nm  .Nm
 will not send mail if this file exists  will not send mail if this file exists.
   .It Pa calendar.all
   International and national calendar files.
 .It Pa calendar.birthday  .It Pa calendar.birthday
 births and deaths of famous (and not-so-famous) people  Births and deaths of famous (and not-so-famous) people.
   .It Pa calendar.canada
   Canadian holidays.
 .It Pa calendar.christian  .It Pa calendar.christian
 Christian holidays (should be updated yearly by the local system administrator  Christian holidays (should be updated yearly by the local system administrator
 so that roving holidays are set correctly for the current year)  so that roving holidays are set correctly for the current year).
 .It Pa calendar.computer  .It Pa calendar.computer
 days of special significance to computer people  Days of special significance to computer people.
   .It Pa calendar.croatian
   Croatian calendar.
   .It Pa calendar.discord
   Discordian calendar (all rites reversed).
   .It Pa calendar.fictional
   Fantasy and fiction dates (mostly LOTR).
   .It Pa calendar.french
   French calendar.
   .It Pa calendar.german
   German calendar.
 .It Pa calendar.history  .It Pa calendar.history
 everything else, mostly U.S. historical events  Miscellaneous history.
 .It Pa calendar.holiday  .It Pa calendar.holiday
 other holidays (including the not-well-known, obscure, and  Other holidays (including the not-well-known, obscure, and
 .Em really  .Em really
 obscure)  obscure).
 .It Pa calendar.judaic  .It Pa calendar.judaic
 Jewish holidays (should be updated yearly by the local system administrator  Jewish holidays (should be updated yearly by the local system administrator
 so that roving holidays are set correctly for the current year)  so that roving holidays are set correctly for the current year).
 .It Pa calendar.music  .It Pa calendar.music
 musical events, births, and deaths (strongly oriented toward rock n' roll)  Musical events, births, and deaths (strongly oriented toward rock 'n' roll).
 .It Pa calendar.usholiday  .It Pa calendar.nz
 U.S. holidays  New Zealand calendar.
 .It Pa calendar.german  .It Pa calendar.openbsd
 German calendar  .Ox
   related events.
   .It Pa calendar.pagan
   Pagan holidays, celebrations and festivals.
 .It Pa calendar.russian  .It Pa calendar.russian
 Russian calendar  Russian calendar.
   .It Pa calendar.space
   Cosmic history.
   .It Pa calendar.uk
   UK calendar.
   .It Pa calendar.ushistory
   U.S. history.
   .It Pa calendar.usholiday
   U.S. holidays.
   .It Pa calendar.world
   World wide calendar.
 .El  .El
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr at 1 ,  .Xr at 1 ,
   .Xr cal 1 ,
 .Xr cpp 1 ,  .Xr cpp 1 ,
 .Xr mail 1 ,  .Xr mail 1 ,
 .Xr cron 8  .Xr cron 8
 .Sh COMPATIBILITY  .Sh STANDARDS
 The  The
 .Nm calendar  .Nm
 program previously selected lines which had the correct date anywhere  program previously selected lines which had the correct date anywhere
 in the line.  in the line.
 This is no longer true:  the date is only recognized when it occurs  This is no longer true: the date is only recognized when it occurs
 at the beginning of a line.  at the beginning of a line.
 .Sh HISTORY  .Sh HISTORY
 A  A
Line 219 
Line 268 
 .At v7 .  .At v7 .
 .Sh BUGS  .Sh BUGS
 .Nm  .Nm
 doesn't handle Jewish holidays or moon phases.  doesn't handle all Jewish holidays or moon phases.
Legend:
Removed from v.1.9  
changed lines
  Added in v.1.43