home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume4 / calgen / part1 / README < prev   
Encoding:
Text File  |  1986-11-30  |  4.2 KB  |  107 lines
  1.           Calendar Generation Program
  2.         Copyright 1986 David H. Brierley
  3.  
  4. Permission is granted to anyone to use this software for any
  5. purpose on any computer system, and to redistribute it freely,
  6. subject to the following restrictions:
  7. 1. The author is not responsible for the consequences of use of
  8.     this software, no matter how awful, even if they arise
  9.     from defects in it.
  10. 2. The origin of this software must not be misrepresented, either
  11.     by explicit claim or by omission.
  12. 3. Altered versions must be plainly marked as such, and must not
  13.     be misrepresented as being the original software.
  14.  
  15. David H. Brierley
  16. Portsmouth, RI
  17. {allegra,ihnp4,linus}!rayssd!dhb
  18.  
  19. Note:  I claim the programs as my own but disavow all
  20. knowledge of the associated data file.
  21.  
  22. PLEASE read this file all the way through before installing
  23. the program.  Installation instructions and notes are at the
  24. end of this file.
  25.  
  26.  
  27. The files in this directory are the source and data files
  28. for the calndr program.  There is no manual page but the
  29. program operation is fairly simple.  The program has the
  30. name of the default data file compiled into it so all the
  31. user normally has to do is specify what to do with the
  32. output. The program is almost completely interactive and
  33. there is a built in help facility which explains all the
  34. program inputs.  Since I have a thing against duplication
  35. of effort, run the program if you want an explantion of
  36. the input formats.
  37.  
  38. calndr.c
  39.     This is the main calendar program.  Command line
  40.     options are as follows:
  41.     -f filename    alternate data file in internal format
  42.     -r filename    alternate data file in raw format
  43.     -o filename    create calendar in named file
  44.     -P printer     send calendar to specified printer
  45.  
  46. pic_h2m.c
  47.     This program converts data files from the raw (human
  48.     readable) format to the internal format.  See the comments
  49.     in the source file for an explantion of the two formats.
  50.     In order to use the -r option of the calndr program,
  51.     this program must be installed somewhere where the calndr
  52.     program can find it.  This program takes arguments of the
  53.     input file name and the output file name.
  54.  
  55. pic_m2h.c
  56.     This program is the reverse of pic_h2m.  The main reason
  57.     for having this program is that it has a '-c' option
  58.     which produces a 'compressed' version of the raw data file.
  59.     The compress format is defined in the comments in the
  60.     source.  This program takes an optional argument of -c,
  61.     followed by the names of the input and output file names.
  62.  
  63. compress.data
  64.     This file is the compressed version of the raw data file.
  65.     This file should be transformed into internal format using
  66.     the pic_h2m program.  If you want an easily readable version
  67.     of this file you may run the pic_m2h program on the resultant
  68.     file.
  69.  
  70.  
  71.  
  72.     Installation Instructions:
  73.  
  74. 1. Decide where you want to put the default data file.
  75. 2. Edit the makefile and change the line that says 'PICDATA=' to
  76.    reflect the choice made in step 1.  You should also edit the
  77.    line that says 'GETOPT=' to define where to find the getopt
  78.    routine if it is not in your site's standard library.  This may
  79.    be a library which contains getopt, or just a .o file.
  80. [   2a. Also check the PAGER variable in the makefile.  If your site
  81.     does not have a favorite "more" like program, then set this
  82.     variable to nothing.
  83.             - moderator
  84. ]
  85. 3. type 'make'
  86. 4. There is no 'make install', simply move the executables to
  87.    wherever you want them.  If you want to allow use of the '-r'
  88.    option to the calndr program you must install the 'pic_h2m'
  89.    program, otherwise all you have to install is 'calndr'.
  90. 5. Enjoy.
  91.  
  92.  
  93.     Installation Notes:
  94.  
  95. 1.  The current version of this program has only been tested on
  96.     4.1/4.2 BSD using both a VAX and a PYRAMID although previous
  97.     versions of the program (in various languages) have been run
  98.     on 4.1(VAX), V7/PWB(PDP11/55), and OS/VS1(IBM3032).  In other
  99.     words, I know the algorithms work but I dont gaurantee that
  100.     the program is portable to other versions of UNIX (or anything
  101.     else).
  102.  
  103. 2.  The getopt routine is not included in this distribution.  If
  104.     for some strange reason you do not have getopt you can get it
  105.     from the mod.sources archive or you can probably get it from
  106.     one of your neighbors or you can get it from me.
  107.