home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsd / diary / !Diary / !Help < prev    next >
Text File  |  1994-07-23  |  8KB  |  161 lines
  1. !Diary
  2. v 1.31 (23-Jul-1994)
  3. This program is Shareware.
  4. This means that you can copy this program to anyone you like, but if you
  5.    find the program useful, you should register, as explained below. This
  6.    entitles you to the latest version of this program, and of all my other
  7.    applications.
  8. If you do copy the program it should be in its original format, with ALL of
  9.    the accompanying files. That is : !Boot
  10.                                      !Help
  11.                                      !Run
  12.                                      !RunImage
  13.                                      !Sprites
  14.                                      Messages
  15.                                      Sprites
  16.                                      Templates
  17.  
  18.  
  19. Purpose
  20. -------
  21. A diary program which includes the ability to repeat a given line of text at
  22. regular intervals.
  23.  
  24.  
  25. To use
  26. ------
  27. Double click on the icon in the filer window, to load the application. Then
  28. open the main window by clicking on the icon on the icon bar. The icon at
  29. the top of the window will show today's date, and the main area will show
  30. any text, if a file has been loaded. Click on the right arrow icon with
  31. the left hand mouse button (select) to increase the day by one, and on the
  32. left arrow icon with the left hand mouse button (select) to decrease the day
  33. by one. Using the right hand mouse button (adjust) reverses the effect.
  34. Click on the middle mouse button (menu) on the window to open up the main
  35. menu. From here, it is possible to do the following :
  36.  
  37.    Repeat : Sets the repeat option for the line you clicked the button over.
  38.                The repeat can be set to Daily, Weekly, Monthly, Yearly, and
  39.                Off.
  40.             Daily shows that line of text on every day,
  41.             Weekly shows that line of text on every day of the week that is
  42.                the same as the original entry, i.e. selecting Weekly on an
  43.                entry entered on a Monday, will show that entry every Monday
  44.             Monthly shows that line of text on the same date of the month,
  45.                every month, i.e. selecting Monthly on an entry entered on
  46.                6th June will show that entry on 6th Jan, 6th Feb, etc.
  47.             Yearly shows that line of text on the same day of the same month
  48.                every year, e.g. selecting Yearly on an entry entered on 6th
  49.                June will show that entry on 6th June every year.
  50.             Incrementing does the same as Yearly, except an occurrence of %Y
  51.                will be replaced by the number of years from the first
  52.                occurrence. e.g. if an entry was entered for the 1/1/81 as
  53.                "Joe Bloggs' birthday (%Y)" then on the 1/1/82 it would show
  54.                up as "Joe Bloggs' birthday (1)" etc...
  55.             Off removes any repeat, so that that entry is only shown on that
  56.                particular day, in that month, of that year.
  57.  
  58.    Goto   : The writeable icon allows you to go to a specific date, e.g.
  59.                6/7/89. It is not necessary to pad the day or month to two
  60.                figures, and if two figures for the year are given, it is
  61.                assumed to be in the 1900s, i.e. the last example would go to
  62.                the 6th July 1989.
  63.             Today allows you to go to todays entry.
  64.             Find prev finds the previous entry in the file.
  65.             Find next finds the next entry in the file.
  66.                These two find options count the number of days that are
  67.                scrolled through. If an entry is not found within 365 days,
  68.                then a warning is given, and to continue the search, the menu
  69.                option should be chosen again.
  70.                (I did this to avoid the possibility of the program checking
  71.                an empty file for entries which do not exist, and thus the
  72.                program getting stuck in a loop, which the user cannot break.)
  73.  
  74.    Edit   : Delete line will delete the line of text that the mouse button
  75.                was clicked over.
  76.             Clear window deletes all entries on that day. If a repeated
  77.                option is set from another day, and would appear then that
  78.                entry is temporarily deleted, but going forward a day, and
  79.                then back one causes the entry to appear again.
  80.  
  81.    Search : Allows you to search for a string.
  82.             (Please note - any option that repeats is only found for the
  83.                first time that it occurs. ie. If an entry was
  84.                'Fr16/07/1976 I Neil's birthday (%Y)' then it would only be
  85.                found on Friday, 16th July 1976.)
  86.  
  87.    Show All : Allows direct control over the entries. Open the window, by
  88.                selection on the menu and then double click on an entry to
  89.                edit. This shows the day, date, repeat, and text of the entry.
  90.                The date icon is writable, as is the text icon, and the repeat
  91.                icon has to be clicked on to open a menu allowing you to
  92.                choose the repeat type. The day icon is updated whenever
  93.                RETURN is pressed in the date icon, or when it is clicked on.
  94.                (N.B. I have referred to the date icon, but it is actually
  95.                made up of 3 : one for the date, one for the month, and one
  96.                for the year.)
  97.  
  98.    Save   : Allows you to save the entire diary file, or a list of events
  99.                occuring today. Enter a full pathname and press RETURN or
  100.                click on OK, or alternatively, just enter a filename and drag
  101.                the icon to a filer window.
  102.  
  103. On the main window is another icon titled 'coming up', with left and right
  104. arrows beside it. This lists any events which would occur within a week of
  105. the date shown at the top of the window. Clicking on the left and right
  106. arrows steps through these events. If the event shown is at one end of
  107. the list then clicking on the icon to go further (i.e. left when at the
  108. first, or right when at the last) will not change the text in the icon,
  109. although no error will be called.
  110. N.B. Events with a daily or weekly repeat are not shown in the 'coming up'
  111. section as they would become constant fixtures. (It seemed pointless to me.)
  112.  
  113. N.B. the list is sorted such that the events nearest to the date in the
  114. window are shown first.
  115.  
  116.    The menu available from the icon on the icon bar has four options. These
  117. are :
  118.  
  119.    Info     : Gives the program information - program name, program purpose,
  120.                  program author (me!), and program version number.
  121.  
  122.    New File : Creates a new data file, deleting any data in memory.
  123.    
  124.    Save     : Saves the entire data file only.
  125.    
  126.    Quit     : Quits the program.
  127.  
  128.  
  129. Bugs & Improvements
  130. -------------------
  131. Please report any bugs found and any possible improvements you can think of
  132. to me at the address shown below.
  133.  
  134.  
  135. Registering
  136. -----------
  137. To register, send £5 to me, at the address shown below, stating what version
  138. of which programs you have. You can enclose your own disk for the programs,
  139. and if you do so you can deduct 50p from the price. Registering entitles you
  140. to upgrade to later versions of the same programs and to get new programs
  141. for the price of £1. Any additional contributions from overseas towards
  142. postage would be greatly appreciated.
  143.  
  144.  
  145. Neil Walker.
  146. 16, Finderne Drive.
  147. Wymondham.
  148. Norfolk.
  149. NR18 0HU.
  150.  
  151.  
  152. Legal Notice
  153. ------------
  154. This program is supplied 'as is'. I therefore cannot be held responsible
  155. for any loss of data, profits or any other loss, either directly or
  156. indirectly, that may be incurred by the use (or misuse) of this software,
  157. even if I am aware of the possibility of such a loss. However, I can assure
  158. you that in its original state, the program contains no deliberate viruses,
  159. or damaging procedures, except where these are necessary for the fulfilment
  160. of the program's function.
  161.