XCALEV(1)						      General Commands Manual							 XCALEV(1)

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.

X Version 11 R5 						   October 1993 							 XCALEV(1)