home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 1 / 1813 / ReadMe < prev   
Encoding:
Text File  |  1990-12-28  |  3.1 KB  |  82 lines
  1. This is still another new and improved release (2.1) of the infamous Pcal
  2. program.  The changes this time are:
  3.  
  4.     1) Elementary cpp-like functionality has been added; the date file
  5.        now supports define|undef, if{n}def ... { else ... } endif, and
  6.        include:
  7.  
  8.         ifdef meetings
  9.         include meetings.dat
  10.         undef meetings
  11.         endif
  12.  
  13.        Symbols may be {un}defined on the command line via the new -D
  14.        and -U options described below; symbol names are treated in a
  15.        case-insensitive manner.  "define" alone deletes all symbol
  16.        definitions; "ifdef" alone is always false; "ifndef" alone is
  17.        always true.
  18.  
  19.        The names of files to be included may be optionally surrounded
  20.        by "" or <>; non-absolute path names are taken to be relative
  21.        to the directory where the file containing the include directive
  22.        exists.  The Un*x flavor is smart enough to translate file names
  23.        starting with "~/".
  24.  
  25.     2) Pcal now looks for environment variable (global symbol on VMS)
  26.        PCAL_OPTS, which is parsed for command line options; flags set
  27.        there override the program defaults but are overridden by values
  28.        set in the date file or explicitly on the command line:
  29.  
  30.         setenv PCAL_OPTS "-t Times-Bold"    (Un*x)
  31.         $ PCAL_OPTS == "-t Times-Bold"        (VMS)
  32.  
  33.     3) Pcal also looks for environment variable (logical name on VMS)
  34.        PCAL_DIR which points to the default directory for the calendar/
  35.        CALENDAR.DAT file.
  36.  
  37.         setenv PCAL_DIR "/u4/users/awr/pcal"    (Un*x)
  38.         $ define PCAL_DIR "DISK11:[AWR.PCAL]"    (VMS)
  39.  
  40.        In response to many requests, Un*x pcal looks for .calendar; if
  41.        that does not exist, it looks for calendar as before.
  42.  
  43.     4) The -D and -U flags have been added to define or undefine symbols
  44.        for the preprocessor; if these are specified on the command line,
  45.        they take effect prior to reading the date file.  -D alone clears
  46.        all previously-defined symbols.
  47.  
  48.         pcal -D meetings            (Un*x)
  49.         $ pcal -"D" meetings            (VMS)
  50.  
  51.     5) The -L, -C, and -R flags have been added to specify left, center,
  52.        and right foot strings.  Foot strings consisting of multiple words
  53.        should be specified in single or double quotes:
  54.  
  55.         opt -C "Languages and Tools Group"
  56.  
  57.     6) The '-' (also '--') dummy flag has been added to disambiguate
  58.        cases such as the following:
  59.  
  60.         pcal -t 9 90
  61.  
  62.        which may now be specified as
  63.  
  64.         pcal -t - 9 90        or    pcal -t -- 9 90
  65.  
  66.     7) As many have noticed, Pcal used to overstrike multiple text lines
  67.        for the same date if the lines were not contiguous in the date
  68.        file; this has been fixed.  Also, the text accompanying holidays
  69.        is written in the otherwise-unused space adjacent to the date.
  70.  
  71. The accompanying file called "ReadMe.orig" came with the original distribution
  72. as README and states this program is copyrighted but with permission to modify
  73. and redistribute.
  74.  
  75. Andrew W. Rogers
  76.  
  77. Additional note: This distribution includes a VMS HELP file written by
  78. Richard Dyson.  Countless other people worked on pcal long before me; see
  79. the ReadMe.orig file and topline comments in pcal.c; special thanks to
  80. Mark Kantrowitz, Joe Brownlee, and Eric Hammond for their contributions
  81. and suggestions which I have incorporated into release 2.1.
  82.