*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> calendar (1)              



NAME    [Toc]    [Back]

     calendar - reminder service

SYNOPSIS    [Toc]    [Back]

     calendar [-ab] [-A  num]  [-B  num]  [-f  calendarfile]  [-t

DESCRIPTION    [Toc]    [Back]

     The calendar utility checks the current directory or the directory specified
 by the CALENDAR_DIR environment  variable  for  a  file
named calendar
     and  displays  lines  that begin with either today's date or
tomorrow's.  On
     Fridays, events on Friday through Monday are displayed.

     The options are as follows:

     -A num  Print lines from today and next num  days  (forward,

     -a      Process the ``calendar'' files of all users and mail
the results
             to them.  This requires superuser privileges.

     -B num  Print lines from today and previous num days  (backward, past).

     -b       Enforce special date calculation mode for KOI8 calendars.

     -f calendarfile
             Use calendarfile as the default calendar file.

     -t [[[cc]yy][mm]]dd
             Act like the specified value is ``today'' instead of
using the
             current date.

     To  handle  calendars  in  your  national code table you can
     ``LANG=<locale_name>'' in the calendar file as early as possible.  To
     handle national Easter names in the calendars, ``Easter=<national_name>''
     (for Catholic Easter) or ``Paskha=<national_name>'' (for Orthodox Easter)
     can be used.

     To enforce special date calculation mode for Cyrillic calendars you
     should specify ``LANG=<local_name>'' and ``BODUN=<bodun_prefix>'' where
     <local_name>    can   be   ru_RU.KOI8-R,   uk_UA.KOI8-U   or

     Other lines should begin with a month and day.  They may  be
entered in
     almost  any  format, either numeric or as character strings.
If proper locale
 is set, national months and weekdays names can be used.
A single
     asterisk  (`*')  matches every month.  A day without a month
matches that
     day of every week.  A month without a day matches the  first
of that
     month.   Two  numbers  default  to the month followed by the
day.  Lines with
     leading tabs default to the last entered date, allowing multiple line
     specifications  for  a single date.  ``Easter'' (may be followed by a positive
  or  negative  integer)  is  Easter  for   this   year.
``Paskha'' (may be
     followed  by  a  positive  or  negative integer) is Orthodox
Easter for this
     year.  Weekdays  may  be  followed  by  ``-4''  ...   ``+5''
(aliases last,
     first,  second,  third, fourth) for moving events like ``the
last Monday in

     By convention, dates followed by an asterisk (`*')  are  not
fixed, i.e.,
     change from year to year.

     Day  descriptions  start  after the first <tab> character in
the line; if
     the line does not contain a <tab> character, it isn't printed out.  If
     the  first character in the line is a <tab> character, it is
treated as
     the continuation of the previous description.

     The calendar file is preprocessed by  cpp(1),  allowing  the
inclusion of
     shared  files  such as company holidays or meetings.  If the
shared file is
     not referenced by a full pathname, cpp(1)  searches  in  the
current (or
     home)   directory   first,   and   then   in  the  directory
     Empty lines and lines protected by the C  commenting  syntax
(/* ... */)
     are ignored.

     Some  possible  calendar entries (<tab> characters are highlighted by t


           #include <calendar.usholiday>
           #include <calendar.birthday>

           6/tJune 15 (if ambiguous, will default to  month/day).
           Jun. tJune 15.
           15 JutJune 15.
           ThursdtEvery Thursday.
           JutEvery June    1st.
           15t15th of every month.

           May Suntsecond Sunday in May (Muttertag)
           04/SunLatlast    Sunday in April,
         tsummer  time in   Europe
           OsterntGood Friday (2 days before Easter)
           PasktOrthodox    Easter

FILES    [Toc]    [Back]

     calendar              File in current directory.
     ~/.calendar           Directory in the user's home directory
                           calendar changes into, if it  exists).
     ~/.calendar/calendar  File to use if no calendar file exists
in the current
     ~/.calendar/nomail    calendar will not send  mail  if  this
file exists.
     calendar.birthday      Births and deaths of famous (and notso-famous)
     calendar.christian    Christian holidays (should be  updated
yearly by the
                           local  system  administrator  so  that
roving holidays
                           are  set  correctly  for  the  current
     calendar.computer      Days  of special significance to computer people.
     calendar.croatian     Croatian calendar.
     calendar.fictional     Fantasy  and  fiction  dates  (mostly
     calendar.french       French calendar.
     calendar.german       German calendar.
     calendar.history       Everything else, mostly U.S. historical events.
     calendar.holiday      Other  holidays  (including  the  notwell-known, obscure,
 and really obscure).
     calendar.judaic        Jewish  holidays  (should  be updated
yearly by the
                           local  system  administrator  so  that
roving holidays
                           are  set  correctly  for  the  current
     calendar.music        Musical  events,  births,  and  deaths
(strongly oriented
 toward rock n' roll).
     calendar.openbsd      OpenBSD related events.
     calendar.pagan         Pagan holidays, celebrations and festivals.
     calendar.russian      Russian calendar.
     calendar.usholiday    U.S. holidays.
     calendar.world        World wide calendar.

SEE ALSO    [Toc]    [Back]

     at(1), cal(1), cpp(1), mail(1), cron(8)

STANDARDS    [Toc]    [Back]

     The calendar program previously selected lines which had the
correct date
     anywhere  in  the line.  This is no longer true: the date is
only recognized
 when it occurs at the beginning of a line.

HISTORY    [Toc]    [Back]

     A calendar command appeared in Version 7 AT&T UNIX.

BUGS    [Toc]    [Back]

     calendar doesn't handle Jewish holidays or moon phases.

OpenBSD     3.6                           June      29,      1993
[ Back ]
 Similar pages
Name OS Title
calendar Tru64 Writes reminder messages to standard output
csa_read_next_reminder HP-UX reads the next reminder of the given type in the specified calendar relative to a given time
rpccp_remove_entry HP-UX Removes a name service entry from the name service database
rpccp_add_entry HP-UX Adds a name service entry to the name service database
v5srvtab Tru64 Contains the service key table
nisd_resolv HP-UX NIS+ service daemon
getservent IRIX get service entry
setservent NetBSD get service entry
getservbyport NetBSD get service entry
getservbyname NetBSD get service entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service