Everest

============================================================================

                                E V E R E S T

                   The simple and genial GEM Text Editor.
      Compatible with all Atari 680x0 computers & all graphic cards

============================================================================

Disclaimer

Every effort has been taken to ensure the information in this file is 
correct but you use the program entirely at your own risk!


1.  Introduction
    1.1 Files and file structure
        a) INF File
        b) File Lists (LIS)
        c) Abbreviation Files (KRZ)
    1.2 Getting Started with EVEREST.PRG

2.  The Menus
    2.1 Everest
    2.2 File
    2.3 Block
    2.4 Search
    2.5 Window
    2.6 Parameters
    2.7 Info

3.  Keyboard
    3.1 How to change the shortcuts
    3.2 Keyboard commands

4.  Dialogs

5.  AV protocol

6.  Versions

7.  The Shareware principle
    7.1 Distribution conditions
    7.2 How to register
    7.3 Everest UK Support and Registration
    7.4 UK Update service

****************************************************************************
1.0    I N T R O D U C T I O N
****************************************************************************

Everest is a easy to learn ASCII text editor. Listed below are just some 
of the tasks Everest can assist you with:

- programming
- text entry prior to further formatting through other programs (eg TeX)
- editing configuration files without changing the existing text format
- writing batch files


Everest offers the following features:

- runs with all Atari 680x0 computers and with all known graphic cards
  (apart from ST low resolution (320*200))
- fast scrolling on all models, with or without the blitter
- no cursor overrun (or similar annoying glitches)
- standard GEM interface
- Turbo C Editor compatible keyboard shortcuts
- capable of loading large (>300Kb) files without problems
- almost every command can be controlled via the keyboard, drop down menus 
  or dialogs (even block marking!)
- enables the use of GDOS (mono-spaced) fonts, provided GDOS (or GDOS 
  replacement such as NVDI) is installed. (The fonts supplied with Gemini
  are particularly recommended)
- no external RSC file, so Everest is well suited to residing outside 
  folders on the root directory
- Everest employs dynamic memory allocation to leave the maximum possible 
  memory for other applications. Ideal for multitasking environments and 
  accessories
- Hard tabs
- GEM Clipboard support
- Turbo-C Help Accessory and 1STGUIDE support
- up to 10 active files. Although most TOS versions only support 7 windows 
  various utilities are available to increase this limit.
  (WINX is recommended)
- Wildcards
- File Lists
- Abbreviations


1.1 Files and file structure
============================

Everest is suited for editing standard ASCII files. The line ending is 
defined by the code 10 or the codes 13,10. Maximum line length is 300.
Unfortunately it is not possible to edit files that contain Null 
Characters, i.e. characters with ASCII Code 0. Everest allows an 
alternative character to be specified to replace the Null Character.

To use Everest only the file EVEREST.PRG is needed, however the following 
files make Everest even easier to use:

a) INF File: EVEREST.INF
   Everest creates or updates this file using the 'Save setup' option from 
   the 'Parameters' drop down menu. EVEREST.INF contains all configurable 
   parameters from the 'Parameters' drop down menu with additional 
   Search/Replace, printer and window position parameters. After 
   registration your name and key is can also be saved in the INF file.
   
Important!
   Distribution of an INF file containing registered user details is NOT 
   allowed! Please be careful if you re-distribute your copy.
   
   If you want to return to Everest and find everything exactly as you 
   left it use 'Save setup' to create or update EVEREST.INF.

b) File lists: EVEREST.LIS by default
   A file list is a standard ASCII file that should have the extension LIS.
   Each line has the following structure:
   
          
    =
   
   , , ,  are the window coordinates, 1000 is maximum screen 
   width/ height.
    is the number of the function key you have to press to 
   top the corresponding window.
    is the number of the function key you have to press to 
   jump to this label.
    is the line number the label points to.
   = can to be repeated if there's more than 
   one label set for this file.
   
   These parameters may be omitted beginning from the right.
   If a file list is created with Everest, the names of all currently 
   loaded and named files and the window layout is written to this list. So 
   you can easily save and restore complete working layouts with several 
   file lists.

c) Abbreviation files: EVEREST.KRZ by default
   An Abbreviation file is a standard ASCII file in which contains each 
   line contains a definition of frequently used words. Abbreviations files 
   are case sensitive and defined as follows:

1) Simply type in the word to be abbreviated.
   Example: The Abbreviation file contains the line 'Something to 
   abbreviate'. If you type 'Some[Esc]', then Everest expands this to 
   'Something to abbreviate'. If there are no other lines beginning with 
   'S' then even 'S[Esc]' will be expanded to 'Something to abbreviate'.
   Everest takes the word to the left of the cursor as the word to search 
   for an abbreviation. For example 'Something to[Esc]' will not be 
   expanded, because the word 'to' determines the abbreviation. If the 
   abbreviation is too short the abbreviation may have more than one 
   possible expansion. Everest will search in alphabetical order and use 
   the first (legitimate) expansion it finds.

2) The abbreviation may be different from the expanded form, in which case 
   the '=' equals character is used. Example: The Abbreviation file 
   contains the line 'stoa =Something to abbreviate'. If you type 
   'stoa[Esc]' or 'st[Esc]' this will be expanded to 'Something to 
   abbreviate'.

Using the '~' tilde character it's possible to determine the cursor 
position after expansion, here's an example: The Abbreviation file 
contains the line 'writeln(~);'. Type 'w[Esc]' to expand to 'writeln();' 
and you will find the cursor positioned between the 2 brackets.

Use the "=" equals character to define abbreviations with line feeds. 
Here's an example: The abbreviation file contains the following lines:

if=IF (~) THEN BEGIN
  =  
  =END

After typing "if[Esc]" you will get:

IF () THEN BEGIN
  
END

with the cursor inside the brackets. Each abbreviation can contain up to 
a maximum of 1000 lines.

Word separator characters like "-.,:;_[} can not be used within an 
abbreviation. But there's an exception: At the end of an abbreviation it's 
possible! So you can define the following abbreviations:

