home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Power-Programmierung
/
CD1.mdf
/
forth
/
compiler
/
fpc
/
doc
/
zhelp.txt
< prev
next >
Wrap
Text File
|
1990-07-02
|
30KB
|
633 lines
°EDMAIN Help with the NEWZ Editor
───────────────────────────────
┌───────────────────────────────────────────────┐
│ Welcome to the Hypertext HELP system for NEWZ │
└───────────────────────────────────────────────┘
∙Hypertext ─ What is Hypertext anyway.
∙SED-Help ─ Help with editor commands and functions.
∙DOS-Commands - Issue DOS commands from the NEWZ editor environment.
∙Setup-NEWZ - Setting up NEWZ and compiling index files.
┌───────────────────────────────────────────────┐
│ Move the cursor with TAB onto a word shown in │
│∙reverse_video and press F9 or the Enter key. │
└───────────────────────────────────────────────┘
─────> Press ∙F10 to leave Help or leave NEWZ <─────
°Hypertext Hypertext Introduction
──────────────────────
Hypertext is a technique for inter-connecting information for the purpose
of making it easier to locate desired sections of that information. You
can think of Hypertext as a sort of bookmark and index system. You can, with
a single key, go off to look at some information related to what you are
currently looking at. When you are done looking at that other information,
you can return to where you were with another single key.
Lets try it to see how it works. ∙Other-Information
Notice the word pair shown above shown in reverse video, press the TAB
key to move to that word. Now you are ready to "link" to
Other-Information. You can perform the link in one of three ways:
Press Enter Press F9 Press Alt-B
(links ONLY while browsing) (the link key) (B meaning BROWSE)
Press any of the above keys NOW! When you come back unlink with ∙F10.
°Other-Information Other information on Hypertext
──────────────────────────────
You are now at least +2 levels down in the Hypertext links. The number
you see at the upper right hand corner of the screen tells you how many
links FORWARD have been performed. Each time you link forward (like an
index) to a new piece of information, your previous location is saved
(like a bookmark). You can link forward exploring new information up to
twenty (20) times before the link save stack fills up.
When it comes time to "unlink", The ∙F10 key will unlink to the exact
previous place where you linked from.
This Hypertext system is really implimented as a special "mode" of the
SED editor. You are in fact in the SED editor now, in what I call BROWSE
mode. You are allowed to look around, but you can't make any changes.
Press ∙F10 to UNLINK, or Press PgDn for more.
More Information on the Browser
───────────────────────────────
Certain keys perform special functions while in BROWSE mode. as
mentioned before the TAB key moves to the next reverse video link, and
Enter performs a link to the current word under the cursor.
BROWSE mode is indicated visually by the word BROWSE in the upper left
corner, and the double line screen border.
In Browse mode, you can use the editor PgDn & PgUp as well as Arrow
keys to move through a file, or you can move the cursor to a word of
interest, and press F9 or Enter to link directly to that topic.
Actually, F-TZ will allow you to try linking to ANY word in a file. You
can link to ANY Forth word for example. If no link is available for a
word, you will receive a message to that effect. In a documentation file
like this, linked words are shown in reverse video to make them stand out.
Press ∙F10 to UNLINK, or Press PgDn for more.
Browser Introduction (cont.)
────────────────────
You can link THROUGH a DEFERED Forth word by pressing Alt-F9. This is
useful for defered words like ∙EMIT . F9 will link to the source for one
of these words, and Alt-F9 will link to its defered function.
Position the cursor with TAB on EMIT above.
press F9 then ∙F10 to return.
You will have seen the source for EMIT which is a defered word and not
very interesting.
Now press Alt-F9 then ∙F10 to return.
You will see the source for (EMIT) which is the function in EMIT.
If you are nested deeply into a complex browse, you can Unnest quickly to
the top level edit or browse, by using the File menu's Unnest item. the key
sequence for Unnest is Shift-F10 or ESC-F-U.
Press ∙F10 to UNLINK
°DOS-Commands DOS Commands in the Browser
───────────────────────────
DOS commands can be issued while within the Z editor in several ways:
1. Ctrl-Enter will prompt you for a dos command line to perform.
2. Shift-Ctrl-Enter will perform the most recent DOS command you have
entered again without a prompt.
3. Alt-F2 will perform a series of DOS commands you have entered in a
document in the following format:
<dir;pause> Dir of current directory and pause.
<dir *.txt;dir *.com;pause> Dir of all .TXT and all .COM files.
<;> Spawn a shell. Type EXIT to return.
<dir> Dir of current directory with no
pause on command completion.
Press ∙F10 to UNLINK
°SED-Help Table of Contents for Help with SED
───────────────────────────────────
∙*Copy* Cut, Copy, Paste & Append
∙*Drawing* Drawing lines & Sorting
∙*FuncKeys* Function key assignments
∙*Keypad* The Keypad is fully supported
∙*Leaving* Leaving & Printing
∙*Line* Line & Word commands
∙*Margin* Margin Control commands
∙*Menus&Mouse* Using pulldown menus and the MOUSE.
∙*More* Bold, Underline & DOS
∙*Other* Other functions
∙*Search* Search, Replace & Goto
∙*Specs* SED Specifications
∙*WordStar* SED uses WordStar movement key sequences.
┌──────┐ ┌──────┐
You can move through this help file with │ PgDn │ and │ PgUp │ or,
┌──────┴─┬────┘ └──────┼───────┐
use TAB to place the cursor on an │ *Item* │ above and press │ Enter │
to browse that item. └────────┘ └───────┘
°*Menus&Mouse* Menu & Mouse Control Press ∙F10 to pop Help level
────────────────────
SED provides both pulldown menus, and fairly complete mouse support.
Select ∙*Menus* for a description of using pulldown menus with the
keyboard.
To use a mouse in SED you must have a compatible mouse driver (like
MOUSE.COM) already installed in your autoexec.bat. When F-TZ starts up, it
looks for the presence of a mouse driver, and activates the mouse if the
driver is present.
As you are looking at this screen you will see arrows to the right and
lower right of the screen. These arrows can be used to scroll the screen,
showing more text from the direction the arrow is pointing by clicking the
left mouse button. The ∙F10 or +1 etc. in the upper right corner can be used
like the ∙F10 key by positioning the mouse and clicking the left button. You
can also change the INSERT/OVERWRITE mode by clicking at the top left of
the screen on INSERT. Help can be obtained by pressing HELP at the lower
left. The cursor can be positioned by clicking within the edit window with
the left mouse button. The right mouse button is the same as the ESC key.
°*Menus* Using Pull Down Menus Press ∙F10 to pop Help level
─────────────────────
SED uses Pull Down menus to make many functions available while editing.
Press the ESC key NOW to see the menubar appear at the top of the screen.
If you have pressed the ESC key, then you are looking at a list of menu
titles starting with "File" which should be shown in reverse video, through
"Help" on the right. Use the keypad right arrow key to walk along the
menubar. As you press right arrow, the hilighting moves along the menubar.
Continue to press right arrow until "File" is again the hilighted menu. Now
press down arrow to pull the menu down. Notice the last two items of the
"File" menu, Exit and Quit. To the right of these menu items, are
displayed the short cut keys F10 and Alt-F10. Any menu function can be
performed with the short cut key rather than moving through the menu and
pressing Enter. If you press right arrow while the "File" menu is pulled
down, you will walk along the menu bar with each menu "open", so you can
see what menu items are available. You can also press the first
CAPITALIZED letter of a menu item to perform the item.
°*WordStar* WordStar Movement Keys Press ∙F10 to pop Help level
──────────────────────
┌─────────────┬────────────┬────────────┬─────────────┬────────────┐
│ ^W scroll │ ^E line │ ^R page │ ^T Word Del │^Y Line Del │
┌─────┴─────┬───────┴────┬───────┴─────┬──────┴─────┬───────┴─────────┬──┘
│ ^A -word │ ^S -left │ ^D right- │ ^F word- │ ^G char Delete │
└─────┬─────┴───────┬────┴───────┬─────┴──────┬─────┴─────────┬───────┘
│ ^Z scroll │ ^X line │ ^C page │ ^V INS toggle │ ^=Control
└─────────────┴────────────┴────────────┴───────────────┘
SED supports a subset of the WordStar control keys used to move around a
document. The keypad is also supported, as can be seen in the next screen.
Function key assignments are shown under the ∙*Keypad* entry.
°*Keypad* Keypad keys Press ∙F10 to pop Help level
───────────
┌──────┐
│ Esc ├─ = Pops up the MENU display
└──────┘
Ctrl-Home = Beginning of file Up-arrow = Up a line in document
┌──┴───┬──┴───┬──────┐
Goto beginning of line ─┤ Home │ │ PgUp ├─ Previous page in document
├──────┼──────┼──────┤
Left a character on line ─┤ - │ │ - ├─ Right a character on line
( with Ctrl, left word) ├──────┼──────┼──────┤ (with Ctrl, right word)
Goto end of line ─┤ End │ │ PgDn ├─ Next page in document
└──┬───┴──┬───┴──────┘
Ctrl-End = End of file ────┘ Down-arrow = Down a line in document
┌─────────────┬──────┐
Insert/Overwrite toggle ─┤ Insert │ Del ├─ Delete char under cursor
└─────────────┴──────┘
Function key assignments are shown on the next screen.
°*FuncKeys* Function Key Assignments
────────────────────────
┌─────┬─────┐
Call up F-TZ HELP │ F1 │ F2 │ Move cursor to TOP of screen
│ │ │
├─────┼─────┤
Set mark at current line │ F3 │ F4 │ Move cursor to BOTTOM of screen
│ │ │
├─────┼─────┤
Copy a line from mark │ F5 │ F6 │ Search (asks for search string)
│ │ │ Use with Alt to repeat a search
├─────┼─────┤
Line & box drawing │ F7 │ F8 │ Replace (asks for replace string)
│ │ │ Use with Alt to replace & search
├─────┼─────┤
Link browse to word │ F9 │ F10 │ Exit & save, Unlink one level
Use Alt-F9 to link through │ │ │ Use with Alt to leave and discard
a defered word. └─────┴─────┘ changes. Use Shift-F10 to Unlink
to the top level.
°*Leaving* Press ∙F10 to pop Help level
Leaving, Saving, and Printing in the F-TZ editor
────────────────────────────────────────────────
∙F10 = Save changes and leave editor
Alt-F10 = Discard changes and leave editor
Ctrl-U = Save changes and continue editing
Alt-P = pops up the printing menu display
°*Search* Search, Replace & Goto Press F10 to pop Help level
──────────────────────
Search for text commands
────────────────────────
F6 = Search the first time (prompts for text)
Alt-F6 = Search for same again
Shift-F6 = Search for same again BACKWARDS
Shift-Alt-F6 = Srch again cAsE Sensitive
Replace text commands
─────────────────────
F8 = Replace the first time (prompts for text)
Alt-F8 = Replace same again and search same again
Shift-Alt-F8 = Same as Alt-F8, but cAsE sensitive
Shift-F8 = Replace All occurances
Goto Page
─────────
Alt-G = Goto specified page/line or next/prev paragraph
°*Copy* Cut, Copy & Paste Press ∙F10 to pop Help level
──────────────────
Mark and Copy in memory
───────────────────────
F3 = MARK first, then last line of an area to copy or cut.
F5 = Copy a line from MARKed line to cursor line.
**** Use F3 to MARK the START & END of ALL Cut, Copy & Append operation ****
Cut, Copy, Paste & Append with DISK
───────────────────────────────────
* Alt-X = Cut MARKed lines to TEMP.SEQ
* Alt-C = Copy MARKed lines to TEMP.SEQ
* Alt-V = Paste Cut/Copied text at cursor line from TEMP.SEQ
* Alt-A = Append MARKed lines to TEMP.SEQ
Paste Date and Time
───────────────────
Alt-O-P = Paste the current date and time into text at cursor.
* Use SHIFT-Alt to specify the file to Cut, Copy, Paste or Append with.
°*Line* Line & Word Commands Press ∙F10 to pop Help level
────────────────────
Split and Join lines Word Delete & Undelete
──────────────────── ──────────────────────
Ctrl-N = Split this line at the cursor Ctrl-T = Word delete and save
Alt-N = Join this line with next line Alt-U = Word Undelete *
Line Delete and Undelete
────────────────────────
* Ctrl-Y = Delete this line and save in delete buffer
* Alt-Y = Undelete a deleted line from the delete buffer
* The line delete buffer can hold 100 deleted lines.
* The word delete buffer can hold 128 characters total.
°*Margin* Margin control Press ∙F10 to pop Help level
──────────────
Ctrl-L = Set left margin to current column.
Alt-L = Prompt for the number of spaces to insert before
all lines of the current paragraph. Table move right.
────────────────
Shift-Alt-L = Remove all space from the current paragraph to the
right of the current cursor column. Table move left.
───────────────
Alt-S-R = Prompt for value to set Right Margin.
Home = Set cursor to column 0 and reset Left Margin to 0.
Ctrl-B = Reformat current paragraph.
The left margin is also set at the new cursor position after
pressing TAB when there are only spaces to the left of the
cursor. This is useful for maintaining or setting an indent
while editing source.
°*Other* Other help Press ∙F10 to pop Help level
──────────
Write to a new filename
───────────────────────
Alt-W = Write the file in memory to a NEW file (prompts for filename)
TAB Control
───────────
Alt-T = Set tab increment to current column value.
Alt-O-X = eXpand all TABs to spaces in the file in memory.
Case Conversion
───────────────
Alt-O-U = Convert the current cursor line to UPPERCASE.
Alt-O-L = Convert the current cursor line to lowercase.
Alt-O-W = Toggle case of WORD under cursor, starting at cursor.
Alt-O-C - Toggle case of the CHARACTER under the cursor.
Help on a WORD
──────────────
Alt-H = Shows help on the word under the cursor while editing.
°*Specs* SED Specifications Press ∙F10 to pop Help level
──────────────────
┌──────────────────────────────────────────────────┐
│ Maximum Characters in a File limited by memory │
│ 640k can edit ≈250k file │
│ 512k can edit ≈150k file │
│ │
│ Maximum Lines in a File Adjusted to memory │
│ 640k has 8000 lines │
│ 512k has 6000 lines │
│ │
│ Maximum Characters in a Line 132 │
│ │
│ Maximum # of Deleted Lines Saved Adj to memory │
│ available edit memory > 48k, save 100 lines │
│ < 48k, save 20 lines │
│ │
│ Printed # of Lines on a Page 55 │
└──────────────────────────────────────────────────┘
°*Drawing* Line Drawing & Sorting Press F10 to pop Help level
──────────────────────
┌┬┬┬┬┬┬┬┐ Line drawing commands
└┴┴┼┼┼┴┴┘ ─────────────────────
├┼┤
├┼┤ F7 Start/Stop drawing lines
├┼┤ Ins Pen up/down command
├┼┤ - Select single width lines (minus)
├┼┤ ┌┐ = Select double width lines (equal)
└┴┘ └┘ Del Clear char under cursor
Arrows Move and draw a line
┌┬┬┬┬┬┬┬┐
└┴┴┴┴┴┼┼┤
├┼┘ Sorting the lines of a Paragraph
┌┼┘ ────────────────────────────────
┌┼┘
┌┼┘ Alt-F7 Sort paragraph lines starting at current
┌┼┤ line and column. This sort is cAsE
┌┼┼┼┬┬┬┐ ╔╗ sensitive.
└┴┴┴┴┴┴┘ ╚╝ Shift-Alt-F7 Sort NON-case sensitive.
°*More* More Neat Stuff Press ∙F10 to pop Help level
───────────────
SED can "Shell" to DOS with "ESC F C" under the FILE menu. This is useful
for manipulating files on a disk that is TOO full to save to, or to go out
and format a new disk if needed. You can even run other programs from within
the editor if you need to. Type EXIT to get back to SED.
BOLD UNDERLINE & USER DEFINED PRINT CONTROL
───────────────────────────────────────────
%B This line will be printed BOLD %B
%U This line will be printed UNDERLINED %U
%B%U This line will be both BOLD and UNDERLINED %U%B
%1, %2 & %3 are user defined printer attributes.
See an example in the file PROPRINT.SEQ.
°Setup-NEWZ Setting up NEWZ and compiling index files
─────────────────────────────────────────
Included with NEWZ is a file called "NEWZ.CFG". This file contains
a series of lines holding parameters used by NEWZ. The NEWZ.CFG file
will look something like the following example (the line numbers are
not included in the file):
1: PATH C:\;C:\TEXT;C:\NEWZ ; file search path
2: DEFEXT TXT ; default file extension
3: DELIMS " " ; browse word delimiter string
4: SPECS *.TXT;*.DOC ; index compiler specs.
5: GLOBAL \TEXT ; hyper index \TEXT dir and below
6: WRAP ON ; turn wordwrap ON, or OFF
7: BACKUP ON ; make backup copies of files
8: AFTER 0 ; start looking after column 0
9: BEFORE 132 ; stop looking at column 132
10: STOPAT \ ; stop looking when ";" found
11: HILIGHT { } ; hilight these words in text
12: TYPE 0 "°" ; ∙Index-Compiler command
13: COLOR 1 1 2 ; set attrib1 to bg=blue, fg=green
14: ; ; stop looking at file
Press PgDn for more..
Setting up NEWZ continued
─────────────────────────
Parameter descriptions by line number
1. Directory search path line. The directories NEWZ will
search when you specify a file to open but don't include a
path to the designated file. This path is similar in format
to the DOS PATH command, but excludes the "=" symbol.
2. Default file extension. When you specify a file to open
but do not give it an extension, NEWZ will apply this the
default file extension to the filename before trying to
open it. If the line following DEFEXT is blank, no default
file extension will be applied to files.
Press PgDn for more
Parameter descriptions by line number (continued)
─────────────────────────────────────────────────
3. BrowseWord, uses the characters between " chars as a word
delimiter for the browse word operation. normally just a space,
but can contain other characters for use with other languages.
for example " (+-)[];" might be used for the "C" language.
4. Index compile file specifications. NEWZ can build an
index file from multiple file specifications as included
on this line. Filespecs can include full paths if needed.
5. Including the GLOBAL command followed by any directory, will
cause Z, when building the Hyper Index file, to search all
directories including the one specified and below for matching
file specs. "GLOBAL \" will search entire drive.
6. ON, OFF or 20 to 132, enables or disables wordwrap at editor
startup. ON calculates right margin according to longest file
line. 20 to 132 set a fixed right margin regardless of file.
Press PgDn for more
Parameter descriptions by line number (continued)
─────────────────────────────────────────────────
7. ON or OFF, keep backup copies of edited files or don't.
User specifiable depending on disk space available.
8. Only the characters in each file line AFTER the column number
specified will be examined when building HYPER.NDX. Defaults to
zero if not specified.
9. Only the characters in each line BEFORE the column number
specified will be examined. Defaults to column 132 if not set.
10. Don't look at the contents of any line beyond the specified
terminator character. (backslash in this case.) When building
the index file.
11. Hilight the words following whenever they are found on the
screen. Words are seperated by spaces, in list and on screen.
Multiple HILIGHT lines are accepted from the NEWZ.CFG file.
Alt-K for Keyword, toggles keyword hilighting on/off.
Press PgDn for more
Parameter descriptions by line number (continued)
─────────────────────────────────────────────────
12. Command to the index compiler. See the following section
∙Index-Compiler for further information.
13. Set color attribute 0 through 4 to the background/forground
color pair following. Three parameters follow the COLOR command,
an attribute number 0 to 4, and two color value in the range
0 to 15. Attribute 0 controls the normal background/forground
colors as used for text. Attributes 1 through 4 control various
aspects of the screen display. The color values for background/
forground, range from 0 to 15 as follows:
0=black 1=blue 2=green 3=cyan 4=red
5=magenta 6=brown 7=ltgray 8=dkgray 9=ltblue
10=ltgreen 11=ltcyan 12=ltred 13=ltmagenta 14=yellow
15=white
14. ";" terminates reading the configuration file.
Press ∙F10 to pop help level
°Index-Compiler Index Compiler Directives
─────────────────────────
Three index compiler directives are currently supported, they each start
with the word "TYPE" followed by a type number and a "string" parameter:
0 "string" Pick up and index the word IMMEDIATELY following
string. No space delimiter is required. If you
want to space delimit the string, include a space
within the quotes. Examples: ": " "CONSTANT "
"CODE " etc.
This type can pick up words following, as will be
the case with the above examples, or you can pick
up words starting with a character by not
including a space at the end of the string. An
example of this is the graphic symbol above "°",
which compiles any word starting with this
symbol. That is any hypertext destination link.
Press PgDn for more
Index Compiler Directives continued
───────────────────────────────────
1 ":" Pick up and index the word preceeding this
symbol. That is index all words that end in a ":"
character. Normally used for assembler labels.
2 "string " Pick up and index the word at the start of this
line preceeding this string. Again this is
typically used to include references to the
assembler word LABEL as it is used in some
assemblers. here is an example:
symbol_name LABEL
Symbol_name will be included in the index file.
Press PgDn for more
Index Compiler Directives continued
───────────────────────────────────
Several of the above index commands can be included one per line
before the line starting with a ";" character. The index compiler
currently supports up to sixteen (16) index compiler commands in the
above format.
Press ∙F10 to pop help level
°F10 What is the F10 key for?
────────────────────────
The F10 key "unlinks" or leaves one edit/browse level. If you were
editing, your changes are saved, and you will return to the previous file
you were editing or browsing. If you were at the first level of editing,
F10 will leave the editor.
The Shift-F10 key will take you to edit/browse level one. This saves you
from having to unlink through many levels with F1, and takes you directly
to level one. If you were already on level one, Shift-F10 will leave the
editor.
Clicking the left mouse button on the F10, +1 or +2 at the upper right
hand corner will do the same as pressing the F10 key.
Press F10 now to return to where you were before coming here.