Fileview by Snake River Software Version 1.12 Program and Documentation Copyright 1990-1991 All Rights Reserved Microsoft and MS-DOS are registered trademarks and Windows is a trademark of Microsoft Corporation. Fileview 1.12 ______________________________________________________________________ Contents* Contents* Contents* 1. 1. 1. Overview Overview Overview ................................ ................................ ..................................... ..... ..... 1 1 1 2. 2. 2. Notations Notations Notations ................................ ................................ .................................... .... .... 1 1 1 3. 3. 3. Acknowledgements Acknowledgements Acknowledgements ............................. ............................. ............................. 1 1 1 4. 4. 4. System Requirements System Requirements System Requirements .......................... .......................... .......................... 1 1 1 5. 5. 5. Installation Installation Installation ................................ ................................ ................................. . . 2 2 2 6. 6. 6. Usage Usage Usage ................................ ................................ ........................................ ........ ........ 2 2 2 7. 7. 7. Commands Commands Commands ................................ ................................ ..................................... ..... ..... 3 3 3 8. 8. 8. Keys Keys Keys ................................ ................................ ......................................... ......... ......... 5 5 5 9. 9. 9. Searching Searching Searching ................................ ................................ .................................... .... .... 6 6 6 10. 10. 10. Messages Messages Messages ................................ ................................ ..................................... ..... ..... 7 7 7 11. 11. 11. WIN.INI WIN.INI WIN.INI ................................ ................................ ...................................... ...... ...... 8 8 8 12. 12. 12. License Information License Information License Information .......................... .......................... .......................... 9 9 9 13. 13. 13. Rates Rates Rates ................................ ................................ ........................................ ........ ........ 10 10 10 A. A. A. Single User License Application Single User License Application Single User License Application .............. .............. .............. 11 11 11 B. B. B. Site License Application Site License Application Site License Application ..................... ..................... ..................... 12 12 12 * Page numbers are based on the printed version. The *.txt version of this document that is distributed on disk may not be the same. The page numbers should provide an approximate place to refer to. __________________________________________________________________________ Date: January 11, 1991 1. 1. 1. Overview Overview Overview This documentation is for release 1.12 of Fileview. Fileview is a Microsoft Windows based tool that allows you to browse files on your hard-drive or network drives. Unlike other Windows browsers, Fileview does not load the file into memory, allowing you to browse files that are larger than available memory while leaving room for other windows applications to run. To use Fileview, select a file to browse from the File/Open dialog as you would select a file in any other windows program. Once you are browsing a file, you can scroll through it and search for text using DOS style or Regular Expression style search patterns. 2. 2. 2. Notations Notations Notations The following notations are used in this manual: [text] is used to identify optional information. If the option is not specified, the default action will be taken. An exception is in the discussion of the WIN.INI file. WIN.INI section headers are identified as [text] [text] [text]. These sections are boldfaced to assist in their identification whereas [options] are not normally boldfaced. Hopefully, context and the use of boldfacing will distinguish these two uses. 3. 3. 3. Acknowledgements Acknowledgements Acknowledgements The regular expression routines were derived from routines written by Henry Spencer and copyright in 1986 by the University of Toronto. 4. 4. 4. System Requirements System Requirements System Requirements Fileview runs within the Microsoft Windows. Minimum System requirements include: Microsoft Windows 3.X or higher Fileview 1.12 ______________________________________________________________________ DOS 3.X or higher Approximately 70K memory* Approximately 50K disk space Windows compatible mouse * Memory available within the Windows environment. The memory required by Fileview varies with use. The minimum memory is approximately 70K. 5. 5. 5. Installation Installation Installation Fileview is easy to install. Simply copy all distribution files to the disk/directory where you want to run Fileview from. This will usually be \windows. Note that you may install Fileview in a directory that is not in your environment path if you provide the path to the program manager. However, the Fileview.hlp file must be in the environment path for it be found when help is requested. If you install Fileview in a path that is not in your environment path, installing it in the \windows directory is recommended. All configuration options reside in your WIN.INI file. All of these can be set within Fileview. 6. 6. 6. Usage Usage Usage Fileview is invoked like other windows programs. From the WINDOWS Program Manager, double click a Program Group that contains Fileview, then double click on the Fileview icon. If you have installed Fileview as a program under Filefind's user defined menu, you may invoke it from Filefind and automatically open and browse the selected file. __________________________________________________________________________ Date: January 11, 1991 Page: 2 Fileview 1.12 ______________________________________________________________________ 7. 7. 7. Commands Commands Commands _ F _ F _ File ile ile _ Open Invokes a dialog to choose a file to browse. The dialog consists of one edit field and two list boxes. The file name with a path or wild cards may be entered. If the file specification does not contain wild cards, Fileview will attempt to open the file. If the file specification includes wild cards, Fileview will list all matching files in the path, and change the default extension to match the specification extension. The extension will remain until changed again, or the program is terminated. A file list box allows a specific file to be picked without typing the filename. A directory list box allows the directory tree to be traversed and the disk drive to be changed. _ Refresh File Reloads the current file. Fileview loads a series of pointers into the file the you are using. If this file becomes changed (because you are changing it with NOTEPAD for example), Fileview will not display the file correctly. The _ Refresh File command instructs Fileview to reload its pointers so the file is correctly displayed. This command is only needed if the file is changed while you are viewing it. _ Select Printer Selects the printer to use. The printer selected will remain the printer to use until another is selected or you close the program. If no printer is selected, the windows default printer is used. Setup... within this dialog opens the setup dialog for the particular printer selected. The details of the Setup... dialog vary with the printer selected. Control Panel... within this dialog will invoke the Control Panel(CONTROL.EXE CONTROL.EXE CONTROL.EXE). This program must reside in the windows directory (Whatever directory you originally installed windows in). Print _ File Prints the file. Print _ Window Prints the portion of the file shown by __________________________________________________________________________ Date: January 11, 1991 Page: 3 Fileview 1.12 ______________________________________________________________________ the window. E_ xit Shuts down the program. _ E _ E _ Edit dit dit _ Search Invokes a dialog to specify search criteria _ Continue Search Searches from the top line in the display downward for the last search string specified. _ O _ O _ Options ptions ptions _ ASCII Switches the display mode to ASCII. ASCII is not always available. Fileview examines the beginning of the file to determine whether ASCII mode is feasible. If not, ASCII mode is disabled. _ Hex Switches the display mode to Hexadecimal. _ Format Invokes a dialog that allows the display to be tailored. Settings in this dialog may be saved. Saved settings may also be restored. _ Register User Invokes a dialog to enter a license id. _ H _ H _ Help elp elp Invokes the windows help program. Once invoked, you can select from the various help topics as in other windows 3.x programs. You can open other help files if you wish. When FileView is closed, the windows help program will also be closed (if no other application is using WinHelp). _ Index The main index is displayed _ Keys Displays help for Fileview's use of keys. A_ bout Invokes the About dialog. Additional information about the selected file is included in the About dialog. This information includes the file path, Size in bytes, size in records, date and time created or last modified, and the file attributes. __________________________________________________________________________ Date: January 11, 1991 Page: 4 Fileview 1.12 ______________________________________________________________________ 8. 8. 8. Keys Keys Keys Ctrl+R Refresh the file => Scroll 1 character to the right <= Scroll 1 character to the left. /\ Scroll 1 character up \/ Scroll 1 character down Home Position at the top of the file Ctrl+Home Position at the leftmost position of the file End Position at the end of the file Ctrl+End Position at the rightmost position of the file PgUp Scrolls 1 screen up Ctrl+PgUp Scrolls 1 screen to the left PgDn Scrolls 1 screen down Ctrl+PgDn Scrolls 1 screen to the right F3 Repeat search forward Shift+F3 Invoke the Search specification Dialog. Alt+F4 Exit the application. Crtl+F12 Invoke the Open dialog. __________________________________________________________________________ Date: January 11, 1991 Page: 5 Fileview 1.12 ______________________________________________________________________ 9. 9. 9. Searching Searching Searching Fileview will the file for a specified string. To specify and start a search, invoke the Edit/Search Edit/Search Edit/Search command. Once the OK button is pressed, the search will start at the top of the file and continue until the string is found or the end of the file is encountered. Fileview searches a single record at a time, so the search string can not span a line. Search For: Enter the text that should be search for. The string is entered as a wild card string or a regular expression depending on which search type is chosen. Ignore Case: If checked, the search ignores case in the search string and the file. If unchecked, the search matches on case as well as value for non- wildcard positions. Search Type Wildcard specifications are similar to wild card specification in DOS. Only the '?' is implemented as the '*' doesn't make a lot of sense. Regular Expression specifications include all the normal stuff. A couple brief commands for those not familiar with regular expressions: . Any character (like DOS ?) ? 0 or 1 of the previous character + 1 or more of the previous character * 0 or more of the previous character ^ match at the beginning of the line $ match at the end of the line [abc] match 'a', 'b', or 'c' Examples: a* match on 'a', 'aa', 'aaaaaaa', etc. a.b match on 'axb', 'ayb', 'azb', etc. a.b* match on 'ax', 'axb', 'axbb', 'ay', 'ab', 'abb' ^a.b matches 'axb' at the beginning of the line __________________________________________________________________________ Date: January 11, 1991 Page: 6 Fileview 1.12 ______________________________________________________________________ a.b$ matches 'axb' at the end of the line Save Saves the current values of the Ignore Ignore Ignore Case Case Case check box and Search Search Search Type. Type. Type. Reset Reset Ignore Ignore Ignore Case Case Case check box and Search Search Search Type Type Type to the saved values. 10. 10. 10. Messages Messages Messages This section describes the various messages that Fileview may generate. This section contains a description of the messages that are specific to Fileview. Other messages may occur because of general windows errors, network problems, etc. Please refer to the appropriate documentation for these messages. File File File does not exist does not exist does not exist Fileview can not open the requested file. This message will occur if you invoke Fileview will a command line file that does not exist or specifies a path that does not exist. This message will also occur if you type in an invalid file or path from the open dialog. Not a valid license Id Not a valid license Id Not a valid license Id You have entered an invalid license id. You must provide a valid license id or cancel the dialog. Text Not Found Text Not Found Text Not Found You have invoked the Search... or Continue Search commands. Fileview can not find a match for the search pattern. WM_COMMAND message nnnn not handled WM_COMMAND message nnnn not handled WM_COMMAND message nnnn not handled This message should never be displayed. If it does, an internal error has occurred. If you receive this message, please record the events leading to the message and contact support. __________________________________________________________________________ Date: January 11, 1991 Page: 7 Fileview 1.12 ______________________________________________________________________ 11. 11. 11. WIN.INI WIN.INI WIN.INI This section describes the contents of the [Fileview] section of the WIN.INI file. iTab iTab iTab The number of spaces that tab expansion creates. lLinN lLinN lLinN Indicates whether line numbers will be displayed or not. A value of 0 indicates that line numbers are not displayed. A value of 1 indicates that line numbers are displayed. lLinT lLinT lLinT Indicates whether line numbers or displacement values will be displayed. A value of 0 indicates that displacement values are displayed. A value of 1 indicates that line numbers are displayed. lRul lRul lRul Indicates whether a ruler will be displayed. A value of 0 indicates that a ruler will not be displayed. A value of 1 indicates that a ruler will be displayed. lSrchC lSrchC lSrchC Indicates whether case is respected or ignored. A value of 0 indicates that case is respected. A value of 1 indicates that case is ignored. lSrchT lSrchT lSrchT Indicates whether wildcards or regular expressions are used. A value of 0 indicates that wild card expressions will be used. A value of 1 indicates that regular expressions will be used. lTab lTab lTab Indicates whether tabs in the file are expanded or not. A value of 0 indicates that tabs will not be expanded. A value of 1 indicates that tabs will be expanded. Regn=hhhhhhhhh Regn=hhhhhhhhh Regn=hhhhhhhhh Is used to store your license identifier. __________________________________________________________________________ Date: January 11, 1991 Page: 8 Fileview 1.12 ______________________________________________________________________ 12. 12. 12. License Information License Information License Information Fileview is distributed as a shareware product. All rights have been reserved by the author. Fileview has not been released into the public domain. If you use Fileview beyond an initial evaluation period, you must purchase a license. Two license options are available. You may purchase one license for each user of Fileview. Alternatively, you may purchase a site license. Fileview is also currently bundled with our FileFind product. If you have purchased a license for Filefind, that license will be recognized by at least all 1.XX versions of Fileview. Duplication and Distribution Restrictions Fileview is a shareware product. It may be copied and distributed for others to evaluate as long as the following rules are followed. They are: 1 The Fileview program, this documentation, and any other accompanying materials may not be modified in any way. 2 A copy of this documentation and all accompanying materials must be distributed along with the program. 3 You may not charge for distributing this program, except for a nominal media and handling charge. In any case, such a charge may not exceed $10.00. 4 Users of Fileview must purchase a license for its use. One license per copy of Fileview, or the alternative site license, is required. Note that this requirement allows you to make as many backup copies as you wish as long as you have a license per user or a site license. 5 If you purchased a disk containing this software from a public domain/shareware software distributor, you have paid the media and handling charges as permitted in 3 above. You have not purchased the required license for Fileview. Purchasing a license is required for continued use. __________________________________________________________________________ Date: January 11, 1991 Page: 9 Fileview 1.12 ______________________________________________________________________ 13. 13. 13. Rates Rates Rates Two rate scales are available for licensing Fileview. You may purchase a single user license or a site license. For either, you may simply purchase a license, or you may purchase a license, the current version on disk, and/or a printed copy of the documentation. Refer to the license applications following this section for current rates. The purchase of a license allows you to use Fileview and receive support. As new versions are released, you may obtain them through the various shareware channels. New versions will also be available directly from the author for a nominal materials and shipping charge. Make checks payable to and send payments to: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Note Note Note Payments must be US funds. Checks must be drawn on or payable through a US bank. If you wish to remit a foreign check, we will attempt to have our bank process it through their collection department if you include a $7 fee. Somehow that doesn't seem worth it. Foreign users are probably better off sending cash. __________________________________________________________________________ Date: January 11, 1991 Page: 10 Fileview 1.12 ______________________________________________________________________ Application for Single User License Registration Fileview 1.12 Date: ______________________ To: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Please register Fileview for: Name___________________________________________________ (Company)______________________________________________ (Title)________________________________________________ Address________________________________________________ City, State Zip _____________________________________ Windows version that I am currently using: ____________ I got FileView from (BBS & Phone #) ___________________ _______________________________________________________ +--------------------------------+---------+-------+---------+ | Item | Unit $ | Quant | Total $ | +--------------------------------+---------+-------+---------+ | FileView | $10 | | | +--------------------------------+---------+-------+---------+ | Current Version on 5 1/4 disk | $6 | | | +--------------------------------+---------+-------+---------+ | Current Version on 3 1/2 disk | $6 | | | +--------------------------------+---------+-------+---------+ | Total | | +--------------------------------------------------+---------+ __________________________________________________________________________ Date: January 11, 1991 Page: 11 Fileview 1.12 ______________________________________________________________________ Application for Site License Registration Fileview 1.12 Date: ______________________ To: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Please register Fileview for: Name___________________________________________________ (Company)______________________________________________ (Title)________________________________________________ Address________________________________________________ City, State Zip________________________________________ Windows version that I am currently using: ____________ I got FileView from (BBS & Phone #) ___________________ _______________________________________________________ +--------------------------------+---------+--------+--------+ | Item | Unit $ | Quant |Total $ | +--------------------------------+---------+--------+--------+ | First 10 Users | $100 | 1 | $100 | +--------------------------------+---------+--------+--------+ | Users 11-20 | $9 | | | +--------------------------------+---------+--------+--------+ | Users 21-50 | $8 | | | +--------------------------------+---------+--------+--------+ | Users 50+ | $7 | | | +--------------------------------+---------+--------+--------+ | Current Version on 5 1/4 disk | $12 | | | +--------------------------------+---------+--------+--------+ | Current Version on 3 1/2 disk | $12 | | | +--------------------------------+---------+--------+--------+ | Total | | +---------------------------------------------------+--------+ __________________________________________________________________________ Date: January 11, 1991 Page: 12