test.:.,)(
t{=test{~}

If you type "t{[Esc]" this will be expanded to test{} with the cursor 
between the two brackets. If you type "test.:.,[Esc]" or "test[Esc]" both 
will be expanded to "test.:.,)(".

It's also possible to use abbreviations that are not defined. If you type 
the [Esc] key after typing the beginning of a word that is not a defined 
abbreviation, Everest searches the actual text if there's a word with the 
same beginning. If so, then this word is taken for expansion.


1.2 Getting Started with EVEREST.PRG
====================================

If you are using an unregistered version, a dialogbox appears, offering 
you a chance to enter you registration details. After registrating and 
saving the INF file this dialog will no longer appear on starting Everest.

Everest can be called from a command line or a shell. Additionally (using 
Gemini or NeoDesk for example) several files can be 'drag & dropped' onto 
the Everest icon for automatic opening and editing. Optionally the line or 
line/column position for the cursor can be passed as parameters. (The 
first line/column position has the number one, zero is interpreted as 
one).
To search for a file Everest uses the GEM function 'SHEL_FIND', and takes 
into account the actual entry in the 'PATH' environment variable.
If 'EVEREST' is defined as an environment variable Everest will search this 
path for its configuration file EVEREST.INF.
If 'EVEREST' is not defined as an environment variable Everest will search 
the path defined under the 'PATH' environment variable, using 'SHEL_FIND', 
for its configuration file EVEREST.INF.
The file EVEREST.KRZ will also be searched for in the same directory as 
EVEREST.INF and if found will be used as default Abbreviation file.

If the command line does not specify a file to load EVEREST.LIS will be 
searched for and used as the standard file list.
If there is only one file with the extension LIS in the command line this 
file will be taken as the standard file list (instead of EVERST.LIS).
If you quit Everest automatically saving the standard file list, then this 
file is used.

Problems:
If Everest doesn't find its INF, LIS or KRZ file at the program start, the 
TOS searches for these files (SHEL_FIND). But older TOS versions take A: as 
boot device and not the hard disk. So a bad PATH environment for the GEM is 
created. The problem is, that 'SHEL_FIND' wants to look at drive A, even if 
there's no disk in.
All problems will vanish if you save EVEREST.INF and an (empty) file list 
EVEREST.LIS at the directory where EVEREST.PRG is installed (In Everest 
>=2.4 you also should save an (empty) EVEREST.KRZ). Another possibility is 
a better harddisk driver or an AUTO folder program that installs a correct 
PATH evironment before the GEM is installed.


****************************************************************************
2.0    T H E   M E N U S
****************************************************************************

Nearly all commands offer keyboard shortcuts. These are shown on the right
in drop down menu commands and as underlined characters in dialog and
alert boxes.

2.1 Everest
===========

-About Everest
  A dialog box appears containing the copyright message and version 
  number. Select 'Info' to display the registration dialog and your 
  personal key details. This dialog box is the same as the dialog 
  displayed after starting an unregistered version of Everest.
  After entering your registration details the file selector appears which 
  can be used to save your details in 'EVEREST.INF'. This registration 
  method means that (unless the INF file format is changed) you can use 
  your existing INF file with Future Everest releases.
  
  
2.2 File
========

-New ([Control]+N)
  A new untitled file is opened in memory. The first time an untitled file 
  is saved a proper filename must be entered via the file selector.

-Open ([Control]+O)
  The file selector is appears and after selecting a filename the text is 
  loaded into memory. If the loaded file is not in ASCII format the 
  display may well contain garbage characters!

-Merge ([Control]+M)
  The file selector appears enabling an existing file to be selected and 
  merged into the existing text. If a block is marked, it's replaced by 
  the merged text.

-Close ([Control]+U)
  If the text has been changed a dialog box appears offering a last chance 
  to save the text before it is removed from memory. If the text is 
  unchanged the file is immediately closed and removed from memory.

-Save ([Control]+S)
  The text is saved under the filename and path shown in the window title 
  bar. The window remains open so that the file can be further edited.

-Save as ([Control]+M)
  The file selector appears enabling a filename and path to be entered. 
  After saving a dialog box appears from which either the original or the 
  new filename and path can be chosen for the name of the file being 
  edited.
  If a block is marked a dialog box appears offering a choice between 
  saving the entire file or just the marked block.
  If the file already exists, a warning message appears and you can decide 
  whether to overwrite the existing file or cancel the operation.

-Cycle windows ([Control]+W)
  Each window in turn becomes the topmost window.

-Save changes ([Shift]+[Control]+S)
  Saves every changed file. Untitled files are not affected.

-Close all ([Shift]+[Control]+U)
  Each window is closed. To define the handling of changed files, use the 
  Program exit parameters option.

-Print/Printer parameters ([Control]+P)
  Use this option to print the text in the active window. Before printing 
  or if no window active, you can change the printer parameters:
  Convert Atari 'ž' to IBM 'ž'; when enabled (crossed) this option enables 
  the 'ž' character to be printed in IBM compatible printer modes.

  Send page break after specified number of lines; when enabled (crossed) 
  page breaks will be generated by Everest, many printers with sheet 
  feeders don't need this option.
  
  Send formfeed after end of text; when enabled the paper is ejected after 
  printing.

  Left margin width; by entering a number of space characters before each 
  line it is possible to move the left margin to the right as desired.
  If a block is marked a dialog box appears offering a choice between 
  printing the entire file or the marked block only.
  
-Quit ([Control]+Q)
  If all open files are unchanged Everest will quit. Edited files are 
  handled according to the parameters set in the 'Program exit' menu 
  option.
  You can also quit the editor via [Control]+Numeric keypad. All changed 
  files will be saved and Everest sends the return code to the program that 
  invoked Everest.


2.3 Block
=========

The block function follows the widely adopted Cut, Copy, Paste principle. 
This works as follows, a text block is marked (block marking methods are 
explained later) and displayed in reverse video. Using the Cut or Copy 
options from the 'Block' menu places the marked text into block memory 
where it is stored until the next time the Cut or Copy command is used. 
Text stored in block memory can be inserted into the text at the cursor 
position using the Paste or Copy commands.

Block marking methods:

a) Using the mouse;
  Position the mouse over the desired starting point for the block then 
  click and hold down the left mouse button. Move the mouse to the desired 
  end point for the block and release the mouse button. The marked block 
  will be displayed in reverse video. If you move the mouse over the window 
  border the window will automatically scroll in that direction.
  
  If a block is already marked the start/end positions of the block can be 
  easily changed. Hold down either [Shift] Key and click using the mouse on 
  the desired new block start/end position. The text between the new 
  position and the existing start/end position is now shown marked in 
  reverse video.
  
  Another method of marking a block is to position the cursor at the 
  desired start/end point and holding down either [Shift] Key click the 
  mouse on the other start/end point. The text between the cursor and the 
  mouse position will be marked and displayed in reverse video.
  
  Double click on any bracket ({[]}) and the text between this bracket and 
  it's matching opening/closing bracket will be marked and displayed in 
  reverse video. If no matching bracket is found no text will be marked and 
  the error bell will sound.
  
  Double click on any word and the word will be marked and displayed in 
  reverse video.

  Important!
  If a line containing a configured error message (refer to Chapter 2.6 for 
  a detailed explanation of error messages) is double clicked on, it is not 
  marked but instead the corresponding error location is jumped to.
  
  Triple click to mark a paragraph. The paragraph's ending is defined in 
  the 'Formatting parameters' menu. You can also double click whilst 
  holding the [Control] key down instead of triple clicking.

b) Using the keyboard;
  Pressing [Control]+A positions the block start point at the cursor 
  position and enters block marking mode. The cursor is moved to mark the 
  desired text, which is displayed in reverse video. All the commands which 
  reposition the cursor are available, the arrow keys, keyboard shortcuts 
  and drop down menu options (eg. the 'Search', 'Go to label' and 'Go to 
  line' options). The window automatically scrolls in the appropriate 
  direction to display the cursor. Normal text entry is temporarily 
  suspended in this mode. Pressing [Control]+A a second time exits block 
  marking mode. [Control]+I also selects the word at the actual cursor 
  position.

c) Using the keyboard and mouse in combination.


