home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 1 / 1665 / pcal.hlp < prev    next >
Encoding:
Text File  |  1990-12-28  |  4.0 KB  |  82 lines
  1. 1 PCAL
  2.         Pcal  generates  PostScript  to produce landscape or  portrait
  3.     orientated calendars for  any  month  and  year.  The defaults for
  4.     month and year are the current month and year.
  5.  
  6.         VMS Version
  7.         Execution format:
  8.     
  9.             pcal [options] [mm yy] [n]
  10.  
  11.         If a file named calendar.dat  resides  in  the  caller's  home
  12.     directory, it  will  be  searched  for  lines  with  leading dates
  13.     matching the requested  month  and year (current by default).  Any
  14.     text following the date  will be printed on the calendar under the
  15.     appropriate day of the month.   Dates in the calendar.dat file may
  16.     consist  of  a  numeric or alpha  month  (at  least  the  first  3
  17.     characters  for  month  names)  followed  by  a  numeric  day  and
  18.     optionally  followed  by  a year.  Any non-numeric  character  may
  19.     separate numeric dates.  Holidays may be flagged by  following the
  20.     date immediately with '*';  this will cause the date to be printed
  21.     in gray.  Lines in the calendar.dat file consisting of "year xxxx"
  22.     (where  xxxx  is a numeric year) can be used to set the  year  for
  23.     following entries.  This assumes that the following entries do not
  24.     contain a year;  any date entries containing year information will
  25.     set  the  remembered  year  to  that  year.  Lines  consisting  of
  26.     "opt <options>" can be used to  override defaults for all command-
  27.     line flags  except  -e and -f; any  flags set  in this  manner are
  28.     themselves overridden by flags specified explicitly on the command
  29.     line.  Comments ('#' through end-of-line) are permitted.
  30.  
  31. 2 parameters
  32.   mm yy n
  33.         "mm" and "yy"  are numeric values of the month (1-12) and year
  34.     (0-99) (i.e., July 1990  would  be 7 90).  If you just include the
  35.     "yy" option, an entire 12  months  of calendars will be generated.
  36.     A specific month can be produced  by including the "mm" parameter.
  37.     The  "n"  parameter will produce the "n"  consectutive  months  of
  38.     calendars starting with the requested month.
  39.  
  40. 2 -e
  41.         Print an  empty  calendar.    Do  not  print  entries  from  a
  42.     calendar.dat file.
  43.  
  44. 2 -f <FILE>
  45.         Directs pcal to use the  file name <FILE> as the input file in
  46.     place  of the  default  calendar.dat  file  in  the  callers  home
  47.     directory.
  48. 2 -o <FILE>
  49.         Directs pcal to write the PostScript calendar into FILE.
  50. 2 -l
  51.         This will cause the  output  to  come  out  in  landscape mode
  52.     (default).
  53. 2 -p
  54.         This will cause  the  output  to  come  out  in  portrait mode
  55.     instead of landscape mode.
  56. 2 -b <DAY> | all
  57.         This  will cause  all dates  on weekday  DAY to be  printed in 
  58.     black;  "-b all" causes  all dates  to be printed  in black unless
  59.     explicitly flagged as a holiday.
  60. 2 -g <DAY> | all
  61.         This  will cause  all dates  on weekday  DAY to be  printed in 
  62.     gray; "-g all" causes all dates to be printed in gray.  Default is
  63.     to print Saturdays  and Sundays in gray and  other dates in black.
  64. 2 -t <FONT>
  65.         This option can be used  to  change  the  font  the  title  is
  66.     printed in  (ie. pcal -tTimes-Roman).  The default  is Times-Bold.
  67. 2 -d <FONT>
  68.         This option is the same as  -t  except  that  the font used to
  69.     print the day numbers is changed.
  70. 2 CAVEATS
  71.         The original PostScript code  to  generate  the  calendars was
  72.     written by Patrick Wood (Copywrite  (c)  1987  by  Patrick Wood of
  73.     Pipeline  Associates, Inc.), and authorized for  modification  and
  74.     redistribution.    The  calendar.dat  file  inclusion  code    was
  75.     originally written in "bs(1)" by Bill Vogel of  AT&T.    Patrick's
  76.     original  PostScript  was  modified  and enhanced several times by
  77.     others  whose names  have  regrettably been lost.  Ken Keirnan  of
  78.     Pacific Bell assembled the original "C" version upon which this is
  79.     based;  additional modifications and enhancements were the work of
  80.     Joseph P. Larson, Ed Hand,  and Andrew W. Rogers.  This  VMS  HELP
  81.     file was written by Richard Dyson.
  82.