OgEdit.geo      Version 1.02

OgEdit:  Geos Text Editor For the OmniGo 100
         http://www.usa.net/~schuler/pub/ogedit.zip

Author:  RC Schuler

                02/20/96        first drop V1.0
                02/22/96        V1.01, improve file selector interface
		04/29/96	change inet address. NO FUNCTIONAL CHANGE.
		05/18/96	V1.02 add 'File not saved' warning

Other OgWare programs:
	OgComm - Modem Communications Program
	OgFile - File Manager

Things to do:
 - make 'find next' control non-modal
 - search from cursor
 - book marks

Installation:

 o Copy ogedit.geo to \geoworks\world

Using the File Selector:

   The file selector is not as intuitive as it should be.
   Follow these guidelines when selecting files to open or save.
   - always use the file selector to choose the desired directory
     use the "OPEN" button to open a sub-directory, and use "UP DIR"
     for the opposite.
   - if the file exists, select it in the file selector and click "OPEN"
     or "SAVE".
   - only use the "New:" text entry field when you wish to
     create a new file.  In this case, FIRST SELECT THE SUB-DIRECTORY
     WITH THE SELECTOR by highlighting its name.  In the "New:" entry
     field, you add a RELATIVE pathname to what the directory you
     selected.  For example. to create a file in \geoworks\document
     called tmp.txt,  use the selector to highlight the directory
     named DOCUMENT.  Then replace the text in the "New:" entry field
     with "tmp.txt".  IMPORTANT:  File names must adhere to the DOS
     8.3 file format.  (maximum 8 chars in name, with no spaces, followed
     by up to three chars of extension.  i.e. 12345678.123)

   You can view the name of the current file in the editor by
   selecting the menu item 'View->File Name'.  Note that full DOS
   pathnames will NOT be shown on files in the standard GEOS filesystem.
   For the example above, the 'View->File Name' option would show:

        (DOCUMENT):
          \tmp.txt     512 bytes

   Which physically corresponds to: \geoworks\document\tmp.txt on
   the omni.  The same is true of other system directories on the
   OmniGo (GEOWOKS, SYSTEM, DOCUMENT, WORLD)

   Note that on the OmniGo file selector, the parent directory does
   not show a name.  Therefore, selecting the top selector location
   (which is blank) corresponds to selecting the parent of the
   listed sub-directories.  For example, to save a new file in the
   root directory of your B: drive:

        - select menu item 'File->Save As'
        - click "Up Dir" until you are at the top of the filesystem
        - position the selector bar ABOVE the top sub-directory entry
          (probably above GEOWORKS on the OmniGo)
        - replace the words "(New Filename)" in the text entry field
          with your new file name.  (i.e. tmp.txt)

   Using menu item "View->File Name" from this example would show:

        Non-Geos:
          \tmp.txt     512 bytes

   If the file is NOT in the Geos filesystem, (Geoworks directory and
   its children) "View->File Name" will show the absolute path and file
   name from the root directory.

Implementation Details:

   OgEdit attempts to minimize system resources required
   for processing large ascii files.  'Chunks' of the required
   file are dynamically added to memory, as needed.  By using the
   control 'Options->Large Chunk' and 'Options->Small Chunk'
   you can trade off speed, vs system resources.  The default,
   'Large Chunk' should be sufficient for all but the largest
   files you edit.

   One of the performance trade offs I chose for the search routine,
   allows a small probability that a search key will be missed in
   one 'Chunk' setting.  Assuming a 5 character key searching
   a 20K file, the algorithm has a .04% chance of a miss.
   If you suspect a search has missed your key, use 'Options'
   and select the alternate 'Chunk' mode.  The chance of a miss
   in both modes is orders of magnitude smaller.  The larger the
   file, and the smaller the key, the less chance of error.
   I have yet to have a search miss in normal use.  I would be
   interested in your feedback regarding this matter.


Motivation:

   OgEdit is a simple text editor for the the HP OmniGo 100 (OG).
   The program has also been tested on Desktop GEOS.  I believe
   OgEdit to work on the Zoomer, but I haven't tested this.

   OgEdit was developed using the Geos 2.0 SDK.  Since Geos has
   released a SDK targeted for the OG, there may be problem fixes,
   or enhancements I cannot provide.  I have no intention on spending
   another $100 for the OG SDK.  If you feel strongly about problems
   which can only be corrected with the OG SDK, buy me one for Christmas.

   OgEdit is Freeware.  I am developing OgEdit because I have not found
   a better alternative for my own use.  The motivation for
   releasing OgEdit to the internet community is two-fold.  1) repay
   the many folks who continue to provide free advice in the various
   newsgroups and mail lists I follow.  2) encourage the development
   of other Freeware in the GEOS/PDA environment.  Source code will
   be available when the program is further along.

   There is no list of bugs or limitations in this release.
   I will put one together from use feedback, when time allows.
   You use OgEdit entirely at your own risk.  If this code causes you
   any grief or frustration, whimper quietly to yourself and don't
   disturb others.

Conditions for use:

   To keep and use OgEdit, you must agree to do so at your own risk.
   You must agree to hold Ray Schuler harmless for any and all
   damages, monetary and otherwise.  OgEdit may not be used to
   conduct illegal, or hateful, activities on any internets, public
   or private.  In general, just be a good person.

   You may not sell OgEdit, or include OgEdit in any for profit
   venture without the author's permission.

   OgEdit, as with most GEOS programs I write, makes much use
   of the GEOS 2.0 SDK examples.  Rather than figure out which
   portions were lifted, I'll just say:

    "Portions of this program are Copyright (c) Geoworks 1993, 1994
     and used by permission."

    (note, the (c) is a true copyright symbol, it just looks
     like a (c) to the untrained eye...)


If you have questions or comments, feel free to contact me by way
of schuler@usa.net.  Keep in mind that I develop GEOS programs
for my own use, and not for profit.  I may not be able to respond
in a timely fashion.

Best Regards,
Ray Schuler
schuler@usa.net