Commands:

-Delete & Delete line ([Control]+Y)
 Deletes the marked block. If no block is marked, the line the cursor is 
 on is deleted.

-Cut & Cut line ([Control]+X)
 The marked text block is removed from the active window and stored in the 
 block memory. If no block is marked the line the cursor is on is cut.

-Copy & Copy line ([Control]+C)
 The marked text is copied into the block memory. If no block is marked the 
 line the cursor the cursor is on is copied into block memory.

-Paste ([Control]+V)
 The text stored in the block memory is inserted at the cursor position. If 
 a block is marked the contents of the marked block is deleted and replaced 
 with the text stored in the block memory. The block end point is 
 automatically adjusted and remains marked and displayed in reverse video.

-Paragraph format ([Control]+Z)
 The marked block will be formatted as a paragraph. If no block is marked 
 then the paragraph at the actual cursor position is taken. The right 
 margin can be defined in the 'Formatting parameters' menu with the option 
 'Word wrap/line length'. The second line of a paragraph defines the left 
 margin.

-Indent left/right ([Control]+J or K)
 Moves a marked block left or right. [Control] over indentation is provided 
 in the 'Formatting parameters' option in the 'Parameters' menu. This 
 option is of particular benefit to programmers and comms users.

-Set block start ([Control]+A)
 Activates block marking using the keyboard. The cursor is moved to mark 
 the desired text, which is displayed in reverse video. All the commands 
 which reposition the cursor are available, the arrow keys, keyboard 
 shortcuts and drop down menu options (eg. the 'Search', 'Go to label' and 
 'Go to line' options). The window automatically scrolls in the appropriate 
 direction to display the cursor. Normal text entry is temporarily 
 suspended in this mode. Pressing [Control]+A a second time exits block 
 marking mode.
 It's obviously not sensible to select this option using the mouse and is 
 only included for completeness. It does however, serve as a reminder of 
 the keyboard shortcut!

-Select word ([Control]+I)
 The word under the current cursor position is marked as a block. Typing 
 [Control]+I twice automatically opens the 'Search' dialog with the 
 selected word ready to use.


2.4 Search
==========

-Search ([Control]+F)
 Attempts to find a character string (maximum 43 characters) within the 
 active window. A dialog box appears into which the search character string 
 is entered.

 Parameters:
 Direction; the search direction can be either forwards or backwards from 
 the current cursor position. If the search fails and the start/end of the 
 text is reached the direction is automatically reversed if the 'Auto 
 reverse search direction' option in the 'Screen elements' dialog is 
 enabled.

 Match upper/lower case; when enabled (crossed) the case of the search 
 string will be matched, otherwise the case of the search string is 
 ignored.

 Whole words; this option is useful to find, for example, a variable 'i' 
 within your program source code. Using this option Everest ignores all 
 occurrences of the letter 'i' within other words. If this option is 
 enabled it's not possible to find a string consisting of two or more 
 words. For example, 'test.test' will not be found, because the '.' 
 character is recognised as a word seperator.
 
 You can use the wildcards '*' and '?'.'*' represents any text string (the 
 string may even be empty), '?' represents any single character. Example: 
 If the 'Wildcard' option is enabled a search for 'Abc*defg?hi*jkl' finds 
 'Abcdefg1hi123jkl' and 'Abc123defg1hi123jk456jkl' but not 'Abcdefghijkl' 
 or 'Abc123defg1hi123jk456jk'. In contrast to all other dialogs 'Cancel' 
 does NOT discard all the changes made in the dialog box. 'Cancel' in this 
 context means 'leave the dialog without searching'.

-Search again ([Control]+G)
 Attempts to find the character string previously entered and searched for 
 using the 'Search' option (above). The search proceeds from the current 
 cursor position using the 'Search' option parameters. The search is halted 
 when the start/end of the document is reached and if the 'Auto reverse 
 search direction' option in the 'Screen elements' dialog is enabled the 
 search direction is automatically reversed in the 'Search' dialog. To 
 continue the search in the opposite direction re-select this option.

