#################################

          Prescribble

       (C)opyright 2001 
          by Kent Dahl 

       MenThal@bigfoot.com
 http://www.bigfoot.com/~MenThal/

   Released under the GPL 
    (Gnu Public License)

So release any changes you make,
keep part of the README unchanged
and mostly spread as you will.
      Use at own risk. 

##################################


Prescribble - a notetaking / sketchpad for the Agenda VR3 Linux
personal digital assistant (PDA)

 * "Prescribble: Just as illegible as the prescription from your doctor!"
 * "Prescribble: So hard to read, you'll need prescription glasses!"

Version: 0.09 (see doc/creationtime)

Contents:
- Usage
- Command-line options
- Contact
- Credits

______________________________________________________
* USAGE

Scribble whatever on the main area. You wrote it, you read it!

The lower part of the screen containts menus and buttons.
From left to right:

_____________
--> File Menu
  - Quit - exits program _without_ saving
  - Save As... - experimental dialog for saving to other name/place
  - Save - tries to notes to "prescribble.dat" in current directory.
  - New  - deletes all the notes 
  - Load - tries to load "prescribble.dat" from the current directory,
           or the last filename you selected when saving/loading.
                (may coredump if file not there)
  - Load From... - load any given file. 
  - About - blatant self promotion
  
_____________
--> Edit Menu
  - Clear    - removes everything on the current note 
                (try tapping "redo" alot if you suddenly regret it) 
  - Undo     - undoes last entered stroke (unlimited)  (Shift-PageUp) 
  - Redo     - redoes the last undoed stroke (limited) (Shift-PageDown)

  - Note ... -
    - Delete   - delete current note
    - Insert   - insert blank note at position
    - Append   - insert blank note at the end
    - Backward - move this note backwards in list (shift + left)
    - Forward  - move this note forwards  in list (shift + right)

  - Redraw   - refreshes your current note  

  - Mode...  -  
    - Delete - drag stylus/mouse drag towards lines you want
                to delete.
    - Erase  - drag stylus/mouse towards lines you want
                to erase. This isn't particularly effective.
                A better erase strategy is to use this mode to
                split up things you want to delete, and then use
                the delete mode to kill complete strokes.
    - Zoom   - experimental zoom mode. Drag a box over the area
                you wish to zoom in on. Tapping with the stylus
                or dragging a very small box, zooms back out.
                ( PageUp and PageDown keys are also connected
                to zooming functionality) 
    - Box    - draw boxes
    - Draw   - normal scribble mode

  - Undo     - undoes last entered stroke (unlimited) 
  - Redo     - redoes the last undoed stroke (limited)
  - New note - appends a brand new note to the end of the notebook
  - Redraw   - refreshes your current note  


_________________
Onscreen Buttons:

--> [|<-] Undo button
--> [->|] Redo button


--> [<-]  Previous note button (shortcut: Left key/button on Agenda )
--> [#/#] Current note number display: current/# of notes (also redraws)
--> [->]  Next note button (shortcut: Right key/button on Agenda )

________________________
Agenda Hardware Buttons:

--> Left / Right 
                - move to previous/next note in the notebook
--> Left / Right with Shift 
                - move this note backward/forward in notebook.
                  Will insert blank notes at extremeties of list.

--> Page Up/Down with Shift
                - Undo/Redo



______________________________________________________
* COMMAND LINE OPTIONS

-hl     horizontal guidelines on  (default)
-nohl   ----------"---------- off
-hs #   horizontal spacing in pixels (default: 15) 

-vl     vertical   guidelines on 
-novl   ----------"---------- off (default)
-vs #   vertical spacing in pixels (default: 15)

-r      point range (default=0)

-f [filename]   assign filename (default: prescribble.dat)

-auto           automatically load on startup, and save on exit

-maxredo #      maximal number of redo-actions stored (default: 16)

-eraserange #   how wide the erase mode should look for strokes     

-redrawless     turn on the old-style redrawing 
                (default now tries to be a bit more clever)

-ziphack        uses the shell to compress/decompress
                files with a name containing ".gz" using
                /tmp/prescribble.dat as temporary file
                ( /tmp/ is RAM disk on the Agenda so far )


______________________________________________________
* WEB SITE for Prescribble


 -* http://www.bigfoot.com/~MenThal/agenda.html#Prescribble 
        (major releases only)

 -* http://www.stud.ntnu.no/~kentda/public/agenda/#Prescribble
        (snapshot; i.e., whatever compiles)


______________________________________________________
* CREDITS

This progam would not have been possible without the aid of the 
community of Agenda VR3 users and developers.