home *** CD-ROM | disk | FTP | other *** search
/ Kosovo Orphans' Appeal Charity CD / KosovoOrphansAppeal.iso / utilities / _close / _help next >
Text File  |  1996-11-08  |  5KB  |  129 lines
  1.                                     Close
  2.                                     =====
  3.      
  4. Introduction
  5. ------------
  6.    In the midst of developping an application have you ever come across the
  7. dreaded File open (or Bad buffer size if you have LongFiles) error ?
  8.    If you haven't then you obviously program very well. If, on the other
  9. hand, a crashed application can leave a thousand miscellanous files open by
  10. accident, then you might like to use this application.
  11.  
  12. Usage
  13. -----
  14.    Clicking Select on the iconbar icon will bring up a menu of currently open
  15. files. These are categorised into 7 sections :
  16.   R     Run files; those whose leafname starts !Run.
  17.   B     Boot files; those whose leafname starts !Boot.
  18.   O     Obey files; any other Obey file.
  19.   A     Font files; any file of type Font.
  20.   D     Device files; those in DeviceFS.
  21.   Ixxx  Image files; each individually catagorised.
  22.   F     Other files; anything not covered by the above.
  23.   P     Directories (Paths)
  24.   
  25. The codes on the left indicate options which may be included in the
  26. Close$Options variable.
  27.  
  28. For example; if you wanted to see only obey files, device files and ArcFS
  29. archives you would use *Set Close$Options ODI3fb
  30.  
  31. If you wanted just the files not covered in the other sections (ie probable
  32. data files), you could use *Set Close$Options F
  33.  
  34. Note, the order of the options is the order they appear on the menu.
  35.  
  36.     
  37. How it works
  38. ------------
  39. Well, it's dull, butî
  40.  
  41. When select is clicked the file handles from 255 downwards are scanned until
  42. a gap of 8 unused file handles is found (to speed up the listing). If one of
  43. the handles is used, the OS_Args call 7 is used to find the filename; then
  44. the type of the file is checked and the correct array is added to.
  45.  
  46. Then, when the end of the handles is found, the arrays are built into menus,
  47. and finally the system variable is scanned and the top level menu is created
  48. and opened.
  49.  
  50. When clicked on, all handles with the same pathname are closed, so if you
  51. have opened a file a couple of dozen times (for read), then one click will
  52. close every instance of that file in the handles list. For speed, the menu is
  53. not updated on menu selection.
  54.  
  55.  
  56. Help and message files
  57. ----------------------
  58. This application is fully !Help compliant and it is recommended that when
  59. getting to grips with it the help should be used if only to give it some
  60. purpose! It also supports the use of MessageTrans and therefore translation
  61. to another language or changing the messages for the fun of it is much easier
  62. than it might have been.
  63.  
  64.  
  65. <BasicLibrary$File>
  66. -------------------
  67. This application requires Justin Fletcher's JFShared library to function.
  68. This can be obtained from Arcade and possibly other bulletin boards. I have
  69. seen QuickHelp on Digital Databank, so it is possible that JFShared exists
  70. there also.
  71.  
  72.  
  73. Compatibility
  74. -------------
  75. This application has been tested on the author's A5000, but due to the lack
  76. of friends with Acorns has not been tested on other systems. Therefore, it
  77. ought to work on any RO3.1 machine, and with a RO2 machine if it is
  78. recognised in JFShared and uses no specific RO3 features.
  79.  
  80.  
  81. Disclaimer
  82. ----------
  83.   The author accepts no responsibility for any problems which this
  84. application may cause or loss of data resulting in its use. This application
  85. is Public Domain. This means that it may be distributed, so long as no charge
  86. other than copying costs are charged for it.
  87.   
  88.         
  89. Contact
  90. -------
  91. Any comments, queries, donations or bug reports can be sent to Justin
  92. Fletcher at :
  93.  
  94. E-Mail : Gerph@essex.ac.uk
  95. URL    : http://users.essex.ac.uk/users/gerph
  96. IRC    : On #Acorn as Gerph
  97. Finger : finger jrflet@postman.essex.ac.uk
  98. Tel    : (01842) 813979
  99.  
  100. Snail Mail :
  101.     Justin Fletcher
  102.     öGaladrielò
  103.     17b Cromwell Road,
  104.     Weeting,
  105.     Brandon,
  106.     Suffolk.
  107.     IP27 0QT
  108.  
  109.  
  110. History
  111. -------
  112. Version 1.00 : ?? ??? ????
  113.                First version written
  114.  
  115. Version 1.02 : 05 Sep 1995
  116.                Added Image files support to remove great big list of
  117.                StrongHelp files which I tend to get.
  118.  
  119. Version 1.03 : 27 Mar 1996
  120.                Multitudinous extensions added :-)
  121.                Å Added the extra information to the menu line and handle number
  122.                Å Added the greying so that files you have already closed will
  123.                  not be accessable.
  124.                Å Little bits of tidying up.
  125.  
  126. Version 1.04 : 05 Jul 1996
  127.                Major bug in RO3.1 menus fixed - you could only see 4 letters
  128.                of the filename :-(
  129.