-Search selection ([Control]+I)
 Attempts to find the character string (50 significant characters) marked 
 using the mouse. The string must be contained on a single line. The first 
 50 characters of the string are automatically entered into the 'Search' 
 option and the search proceeds from the current cursor position using the 
 'Search' option parameters. The search stops when the start/end of the 
 document is reached and if the 'Auto reverse search direction' option in 
 the 'Screen elements' dialog is enabled the search direction is 
 automatically reversed in the 'Search' dialog. To continue the search in 
 the opposite direction re-select the 'Search again' option.
 If no block is marked [Control]+I can be used to mark the word under the 
 cursor. Typing [Control]+I a second time automatically opens the 'Search' 
 dialog with the marked word entered ready for use.

-Replace ([Control]+R)
 Attempts to find the 'Search for' character string within the active 
 window and replace it with the 'replace with' character string. A dialog 
 box appears into which the search and replace strings are entered. If a 
 block less than one line is marked, [Control]+R automatically enters the 
 marked character string into the 'Replace' dialog.
 You can search AND replace with wildcards. Example: Search for 
 'Abc*defg?hijkl' and replace it with 'Mnopqrstuvw*x?yz'. Then 
 'Abc123defg4hijkl' will be replaced with 'Mnopqrstuvw123x4yz' and 
 'Abcdefg1hijkl' will be replaced with 'Mnopqrstuvwx1yz'.
 The search stops when the start/end of the document is reached and if the 
 'Auto reverse search direction' option in the 'Screen elements' dialog is 
 enabled the search direction is automatically reversed in the 'Replace' 
 dialog. To continue the replace in the opposite direction re-select this 
 option.
 
 Parameters:
 In addition to the parameters provided in the 'Search' option (above): 

 Replace all; when enabled (crossed) every occurrence of the search 
 character string will be replaced by the replace character string, 
 otherwise the first occurrence of the search character string only is 
 replaced by the replace character string.

 Prompt for each; as each occurrence of the search text it found the text 
 will be marked and a dialog will appear offering the option to replace or 
 not.

-Replace again ([Control]+T)
 Further occurrences of the 'Search for' character string are searched for 
 and replaced with the character string previously entered in the 'replace 
 with' field (above). The search proceeds from the current cursor position 
 using the 'Replace' option parameters. The search is halted when the 
 start/end of the document is reached and if the 'Auto reverse search 
 direction' option in the 'Screen elements' dialog is enabled the search 
 direction is automatically reversed in the 'Replace' dialog. To continue 
 searching in the opposite direction re-select this option.

-Go to line ([Control]+L)
 A dialog box appears displaying the current line number. Enter the desired 
 number into the dialog box and the cursor moves to the start of the line 
 number entered.

-Matching bracket ([Control]+B)
 Position the cursor over any bracket character ([{}]) and select this 
 option to move the cursor to the matching bracket. If no matching bracket 
 is found the warning bell is sounded.

-Find Error ([Control]+E)
 The line containing the cursor is checked for 'Error messages' as defined 
 in the 'Error messages' option from the 'Parameters' menu. If an error 
 message is found the appropriate file is loaded and the cursor is 
 positioned on the appropriate line number. If the file is already loaded 
 the window is topped, and not loaded repeatedly. This function can also be 
 activated by double clicking on a line.

-Set label ([Control]+Function key)
 A popup menu appears displaying the 10 label fields. The current line 
 number and filename can be assigned to any field. Using the 'Go to label' 
 option (below) or the relevant key combination the cursor can be quickly 
 placed at the desired line number in any loaded file.

-Go to label ([Shift]+Function key)
 A popup menu appears displaying the 10 label fields. To move the cursor to 
 the desired line number within a loaded file select the desired entry.


2.5 Window
==========

-Tile horizontally ([Alternate]+H)
 All windows are displayed across the full width of the screen one above 
 the other without overlap.

-Tile vertically ([Alternate]+V)
 All windows are displayed the full height of the screen in columns 
 adjacent to one another without overlap.

-Stack ([Alternate]+C)
 All windows are displayed overlapping each other.

-Toggle size ([Alternate]+X)
 This option performs the same function as the standard GEM window gadget 
 in the top right of the window and is included for completeness only.


2.6 Parameters
==============

-Insert mode ([Insert])
 Characters typed at the keyboard are entered into the text at the cursor 
 position. If the cursor is positioned over an existing character the 
 characters to the right of the cursor are moved over to make room for the 
 new characters. If the maximum line length is exceeded an error dialog 
 will appear.

-Overwrite mode ([Insert])
 Characters typed at the keyboard are entered into the text at the cursor 
 position and overwrite any existing characters, which are lost.

-GEM Clipboard On ([Alternate]+K)
 The GEM Clipboard will be used for all block operations. Before this 
 option can be used a CLIPBRD folder containing SCRAP.TXT must exist (and 
 be known to GEM) where Everest can find it. This can be set up manually or 
 more conveniently using a clipboard accessory such CLIPBORD.CPX via 
 Atari's XCONTROL.ACC. The advantage of using the GEM Clipboard is its 
 ability to exchange data with other GEM Clipboard compatible programs.

-GEM Clipboard Off ([Alternate]+L)
 Memory is used to store text, this is quicker than using the GEM Clipboard 
 option which stores the text in a file on disk.

