home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
No Fragments Archive 10: Diskmags
/
nf_archive_10.iso
/
MAGS
/
KELSTAR
/
KELSTR3B.MSA
/
EVEREST.3_3_EVEREST.DOC
< prev
next >
Wrap
Text File
|
1994-04-29
|
53KB
|
1,154 lines
============================================================================
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: <Filename and full path>, <Cursor
line>, <Cursor column>, <x>, <y>, <w>, <h> window coordinates (1000 is
maximum screen width/ height). 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.
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 [Shift] 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 ([Shift]+[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).
-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 '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
****************************************************************************
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 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
-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.
****************************************************************************
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.
EuroCheque or similar cheque preferred. You can send the fee in any stable
currency.
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 £9.00 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