home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 4: Phase Four / 17Bit_Phase_Four.iso / files / 3204.dms / 3204.adf / EpochCliV1.0.doc < prev    next >
Text File  |  1994-09-15  |  5KB  |  111 lines
  1.                           Epoch CLI V1.0
  2.                        (C) C.S.J.Brady 1994
  3.  
  4. This  program  may  be freely distributed, no fee is required either from 
  5. people distributing the program or from people using the program.  People 
  6. distributing  the  program may not make more than a reasonable charge for 
  7. distributing the program to cover disks and postage.  The distribution by 
  8. 0898  BBSs  or  any  BBS  claiming  copyright  to  file  on the system is 
  9. particularly forbidden.
  10.  
  11. J. Pritchard  has  been specifically granted the right to distribute this 
  12. program and document with his own program Epoch Master.
  13.  
  14. NO  ONE  may  tamper with this software in any way; this includes, but is 
  15. not limited to, reverse  engineering, recompiling, editing the executable 
  16. or document files.
  17.  
  18. Epoch CLI was written in C using DICE on a very old Amiga 500 with WB1.3, 
  19. and although Epoch CLI is FREEWARE I would like to upgrade my machine :-)
  20.  
  21. This  program  uses  the  file  S:EpochCal which is produced by a program 
  22. called  Epoch  Master  which  is  (C) J. Pritchard 1994.  Epoch Master is 
  23. SHAREWARE;  shareware  contributions of £10 should be sent to J.Pritchard 
  24. at HIS address below.
  25.  
  26. Epoch  CLI  was written by me as an alternative to EpochGlance written by 
  27. J. Pritchard.  EpochGlance  requires  that  the user uses the mouse while
  28. scanning  the directory outside the main Epoch Master program, and prints
  29. its output to a separate window.
  30.  
  31. NB: The first argument must be the calendar file that you wish to read.
  32.  
  33. The   output  from Epoch CLI can be made to go straight to the CLI window 
  34. from  which  it  was  run from.  Output from the program can therefore be 
  35. directed  to a file in the normal CLI/Shell way i.e. "program >PATH:file" 
  36. sends  the  output to a new file (a file will be created automatically, a 
  37. file  with  the same name, if present, is DELETED).  The command "program 
  38. >>PATH:file"  will send the output to a new file, if a file called "file" 
  39. doesn't exist, or  it  will  append  the  output  to the file if the file 
  40. already exists.
  41.  
  42. If  you  wish  to  use redirection when using Epoch CLI please use the -p
  43. option as this will stop the program waiting for the user to press return
  44. after each entry and also sends the output to the CLI/SHELL window (which 
  45. is needed when using redirection).  To do this type :-
  46.  
  47.       epoch_cliV1.0 >>ram:diary.txt s:epochcal -p
  48.  
  49. Replace s:epochcal with the filename that you use.
  50.  
  51. To use this program in your startup-sequence I recommend that you use the
  52. following lines in the startup-sequence of your system (boot) disk:-
  53.  
  54. ask "*e[33mCheck Diary ?*e[0m {y/n}"
  55. if WARN
  56.    epoch_cliV1.0 s:epochcal
  57.    echo "Checked Diary"
  58. else
  59.    echo "Did not check diary"
  60. endif
  61.  
  62. Please  ensure  that  you have the commands "ask", "if", "else", "endif",
  63. "echo"  and  "epoch_cliV1.0"  available  on  the  current  (search) path,
  64. for example in the C: directory of the system (boot) disk.
  65.  
  66. Epoch_CLI  uses  the  system date and so you need to have set your system 
  67. clock  before  you  run the program, using "setclock load".  If you don't 
  68. have a system clock use the "-i" option when running the program, as this 
  69. stops the program loading and using the system date.  There is no need to 
  70. use  this option with the "-p" option as the system date is not currently 
  71. used  when  using the "-p" option.  There is no need to use the -c option 
  72. if you use the -i option (see later).
  73.  
  74. The  -c  option  stops the program from searching for the next entry that 
  75. will occur (which is the  default).  If you don't use this option you may 
  76. find  that  the program starts displaying on, for example, the 6th entry, 
  77. this is not a bug !
  78.  
  79. If you use  the  option "-s" when running Epoch_CLI then you will only be 
  80. given a brief summary of each entry in your S:epochcal file.  This option 
  81. can  be  used  in  conjunction  with the "-p" option to create a table of 
  82. entries.
  83.  
  84. At  the  moment  this program can NOT read encrypted calendar files, this 
  85. will hopefully change soon; if a file is saved with a password but is not 
  86. encrypted this program reads the file anyway !
  87.  
  88. You  will  be  told if there are any notes relating to the entry but they
  89. will not be displayed.
  90.  
  91. If you have any  questions, comments or queries relating to Epoch_CLIV1.0
  92. then please write to me (Chris Brady) at my address below.
  93.  
  94. If you have any  questions, comments, or queries relating to Epoch Master
  95. then please write to J. Pritchard at his address.
  96.  
  97.         Chris Brady,                           J. Pritchard,
  98.         (epoch_cliV1.0)                        (Epoch Master)
  99.         5 Hill Grove,                          5 Parklands Close,
  100.         Salendine Nook,                        Gosport,
  101.         Huddersfield.                          Hampshire.
  102.         West Yorkshire.                        
  103.         England.                               England.
  104.         HD3 3TL.                               PO12 4XJ
  105.  
  106.  
  107. Please support the AMIGA by sending the SHAREWARE fee to J.Pritchard, and 
  108. send me a postcard of your home town if you can.
  109.  
  110. Chris Brady
  111.