-Screen elements ([Alternate]+R)
 -Scroll bars; The scroll bars to the right and bottom of the active window 
  reflect the position of the text displayed in the active window within 
  the overall text. The scroll bars can be updated either:
   While scrolling; reflects the current position of the window within the 
  text even during scrolling.
   After scrolling; offers a distinct speed advantage but the position 
  within the text is only displayed by pausing the scroll action.
  
 -Dialogs;  Dialog boxes may be displayed either centrally or at the mouse 
  position. Parameters:
  Screen centre; dialogs displayed at screen centre.
  At pointer; dialogs displayed at the mouse position.
  
 -Cursor parameters;
  Text dependent/Free position; if the 'Text dependent' option is enabled, 
  the cursor can't be moved over the line ending.
  
  Cursor Style; can be either a vertical line, a block or mode dependent. 
  Mode dependent sets the cursor to a vertical line in Insert mode and a 
  block in Overwrite mode. Flashing cursor; when enabled (crossed) the 
  cursor will flash, making it easier to find.
  Cursor position; when enabled (crossed) the line number and column are 
  displayed in the Window title bar. The current position is updated during 
  a typing pause (this method is used to avoid adversely affecting the 
  speed of Everest).
  
 -'Failed search' dialog; when enabled an alert box will appear each time a 
  search string cannot be found, useful if you can't hear the bell.
  
 -'Auto-reverse search direction'; when enabled, the search direction is 
  automatically reversed, when a search/replace operation reaches the 
  start/end of the document.
  
 -Select block after paste; When disabled a pasted block is not marked 
  after pasting which is a fast way to work. When enabled the pasted block 
  is marked and can be simply indented using [Control]+J (or K).
  
 -'Typing deletes selected block'; when enabled, typed characters replace 
  the selected block. You may only restore the block with undo if you have 
  typed only one character. So enabeling this option can be dangerous.

-Typeface ([Alternate]+T)
 If GDOS (or equivalent) is installed GDOS fonts can be used instead of the 
 system font within Everest. The first time this option is selected the 
 available fonts are loaded into Everest, so the dialog may take a longer 
 than normal to appear. This approach minimises the time taken to load 
 Everest.
 Some GDOS fonts may cause display problems when displayed in reverse video 
 and others do not display correctly at all sizes. Use FONTFIX or similar 
 utility to correct these typefaces. The fonts supplied with Gemini are 
 especially recommended.
 The dialog box contains a preview display showing the currently active 
 typeface and size. The size and style can be changed using scroll arrows 
 or cursor keys and the changes are shown in the preview display.
 If GDOS is not installed only the size of the system font can be changed.

-Formatting ([Alternate]+W)
 'Word wrap', 'Line length' and 'Automatic indentation' can be defined 
 depending on the file extension.

 Tabs; The preset tab width for up to 10 different file extensions can be 
 set from this dialog. Wildcards are allowed. The tab width must be 
 between 1 and 20. If you type the [Tab] key and Real tabs is enabled, the 
 Tab character (Code 9) is inserted at the cursor position. If Real tabs 
 is disabled, the corresponding amount of spaces is inserted.

 If 'Word wrap' is enabled then the cursor will jump into the next line 
 while typing if the right margin is reached. 'Line length' defines the 
 right margin.

 An option especially handy for programmers is:
 Automatic Indentation; when enabled (crossed) the Return key will return 
 the cursor to the position under the first column used in the preceding 
 line.


-Miscellaneous parameters ([Alternate]+M)
 -The 'Block indent' options allows you to determine how a block is 
  indented with the [Control]+J (or K) option. If 'Tabulator' is activated 
  then a tab is inserted at the beginning of every line each time the block 
  is indented right. Instead of tabs a number of spaces or a text string 
  can be used. This is especially handy for comms users where existing mail 
  can be copied and pasted into a reply with the '>' character 
  automatically inserted at the start of each line for example.
  
 -If you want to reformat a paragraph the paragraph ending is recognised by 
  Everest with the following options:

  Additional Carriage Return; A additional CR at the end of the line means 
  that the paragraph ends here. You can create a CR by [Shift]+[Return]. 
  However this method is not very well supported by Everest. The 'Blank 
  line' or 'No trailing space' options are better.

  'Blank line'; An empty line acts as a paragraph seperater.
  
  'No trailing space'; This is the most common method. Every line which is 
  not the last line of a paragraph has a space character at the end. Only 
  the last line has no trailing space. If a paragraph is formatted Everest 
  automatically inserts the spaces according to this method.

  Important: If you use this option it is suggested you do not delete 
  trailing spaces while saving a text. This option can be found in the 
  'Miscellaneous' dialog.
  
 -Save text; Line Feed at line end; may be useful for exchanging text files 
  with other systems. CR/LF at line end (default); most Atari applications 
  and printer drivers expect this combination.
  Delete trailing spaces; when enabled (crossed) any extra space characters 
  at the end of each line will be deleted. But be careful! If you use 
  Everest's word wrap all paragraph information will be lost, because a 
  space at the line ending means that the paragraph continues to the next 
  line.
  Backup file: *.BAK; When a text is saved it will normally replace the 
  existing file on the disk. When the Backup file option is enabled the 
  existing file extension is changed to BAK and then the text is saved. 
  This means you will always have two versions of a text on your disk: the 
  current one and the previous one. Of course you may change the extension 
  BAK if you prefer.
  
 -Null character code; Allows you to define a character to which a Null 
  character is changed while loading (default 32=Space) and a character 
  that is saved as a Null character (default 0).

