                     
 |*| EDEN: EDitor |*|
 |*| ENvironment! |*|
 |*|  v2.0 G(X)  |*|
 |*| HPFox 96/97 |*|

                   []
* Warning

 Reading this doc is
 just INDISPENSABLE
 to even use only 
 1% of EDEN's
 possibilities which
 would be a real
 shame!
                      
 So, if you have   
 enough memory, keep  
 it in its original   
 dir: do not give     
 EDEN without its doc 

* Description

EDEN is the first...
 _ multi-font
 _ multi-file
 _ multi-attribute
 _ ...
...Editor/Viewer !

 Much more than just
 an Editor, EDEN is a
 real word processor,
 filled with all you
 might expect from
 such a utility, plus
 many other features
 that make it a tool 
 one should never get 
 rid of.

 To quickly learn how
 to properly use this 
 software, I suggest
 that you work on
 understanding
 the way this doc was
 made and that you try
 each function while
 reading it.

* EDEN's Argument(s)

              2:String
 1: Object or 1:   Hex

 Note 1:
 #Hex is a Binary
 matching the
 following syntax :
 #cccccbbbbbaaaaa h
 defining the entry
 parameters into EDEN:
 _ aaaaa: starting
   position in the
   text.
 _ bbbbb: position of
   the beginning of
   the selection.
 _ ccccc: size
   of that selection.

 Note 2:
 You can also run EDEN
 wihtout anything on
 the stack. In that
 case, a new file will
 be open.
 If you want to create
 a string, make sure
 you first input
 string delimiters,
 otherwise your typing
 will be considered as
 a program and not a
 string.

 Note 3:
 I included the BZ
 decompressor inside
 EDEN, so that you can
 give EDEN BZ
 compressed arguments.
 Their handling is
 automatic, which
 allows you to save as
 much memory as the 
 string uncompressed,
 which is a more than 
 just a small gain.

* EDEN.INI Variable

This optional variable
lets you customize
EDEN as you wish.

This variable is
made of a list of one,
two, or three
programs.

The first program is
necessary if you
decide to create
EDEN.INI. It's to be
executed when giving
EDEN anything but a
string as an argument.

Thus, if you use the 
DEV-LIB (lib1797),
put { S } into
EDEN.INI, if you use
the Meta-Kernel, put
{ S2 } or { S4 }
into EDEN.INI.

By default, EDEN
uses the HP's STR.

If you like, you can
also add in second
position in the
EDEN.INI list a
program to be executed
BEFORE each edition.
And in third position,
a program to be
executed AFTER each
edition.

 Exemple for EDEN.INI:
 { S2
    "Hello!"
     1 DISP 1 WAIT 
    "See you soon!"
     1 DISP 1 WAIT  }

* Syntax Error(s)

 In case of a Syntax
 Error, after editing
 an object other than
 a string EDEN places
 the cursor on the 
 error, just as the 
 HP internal editor 
 would.

* Changing the Font

 You can store your
 own font in the
 'FONT' variable
 (GROB 6*2048,
 7*2048 or 8*2048),
 but it's not 
 necessary as EDEN
 recreates its own
 Font for each use.

 Note: The 'FONT'
 variable is evaluated
 if it exists, so it's
 enough to specifiy
 the path of your
 font, for instance:
  :0:Fonte6 RCL ,
 but you could as well
 compress it !

* EDEN's flags

These are actually
entry parameters
in EDEN.

 1  Default font
CF: User's font
SF: Minifont

 2  Default mode
CF: Editor
SF: Viewer

* EDEN's modes

 EDEN provides three
 combinable modes :

 _CST =Switch between:
   * Minifont
   * User's font
 _VAR =Switch between:
   * Viewer
   * Editor
 _RS+CST
      =Switch between:
   * Normal speed
   * Fast speed

* The Viewer's Effects

Inside the viewer you
can use the following
attributes:
_Chr(11)+I: Invert
_Chr(11)+U: Underline
_Chr(11)+/: Italic
_Chr(11)+B: Bold

 Notes:
 _Bold isn't available
  with the Minifont.
 _All attributes are
  combinable.
 _Chr(11) can be
  obtained pressing:
  [PRG]+[1]+[1], in
  the editor.
  (see paragraph:
  Edition Functions)

* EDEN's functions

 For the rest of this
 doc:
 RS = Right Shift
 LS = Left  Shift

*  Edition Functions
 _RS+DROP=Erases all
  character between
  the curseur and the
  beginning of the
  line.
 _LS+   =Page Up
 _LS+   =Page Down
 _LS+   =Caps Lock
 _PRG    =ASCII Chr:
  This key is
  customizable:
  Hold PRG and
  type the decimal
  character's number.
  The chosen number is
  memorised so that
  you'll only have to
  press PRG again to
  insert another one..
  By default, this chr
  is Chr(11), which is
  useful to create
  effects.
 _LS+7   | Accents...
  LS+8   | Just as
  LS+9   | in the
  RS+7   | internal
  RS+8   | editor of
  RS+9   | the HP.

*  Special Functions

 _RS+ON  =OFF
  Switches the HP off.
   Note: This is a
   real OFF, using the
   HP's routines. Just
   a bit improved,
   though.
   Thus, you won't get
   any bug, even if
   you use a card in
   port 2 or an
   unprotected one...
 _Changing the
  contrast:
  Press [ON] and,
  still holding,
  press [+] or [-].
 _If your batteries
  are weak:
  EDEN will tell you
  thanks to the (())
  indicator. (Warning)

