DIARY version 1.5           ( 11/15/89 )
-----------------

New for Version 1.5
-------------------
1)  The biggie:  Edit ANY size file (up to 10 megs)!!!  (details below). 
2)  Increased text buffer size to 10K.
3)  Save block. 
4)  Allow appending to an existing file when saving.
5)  Non-Ascii character output (all 1-255 funny characters).
6)  Control character keyboard input (e.g., try typing ctl-H).
7)  Fixed bug in Find dialog that wouldn't let you exit with Return key.
8)  Fixed bug in file saving that could end up giving more than one file
  of the same name.  (In some cases the file wouldn't get closed properly).
9)  Various other small fixes and enhancements.

Details of the "ANY file size" feature:
---------------------------------------
Despite Diary's small (now 10K) text buffer size, it will now handle ANY
size file (up to about 10 megs), by loading in only the portion of the
file that you want.  Block zero is the first 8K block of the file, and
the dialog box will allow you to go up to a block starting at about 1K
from the end of the file, which would give you over 8K of free space to
add text to the end of the file.  When you go to save the file, Diary will
take care of stringing together the text from the original file with the
block of it that you editted to create a new file.  This means that it
won't let you overwrite the latest version of the original on disk, since
it needs that to create the new version to be saved.

Since you can only load an 8K block of a file that is bigger than 10K, it
will require more work to do some things, like doing a cut/paste from the
end of a big file to its beginning.  To do such a thing you would need to
first save the file after the Cut, then read in the other portion of the
file, and finally do the Paste.  In a later version I also plan to add an
Insert Text File feature, which will allow you to save a block bigger than
the paste buffer to disk and then insert it back into a different portion
of the file.

Some of the things I hope to add/fix in the future
--------------------------------------------------
1)  Make the desktop directory windows update themselves when a file is
saved from Diary.  For now you have to hit Escape after leaving Diary to
get the window updated.  (Just as is true with Universal Item Selector).

2)  Insert File.

3)  Fix the word wrap to leave 2 spaces after periods.

4)  Deal with files with other end-of-line characters (e.g., just LF).

5)  A bottom slider bar or some other means of dealing with lines too long
to fit in the window.  The other option would be to have the lines wrap 
at the right edge of the window without inserting a newline (CR/LF).

6) Maybe create my own sliders/arrows that repeat (the GEM ones don't
without TOS 1.4).

7)  It should be fairly easy for me to add the ability to view/edit any
user-chosen portion of the ST's memory.  This wouldn't be something most
people would be interested in, but it could be useful/fun.


New for Version 1.4      10/31/89
-------------------
1)  Print Block.
2)  Find (Search for) a string of text including end-of-line characters
    (carriage return = Control-M, and linefeed = Control-J).
3)  No more "double menu" if you move the mouse quickly across the Diary
    Menu to the desktop (or application) menu bar.
4)  Better handling of Help screens (no longer cares where you click).

New in Version 1.3           10/23/89
------------------
1)  Speeded up more of the text movement operations.
2)  The delete key now deletes into the paste buffer, so it can be undone.
3)  The undo key now works (for multiple character or line deletions,
    and block cuts, but not for multiple backspaces).
4)  Greater compatibility with Turbo ST. (highly recommended)
5)  Much improved (but not perfect) ability to deal with other windows
    being open and on top of the Diary window.
6)  No longer crashes if you exit from an application before closing Diary,
    (unless you do it from within the Help screens).
7)  Various other small bug fixes and enhancements.

New in version 1.2
------------------
1)  Full size window toggle
2)  Faster scrolling
3)  Block cut/paste

Notes on Block Cut/Paste and Delete functions
---------------------------------------------
The buffer that is used to hold cut blocks and deleted lines and
characters is not very large (1000 bytes).  Deleting a line (or multiple
lines in sequence) has the same effect as doing a block cut of them.  It
is similar to the Flash editor in that after deleting, you can paste it
back any number of times wherever you want.  So to do a block copy, you
first cut, then paste at the same location, and finally paste where you
want the copy to be.  The Undo key does the same thing as F5 (paste).

