Program   :  Diary
Version   :  1.0a
Format    :  Either ARC or LZH
Files     :  Diary1_0.prg  Diary1_0.doc  Diary1_0.rsc  
               Diary1_0.sys  Diary.cfg  Other.doc  
Memory    :  This program needs about 126K to operate. 62K for the 
             program, 32K for data, and 32K for the screen buffer.

Author(s) :  Jay Taylor/Steven Taylor. 1989.

What      :  Diary v1.0a is a computerised diary, allowing you
             to  enter  up to 20 pages per day and store  them  on 
             disk, ready for viewing or printing, later. Each page 
             is 20 lines by 80 characters,  so there is plenty  of 
             room for you to enter your thoughts.

             I wrote this program as an extra module for my 
             Filofact program, but have released this version as a 
             stand alone program for every one to use. Registered 
             users of Filofact will receive a free update, v1.3b 
             very soon.

Notice    :  This program is public domain, and may be distributed
             freely*. The author(s) own the copyright and the 
             program must be distributed as in the format detailed 
             above.

             *This program may not be put on a magazine cover disk
              without  the  express,  written  permission  of  the 
             author(s). 

             This program may not be sold. No payment must be 
             made, except where such payment is for the cost of
             distribution etc. Such a payment must not exceed
             five pounds.

             No payment is needed for this program. If you would 
             like to make a donation, please send me a couple of 
             blank disks.

Warning   :  "I make no warranty with respect to the 
             documentation, or the program(s) it describes, and 
             disclaim any implied or explicit suggestions of 
             usefulness for any particular purpose. Use this 
             program only if you are willing to assume all risks, 
             and damages, if any, arising as a result, even if it 
             is caused by negligence or other fault."

*****************************************************************

                     *** THE INSTRUCTIONS ***


                  * WHERE SHOULD THE FILES GO? *

All  the  files found in the archive,  with the exception  of  the 
documentation  files,  should all be placed in the same folder  of 
your choice. When diary saves your data, it will also be placed in 
this folder. It is very important that you do not move these files 
or diary will not be able to find them.


                 * HOW DO I START THE PROGRAM? *

Simply  double  click on the file 'diary1_0.prg' and  the  program 
will begin to load.  Once it has loaded, it will begin to load the 
resource file and systems file.  If for some reason it cannot find 
any of these,  a error message will be displayed informing you  of 
the problem, and the application will abort.

Next,  diary will try to allocate some memory for itself. If there 
is  not enough available you will be informed and the  application 
will abort.

If all is well,  the main working screen will be displayed and the 
allocated  memory  will be zeroed.  You are now ready to  use  the 
program.

If  you  do not have a battery backed clock,  you  would  be  well 
advised  to  enter  the  correct time  and  date  using  the  'set 
time/date' option from the 'systems' menu,  before doing  anything 
else.  All  data files are saved using a name made up  from  their 
date, so it is very important that this is always correctly set.

I  would  like  to  take this opportunity to  remind  you  of  the 
importance of switching off your computer for 30 secs, after using 
a new piece of PD software,  untill you are sure that it is  virus 
free.  On no account put new PD software on your hard disk  untill 
you know it to be safe.


                          * THE MENUS *

                             * DESK *

* diary *

Selecting  this option will display details about the program  you 
are using.


                             * FILE *

* LOAD DATA *

This  option  will enable you to load diary entrys that  you  have 
previously saved to disk.
Upon  selection,  a dialog will appear,  enabling you to  set  via 
radio buttons,  the date,  month,  and year of the diary entry you 
wish to load. 

* SAVE DATA *

This allows you to save the current entry in memory, to disk.
As above,  you may set the date,  month,  and year for the  entry, 
which will then be used as the file name.  If the entry is for the 
current  system date,  then you may select 'auto' in  the  dialog, 
without setting the radio buttons.  Your entry will be saved using 
the current system date.

If you select a date that has already been used, you will be asked 
if you want to overwrite the old file, or abort the operation.

* DIRECTORY *

This  allows  you  to view or print the contents  of  the  current 
directory.
Upon  selection you will be asked if the listing is to go  to  the 
screen or printer.  Then you will be asked if you want to list all 
the files in the directory, or just the diary data files.
After  making your selections a listing will be produced  on  your 
screen or printer.  If you selected screen, the program will pause 
untill  you press a key,  whereupon you will be taken back to  the 
work screen.

* FORMAT *

Use  this  to format yourself a disk.  Care should be  taken  when 
using  this option,  so that you do not accidentally format  a  disk 
that already has files on it.
After  selecting,  a  dialog will appear that will enable  you  to 
select  drive  A or B for the formatting,  and  single  or  double 
sided.
The  formatting  is  standard  Atari  TOS.  No  extra  sectors  or 
anything!

* QUIT *

Allows you to leave the program and go back to the desk top.
Upon  selecting you will be given the option of returning back  to 
the diary program. Just in case you select it by accident!


                           * OPTIONS *

* DELETE LINE *

Deletes  the line the cursor is currently on.  Please note that  a 
line cannot be undeleted once it has been deleted! 
Pressing 'undo' on the keyboard has the same effect.

* DELETE/WIPE PAGE *

Deletes or wipes the current page. Not reversible.
After  selecting  you  will be asked if you  want  to  delete  the 
current  page or wipe it.  Selecting delete will delete  the  page 
from memory,  moving all the pages after it,  down one.  Selecting 
wipe  on  the other hand,  simply wipes the  page  blank,  without 
moving any of the other pages.

* DELETE WHOLE ENTRY *

