home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 1 / 1608 / pcal.hlp < prev    next >
Encoding:
Text File  |  1990-12-28  |  3.4 KB  |  75 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]m 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.  Comments ('#' through end-
  26.     of-line) are permitted.
  27.  
  28. 2 parameters
  29.   mm yy n
  30.         "mm" and "yy"  are numeric values of the month (1-12) and year
  31.     (0-99) (i.e., July 1990  would  be 7 90).  If you just include the
  32.     "yy" option, an entire 12  months  of calendars will be generated.
  33.     A specific month can be produced  by including the "mm" parameter.
  34.     The  "n"  parameter will produce the "n"  consectutive  months  of
  35.     calendars starting with the requested month.
  36.  
  37. 2 -e
  38.         Print an  empty  calendar.    Do  not  print  entries  from  a
  39.     calendar.dat file.
  40.  
  41. 2 -f <FILE>
  42.         Directs pcal to use the  file name [1m<FILE>[m as the input file in
  43.     place  of the  default  calendar.dat  file  in  the  callers  home
  44.     directory.
  45. 2 -o <FILE>
  46.         Directs pcal to write the PostScript calendar into [1mFILE[m.
  47. 2 -r
  48.         This will cause  the  output  to  come  out  in  portrait mode
  49.     instead of landscape mode.
  50. 2 -s
  51.         This will  cause  Saturdays  to be printed in black instead of
  52.     gray.
  53. 2 -"S"
  54.         This will cause  Saturdays  and Sundays to be printed in black
  55.     instead of gray.
  56. 2 -t <FONT>
  57.         This option can be used  to  change  the  font  the  title  is
  58.     printed  with  (ie.    pcal  -tTimes-Roman).      The  default  is
  59.     Times-Bold.
  60. 2 -d <FONT>
  61.         This option is the same as  -t  except  that  the font used to
  62.     print the day numbers is changed.
  63. 2 CAVEATS
  64.         The original PostScript code  to  generate  the  calendars was
  65.     written by Patrick Wood (Copywrite  (c)  1987  by  Patrick Wood of
  66.     Pipeline  Associates, Inc.), and authorized for  modification  and
  67.     redistribution.    The  calendar.dat  file  inclusion  code    was
  68.     originally written in "bs(1)" by Bill Vogel of  AT&T.    Patrick's
  69.     original  PostScript  was  modified  and enhanced several times by
  70.     others  whose names  have  regrettably been lost.  Ken Keirnan  of
  71.     Pacific Bell assembled the original "C" version upon which this is
  72.     based;  additional modifications and enhancements were the work of
  73.     Joseph P. Larson, Ed Hand,  and Andrew W. Rogers.  This  VMS  HELP
  74.     file was written by Richard Dyson.
  75.