Power-Programmierung

home *** CD-ROM | disk | FTP | other *** search

/ Power-Programmierung / CD1.mdf / forth / compiler / fpc / doc / fpchelp.txt < prev next >

Wrap

Text File | 1989-10-28 | 25KB | 528 lines

°EDMAIN Help with F-PC Forth & the SED Editor ─────────────────────────────── Press ∙F10 to leave Help ┌───────────────────────────────────────────────┐ │ Welcome to the Hypertext HELP system for F-PC │ └───────────────────────────────────────────────┘ ∙Hypertext ─ What is Hypertext anyway. Making my own ∙Hyper-System . ∙Get-Started ─ Help me get started with F-PC. ∙SED-Help ─ Help with editor commands and functions. ∙Forth-Help ─ Help with the F-PC Forth commands. ∙F-PC-Utils ─ Information on the Utilities built into F-PC. ∙Preferences ─ Information on the configuring F-PC. ∙Whats-New - What are the latest changes to F-PC ┌───────────────────────────────────────────────┐ │ Move the cursor with TAB onto a word shown in │ │∙reverse_video and press F9 or the Enter key. │ └───────────────────────────────────────────────┘ °Hypertext Hypertext Introduction ────────────────────── Hypertext is a technique for interconnecting 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 implemented 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-PC 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 browse a word with the mouse by positioning the mouse cursor over a word, then clicking twice with the left mouse button. The word will be looked up in the dictionary and a browser will be opened on its source. You can get to the HELP for a word rather than its source, by pressing Alt-H when the cursor is positioned on a word. You can also double-click with the left mouse button while holding down the Alt key to get HELP on a word. 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 command "Unlink to level one". The key sequence for this command is Shift-F10 or ESC-F-U. Press ∙F10 to UNLINK, or Press PgDn for more. Browser Introduction (cont.) ──────────────────── You can link THROUGH a DEFERRED Forth word by pressing Alt-F9. This is useful for deferred words like ∙EMIT . F9 will link to the source for one of these words, and Alt-F9 will link to its deferred function. Position the cursor with TAB on ∙EMIT here or above. press F9 then ∙F10 to return. You will have seen the source for EMIT which is a deferred 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. The next screen gives you information on how to create your own hypertext links. Press ∙F10 to UNLINK, or Press PgDn for more. °Hyper-System Making your own Hyper System ──────────────────────────── Creating a hypertext system with F-PC or the Z editor is very easy. There are only two special commands to learn, and all the rest is just text. The two commands are Alt-F3 which is used to specify words that are to be shown in reverse video, and Alt-F5 which specifies the destination of a link. To create a linkage (you must be in edit mode, not browse mode), pick a word, like "MyWord". Type the word into the document where you want to link FROM. Position the cursor on the word and press Alt-F3; this marks the word to be displayed in reverse video. Now go to where you want MyWord to link to, either in the same or another file. Type "MyWord" in again at the left margin of the document. Position the cursor on the word and press Alt-F5; this will mark the word as the destination of a link. The link will not take effect until you have re-compiled the HYPER.NDX file with the batch file MAKINDEX.SEQ, or with the Z editor's ESC-F-B (Build index) command. Press ∙F10 to UNLINK °Get-Started Help Me Get Started with F-PC ───────────────────────────── F-PC can be a lot to BYTE off at one time; start slowly and examine a few things at a time. There are several words that are useful in learning about this Forth system. Here is a list to remember: ∙HELP <word> Help on using <word>. ∙SEE <word> Decompile <word> to the screen. ∙VIEW <word> Browse the source for <word>. ∙WORDS <sub-string> Look for words in the dictionary containing <sub-string>. ∙F1-key General Help/Browser Hypertext system. (you are in it NOW) You might want to Press Shift-PrtSc to print a copy this screen ∙More-Details More information on the F-PC environment. °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-PC 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 shortcut keys F10 and Alt-F10. Any menu function can be performed with the shortcut key rather than moving through the menu and pressing Enter. If you press the 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-PC HELP │ F1 │ F2 │ Move cursor to TOP of screen Alt-F1 rotate through open │ │ │ files. ∙Files-More ├─────┼─────┤ 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 deferred word. └─────┴─────┘ changes. Use Shift-F10 to Unlink to the top level. °*Leaving* Press ∙F10 to pop Help level Leaving, Saving, and Printing under the FILE menu ───────────────────────────────────────────────── Menu command Shortcut key ESC F Q = Quit, save changes and unlink 1 level. ∙F10 ESC F A = Abort 1 level & discard changes. Alt-F10 ESC F U = Unlink all nest levels to level 1. Shift-F10 ESC F S = Save changes and continue editing. Ctrl-U ESC F W = Write current file to a new filename. Alt-W ESC F P = Enter the Print menu display. Alt-P °*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 line of copy or cut F5 = Copy a line from MARK to cursor line Use F3 to MARK the start of ALL Cut, Copy & Append operation. Cut, Copy, Paste & Append with DISK ─────────────────────────────────── * Alt-X = Cut from MARK through cursor line to TEMP.SEQ * Alt-C = Copy from MARK through cursor line to TEMP.SEQ * Alt-V = Paste Cut/Copied text at cursor line from TEMP.SEQ * Alt-A = Append from MARK through cursor line 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-J = 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 ≈120k file │ │ 512k can edit ≈64k 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. °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 to a screen to choose new file. 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. °Files-More More on using F-PC with multiple files F10 pops up ────────────────────────────────────── Though the File Open command ESC-F-O or Ctrl-O you can open up to 20 files while in the F-PC editor. When you open more than one file F-PC keeps track of where you were in each file, but only really edits one file at a time. Files get swapped in and out of memory as required. This is slower than keeping all of the file in memory, but on a hard disk system the performance is still acceptable. Alt-F1 can be used to rotate through the file that have been opened. Its reverse command is Shift-Alt-F1 which will rotate through the open files in the opposite direction. Shift-F1 will popup a window for you to select a particular file directly, avoiding the time required to rotate through several files to get to the one you want. To leave the editor, and close all files, use the File menu command ESC-F-X.