home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / fileutils / filesee / !FileSee / !Help < prev    next >
Encoding:
Text File  |  1990-09-07  |  4.8 KB  |  91 lines
  1. !Help file for !FileSee
  2.  
  3. This is a little utility which I wrote since I wanted such a program, but
  4. none appeared to exist.   It is a hex dump command (like *Dump) to run in a
  5. window.
  6.  
  7. Simply run the application, it will install itself on the icon bar, and then
  8. files can be dragged onto it from the filer (I don't currently support RAM
  9. transfers, and I think I've got something wrong with the <Wimp$Scrap>
  10. protocol, so you can't save a file from an application into !FileSee, but
  11. then that's probably just as well, since !FileSee is not a safe place to
  12. save to, it has no save options of its own) and a window will open for the
  13. file.   It is in three columns, separated by colons.   The first column is
  14. the offset into the file (this doesn't currently know about load addresses,
  15. and will thus differ from what *Dump sometimes says).   The next column
  16. contains a numeric representation of the bytes from the file in ascending
  17. order starting from the offset in the first column for the next 16 bytes.
  18. The final column contains the ASCII representation of the bytes, unless they
  19. are unprintable in which case a full stop will be displayed.
  20.  
  21. All printed numbers are in hex, the file can only be displayed in the format
  22. you will see, and the Dump configuration bits are ignored in this version.
  23. The current limit on open files is 16, but this can be increased by altering
  24. the value of maxfiles% in !RunImage, but this will cause the program to
  25. crash due to lack of space if you add too many and don't increase the
  26. WimpSlot in !Run, since each extra file slot adds 256 bytes to the program's
  27. running space.  (If someone will explain to me how to alter the value of the
  28. pointer in an indirected title bar icon after creating the window, this will
  29. no longer be a problem, and the file limit will be far more free.)
  30.  
  31. Program history
  32. ======= =======
  33.  
  34. V0.00 - The original, never released and only in existance for a few hours.
  35.         It had redraw code written in BASIC, which for a window so full
  36.         (there are an awful lot of characters in each window) is
  37.         horrifically slow.  It also had loads of bugs in file space
  38.         allocation.
  39.  
  40. V0.01 - This was the first version released into the PD, it had the redraw
  41.         code rewritten in assembler which made the program useable, although
  42.         it's still not exactly lightning - 50 lines per second (regardless
  43.         of how wide the area being redrawn is - it's not optimal in that
  44.         it always redraws whole lines using individual OS_WriteCs for each
  45.         char, so it has space for improvement).
  46.  
  47. V0.02 - This version saw the addition of this helpfile, and was principaly
  48.         done so I could give Moray Mackenzie a reasonably unbugged version
  49.         at the BAU show.   The bug with window title bars getting corrupted
  50.         and sometimes causing address exceptions has been removed, in turn
  51.         causing the feature of each file requiring 256 bytes of static space
  52.         whether it's been loaded or not.   I've removed quite a lot of bugs
  53.         from the space allocation code, and it now looks pretty safe, I've
  54.         not had it crash yet, but I've not tested it thoroughly, simply
  55.         opening and closing windows in a random order for about 15 minutes,
  56.         and it used to crash all the time before, and since it hasn't yet,
  57.         I'm a bit happier.   Anyway, if you find another error, particularly
  58.         a repeatable one, please let me know.
  59.  
  60.  
  61. Sorry to anyone looking through this code, it's not an ideal example of
  62. programming, it's very short in the comments department.   Most of my Wimp
  63. programs are like this since they all derive from one program I wrote when I
  64. had no idea what I'd be doing in advance (which is fairly unusual for me)
  65. and hence the code is uncommented.   The ARMcode redraw is particularly
  66. badly written, using multiple statement lines and no comments (yugh! I'm
  67. sorry..) since it was a direct transcript (line for line almost) from the
  68. original BASIC code.   Believe me most of my code is better than this, the
  69. RiscOS WIMP system just always seems to do this to me.
  70.  
  71.  
  72.  
  73. This code is PD (Public Domain) and may be distributed freely so long as no
  74. profit is made for it (a small handling charge may be made to cover postage
  75. if it is sold in a PD library, but I'd like to be asked before it is
  76. included in such a library), and so long as all files are distributed
  77. together. There should be five files in the !FileSee directory: !Help     -
  78. This file !Run      - Obey file that starts application !RunImage - The
  79. application itself !Sprites  - The icon for the application Templates -
  80. Window definitions All these files are (C) 1990 I D Griffiths.
  81.  
  82.  
  83. I can be reached on Archive, and Arcade BBSs (user #290 Ian Griffiths on
  84. both boards) and The World of Cryton as #123 Flump.   I'm on Microlink as
  85. user MAG20619. I can be reached via snail mail thus: Mr I D Griffiths,
  86. Pinecroft, Berkhamsted, Herts, HP4 3NW.
  87.  
  88.  
  89. Share and Enjoy.
  90.  
  91.