*  Titles Searching

A title is a line
beginning with *.

 _MTH =Previous Title 
 _NXT =Next Title
 _EEX =TitlesTable
  (labels).
  The first titles are
  displayed.
  Press EEX again
  To show the next
  ones.
  To go to a title's
  position, type the
  number that
  precedes it.

*  Cut-and-Paste

 Cut-and-Paste Menu:

 _Begin
  Starts Selection
 _End
  Ends Selection
 _Cut
  SelectionClipboard
  & Erase Selection
 _Copy
  SelectionClipboard
 _Paste
  ClipboardText
 _Del
  Erase Selection

 Functions about
 the selection:

 _LS+Begin or LS+End
  Selects the current
  word.
   Note:
   A word is a set of
   chrs delimited by
   spaces or CRs.
 _RS+Begin
  Moves the cursor to
  the first chr of
  the selection.
 _RS+End
  Moves the cursor to
  the last chr of
  the selection.

* Main Menu

At any time, to show
the menu, press RS+NXT
You access in the same
time information about
the text being edited.

Some functions are
accessible through
that menu :

*  Save

You can save the 
current text, without
having to quit the
environment, just by
pressing RS+VAR or by
choosing Save in the
menu.

This proves especially
interesting when
editing a variable:
the file is instantly
stored again, but it
also works when
editing a file on the
stack.

*  Open

To edit another file,
press LS+[+/-] or
choose Open in the
menu.
The list of files in
the current directory
is displayed.
Choose the new file
with [] and [] and
press [ENTER] to edit
edit it without a way
back or [] to have
EDEN resume afterwards
to the file you were
previously editing.

EDEN will then ask
you, if necessary,
whether you want to
save the current file.
It will then edit the
new file...

 Note 1:
 You can also browse
 directories:
 _ [ENTER] or []:
   Enter a directory.
 _ []: UPDIR.
 Directories are 
 indicated by an
 arrow before their
 name.

 Note 2:
 EDEN spontaneously
 stores the variable 
 you're editing into 
 the proper directory.
 It is therefore
 possible to edit 
 files from different
 directories without
 the slightest 
 problem!

This allows you to 
edit as many files
as you wish at the
same time and to use 
cut and paste between
different texts... All
this in the easiest
possible way!

You'll get to see that
handling the minifiler
is really intuitive.

*  Hypertext

This function might
prove extremely
useful when
programming (in RPL or
in ASM) as well as
when wishing to write
structured docs:
you could associate a
word with its
definition!!! Or you
could create links
between the docs...
  Possibilities  are
        really
     phenomenal..

This is very similar
(but much simpler) to
what you can see on 
the web: if you come
across a sequence such
as:
'File_Name
Move onto the ' with
the cursor and press
RS+[+/-]. EDEN then
searches the name in
the variables, and if
it finds it, it edits
the file.

After a HyperText link
EDEN resumes to the
file it comes from
saving your
parameters, the
screen position...

 Note: File_Name is a
 Global Name ending
 with a space, a CR,
 or a '.

*  Find & Replace

 _LS+MTH =Find pattern
 _RS+MTH =Replace

 Menu Find/Replace:

 _Next
  Find Next.
 _Repl
  Replaces found
  string by what you
  chose in replace.
 _R/N
  Replace and Next.
 _All
  Replace all
  You can stop it
  pressing ON.

  Note: At any
  time, to go back to
  the cut-and-paste
  menu, press LS+NXT.

 _Wildcard:
  That's a kind of
  universal chr that
  replaces any other.
  I chose chr(0). To
  insert it, press PRG
  and, still holding,
  press 0.
  You could also use
  the ASCII table,
  pressing RS+PRG.

 Note: Find is
 also accessible from
 the viewer, which is
 rather useful to find
 your way through a
 doc! All you need to
 know is that Next is
 assigned to the [A]
 key. And don't
 hesitate in using
 wildcards!

*  ASCII Table

 RS+PRG =ASCII Table:
   :Move amid the
        characters
   ON  :Return to the
        editor
 ENTER :Insert the
        selected chr
        in the text
  CST  :Switch between
        Minifont and
        User's font.

Not available in the
Viewer mode, as you
couldn't write in that
mode, anyway.

* Return to RPL

 _ENTER = EXIT + SAVE
 _   ON = Quit ? [Y/N]
     Y = EXIT
            + Old Text
     N = CANCEL

 Note:
 If the text is
 unchanged, EDEN
 exits without 
 confirmation.

* Program's goal

My goal was to create
the...
 * fastest,
 * most powerful
 * most practical
 * smallest and
 * most user friendly
lib ever made for docs
and programming...

* Credits

Thanks to JrmieK,
fde, Mika Heiskanen
(BZ) and to all
 PULSAR  Users
for their ideas, their
comments, and above
all, for their
patience...
Special thanks to JMZ
for his help during
debugging, and for
his numerous ideas.

* Contacts

 PULSAR  : 01-45456533
 RTC-ONE : 01-48701029
    Mailbox: HPFox  

  Greatings to all   
  RTC-ONE and PULSAR 
  adepts as well as  
  to the SAINT-LOUIS 
  lycee.             

  PS: Cheers to anyone
 who'll try hacking
 this lib !
                     
 |*|  HP FOREVER  |*|
 |*|  HPFox 97  |*|
 |*|  Translated  |*|
 |*|      by      |*|
 |*| HpTroll  98 |*|