Text buffer size   ( 8K -- changed to 10K in v 1.5 )
----------------
I really tried to make the text buffer size configurable by the user, and
I  thought I'd succeeded until I noticed what was happening to the amount
of free memory any time I switched between low and medium resolution. 
For some reason, no matter what I did, TOS would not realize that I
wanted to free up a chunk of memory, and thus it would load Diary (and
any later accessories) on top of (higher than) the memory they were
already using.   This could quickly run you out of free memory, so I went
back to the old simple method.  Maybe in a later version I'll have
another go at it after getting some answers from those more knowledgable
than I.

Please see the last section of these docs for information on customized
versions and what you get for the $5 shareware registration.


Basics of version 1.1
---------------------
If you cover up the Diary window by clicking on a desktop or application
window, you can get back to Diary either by clicking on any visible part
of the Diary window (if any is still showing) or by going to the desktop
desk accessory menu and clicking on Diary as if you were opening it. 
However, I still don't recommend closing an application while you've got
the Diary window open.  Just be nice and orderly and close Diary first.

The other major addition is the funny/simple little drop down menu within
the Diary window.  The items don't highlight as in a normal menu, but the
menu goes away just by moving the mouse outside the menu without having to
click again.

Also, word wrapping now really does seem to work in all cases.  I should
explain the Turn Off/On button in the Wrap selection box though.  Diary
will ALWAYS word wrap when adding to the end of your text or when inserting
prior to the right edge of  the window.  However, with wrap turned off,
you can create lines longer than the window (no length limit).  This can
be done by any of the following methods.

(a) deleting the 'cr' at the end of a line and thus bringing the following
    line up to the end of that line,
(b) backspacing from the start of a line, or
(c) inserting anywhere in a line prior to the right edge of the window.


Intro for those new to Diary
----------------------------
You can always hit the Help key or use the drop-down menu if you don't
know what you're doing.

This program is simply a text editor accessory that opens up a half-screen
window which you can move up or down on your screen, and toggle between
full and half size.  It has no special diary functions (yet) other than
being there when you want to jot something down.  Versions before 1.5 are
limited to 8K of text, which it allocates all at once when you boot up. 
Any text in the buffer stays there until you Clear it or reboot,
regardless of whether you have the Diary window open.  Diary deals
STRICTLY in text with the standard CR/LF at the end of each line.  It only
displays the 'cr' but the line feed is still there.

If you have any lines longer than what will fit in the window, it simply
displays a big right arrow at the end of the line to indicate that there's
more text there.  If you need to do something with that extra text, you
can either tell it to Wrap from that line forward, or just insert a Return
somewhere in the line to force the rest onto the next line.


Something for Everyone
----------------------
Incidentally, if you find yourself using this on any sort of regular
basis, it is shareware, and I'd be most appreciative of something in
return.  For example, for the $5 registration I would gladly provide custom
versions with whatever buffer size you desire or different ALT-key and
function key assignments.  Registration will also get you more complete
documentation, if you request it.  I am also very interested in suggested
improvements, bug reports, etc.  Further improvements are occurring 
(e.g. the ability to insert a file), and registering will reward you with
a later version than is available for download (and it won't have the alert
box telling you to register from the Help screens).

The Modula-2 source code for the initial version exists as a different
file earlier in the ST downloads, and I'd happily provide source to this
and later versions to any registered user.

Feel free to distribute Diary to friends, BBS's etc, but please also
include this documentation file. 

DIARY.ACC version 1.5, copyright 1989 by

Craig Harvey

GEnie:      c.harvey
CompuServe: 73047,600

Clear Thinking, BBS: 313-761-2444    P.O. Box 715  Ann Arbor, MI  48105


THANK YOU  ( People who have registered.  Who will be next ? )
---------
James Kleiser
James Conway
Robert Wenham
