Provided by: xcal_4.1-19_amd64 bug

NAME

       xcalev - load xcal calendar files with regular dates

SYNTAX

       xcalev [ -r ][ -x ][ -f file ][ -d dir ][ year ]

DESCRIPTION

       Xcalev  is  used to preload the calendar files for the xcal program with regular events in
       your life.  It reads lines from a file (usually called regular  stored  in  your  Calendar
       directory.  Each line in the file contains three fields separated by spaces or tabs, these
       are: a month name, a day in the month and some text.  For example:

            December 25    Christmas
            Dec 31         New Year's Eve

       The order of the month and the day are optional, the program deduces the  day  by  looking
       whether the string contains an initial numeric character or not.  The year defaults to the
       current year unless the program is given a year number as an argument.  This  year  cannot
       be abbreviated to two digits because xcal
        deals with years from year zero.  There's a rough validity check on this.

       The  string from the data line is inserted in the appropriate file and will appear in your
       xcal date strip.  Nothing will happen if the string already exists in the  file  for  that
       day.   This  means  that  it's  safe to run xcalev at any time, only the strings that have
       altered in the regular file will be updated.

       To help with entering the same event for a number of days in one month, you can give a day
       range with a hyphen
            Jan 16-21 Usenix SF

       If  you supply the -r option, xcalev will delete all the matching strings that it finds in
       the appropriate daily file.  So, if you want to make radical changes to the regular  file,
       you  should run xcalev with the -r option to remove all the current entries from one year,
       edit the regular file and run xcalev to reload things.

OPTIONS

       The -r option makes xcalev delete rather than append entries.

       The -x option makes xcalev operate with  Calendar  files  that  are  compatible  with  the
       xcalendar program.

       The  -f  switch  is followed by a filename gives an alternative name for the regular file.
       If the filename does not start with a slash or a dot,  then  the  name  of  your  Calendar
       directory will be prepended to it.

       The  -d  switch  is  followed by a directory name and specifies an alterative location for
       your Calendar directory.  Your home directory is prepended if the name doesn't start  with
       a slash or a dot.

FILES

       $HOME/Calendar/∗

       xc<dd><Mon><Year>  A data file is day, Month in three letter format and the year.

       xy<Year>           A year directory.

       xw<Day>            A data file for the weekly code, one per day.

SEE ALSO

       xcal(1), xcalpr(1), xcal_cal(1)

AUTHOR

       Copyright 1993 by Peter Collinson, Hillside Systems All rights reserved.