home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilss / showfile / !ShowFile / !Help < prev    next >
Text File  |  1995-03-05  |  6KB  |  144 lines
  1.  
  2.  ABOUT THIS PROGRAM
  3.  ---------------------------------------------------------------------------
  4.  
  5.  Name    : ShowFile
  6.  Version : 1.01 (13 Feb 1995)
  7.  Purpose : *Type/List/Dump files
  8.  Author  : Andrew Berry
  9.  Licence : Freeware. Please see conditions at the end of this file.
  10.  
  11.  
  12.  PURPOSE
  13.  ---------------------------------------------------------------------------
  14.  This program is designed to display files of any type using the * commands
  15.  Type, List and Dump. Why can't this be done from the command line? Well, it
  16.  can, only this way is easier. It has the following advantages over the
  17.  command line:
  18.  
  19.      - A specified mode can be entered, the file displayed, and
  20.        then the original desktop mode re-entered. This means that even if
  21.        you normally use mode 27 for the desktop you can set the program to
  22.        display files in a wide screen mode, eg 39, then return to mode 27.
  23.  
  24.      - Options are selected from a window.
  25.  
  26.      - Files are selected by dragging instead of typing long filenames.
  27.  
  28.           
  29.  USING THE PROGRAM
  30.  ---------------------------------------------------------------------------
  31.  Three types of display can be selected. These are Type, List and Dump, and
  32.  are described in detail later.
  33.  
  34.  The main window is opened by clicking on the ShowFile icon on the icon bar.
  35.  It contains four options. These are:
  36.  
  37.           Mode : This selects the mode which will be entered before
  38.                  displaying the file. If the mode specified is unsuitable
  39.                  then an alternative will be suggested, or a reason given as
  40.                  to why it is unsuitable.
  41.  
  42.     Tab expand : This can only be used with the Type and List options, and
  43.                  becomes unselectable if Dump is chosen. It has the effect
  44.                  of replacing ASCII 9 characters with 8 spaces when
  45.                  selected.
  46.  
  47.         Offset : When selected, this specifies the offset from the beginning
  48.                  of the file from which to dump the data. Can only be used
  49.                  with Dump.
  50.  
  51.          Start : This can only be used if the 'Offset' option is ticked and
  52.                  is otherwise greyed out. When selected, it displays the
  53.                  file as if it were in memory starting at the specified
  54.                  address.
  55.  
  56.  Both the offset and start addresses must be entered in hexadecimal.
  57.  
  58.  Files are displayed by dragging from the filer window onto either the
  59.  ShowFile icon on the icon bar or the options window. Use Ctrl, Shift and
  60.  Scroll Lock as normal to look through the file slowly.
  61.  
  62.  All options take effect as soon as they are altered and are not (currently)
  63.  saved to disc.
  64.  
  65.  
  66.  TYPES OF DISPLAY                           [RISC OS 3 PRM's page reference]
  67.  ---------------------------------------------------------------------------
  68.  Type : This displays the file using the configured DumpFormat.      [2-190]
  69.  List : As Type, but each line is numbered.                          [2-171]
  70.  Dump : Displays the file in hexadecimal and ASCII codes.            [2-162]
  71.  
  72.  
  73.  HISTORY
  74.  ---------------------------------------------------------------------------
  75.  1.00 (21 Jan 1995) - • The first version, fully working. Type, list, dump,
  76.                         specify mode, tabexpand, offset and start addresses.
  77.  ---------------------------------------------------------------------------
  78.  1.01 (13 Feb 1995) - • Bug fix. Pressing Escape when a file was being
  79.                         displayed brought up an empty error box on return
  80.                         to the desktop.
  81.                         
  82.  
  83.  THINGS TO DO
  84.  ---------------------------------------------------------------------------
  85.  • Include option for *Print. This is more complicated as all characters are
  86.    sent to the VDU and some can cause 'unwanted screen effects' and need to
  87.    be filtered out.
  88.  • Option for paged scrolling (a serious omission at the moment)
  89.  • Save options to disc
  90.                                                         
  91.  
  92.  LEGAL BIT
  93.  ---------------------------------------------------------------------------
  94.  This program is Freeware, NOT public domain. This means that I retain the
  95.  copyright but give everyone the right to distribute it by any means,
  96.  anywhere, as long as all files are supplied and I am fully credited.
  97.  
  98.  Although this program has been fully tested, I (the author) cannot be held
  99.  responsible for any loss or damage caused my the use or misuse of this
  100.  program. It is used entirely at your own risk.
  101.  
  102.  
  103.  CONTACT
  104.  ---------------------------------------------------------------------------
  105.  Please feel free to write to me at the address below. Let me know if you
  106.  can think of any ways to improve the program, or if you find any bugs. Any
  107.  donations will be greatly appreciated, and you can obtain the latest
  108.  versions of all my programs by sending either:
  109.  
  110.     a) A cheque for £1.00
  111.  or b) A disc of PD, a first class stamp and a suitable method of returning
  112.        your disc. (If you send me the disc in a Jiffy bag then I can re-use
  113.        it to send the disc back).
  114.  
  115.  
  116. Currently (5/3/1995) my other programs are as follows:
  117.  
  118.    - DiscComp  1.06 (23 Feb 1995) : Compact discs from the desktop, various
  119.                                     options.
  120.    - LoseCaret 1.12 (23 Feb 1995) : Force applications to lose the caret.
  121.                                     Useful if the app. doesn't pass on
  122.                                     unknown keypresses.
  123.    - PinExtend 1.14 (23 Feb 1995) : Easy method of putting sprites on the
  124.                                     backdrop, lots of options, load backdrop
  125.                                     on startup, etc.
  126.    - DirOpen   1.01 (04 Feb 1995) : Drag directories and apps to icon bar to
  127.                                     open them. Reopen last dir from icon bar    - IconSprit 1.10 (28 Jan 1995) : IconSprites, ToolSprites, save RAM and
  128.                                     ROM sprites to disc
  129.    - TidyApp   1.01 (04 Mar 1995) : Rename !Boot, !Run, etc. in application
  130.                                     directories (to correct wrong case,
  131.                                     e.g. !boot)
  132.    - TextInfo  1.12 (05 Mar 1995) : Counts words/sentences etc in text files.
  133.  
  134.  
  135.  Please write to:
  136.  
  137.     Andrew Berry
  138.     39 Lancaster Avenue
  139.     Sandiacre
  140.     Nottingham
  141.     NG10 5GW
  142.     
  143.  ---------------------------------------------------------------------------
  144.