Return to calendar.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / calendar

Annotation of 43BSDReno/usr.bin/calendar/calendar.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"     @(#)calendar.1 6.9 (Berkeley) 7/24/90
        !            19: .\"
        !            20: .Dd July 24, 1990
        !            21: .\"
        !            22: .Dt CALENDAR 1
        !            23: .Os BSD 4.4
        !            24: .Sh NAME
        !            25: .Nm calendar
        !            26: .Nd reminder service
        !            27: .Sh SYNOPSIS
        !            28: .Nm calendar
        !            29: .Op  \-a
        !            30: .Sh DESCRIPTION
        !            31: .Nm Calendar
        !            32: checks the current directory for a file named named
        !            33: .Li calendar
        !            34: and displays lines that begin with either today's date
        !            35: or tomorrow's.
        !            36: On Fridays, events on Friday through Monday are displayed.
        !            37: .Pp
        !            38: The following options are available:
        !            39: .Tp Fl a
        !            40: Process the ``calendar'' files of all users and mail the results
        !            41: to them.
        !            42: This requires super-user privileges.
        !            43: .Tp
        !            44: .Pp
        !            45: A month and day should begin lines.
        !            46: They may be entered in almost any format, either numeric or as character
        !            47: strings.
        !            48: A single asterisk (``*'') matches every month.
        !            49: A day without a month matches that day of every week.
        !            50: A month without a day matches the first of that month.
        !            51: Two numbers default to the month followed by the day.
        !            52: Lines with leading tabs default to the last entered date, allowing
        !            53: multiple line specifications for a single date.
        !            54: By convention, dates followed by an asterisk are not fixed, i.e. change
        !            55: from year to year.
        !            56: .Pp
        !            57: The ``calendar'' file is preprocessed by
        !            58: .Xr cpp 1 ,
        !            59: allowing the inclusion of shared files such as company holidays or
        !            60: meetings.
        !            61: If the shared file is not referenced by a full pathname,
        !            62: .Xr cpp 1
        !            63: searches in the current (or home) directory first, and then in the
        !            64: directory
        !            65: .Pa /usr/share/calendar .
        !            66: Empty lines and lines protected by the C commenting syntax (/* ... */)
        !            67: are ignored.
        !            68: .Pp
        !            69: Some possible calendar entries:
        !            70: .Pp
        !            71: .Ds I
        !            72: #include       <calendar.usholiday>
        !            73: #include       <calendar.birthday>
        !            74: 
        !            75: 6/15           ... June 15 (if ambiguous, will default to month/day).
        !            76: Jun. 15        ... June 15.
        !            77: 15 June        ... June 15.
        !            78: Thursday       ... Every Thursday.
        !            79: June           ... Every June 1st.
        !            80: 15 *           ... 15th of every month.
        !            81: .De
        !            82: .Pp
        !            83: .Sh FILES
        !            84: The following default calendar files are provided:
        !            85: .Dw calendar.christian
        !            86: .Di L
        !            87: .Dp Pa calendar.birthday
        !            88: Births  and  deaths  of  famous ( and  not- so- famous) people.
        !            89: .Dp Pa calendar.christian
        !            90: Christian holidays.
        !            91: This calendar should be updated yearly by the local system administrator
        !            92: so that roving holidays are set correctly for the current year.
        !            93: .Dp Pa calendar.computer
        !            94: Days of special significance to computer people.
        !            95: .Dp Pa calendar.history
        !            96: Everything  else,  mostly  U. S. historical events.
        !            97: .Dp Pa calendar.holiday
        !            98: Other  holidays,  including  the  not-well-known,  obscure, and
        !            99: .Em really
        !           100: obscure.
        !           101: .Dp Pa calendar.judaic
        !           102: Jewish holidays.
        !           103: This calendar should be updated yearly by the local system administrator
        !           104: so that roving holidays are set correctly for the current year.
        !           105: .Dp Pa calendar.music
        !           106: Musical  events,  births, and deaths.
        !           107: Strongly  oriented  toward  rock ' n' roll.
        !           108: .Dp Pa calendar.usholiday
        !           109: U.S. holidays.
        !           110: This calendar should be updated yearly by the local system administrator
        !           111: so that roving holidays are set correctly for the current year.
        !           112: .Dp
        !           113: .Sh SEE ALSO
        !           114: .Xr at 1 ,
        !           115: .Xr cpp 1 ,
        !           116: .Xr cron 8
        !           117: .Xr mail 1 ,
        !           118: .Sh COMPATIBILITY
        !           119: The
        !           120: .Nm calendar
        !           121: program previously selected lines which had the correct date anywhere
        !           122: in the line.
        !           123: This is no longer true, the date is only recognized when it occurs
        !           124: first on the line.
        !           125: .Sh HISTORY
        !           126: A
        !           127: .Nm
        !           128: command appeared in Version 7 AT&T UNIX.
        !           129: The version of
        !           130: .Nm calendar
        !           131: released with this man page
        !           132: is unrelated.
        !           133: .Sh BUGS
        !           134: .Nm Calendar
        !           135: doesn't handle events that move around from year to year, i.e.
        !           136: ``the last Monday in April''.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.