Man Linux: Main Page and Category List

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.