Power-Programmierung

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 | 29.2 KB | 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.