home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / w3_disk / gander10.arj / GANDER.TXT < prev    next >
Encoding:
Text File  |  1991-09-01  |  12.7 KB  |  389 lines
  1.  
  2. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  3.  
  4. Dave Lord's  
  5.     GANDER     -  A File Viewer        Version 1.0
  6.  
  7. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  8.     
  9.     This program is distributed as shareware. You may make 
  10.     copies of it for evaluation and distribution but if you 
  11.     like the program you should register it. The cost is 
  12.     $15. Registered users will receive a disk containing the 
  13.     latest version of the program or optionally some future 
  14.     version if you already have the latest version. I will 
  15.     also include on the same disk the most recent version of 
  16.     my Windows ascii chart program ACHART and anything else 
  17.     I happen to have complete.
  18.     
  19.     This program may be freely distributed. It may not be 
  20.     sold except by me. A nominal copying charge may be made 
  21.     not to exceed US $10.
  22.     
  23.     
  24. Registrations outside of the US:
  25. --------------------------------
  26.  
  27.     Unfortunately it is virtually impossible within the US 
  28.     to exchange small amounts of foreign currency or to cash 
  29.     checks drawn on foreign banks (the fees exceed the cost 
  30.     of this program). If you can't send US money I will 
  31.     accept CD or cassettes of any music you think will not 
  32.     be generally available in the US.  Generally we get the 
  33.     most popular British groups and that's about it. We 
  34.     don't even get much Canadian music. My tastes are 
  35.     eclectic, anything from traditional to modern. How about 
  36.     if one of you Canadians sends me some "Doug and the 
  37.     Slugs", eh?
  38.  
  39.  
  40. Copyright c 1991 by Dave Lord
  41.  
  42.     Dave Lord
  43.     3307 Lincoln Av.
  44.     San Diego, CA 92104
  45.  
  46. Internet:   davel@pnet01.cts.com
  47.  
  48.     This program is distributed as is. The author assumes no 
  49.     liability for any damages resulting from its use.
  50.     
  51. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  52.         
  53. Description of program
  54. ----------------------
  55.     
  56.     GANDER is a Windows 3.0 program which will allow you to view and 
  57.     print files in text mode or hexidecimal mode (with the ascii text 
  58.     displayed alongside). You can also view items from the clipboard
  59.     and copy sections of text to the clipboard.
  60.  
  61.     Gander will handle pretty much any file you can throw at it. I've
  62.     tested it on binary files larger than 3 Meg and on text files with
  63.     over 17000 lines. I've also tried lines up to 34000 characters 
  64.     long (that's real slow). I've included a number of filters to aid 
  65.     in viewing files which aren't pure text, a high-bit filter for 
  66.     Wordstar files, an overstrike filter for files which use 
  67.     overstrike  for  bolding and underlining, and other filters for 
  68.     removing  non-text characters. I allow either CR LF or just LF as 
  69.     end-of-line  characters.  I support selectable tab widths and a 
  70.     variety of  string search options.
  71.  
  72.     Gander is based on my previous program, Hex View (WINHV 2.0) with 
  73.     additional functionality added to support display of text files.
  74.     
  75.  
  76.     You should have these files:
  77.  
  78.         GANDER.EXE        the executable
  79.         GANDER.HLP       the help file
  80.         GANDER.TXT       this file
  81.         GANDER.INI        preferences file
  82.         REGISTER.TXT    registration form
  83.         
  84. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  85.     
  86. History
  87. -------
  88.  
  89.     1.0    First release. Gander is based on Win Hex View 2.0
  90.         (WINVH20.ZIP).
  91.         
  92. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  93.  
  94. Using the Program
  95. =================
  96.  
  97. Menus
  98. -----
  99.  
  100. Open File
  101.  
  102.     Allows you to select a file to view. The open dialog 
  103.     works pretty much the same as in nearly every other 
  104.     Windows Program.
  105.  
  106.  
  107.  
  108. Open Clipboard
  109.  
  110.     Allows you to view an item from the clipboard. Clipboard 
  111.     items are stored on a variety of formats, Hex View 
  112.     allows you to view the predefined formats: BITMAP, DIB, 
  113.     DIF, METAFILEPICT, OEMTEXT, PALETTE, SYLK, and TIFF.  
  114.     Some programs may also use private formats which I don't 
  115.     support. In theory the clipboard can hold several items 
  116.     simultaneously as long as each is in a different format. 
  117.     In practice this is rarely done. 
  118.     
  119.     For each of the above formats except METAFILEPICT and 
  120.     BITMAP what I display is simply the contents of the 
  121.     global memory block retrieved from the clipboard.  
  122.  
  123.     For METAFILEPICT I show the METAFILEPICT structure 
  124.     followed by the Metafile itself (starting at 0x10). 
  125.  
  126.     For BITMAP I show the BITMAP structure followed by the 
  127.     Bitmap bits (starting at 0x10).
  128.  
  129.  
  130.  
  131. Print
  132.  
  133.     Allows you to print all or part of the file. In the 
  134.     dialog box select All or From/To. 
  135.     
  136.     The default for From/To is to print what is on the 
  137.     screen but you can set your choice of From and To 
  138.     locations. If you are viewing the file in hex mode, 
  139.     values are byte offsets into the file specified in hex. 
  140.     If you are viewing in text mode values are line numbers 
  141.     specified in decimal. You don't have to remember that, 
  142.     the dialog box will tell you how to specify the values.
  143.     
  144. Info
  145.  
  146.     Show some information about the file being viewed: the 
  147.     file name, the number of bytes, and the number of lines. 
  148.     The number of lines may be unknown until you have 
  149.     actually viewed to the end of the file.
  150.     
  151.  
  152. Marking & Copying to Clipboard
  153.  
  154.     You can mark text using the left button of the mouse. 
  155.     Only whole lines are marked. To mark a large section of 
  156.     text, mark the beginning line and release the button. Go 
  157.     to the last line you want to mark and click on it while 
  158.     holding down the shift key.  
  159.  
  160.     Copy the marked text to the clipboard by selecting Copy 
  161.     from the Edit menu. 
  162.  
  163.     To remove the highlighting from the screen press the 
  164.     right button of the mouse or press either button in the 
  165.     Line Number or Ruler windows if they are displayed.
  166.  
  167.     This version of Gander can only mark and copy text in 
  168.     text display mode.
  169.     
  170.     
  171. Charsets & Fonts
  172.  
  173.     Gander gives you a choice of three standard Windows 
  174.     fonts, all with a fixed pitch (equal spacing of 
  175.     characters).  One of the fonts uses the IBM PC character 
  176.     set and the other two use the Ansi character set.  
  177.     
  178.     To select one, choose the Display menu and select from 
  179.     IBM PC charset, Ansi fixed font, or System fixed font. 
  180.  
  181.  
  182. Display Modes
  183.  
  184.     Gander displays files in Text mode or in Hex mode.  You 
  185.     can choose the one you prefer by opening the Display 
  186.     menu and selecting Text Display or Hex Display.  
  187.     
  188.     If Auto Select is turned on Gander will automatically 
  189.     select what it thinks is the most appropriate mode each 
  190.     time you open a new file.  Gander won't force it's will 
  191.     on you however. If you choose, Gander will allow you to 
  192.     view any file in text mode, even object files. Be warned 
  193.     however that things slow down substantially when you try 
  194.     to view files which have 1000+ character lines as text .
  195.  
  196.  
  197. Ruler & Line Numbers
  198.  
  199.     The ruler and line numbers are always turned on in hex 
  200.     mode but are optional in text mode. To toggle them on or 
  201.     off select the appropriate items from the Display menu.
  202.     
  203.     
  204. Find
  205.  
  206.     Allows you to search for a character string within the 
  207.     file you are viewing. The string may be specified as 
  208.     text characters (a, b, c, etc.) or as hex (41, 0a, ff). 
  209.     Enter the string and choose whether it is a string 
  210.     search (text) or a hex search. If it's a string search, 
  211.     choose whether uppercase and lowercase characters should 
  212.     match, then press Forward or Reverse. 
  213.     
  214.     If there is highlighted text on the screen then Forward 
  215.     searches will start immediately following the 
  216.     highlighted text, otherwise the search will start with 
  217.     start with the first character on the screen, backwards 
  218.     searches start before any highlighted text on the 
  219.     screen, or with the character preceding the first one on 
  220.     the screen.  The string is highlighted on the screen 
  221.     when it is found.
  222.  
  223.     Repeat a search using Repeat Forward or Repeat Back.
  224.  
  225.  
  226.  
  227. Jump
  228.  
  229.     This allows you to jump to a particular character, line 
  230.     or record in the file. In text display mode, line and 
  231.     record are essentially the same thing unless you have 
  232.     specified an alternate record marker (see below).
  233.  
  234.     Enter a number, select decimal or hex, select character, 
  235.     line or record and press OK.
  236.  
  237.     Characters are found by simply counting from the 
  238.     beginning of the file (starting at 0 of course).
  239.  
  240.     Lines are counted as lines displayed on the screen, 
  241.     starting at 1.
  242.  
  243.     Records are found by counting Record Markers.  You can 
  244.     chose the record marker by entering the hex value of the 
  245.     character which marks the end of a record. The default 
  246.     is 0xa (Linefeed). Records are counted starting at 1.
  247.  
  248.     
  249. Hex/Dec Converter
  250.  
  251.     The Hex/Dec Converter allows you to quickly convert 
  252.     numbers to and from hex, decimal, and binary. 
  253.     
  254.     The converter contains three edit boxes, one each for 
  255.     hex, decimal, and binary. Simply select the one you want 
  256.     with the mouse, enter a number in the appropriate form, 
  257.     and the number will appear converted to the other forms 
  258.     in the other two boxes. Converting hex numbers to and 
  259.     from Little Endian form is left as an exercise for the 
  260.     user.
  261.  
  262.     The converter is a modeless dialog box so you can leave 
  263.     it on the screen while you use Gander.
  264.  
  265.     The Hex/Dec Converter is also available as a standalone 
  266.     program. Look for HEXCNV10.ZIP.
  267.  
  268.     
  269.     
  270. Filters
  271.  
  272.     Gander supports a variety of filters which control the 
  273.     handling of non-text characters. 
  274.     
  275.     Overstrike filter causes the program to backspace when 
  276.     it sees a backspace in the file. This is useful for 
  277.     viewing files which use overstrikes for bolding or 
  278.     underlining. Operates in text mode only.
  279.  
  280.     Control Char filter causes control chars (0x0 - 0x1f) to 
  281.     display as spaces (or gray boxes in hex mode). This 
  282.     filter combined with the high-char filter make it easier 
  283.     to read the text in files which aren't pure text.
  284.     
  285.     High-char filter causes characters above the highest 
  286.     text character to display as spaces (or gray boxes in 
  287.     hex mode). For the benefit of users in other countries 
  288.     the highest text character can be set by the user.
  289.     
  290.     High-bit filter masks out the high order bit in each 
  291.     character. This is for use when viewing Wordstar files 
  292.     and really shouldn't be used for anything else.
  293.  
  294.     
  295. Tabs
  296.  
  297.     You can set expansion of tabs on or off and set the tab 
  298.     width up to nine characters. If you have tab expansion 
  299.     off then tabs are displayed as a single space when the 
  300.     Control char filter is on or as some funny shape when 
  301.     the Control char filter is off. Tab expansion only 
  302.     operates in text mode.
  303.  
  304.  
  305. Keyboard
  306. --------
  307.  
  308. Shortcut Keys
  309.  
  310.     <down arrow>        Down one line.
  311.     <up arrow>        Up one line.
  312.     <left arrow>        Left a page.
  313.     <right arrow>        Right a page.
  314.     <page up>        Page up.
  315.     <page down>        Page down.
  316.     <home>            Beginning of file.
  317.     <end>            End of file.
  318.     Shift + F3        Search.
  319.     F3            Repeat forward.
  320.     F4            Repeat backward.
  321.     Ctrl + F3        Jump
  322.     Shift + F5        Hex / Dec Converter
  323.      
  324.  
  325. 'vi' User's Keystrokes
  326.  
  327.     In Windows 3.0 the standard is to use control - alt - 
  328.     shift - function key combinations as shortcut keys. I 
  329.     can only assume that Microsoft was trying to emulate the 
  330.     one feature of WordPerfect that everyone really hates. 
  331.     Anyway, I provided those, but I also provided shortcut 
  332.     keys based on the one true keyboard interface: vi.
  333.  
  334.     j    Down one line.
  335.     k    Up one line.
  336.     h    Left. OK I cheated, it's Left a whole page.
  337.     l    Right a page.
  338.     ^F    Down a page.
  339.     ^B    Up a page.
  340.     ^U    Up half a page.
  341.     ^D    Down half a page.
  342.     /    Search.
  343.     n    Repeat search Forward.
  344.     N    Repeat search Backward.
  345.     G    Go to End.
  346.     :    Jump. OK in vi ':' does lots of other things too.
  347.         Here it just jumps.
  348.  
  349.     
  350.     
  351. Saving Preferences
  352. ------------------
  353.  
  354.     This program saves a number of options in GANDER.INI.  
  355.     GANDER.INI should be in the same directory as 
  356.     GANDER.EXE. If GANDER.INI is missing the program will 
  357.     not recreate it, if you want it back you should create 
  358.     it as an empty file using an editor, and the next time 
  359.     you run GANDER.EXE it will get updated.
  360.     
  361.     
  362. Future Enhancements
  363. -------------------
  364.  
  365.     There are a number of things I want to put into a future
  366.     version of Gander:
  367.  
  368.     o    Screen wrap option in text mode.
  369.     
  370.     o    Mark and Copy to clipboard while in hex mode.
  371.     
  372.     o    This version hard codes printer line width to 80. That
  373.          should be changed.
  374.     
  375.         o    Get rid of red highlighting in text mode or allow setting
  376.              of colors or take colors from control panel (the reason I
  377.              don't is because of the use of gray text and lines in
  378.              hex mode).
  379.     
  380.         o    Performance improvements.
  381.     
  382.         o    Additional file formats.
  383.  
  384.         I'm open to other ideas, please write.
  385.  
  386. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  387. -- GANDER.TXT --   Copyright 1991 by Dave Lord
  388. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  389.