home *** CD-ROM | disk | FTP | other *** search
- *****************************************************************************
- * *
- * Text Plus V2.2E (c) Copyright 1990 by Martin Steppler *
- * *
- * Text Plus V2.2E is SHAREWARE. It is freely distributable, although all *
- * rights remain with the author. If you like Text Plus and use it regu- *
- * larly, you should send me a donation ($15). This will make you get *
- * the latest update. *
- * Advice for all PD-distributors: *
- * Text Plus V2.2E must not be added to a PD-library without my consent. *
- * The price must not exceed the costs of disk, package and mailing. *
- * *
- * Please send bug-reports, suggestions, comments, and MONEY (!!!) to: *
- * *
- * Martin Steppler Roermonder Str. 112a *
- * Dr.-Danzebrink-Str. 11 D-5100 Aachen, FRG *
- * D-6400 Fulda, Fed. Rep. of Germany (I study in Aachen) *
- * *
- *****************************************************************************
-
-
- CREDITS
-
- First I want to thank JUSTIN V. McCORMICK, whose
- FileRequester (Fish #245) I've implemented. He wrote the
- best and most comfortable filerequester, I've seen so far.
- Thanks JUSTIN!
-
-
- CONTENTS
-
- 0 CHANGES
- I INSTALLATION
-
- Descrption of menus and their items:
-
- II PROJECT
- III EDIT
- IV PREFS
- V STYLE
- VI FIND
-
- VII KEYMAP AND SHORTCUTS
-
-
- 0) CHANGES
-
- V2.2E 06.08.1990
-
- - The old file-requester has been replaced by Justin's PATHMASTER.
- - The block-opearations mark, copy, delete, and delete mark can now
- directly be executed with the mouse. (--> III)
- - The keymap has almost entirely changed. Now you can delete single
- words, or skip them, move blocks to the left or right etc...
- - Iconfy
- - Backup-mode for saving files from overwriting them.
- - Some new gadgets. Just have a look at the right border! Wow, 8-)
- - Smaller enhancements (e.g. the main window now starts 1 pixel lower
- than before. So you can easily switch back to the WB-screen.)
- - TextPlus creates an own process. You no longer need to type 'run
- TextPlus' to start it the background.
-
- V2.1E 01.05.1990
-
- - TP opens an own screen.
- - A mouse-click now positions the cursor.
- - Blocks are now formatted correctly. (When encountering spaces
- while formatting TP doens't get confused anymore.)
- - 2 bugs of the load-loop have been eliminated
- - Command sequence in letters are no longer handled as regular
- characters.
- - The suffix ".txp" needn't to be typed anymore, in order to
- load a letter correctly.
- - Busy-wait-loop deleted. (How did it get in my program 8-( ?)
-
-
- I) INSTALLATION
-
-
- Text Plus V2.2E (from now on refered to as TP) can be run
- from both, Workbench and CLI.
-
- USAGE: TextPlus2.2E [-i] [filename]
-
- If the i-flag is set, TP only opens an iconized window. If
- you also type a filename, the file will not be loaded until
- you activate TP by pressing the MENU BUTTON. Without the i-
- flag set TP will load the respective file or nothing, if
- nothing was specified.
-
- After a succesful start, TP tries to load its configuration-
- file 'TxP. Config', and if TP fails to find it in the
- current directory, TP will search for it in the 's:'-
- directory. The configuration-file enables the user to create
- a personal environment according to his own requirements,
- i.e. to set the text-width, page-length, tabulators etc.
- TxP.Config is an ASCII- file, which can be changed very
- easily. This is why I think the remarks in TxP.Config fully
- suffice for understanding, how to change the settings.
- Anyway, TP runs without TxP.Config, too.
-
-
- II) PROJECT
-
-
- 1) LOAD
-
- After clicking on this menu-point a filerequester pops up,
- the current function of which - here: 'Load file' - is
- displayed in the window-title-bar. The selector is
- completely dynamic and asynchronous; you may change
- directories, select files, scroll the file list, etc., while
- the selector is scanning a directory.
-
- The three Sort Gadgets (Alpha, Size, and Date) work like
- switches. For instance, if you click on the "Alpha" Sort
- Gadget, the gadget will remain highlighted ("On") when you
- release the mouse button. The File Selector will now
- alphabetize directories automatically until you turn the
- Sort Gadget "off" by clicking it again, or click on a
- differnt Sort Gadget.
-
- Clicking the Menu Button activates the FILE or PATH String
- Gadget, allowing you to type in a new file or pathname
- without having to click inside of the string gadgets first.
- Also, some keyboard shortcuts are available:
-
- ESCAPE - Same as clicking on the "Cancel!" gadget.
- Cursor-Up - Same as clicking on the Up Arrow gadget.
- Cursor-Down - Same as clicking on the Down Arrow gadget.
- Shift-RETURN - Toggle between FILE and PATH gadget.
-
- Note that if the PATH, FILE, or PATTERN String Gadgets are
- in use, the keyboard shortcuts are disabled. The selector
- has a software path length limit of 344 characters. You will
- receive a warning message in the titlebar if you try to
- exceed this limit.
-
- After a file has been chosen as described above, TP loads
- either an ASCII- file (letter-mode switched off) or a letter
- (letter-mode switched on; suffix '.txp').
-
- 2) APPEND FILE
-
- A file will be appended to the end of the already existing
- file.
-
- 3) DELETE FILE
-
- The file will be deleted in memory.
-
- 4) SAVE
-
- The file is saved with its current name depending on the
- letter-mode either in letter-format or as an ASCII-file. The
- filerequester won't pop up.
-
- 5) SAVE AS ...
-
- After a filename has been chosen, it is saved depending on
- the letter-mode either in letter-format or as an ASCII-file.
-
- 6) SAVE & QUIT
-
- The file is saved with its current name and then TP quits.
-
- 7) PRINT
-
- A requester appears, in which you can choose one of four
- print-modes (NLQ, Pica, Elite or Condensed) and set the
- pages to be printed, left and right margin, and the paper-
- length. Furthermore you can switch on/off the page-
- numbering-mode (at the end of every page its number is
- printed) and the line-numbering-mode.
- At the beginning of every page the user is asked, whether
- he wants to skip over the respective page, print it or
- abort. If an error occurs, you are requested, whether you
- want to try again or abort.
-
- 8) ICONIFY
-
- TP closes its window and its screen and opens up an iconized
- window on the Workbench. You will get back to the main
- program by pressing the MENU BUTTON while the window is
- activated. The coordinates of the iconify-window can be set
- in the config-file. Using iconify instead of dropping the
- screen to the background will free 42KB of memory.
-
- 9) HELP
-
- Show the keymap.
-
- 10) ABOUT
-
- Informations about the author.
-
- 11) QUIT
-
- Quit TP without saving changes.
-
-
- III) EDIT
-
- 1) MARK BLOCK
-
- The current position of the cursor determines the beginning
- and after another click on MARK BLOCK the end of the block.
- Now the block-mode is switched on, which can only be
- switched off by clicking on 'Delete Mark' or 'Delete Block'.
-
- 2) COPY BLOCK
-
- Insert previously defined block at the current position of
- the cursor.
-
- 3) DELETE BLOCK
-
- The marked block is deleted.
-
- 4) DELETE MARK
-
- The block-mode is switched off.
-
- Those four block-operations can be done very easily with the
- mouse:
-
- DOUBLECLICK Mark begin of block.
-
- If the mouse-pointer is in the first or in
- the last line TP will scroll respectively. Of
- course, you can use the prop gadget and the
- arrow gadgets, too.
-
- DOUBLECLICK Mark end of block.
-
- DOUBLECLICK Copy block
- DOUBLECLICK + SHIFT Delete block
- DOUBLECLICK + ALT Delete mark
-
- 5) LOAD BLOCK
-
- An previously selected file is inserted at the current
- position of the cursor.
-
- 6) SAVE BLOCK
-
- The marked block is saved on disk.
-
- 7) PRINT BLOCK
-
- The print-out takes place as described above -> PRINT.
-
-
- IV) PREFS
-
- 1) LENGTH OF PAGE
-
- The new page-length is set which must range from 10 to 72
- lines.
-
- 2) WIDTH OF TEXT
-
- The width must range from 10 to 255. If a block has been
- marked, it will formatted according to the new width.
-
- 3) INSERT ON/OFF
-
- The insert-mode is either switched on or off. If switched
- on the 3 letters 'INS' above the ruler indicate it, and
- characters are inserted in the already existing text and
- don't overwrite the text.
-
- 4) LETTER ON/OFF
-
- The state of the letter-mode is displayed above the ruler
- (LETTER/ASCII). Every time when a file is loaded or saved
- the letter-mode determines whether an ASCII-file or a file
- in letter-format is loaded or saved. You can identify a file
- in letter-format by its suffix '.txp'.
-
- 5) AUTO-DIV ON/OFF
-
- Text Plus V2.2E was originally designed to be a German word-
- processor. Due to the occurrence of ultra-long words in
- German a function called Auto-Div which divides ultra-long
- words in accordance with German grammar has been provided
- in order to decrease the number of ultra-long gaps in the
- text. Auto-Div divides English words in accordance with
- German grammar, too. This is why you better keep it switched
- off. If there is someone who wants TP to divide English
- words according to English grammar then don't hesitate to
- send me first the share and then the rules of English
- grammar.
- If Auto-Div is switched on and if a block is marked and then
- formatted (left/right-aligned, centered, justification),
- words which are too long for the respective line are divided
- in order to avoid large gaps. Auto-Div is not perfect. This
- is why you should always check the division. Words divided
- by TP end with this dash '' and only this dash is accepted
- by TP in case of reformatting to indicate a division.
-
-
- 6) BACKUP ON/OFF
-
- If switched on TP checks the disk for the same filename you
- want to save. Providing the file exists the suffix '.bak' is
- added to this file in order to protect it from being
- overwritten.
-
- 7) GO TO ...
-
- After the string which is to be searched for has been
- entered, TP is searching for it at the beginning of every
- line and only finds the string if it starts in the first
- column.
- This routine is quite useful for C-programmers, because one
- can find modules, e.g. main() , very fast especially in long
- sourcecodes.
-
- 8) GO TO LINE X
-
- TP jumps to line x. This routine, too, is useful for
- programmers, because compilers tell the user the line in
- which an error has occurred.
-
-
- V) STYLE
-
-
- 1-4) NORMAL, UNDERLINE, BOLD, ITALIC
-
- The new style is set, and if a block has been marked, it is
- displayed in the new style.
-
- 5-8) LEFT ALIGNED, RIGHT ALIGNED, CENTERED, JUSTIFICATION
-
- The line in which the cursor is located is formatted
- according to the new alignment, or if a block has been
- marked, the block is formatted.
-
-
- VI) FIND
-
-
- 1-3) FIND, NEXT, PREVIOUS
-
- After the search-string has been entered and found it is
- displayed in the top line and the cursor is set to the
- beginning of the word. NEXT and PREVIOUS search for the next
- or previous occurrence of the already entered string.
-
- 4-6) REPLACE, NEXT, PREVIOUS
-
- After the search-string and the replace-string have been
- entered and the search was successful, the user is asked if
- he really wants to replace the found string. NEXT and
- PREVIOUS search for the next or previous occurrence of the
- search-string.
-
-
- VII) KEYMAP AND SHORTCUTS
-
-
- 1) KEYMAP
-
- CONTROL
- -b mark begin/end of block
- -c insert block at position of cursor
- -d delete mark
- -x delete block
- -q save and Quit
- -t display length and end of Text
- -n/-u/-o/-k style: Normal / Underline / bOld / italiK
- -e/-r/-a/-p insErt / letteR / Auto-div / backuP on/off
-
- SHIFT-DEL delete line
- SHIFT-CR insert last deleted line
- CTRL -BS/DEL delete begin / rest of line
- ALT -BS/DEL delete previous / next word
- SHIFT-BS delete spaces
- CTRL/ALT-TAB move line to the previous/next tab-stop or
- move block to the previous/next tab-stop
- CTRL -CRSR-LFT/RGT move block left/right
- SHIFT-CRSR-UP/DOWN jump to top/bottom of window or 18 lines up/down
- ALT -CRSR-UP/DOWN jump to begin/end of text
- CTRL -CRSR-UP/DOWN jump to begin of previous/next page
- SHIFT-CRSR-LFT/RGT jump to begin/end of line
- ALT -CRSR-LFT/RGT jump to previous/next word
-
- HELP show keymap
- ESC quit without saving changes
-
- 2) SHORTCUTS
-
- RIGHT AMIGA
-
- -g load file
- -a append file
- -d delete file in memory
- -w save
- -s save as ...
- -q save and quit
- -p print
- -y iconify
-
- -k load block
- -m save block
- -z print block
-
- -t page-length
- -w text-width
-
- -n style: normal
- -u underline
- -b bold
- -i italics
- -l alignment: left
- -e right
- -c centered
- -j justification
-
- -f find
- -1 "" next
- -2 "" previous
- -r replace
- -3 "" next
- -4 "" previous
-
-
- IS THIS THE END OF THE DOC-FILE! OH, YES!
-
- Keep on using Text Plus V2.2E, bye bye and tschuess
-
-
- 08.08.1990 Martin
-