Club Amiga de Montreal

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

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 451.lha / MuchMore_v2.7 / MuchMore.ReadMe < prev next >

Wrap

Text File | 1990-12-09 | 14.1 KB | 383 lines

M u c h M o r e V 2.7 ============================ © 1989 by Fridtjof Siebert Nobileweg 67 D-7000-Stuttgart-40 Federal Republic of Germany What is MuchMore? MuchMore is another program like More, Less etc. that prints ASCII-Files to the screen. Unlike these, it opens its own screen to show the text and to scroll it softly! But not only softly, MuchMore is also able to scroll very quickly if you want it to! Furthermore, there are commands to search for strings and to print the text. MuchMore will run on any Amiga, whether it's a PAL, NTSC, overscan or any Amiga in future. Because MuchMore's screen has no border, there are 80 characters displayed per line. Why MuchMore instead of MORE, BLITZ or LESS? Because MuchMore is just better :-). MuchMore (17K) is much shorter than LESS (28K). BLITZ or other programs that scroll quickly or softly usually use 2 Colors and don't support any special fontstyles. MuchMore instead has 4 Colors and displays bold, italic, underlined and inverse text. Unlike many other programs, MuchMore uses the Font that's set with SetFont if it's an 8x8 Font instead of topaz 8. MuchMore is ideal to display long texts. The text is loaded simultaneously while it is displayed. That is, while you're reading the first page, the rest of the text is loaded into memory and you're able to move through the text quickly then without re-loading it. How to start MuchMore: CLI: Just Type: MuchMore [-s|-l] <FileName> FileName is the name of the ASCII-Text that is to be displayed. If there are any spaces in the filename it must be enclosed by quotes. "MuchMore ?" displays the usage. If MuchMore is started without an argument and the arp.library is installed, it will ask for the filename using arp's filerequester. 'MuchMore -s' starts MuchMore and sends it to sleep immediately until left alt & ESC is pressed. Then ARP's filerequester is used to get the texts name. '-l' forces MuchMore to open an interlaced Screen. When you're using an interlaced WB-Screen, this tells MuchMore not to open an interlaced screen. '-s' set MuchMore asleep. You may wake it up with Alt + ESC. Workbench: Just click the text to be printed with your mouse and then shift- doubleclick MuchMore. Texts with MuchMore as their default-tool (e.g. ":c/MuchMore" when MuchMore has been copied to the disk's :c/ directory) can be displayed easily by doubleclicking them. MuchMore's commands: The commands are activated simply by pressing their keys: Space or left mousebutton: Stops or restarts scrolling. While scrolling is stopped the filelength, linenumber and the current percentage of the text are displayed in the bottommost line. Pressing space at the end of the texts quits MuchMore. BackSpace or right mousebutton: Stops or restarts backwards scrolling. Works similar to the Space-Key. Up/Down or 2/8 of the numeric keypad: Scrolls one line up or down. If you press these keys together with the shift-key you can start and stop fast scrolling. Alternate plus these keys scroll one page up or down. PgUp / PgDn (numeric keypad): Scroll up or down one page. T (top) or Home: Moves to top of text. B (bottom) or End: Moves to bottom of text. F (find): Waits for a string to be entered and searches for this string starting at the topmost line currently displayed on the screen. The search is case-insensitive. If the string is found, the line containing the string will be displayed and the found string will be highlighted. Else the screen will display a beep. N (next): Searches for the next occurance of the string entered with `F'. See above. P (previous): Searches for the previous occurence of the string entered with `F'. It starts with the topmost line that's currently displayed and searches backwards. If the search is succesful, the line containing the string will be displayed like it is by the F-Command. Else a beep will be displayed. Shift + Fn: Shift plus one of F1 to F10 sets a text marker at the current position. Fn: Jumps to the text marker #n that's been set with Shift plus Fn. If text marker #n isn't set yet, it will be set to the current position, as it would have been if you had pressed shift plus Fn. G (goto): Opens a Window with an integer-gadget. You can enter the number of the line that is to be displayed. Shift + Alt + O (printout): Prints the text. This is done with "TYPE text TO PRT:". So it works with any printer when the preferences are set correctly. The commands TYPE and RUN must occur in the current C: directory. You don't have to wait while printing. You can continue reading the text with MuchMore. I hope that it is impossible to press shift+alt+o accidentally, so you won't print a 100k text when you in fact don't need a printout. The printing cannot be interrupted, but you can switch off your printer and wait for the printertrouble- requester :-). W (write): Writes the text that's marked between the textmarkers that have been set with F1 and F2 to a file or to PRT: when you accept the default filename. The text is saved starting at the topmost line of the page marked with F1 until the bottommost line of F2's page. To print the current page you just press Shift+F1, Shift+F2, w and RETURN. L (load): Opens the arp-filerequester and loads a new text. This command does only work if the arp.library is present in the current libs: directory. HELP or H: Shows all MuchMore-Commands. This way everybody who doesn't have this documentation file should be able to use MuchMore. After pressing any key the text is displayed again. ESC, Q, X or 5 of the numeric keypad: Quit MuchMore. S (sleep): Closes MuchMore's Screen and waits until left alt plus ESC is pressed. Then arp's filerequester is used to get the text's name like it is within the 'L' command. It is not possible to send more than one MuchMore to sleep. The Files in this package: MuchMore The executable MuchMore.ReadMe This textfile MuchMore.LiesMich German documentation src (dir) This directory contains the source: MuchMore.mod The OBERON Source MMQText.asm sources of the assembler procedures (A68k) MMInput.asm assembler source of MuchMore's InputHandler All files apart from the objectfiles have an icon. Copyright: MuchMore is free to be spread on public-domain and shareware disks, as long as they are sold for a reasonable charge that is less than $6 or DM 8.-. It may be used there to display readme- and documentation-files. My name has to be left in the program (HELP). Although MuchMore is not Shareware, donations are welcome. It's not allowed to use this in a commercial way without my written permission. This permission is also necessary if you want to publish MuchMore as a part of a commercial product. If you change anything in my source you're allowed to put your name in the program's head (:History.), but leave my name in! If you've made any enhancements, please send them to me (else there'll be thousands of different versions). Mail: If you have any comments, donations, questions or PD programs just send them to me! If possible, also send the return postage. Compile: MuchMore is written in OBERON using a compiler I've written :-). The compiler is not public domain. It will be available in September '90 at A+L AG Däderiz 61 CH-2540 Grenchen Switzerland. Revisions: v1.0: - this version was terribly slow and therefore not published! v1.1: - first published version. v1.2: - now the file's name, its length etc. are displayed when scrolling is stopped with <Space>. - now left and right mousebutton can be used instead of space and backspace. - controlcodes aren't displayed anymore. v1.3: - Strong increase in speed while scrolling. WarpText has been replaced by QText (Sorry, Bill). MuchMore is now as fast as Blitz (with Video Sync) although it uses a bigger screen. - Now supports numeric keypad (home, end, PgUp etc.) - Now the screen gets it's size from gfxbase^.normalDisplayXXX. This way MuchMore can be run on PAL, NTSC, Amigas with an Overscan- Workbench (like mine), and on resolutions that'll be used in future. It always opens its screen as big as the current Workbenchscreen. v1.4: - Displaying and loading of the text are now done by two asynchroneous tasks. Scrolling is more homogeneous now and there are no more stops to load further text. - The feature to display several texts has been removed. - Bugs in filelength and end-function removed - New commands: find, next, previous to search for strings - Scrolling stops when MuchMore's window becomes inactive. v1.5: - New command: print text (shift+alt+o) - removed all imports to make MuchMore shorter - added numeric key 5 to quit v1.6: - From this version on texts with different fontstyles (bold, italics, inverse) and different colors can be displayed! v1.7: - Now MuchMore is again as fast as MuchMore v1.5 was, although it uses 2 bitplanes and uses several fontstyles. - Print (shift+alt+o) doesn't crash anymore when you quit MuchMore before printing is complete. v1.8: - Bug which occured when searching for a string having searched for a longer string, removed. - Strings found while execution of F, N or P are highlighted now. - Added NK0 to display filelength etc. v2.0: - Ported MuchMore to OBERON - Removed bug that caused RMB not to work on some amigas (it did work on my computer) - now uses the arp-filerequester - new command: L = load new text v2.1: - Read-/write-errors used to create some very interesting crashes with colorful graphics and stereo sound. I'm sorry, but I had to remove this. - CSI-Codes have been executed BACKWARDs. This caused problems with sequences like <CSI>0;4m. Fixed now. - New Commands: Ping & Pong, Goto - First page is displayed immediately now when MuchMore is started. v2.2: - Now MuchMore uses console's keymapping instead of the hardcoded one it used before. So there won't be problems with any japanese keymaps. v2.3: - New command: 's' (sleep) and pop up function lAlt+ESC. 'MuchMore -s' sleeps immediately. - Bug in interpretation of <CSI>[m fixed. <CSI>[m is now treated as <CSI>[0m. v2.4: - New Command: 'w' to write block to file or priner - Argumentparser rewritten. Now supports quotes. v2.5: - Uses 8x8 Font set with SetFont instead of topaz 8. - Allocates 4K Memory chunks instead of one memorychunk for each line. So MuchMore won't scatter the Memory anymore. Another positive effect is that MuchMore needs less nemory now (about 14 Bytes per line). v2.6: - asynchronous fast scrolling with the ctrl-key. - MuchMore is reentrant (pure) - MuchMore uses an interlace screen when the preferences are set accordingly. - On low chip-memory, MuchMore uses a 1-plane screen. v2.7: - '-l' to toggle interlaced mode - uses ASL's FileRequester - no more calls RethinkDisplay() 50 (or even 60) times a second --- Fridtjof.