-Error messages ([Alternate]+E)
 This option enable programmers to configure Everest to respond to compiler 
 specific error messages. Non-programmers can safely ignore this menu 
 entry! Compiler error messages are entered into the dialog using the '%' 
 marker for the filename, the '#' marker for the line number and the '$' 
 marker for the column number. Everest can now search for these error 
 messages, typically in the error file generated by your compiler. Use the 
 'Find error' drop down menu option, [Control]+E keyboard combination or 
 double click on any line. If a matching error message is found the file 
 containing the error is loaded, topped and displayed. If the error message 
 contains a line number the cursor will be placed at the start of the line 
 containing the error otherwise the cursor will be placed at the start of 
 the first line.
 If no filename is specified and it is the only file loaded then the cursor 
 will be positioned at the start of the line defined in the Error message. 
 If more than one file is loaded the cursor will be positioned at the start 
 of the line defined in the Error message of the next available file (as if 
 you had used the 'Cycle windows' menu option (this only makes sense if two 
 files are loaded)).

 Example Heat-and-Serve C error message entries for Everest:
 Error 1: error in % (#):
 Error 2: warning in % (#):

-Abbreviations ([Alternate]+A)
 The file selector appears. The actual active Abbreviation file is selected 
 as default. Now you can load another Abbreviation file. The previous one 
 will be forgotten. If you try to load an empty filename then the memory 
 used by the Abbreviaiton file is released and no other Abbreviation file 
 is loaded. More about Abbreviations is '1.1 Files and file structure'.

-File lists ([Alternate]+F)
 Save file list; select this option to save the filenames, cursor 
 line/column and window layout of all currently loaded and named files to a 
 file called EVEREST.LIS. This file will be automatically loaded if found 
 in the same directory as Everest. Other lists can easily be created by 
 saving the lists under a different path or filename.
 
 Load file list; a further dialog appears offering the following options:
 
 Save all; all loaded files are closed and saved (named only). The file 
 selector appears for selection of a new file list.
 
 With Query; all loaded files will be closed. A dialog appears for each 
 changed file offering a last chance to save or discard the changes. The 
 file selector appears for selection of a new file list.
 
 Merge new; existing files remain loaded and the file selector appears for 
 selection of a further file list. An alert will inform you if the maximum 
 number of windows available is reached and subsequent files on the file 
 list will not be loaded.
 
 You can read more about File lists in '1.1 Files and file structure'.
 
-Program exit ([Alternate]+Q)
 Save edited/changed text; on selecting the 'Quit' menu option all changed 
 text is automatically saved. A dialog will still appear to offer a last 
 chance to save unnamed but changed files.

 Prompt for each; on selecting the 'Quit' menu option a dialog for each 
 file appears in turn offering a last chance to save the file.

 All-in inquiry; when you want to quit Everest a dialog appears where all 
 active texts are shown. There you can decide to save a text or not.
 Save parameters to .INF file; when enabled (crossed) this option saves the 
 user defined parameters to a file called EVEREST.INF in the current 
 directory. If EVEREST.INF is present in the same directory as Everest it 
 is automatically loaded next time Everest is run.

 Save standard file list; when enabled (crossed) the standard file list 
 will be saved to the current directory. If no file list was mentioned on 
 the command line, EVEREST.LIS is the standard file list. Otherwise the 
 file list from the command line is the standard file list.
 If EVEREST.LIS is present in the same directory as Everest it will be 
 automatically used next time Everest is run.
 
*A tip -enable both these last two options to return to Everest as if you 
 hadn't left it.

-Save set up ([Alternate]+S)
 Saves the parameters and window layout to EVEREST.INF in the current 
 directory. (See also chapter 1.1 Files and file structure.)


2.7 Info
========

-Loaded files ([Alternate]+I)
 Displays the current memory allocation for each file and the Block memory 
 used. Click on any filename to quit the dialog and top the selected 
 window. You may also press the corresponding function key instead.

-Help ([Shift]+[Help])
 Help screens for the Keyboard and Mouse can be displayed.

-Help Acc ([Help])
 Only useful to programmers with the Turbo C Help Accessory or 1STGUIDE 
 loaded.


****************************************************************************
3.0    K E Y B O A R D
****************************************************************************


3.1 How to change the shortcuts
===============================

There is no menu in Everest to change the keyboard shortcuts. If you want 
to do this you need a debugger or a (disk) monitor.
Behind the characters ALTTAB and behind CTLTAB are tables which define the 
keyboard shortcuts. The length of each entry is 3 words. The first word is 
the ASCII Code of the shortcut character in upper case. The next two words 
define the menu title and entry. Each table ends with 0 as ASCII Code. You 
may extend each table up to the characters END. It is possible to move an 
entry from one table to another. You also may change the ASCII Code of the 
shortcut characters. In the unchanged Everest the entries are in the order 
as they appear in the menu.
This facility is provided for your convenience. Please do NOT distribute 
modified copies of Everest to anyone without including the original 
un-edited version.


3.2  Keyboard commands
======================

[Undo]                                     Restores line or block
[Shift]     + Left/right arrow             Cursor to line start/end
[Control]   + Left/right arrow             Cursor to last/next word
[Shift]     + [Control]+Left/right arrows  Move window left/right
[Shift]     + Up/down arrow                Scroll window up/down
[Shift]     + Up/down arrow                Cursor to first/last line in 
                                           window
[Shift]     + [Control]+Up/down arrows     Move window up/down
[Shift]     + Backspace/Delete             Delete to line start/end
[Control]   + Backspace/Delete             Delete previous/next word
[Home]                                     Cursor to text start
[Shift]     + [Home]                       Cursor to text end
[Alternate] + Numeric keypad               Insert character by ASCII code
[Control]   + Numeric keypad               Save and quit with return code
Function key                         The window with the corresponding 
                                     number is topped. If there exists no 
                                     such window, the fileselector is 
                                     invoked and you can load a text into 
                                     the corresponding window.



****************************************************************************
4.0    D I A L O G S
****************************************************************************

All underlined buttons can be optionally selected by pressing the relevant
key together with the [Alternate] key.
The turned over corner displayed at the top right of all dialog boxes has
two important advantages over normal GEM dialog boxes. Using the mouse,
clicking and holding down over one of these corners reveals the text hidden 
behind the dialog. Holding down and moving the mouse enables any dialog box 
to be repositioned as desired.
The [Esc] key will clear any data in a dialog text field.
The [Undo] key is equivalent to selecting the Cancel button.
[Shift]+[Undo] will restore a dialog text field to the entry it displayed 
when it was last called.
The [Shift]+left/right arrow keys will move the cursor to the start/end 
of any string entered in a dialog text field.


****************************************************************************
5.0    A V  -  P R O T O C O L
****************************************************************************

More detailed information about the AV-Protocol can be found in the Gemini 
desktop documentation.
Everest supports AV_SENDKEY, AV_OPENWIND and VA_START.
Another program can send keyboard events to Everest. 'mbuf' must contain 
the following entries:
  mbuf[0] = Message code AV_SENDKEY=0x4710
  mbuf[1] = ap_id of sending program
  mbuf[2] = 0
  mbuf[3] = Keyboard status
  mbuf[4] = Pressed key as it is provided by evnt_multi. (ASCII Code: bit 
            0..7, Scancode: bit 8..15)
You may also open Everest's file selector with a predefined path.
  mbuf[0] = AV_OPENWIND=0x4720
  ... s.a.
  mbuf[3],mbuf[4] = Pointer to the path
  mbuf[5],mbuf[6] = Pointer to wildcard
This option is useful for Treeview

Another program can send a command line to Everest with VA_START:
  mbuf[0] = VA_START=0x4711
  ... s.a.
  mbuf[3],mbuf[4] = Pointer to command line
This is useful for multitasking shells. It is for example possible under 
Mag!X to drag files onto the Everest icon which will be loaded into Everest 
even if Everest is running.



****************************************************************************
6.0    V E R S I O N S
****************************************************************************

Version 0.0
-Very old version, no keyboard shortcuts in dialogs.

Version 1.0  5-4-1992
-First usable version. From this version Everest became Shareware.

Version 1.1  12-4-992
-Small bug with memory allocation sorted.
-Block paste optimised

Version 1.2  17-5-1992
-Bug in Block indent handling sorted.
-OK buttons now work with the numeric keypad 'Enter' key.
-EVEREST.INF was not found unless 'EVEREST' was also defined as an 
 Environment variable. It is now also defined under the 'PATH' entry and 
 can is found successfully by SHEL_FIND.
-The Parameters from Search/Replace (Upper/lower case, Replace all) are 
 now saved in the .INF file.
-The Matching bracket drop down menu option was added.
-The program code which hindered the cursor has been replaced. Fast typing 
 no longer causes problems.
-Block indent improved.
-If a block is not marked the operation is carried out on the current line.

Version 1.3  8-6-1992
-Bug causing scroll problems with [Control]+Y operations fixed.
-Keyboard layout bug fixed.
-Now prints under GEMDOS PRN:, multitasking errors avoided.
-Optional line/column display for cursor position added.
-The command to enable the block start/end point to be redefined using the 
 mouse+[Shift] keys outside the current window is now possible and matches 
 the normal keyboard method

Version 1.4  14-6-1992
-Minor bugs marking blocks using the mouse fixed.
-Changes to the method used to load text files and alterations to internal 
 settings and memory allocation. The loading speed has been roughly 
 doubled.

Version 1.5  22-7-1992
-Bug changing typefaces fixed.
-Now searches for PC HELP as well as TC HELP.
-Cursor blink parameter added.
-Program exit parameters added.
-Text lists and complete working layout can be saved.
-Keyboard call bugs fixed.
-The Error messages parameters can work with compiler generated error lists.
-The time taken to Save a file has been almost doubled.
-Printer parameters added.
-2 problematic, deeply buried bugs in the text loading code fixed.

Version 2.0  15-9-1992
-A simple word wrap has been added.
-Full background window support
-Now menu_ienable is used to modify the menu tree.
-Better method to avoid cursor overrun.
-Bug within program start fixed.
-Bug fixed that causes 'Address Error' while typing.
-Memory is now released after a dialog has been moved.
-'Show 'failed search' dialog' option added.
-Wildcards possible in Search AND Replace dialog.
-Bug fixed that caused trouble with line numbers bigger then 32000.
-AV_SENDKEY, AV_OPENWIND and VA_START message support added.
-Better handling of slow printers. Unfortunately the print must go via 
 'Cprnout' again, because 'Fwrite' causes too much problems.
-The help options also searches for 'PC_HELP' and '1STGUIDE'.

Version 2.1  17-10-1992
-Mouse status now inquired with 'evnt_multi' instead of 'graf_mkstate' 
 while scrolling.
-Memory Error fixed. This error can cause memory protection problems.
-Some bugs in block handling fixed.
-'Merge' option implemented.
-'Undo' option for [Control]+Y.

Version 2.2  2-1-1992 and 16-1-1993
-While selecting a block with the mouse the scroll speed will be higher if 
 the distance between mouse position and window frame is larger.
-Selectric support to load more than one file at once. (Bug fixed at 
 16-1-1993)
-[Shift]+mouse button allows you to hold the mouse button down.
-Redraw error with KAOS has been fixed.
-'Search selection' does it even if no block is marked. In this case the 
 word under the cursor will be taken into the Search dialog.
-Extended Accessory entry.
-[Control]+Numeric keypad allows you to quit Everest with Return code.

Version 2.3  17-4-1993
-Bug within the 'Merge' option has been fixed.
-From now it is possible to quit the 'Loaded files' dialog with function 
 keys.
-Bug that occurred with Selectric has been fixed.
-When sizing a window Everest now tries to maintain the cursor position.
-When starting Everest with command line parameters the File list 
 EVEREST.LIS (if present) will be ignored.
-Command line evaluation has been improved.
-'Undo' option now works with the Block cut, paste, delete and merge 
 options.

Version 3.0  29-8-1993 
-Bug fixed that occurred while replacing with two question marks.
-The Typeface parameters can be changed with the cursor keys as well as 
 with the scroll arrows.
-It is now possible to move a window outside the displayed screen. 
-Background scrolling has been improved.
-If there is only one file with extension LIS in the command line then this 
 file is taken as standard File list.
-'Search selection' has been improved.
-'Prompt for each' option has been added in the Replace dialog.
-Abbreviation files implemented.
-The 'Help Acc' option causes no longer a 'Memory Violation' under 
 MultiTOS.
-Null character options implemented.
-In the case that no full path is given to the 'Find error' option, 
 Everest searches the file in the directory of the Error file.
-Program and docs translated to English.
-It is possible to delete a block with the [Delete] Key.
-Word Wrap, Line length and Automatic Indentation can be defined depending 
 on the file extension.

Version 3.1  20-2-1994
-The Delete key after expanding an abbreviation works now correctly.
-WM_BOTTOM Message implemented.
-'The file ... does not exist. Create a new file?' -Message removed, 
 because it's unnecessary.
-WINX's Scrollboxes are now supported.
-Everest works now correctly, if the windows are moved over the left screen 
 border (under WINX).
-Two new menu entries in the FILE-menu: 'Save changes' and 'Close all'.
-The cursor column can be defined in the 'Sample Error messages' dialog.
-If GEM doesn't recognise the scrapdir, Everest takes the environment 
 variable SCRAPDIR.
-Because many people asked for more flexible cursor handling, it's now 
 possible to choose between text dependent and free cursor positioning.
-Optionally a formfeed can be send to the printer after printing a text.
-Everest can create backup files.
-You can save a marked block using the 'Save as' option.
-Everest supports the UFSL, a font selector that can be used by all
 programs like a file selector (UFSL = Universal Font selector).
 
Version 3.2  27-2-1994
-Unfortunately there was a bug in version 3.1 which was not saving marked 
 blocks properly. Hopefully this bug is now fixed.
-The English has been fine-tuned (Open file(s), Save block as, Save file 
 as) etc.

Version 3.3  30-4-1994, 20-5-1994 and 28-5-1994
-Search and replace improved (faster and less bugs).
-Option to disable the auto-reverse direction in the search/replace 
 dialogs, much requested.
-'Whole word' option added to the search/replace dialogs.
-Better menu structure in the 'Block' and 'Search' menus.
-New 'Replace selection' and 'Select word' menu options.
-'Compose' now works correctly in any mode with Everest.
-The cursor column position is maintained after a 'Delete line'.
-Line feeds within abbreviations now possible. 1000 lines max.
-ST-Guide support implemented.
-'vst_unload_fonts' system call implemented to avoid some problems with 
  AMC-GDOS.
-It's now possible to click on the text to select dialog options.
-20-5-1994 Bugfixed: abbreviations with line feeds and screen redraw after 
 dialogs.
-28-5-1994 Bug that occurred with 32k color graphic cards has been fixed.

Version 3.4  29-10-1994 and 5.11.1994
-Bug within the Replace option with wildcards has been removed.
-Typing the [Undo] key in a dialog is now equivalent to selecting the 
 Cancel button. Type [Shift]+[Undo] to restoreûdialog text fields.
-The fileselector is now invoked with the path that was active at last. To 
 invoke the fileselector with the path of the active window, hold the 
 [Shift] key down while selecting the File Open menu entry.
-It's now possible to switch between the Insert and Overwrite mode by 
 typing the [Insert] key.
-You may define abbreviations that have word separator characters at their 
 ending. E.g. t[=test[~].
-It's now possible to use abbreviations that are not defined. If you type 
 the [Esc] key after typing the beginning of a word that is not a defined 
 abbreviation, Everest searches the actual text if there's a word with the 
 same beginning. If so, then this word is taken for expansion.
-If the Help-Accessory is now invoked without any selection, then it's not 
 neccessary to deselect the taken word afterwards.
-Extended file lists: The window number and the set label are saved into 
 the file lists.
-Pressing a function key invokes the fileselector to load a text into the 
 corresponding window if the window doesn't already exist.
-You may configure Everest to delete a marked block if text is typed. Look 
 at the Paramters/ Screen elements dialog!
-It's now possible to use tabs that consist of spaces instead of the 
 special Tab character. You can configure this in the Parameters/ 
 Formatting dialog.


****************************************************************************
7.0    T H E   S H A R E W A R E   P R I N C I P L E
****************************************************************************

7.1 Distribution conditions

Everest is Shareware. The program may only be distributed without charge. 
For example, commercial public domain libraries, magazines, publishing 
companies and software companies may only spread Everest with my prior 
written permission. Everest may be uploaded to BBSs that do not charge for 
downloads. Both the program and the documentation must remain together and 
unchanged. The Everest INF file must NOT under any circumstances be 
distributed as the registered version contains your personal key details.


7.2 How to register

Note!
UK users refer to 7.3 for details of local UK support and Registration.

If you find the program useful and intend to continue using it you are 
honour bound to pay the Shareware fee to the author. The fee is only 20 
DM. If you want to pay with cheque, please send only DM (EuroCheque 
preferred). If you want to pay cash, you can send the fee in any stable 
currency (e.g. $15 or œ10).

After receiving the shareware fee you will receive a personalised key. This 
key together with your name is entered into the Everest registration dialog 
and can be saved in the Everest INF file. After saving the INF file with a 
key the registration dialog no longer appears when starting Everest.

Existing Registered users can request a free key.

The reward for paying the Shareware fee is Everest's continued development. 
The extent to which Everest is upgraded is largely dependent upon the 
Shareware response from users. On receiving your Shareware fee and address 
you automatically become a registered user and can at any time until 
informed otherwise send a stamped addressed envelope for a copy of the 
latest version, or send 5 DM instead

Everest undergoes continual development and as a registered user your wish 
list will be given careful consideration. If you find a bug or have any 
suggestions or comments to make please get in touch. I will do my best to 
remove bugs.


   Address:                   Bank Details:

   Oliver Schmidt             Kreissparkasse Ostholstein
   Haselredder 23             Kontonummer :  127.010.643
   23701 Eutin                Bankleitzahl:  213.522.40
   Germany

Suggestions may also be Emailed to: Christian_Dalichow@ki.maus.de


7.3 Everest UK Support and Registration

To register your copy of Everest in the UK follow the procedure below:

1) Make a cheque for œ10 payable to Joe Connor
2) Check you have included your surname, forename and full address.
3) Registration details are normally stored electronically to simplify key 
   handling and updates. If you do not wish your personal details stored 
   electronically please state this in your letter.
4) Send letter and cheque to the UK Address below:

   Joe Connor
   65 Mill Road
   Colchester, Essex
   CO4 5LJ
   England

I can also be contacted by Email as: jconnor@cix.compulink.co.uk


7.4 UK Update service

Registered UK users can obtain the latest English Version from Joe Connor 
at any time, free of charge, by sending a Stamped Addressed Envelope 
enclosing a floppy disk to the address above so long as the latest version 
remains a free upgrade.
--------------------------------------------------------------------------
EOF