Frozen Fish 1: Amiga

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

/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d570 / view.lha / View / View.DOC < prev next >

Wrap

Text File | 1991-11-21 | 18KB | 397 lines

- View version 1.5 - --------------------------------------- - © Copyright 1991 Jaba Development - - written using DICE C by - - Jan van den Baard - --------------------------------------- DISCLAIMER ---------------------------------------------------------------------------- The author is not responsible for any damage caused by the use or misuse of this documentation and/or the program(s) it describes. Any damage resulting from the use or misuse of this documentation and/or the program(s) it describes is the sole responsibility of the user her/him self. ---------------------------------------------------------------------------- COPYRIGHT ---------------------------------------------------------------------------- View, © Copyright 1991 Jaba Development. All rights reserved. This program may be distributed non-commercially providing that the source code, documentation, copyright notices and executable remain unchanged and are included in the distribution. Also no more than a !NOMINAL! copy fee may be charged for the distribution. This program is FREEWARE so no financial donations are required ( The only thing I would like is a postcard from your home town!). Any form of commercial usage is not allowed without my written permission. ---------------------------------------------------------------------------- Some of you might be familiar with other versions of View. These versions of View have been totally rewritten by me to run only under OS 2. The key- commands have changed radically from the older versions of View. All the key-commands MORE supports are supported by View plus a lot of new commands where added. View KeyMap commands : Space,Pg Dn -> This will go down one page of text (MORE). If there are not enough lines left in the text to fill the screen this function will go down 'x' amount of lines until the last line is displayed. Backspace,Pg Up -> This will go up one page of text (LESS). If there are not enough lines left in the text to fill the screen this function will go up 'x' amount of lines until the first line is displayed. Return,Dn,Nk Dn -> This will scroll the text up one line and display the next line of text at the bottom of the screen. Enter,Up,Nk Up -> This will scroll the text down one line and display the next line of text at the top of the screen. <,Nk Left -> This will display the first page of the text. >,Nk Right -> This will display the last page of the text. /,F -> This opens a little window in which a string gadget is located. In this string gadget you can type a word or a sentence you want to locate in the text. Once you are done you should press return and the program starts to look from the first line on the screen for the specified string. If the program finds the string in the text it will be displayed inverse. The search is case sensitive. N/P -> This will look for the Next/Previous occurrence of the word last found. The search will begin from the point where the program had found the string the last time you have called one of the search routines. The search is case sensitive. .,S -> This does the same thing as /,F with the exception that the search will be case insensitive. CTRL+N/CTRL+P -> This does the same thing as N/P with the exception that the search will be case insensitive CTRL+L,R -> This will redisplay the text on the screen in the (unlikely) event that the display has been damaged for one or the other reason. This has been featured to keep it all compatible to MORE. % -> This opens a little window with an integer gadget in it. In this integer gadget you can type the percentage (0 to 100) of the file you want to jump to. E -> For this to work you must use SetEnv to set-up an environment variable called EDITOR. For example, if you normally use dme as your editor and this editor is located in the C: directory you should type the following in the shell: SetEnv EDITOR=C:Dme. If the environment is set up correctly the program will run the editor with the file currently in memory. The program looks through the DOS resident list first to see if the editor is resident. If not it will try to load the editor from disk. NOTE: The editor may NOT be crunched ! L -> This opens the ASL FileRequester for you to select a file you want to read. When you are done select Load and, if everything went OK, after the loading is done the first page of the file you have selected is displayed. J -> This is a feature not found in many of the other ASCII file viewers. This will jump to the position where the program has found a string the last time one of the search routines where called. It's a feature I use a lot. B -> This puts View to sleep. The program closes the screen and waits until the user call's view by pressing a hotkey. See below for the hotkeys. The text in memory will be lost. CTRL+B -> This does the same thing as B with the exception that the text will stay in memory and will be available when View is signalled to wake-up again. LSHIFT+CTRL+D -> This will dump the page currently on the screen to the printer. It uses the printer.device so make sure that it's set correctly. While the printing is in progress a little window is in the screen's top left corner. Closing this window will abort the printing. Once you have stopped the printing the printer goes on until it's buffer is empty. You can continue reading the file while the printing is in progress. It is not possible to put View to sleep, quit or to load a new file while the printing is in progress. LSHIFT+CTRL+P -> This will dump the complete text in memory to the printer. The same window as with LSHIFT+CTRL+D pops up to enable you to stop printing. H,HELP -> This puts some information about the author and the available key- commands possible with this program. Q,CTRL+C,ESC -> This is a nasty one. Pressing any of these keys will quit View. Fn -> This enables you to mark blocks in the text in memory. This block marking goes in two fases. The first time you press 'F1' the first line on the screen will be the first line of text block #1. When you press 'F1' again the last line on the screen will be the last line of text block #1. Only when you have marked the first and the last line of a text block the block will be marked. It's possible to mark 10 blocks in a text (F1..F10). SHIFT+Fn -> This will unmark text block #n making it free to mark another text block. CTRL+Fn -> This will jump to the first line of text block #nm. LSHIFT+CTRL+Fn -> This will dump text block #n to the printer. The printing window is opened to enable you to stop the printing. You can continue to read the file while the printing is in progress. LALT+Fn -> This will open the ASL FileRequester in which you can select a name under which you can save text block #n. CTRL+S -> This will open the ASL FileRequester in which tou can select a name under which you can save the whole text. SHIFT+E -> This will open a little window in which a string gadget is located. In this string gadget you see the FIRST line on the screen which you can edit. When you press return the line will be replaced by your changes. If you press the close gadget of the window the operation is canceled. This might come in handy if you spot an error in your text and you want to change it quickly. It is possible to edit escape sequences in the string gadget. When View is sleeping : There are three "user-configurable" hotkeys which will signal View to do something. These hotkeys can be set by passing a hotkey- string (See below ) as an argument to view. The following functions can be called with the use of hotkeys while view is asleep. QUIT will quit View while it is asleep. VIEW will pop up the main screen and display the text if remembered or otherwise put up the ASL FileRequester for you to load a file. FLUSH will erase the text, if remembered, from memory. Starting View : You can start View from either the CLI/Shell or the Workbench. To start View from the CLI/Shell you can type : Run View [Name] [PRIORITY=<pri>] [POPWINDOW=<YES|NO>] [VIEW=<hotkey>] [FLUSH=<hotkey>] [QUIT=<hotkey>] With: Name : An optional name of the file you want to read or a pathname in which you want the FileRequester to start looking for files. PRIORITY : With this argument you can specify the broker priority in the commodities queue. Default : 0 POPWINDOW : This enables you to enable/disable View from opening it's window when it is started. Default : YES VIEW : With this argument you can set your own specific hotkey to let View open it's window. Default : lalt lcommand v FLUSH : With this argument you can set your own specific hotkey to let View flush it's text buffer. Default : lalt lcommand f QUIT : With this argument you can set your own specific hotkey to quit View while it's asleep. Default : lalt lcommand q You can specify the last five arguments through the ToolTypes array of the program it's icon for the Workbench. When you start View from the WBStartup startup drawer you must set the DONOTWAIT tooltype also. HotKey Strings : With view you can specify your own hotkeys. The hotkey (Input Description String) string has the following template: [qualifier] [qualifier] [qua...] [highmap | ansi] NOTE: There is more possible with the Input Description String but this template makes the most sence for this aplication. qualifier: lshift, rshift, shift, capslock, caps, control, lalt, ralt, alt, lcommand, rcommand, numericpad, repeat, midbutton, rbutton, leftbutton, relativemouse higmap : comma, space, backspace, tab, enter, return, esc, del, up, down, right, left, help, f1..f10, 0..9, (, ), /, *, -, + ansi : a single character which is translated using the system default keymap. Requirements : View requires Kickstart 2.0 to run. Also a copy of the "nofrag.library" is required to be in the LIBS: directory of the boot disk. If you also have the "powerpacker.library" in the LIBS: directory View is able to read files crunched with PowerPacker. You will need the REGISTERED version of DICE to recompile the source code. Also you need to make link libraries of the "powerpacker_lib.fd" and the "nofrag_lib.fd" files using "fdtolib". "fdtolib" comes with both the registered and freeware versions of DICE. When you use View to read PowerPacker crunched files make sure that you have set-up 'T:' as a logical device. If not try to add the following two lines in your startup-sequence : MakeDir RAM:T Assign T: RAM:T Credits Credits must go to Matthew Dillon for his wonderfull DICE C compiler and his DME editor and DMouse and...and...and..., Thanks Matt! By the way, you should register to DICE because it's the best deal you'll ever make! Credits also must go to Nico François for his PowerPacker and his powerpacker.library. You should order a copy of "PowerPacker professional" And credit must go to Yves Perrenoud for finding the ugly "jump to last found string bug". TODO (perhaps...someday....when I feel like it.......) o Making View automatically detach itself from the CLI. How about a auto- detach "_main.c" Matthew ? o Multiple texts. (Is this really necessary....(?)) o Background process loading/displaying. o Why don't you give me some ideas..... Notes : View does not fragment memory because it uses the "nofrag.library" to allocate the memory for the text. All escape sequences supported by the console.device are supported by View. If the first character on a line is a FormFeed View will translate it into F. The repeating of the keys is handled in a way that View will never execute a function more than once after you have released the keys. View automatically adapts itself to the standard screen resolution and system font. View always displays one column less than there would actually fit on the screen. This is because the console.device uses a cursor, which is invisible in View, that forces the display to scroll when it hits the bottom-right corner of the screen. You should use LEFT_AMIGA+M/N to switch screens because View it's screen has no depth gadget. When you are a lucky owner of an 68030 machine I suggest you use the CpuBlit program by Eddy Carrol which will stop the ugly flickering when multy coloured text is scrolled. View makes use of the "powerpacker.library" if available. This library can be found on FISH 414 and is © Oct 1990 by Nico François. History : 1.0 - Initial version. (let's see how it goes!) 1.1 - The temporary decrunched file did not get written to "T:". This has been fixed. The Enforcer complained when View was started from the CLI or Workbench without any arguments. This has been fixed. View now has a much improved filename parser which recognizes and parses the arguments for the ASL-FileRequester. 1.2 - View now starts to look for a string from the first line on the screen. This seems to be the standard and it is less confusing. View now offers the possibility to save the text blocks to a file. 1.3 - View now supports ECS screen modes like SuperHires. 1.4 - Filerequesters now include a pattern gadget. (Don't you just love OS-2.....) Added the possibility to save the whole text. Added a little line editor. It can't do very much but it's sufficient to fix errors in your text's. 1.5 - Replaced the input-handler by a "user-definable" commodity broker. Removed the routine that controled the repeat keys. I just read the intuition autodoc and guess what.. there is a tag that does the same thing! Bug fixed! --> 'jumping to last found string' when there wasn't any string found would screw up the program trying to display data that does not exist. Bug reports, flames, constructive criticism (I hope I spelled this right), PD programs, ideas to the following address : Jan van den Baard Bakkerstraat 176 3082 HE, Rotterdam Netherlands Fido 2:500/29 (Jan van.den.Baard)