This will delete the whole 20 pages from memory. Not reversible.
After selecting you will be asked to confirm that you really  want 
to delete everything.

* INSERT LINE *

Inserts a new line a the current cursor position.
Pressing 'enter' on the numeric keypad has the same effect.

* NEW PAGE *

Takes you to the next page.
Pressing   '+'  on  the  numeric  keypad  has  the  same   effect. 
Alernatively you may press 'esc' and select a page from the pop up 
menu.


                            * BLOCK *

* START OF BLOCK *

Marks the start of a block for the cut and paste operations.

* END OF BLOCK *

Marks the end of a block. Note that you should position the cursor 
one line below the last line of your block.

* MOVE BLOCK *

Moves a marked block and places it at the current cursor position.
Once the block has been moved the block makers are reset.

* COPY BLOCK *

Places a copy of a marked block at the current cursor position.
The block markers are not reset after this operation,  so you  may 
use  this command as many times as you need.  To mark a new  block 
you must first select 'clear buffer' from the buffer menu.

* DELETE *

Deletes the marked block. Not reversible.
Once the block has been deleted the block markers are reset.

* BUFFER BLOCK/LEAVE *

Only available in Filofact module version.

* BUFFER BLOCK/ERASE *

Only available in Filofact module version.

                            * BUFFER *

* PASTE BUFFER *

Only available in Filofact module version.

* LOAD BUFFER *

Only available in Filofact module version.

* SAVE BUFFER *

Only available in Filofact module version.

* CLEAR BLOCK *

Clears the buffer and resets the block markers.

                           * SETTINGS *

* INSERT MODE *

Use this to select insert mode.  You may also use the 'insert' key 
on the cursor keypad.
This  mode only works within one line.  When the length of a  line 
exceeds 80 charaters whilst in insert mode,  diary reverts back to 
normal overwrite mode.
The mode status is displayed at the bottom of your work screen.

* OVERWRITE *

Use this to select overwrite mode.  You may also use the  'insert' 
key on the cursor keypad.
Overwrite is the normal operation mode of diary.  The mode  status 
is displayed at the bottom of the screen.

* AUTO-JUSTIFY *

This  option has not been implemented yet.  This is something  for 
the future!

* SET TABS *

This allows you to set up to five tabs settings.
After selecting a dialog will appear giving the current  settings. 
You may change these to any value you like, within the range 1-80. 
However,  each  tab setting must be higher than the previous  one, 
for obvious reasons.
These settings are saved to disk so that when you next use  Diary, 
they will be loaded as well.

* SET FUNCTION KEYS *

This  allows  you to allocate a string to each of the  first  five 
function  keys,  so  that when they a  pressed,  the  pre-selected 
string will be automatically entered into your text.
After selecting a dialog will appear giving the current  settings. 
You may change any or all of them as above.
These settings are saved to disk, and will be loaded the next time 
you use Diary.

                            * PRINT *

* PRINT PAGE *

This will print the current page you are viewing.

* PRINT WHOLE ENTRY *

This will print the whole 20 pages of the current entry.

* PRINT TEST *

This will do a test print.

                             * INFO *

         This menu contains various bits of information!

                            * SYSTEM *

* TEST *

Provides system check and insep date.

* SET TIME *

This option allows you to set the time and date.
The  time and date is displayed on the bottom status line  at  all 
times. Well, nearly.

                        * KEYBOARD STUFF *

esc:         Pressing  this key brings up a dialog from which  you 
             can select any page from 1-20. After selecting a page 
             you will be taken straight to it. Wow.

tab:         Takes the cursor to the next pre-set tab position.

backspace:   Deletes  the first character infront of  the  cursor, 
             and places the cursor in that position.  The rest  of 
             the line is moved down one.

delete:      Deletes  the character under the cursor,  moving  the 
             rest of the line down one.

help:        Calls up the help text.  Please note that this option 
             is not very helpful.

Insert:      Puts  the  cursor  into  insert  mode  if  it  is  in 
             overwrite, and in overwrite mode if it is insert. The 
             current  status  is displayed on  the  bottom  status 
             line.

undo:        Can't remember what this does!  I know it's  something 
             non  standard.  Wait  a  minute......  Got  it!  This 
             deletes the current line the cursor is on.  Cannot be 
             undone once selected.

arrow keys:  The  usual.  Moves  the cursor at  break  neck  speed 
             around the screen.

clr home:    Force  screen  refresh.  Part of the  debug  options. 
             Forgot to take it out!  Not much use to  you,  unless 
             something odd happens to the screen.  Might be  worth 
             trying  then.  It  updates the screen with  the  text 
             stored in memory.

-:           Takes you back one page.

+:           Takes you forward one page.

enter:       Inserts a line at the current cursor  position.  Note 
             that  this is the enter key on the numeric  key  pad, 
             not the return key on the main keyboard.  The  return 
             key has the usual effect.

                           * THE END *

I hope that gives you a bit of an idea on how Diary works.  I must 
say that it didn't help me non!

There  are a few more bits and pieces which you will come  across, 
but  they are pretty simple to understand.  No doubt  you'll  work 
them out!

If  you  find this documentation of use,  then  it  was  completely 
unintentionally,  and  if  you send your copy back it  will  be  put 
right straight away.

                        * REALLY THE END *

People may contact me at the following, for bug reports, comments, 
etc:

       STUN BBS 061-429-9803 (One of the best BBS's ever!)

                                or

                            Jay Taylor
                         18 Knowles Road,
                        New Parks Estate,
                            Leicester,
                             LE3 6LU.


         * OK SO I LIED ABOUT IT REALLY BEING THE END! *


