home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / filemanager / filebox_1 / Docs_Release < prev    next >
Encoding:
Text File  |  1997-09-03  |  5.4 KB  |  144 lines
  1. File Box Module Release Note
  2. (Version 0.60)
  3.  
  4. Loading
  5.  
  6. This version of the FileBox module can be loaded (and the File Box task
  7. automatically started) by:
  8.  
  9. - double-clicking on the FileBox relocatable module icon (in the Modules
  10.   directory).
  11.  
  12. - using the following command sequence in an Obey file (assuming FileBox is
  13.   resident in the System:Modules directory):
  14.  
  15.     *RMEnsure FileBox 0.60 WimpTask RMRun System:Modules.FileBox
  16.     *RMEnsure FileBox 0.60 Error You need File Box version 0.60 or later
  17.  
  18. - double-clicking on the !FileBox application (which also performs other
  19.   actions- see below).
  20.  
  21. Desktop features
  22.  
  23. The File Box Desktop task is RISC OS 3 friendly. It supports:
  24.  
  25. - transparent sprite file dragging, based on the machines configuration
  26.  
  27. - 2D-style or 3D-style windows, based on the system's configuration
  28.   (although this can be overridden). The 3D style windows are compliant
  29.   with Acorn's recommendations for the "new look", while the 2D style
  30.   windows are derived from previous versions of FileBox windows.
  31.  
  32. - interactive help (in conjunction with !Help application in the Apps
  33.   directory)
  34.  
  35. - outline fonts in dialogue boxes, as under RISC OS 3.5 and later
  36.  
  37. To change your system's configuration option determining your preference
  38. between 2D-style and 3D-style windows, double-click on the !3DWindows
  39. application. This application toggles bit 0 of CMOS RAM byte number 140,
  40. which is used by RISC OS 3 friendly applications to determine the users
  41. preference for 2D-style or 3D-style windows.
  42.  
  43. To change your system's configuration option determining your preference
  44. between transparent sprite dragging (using the RISC OS 3 DragASprite module)
  45. and rotating-dash drag boxes, double-click on the !DragASpr application.
  46. This application toggles bit 1 of CMOS RAM byte 28, which is used by RISC OS
  47. 3 friendly applications to determine the user's preference for the graphical
  48. representation of file dragging.
  49.  
  50. New features since first public release
  51.  
  52. Since version 0.50, a new SWI has been added which allows icons for
  53. extended filetypes to be correctly displayed in FileBox windows under
  54. FiletypeExtend. See the revised edition two (issue 2) manual for details.
  55.  
  56. File Box application front end
  57.  
  58. To initialize all File Box facilities, double-click on the !FileBox
  59. application. The !FileBox application provides:
  60.  
  61. - A system variable <I> which is a synonym for the system variable
  62.   <FileBox$GetInputFilename>
  63.  
  64. - A system variable <O> which is a synonym for the system variable
  65.   <FileBox$GetOutputFilename>
  66.  
  67. - An alias command, *B, which alleviates a small bug which produces the
  68.   error 'Not enough stack for filing system' or similar. This error occurs
  69.   only with some commands, such as *IconSprites, when used in conjunction
  70.   with the File Box system variables. If a command gives this error, prefix
  71.   it with the *B command. For example:
  72.  
  73.     *B IconSprites <I>
  74.  
  75.   See also the Known bugs section.
  76.  
  77. - A small arrow icon sprite which is used in the Load window. This is not
  78.   essential to File Box, but does give the user a more positive indication
  79.   of what is required when a Load window appears.
  80.  
  81. TaskTypes utility
  82.  
  83. The !TaskTypes application provides task window support commands, some of
  84. which make use File Box facilities. Please refer to the !Help file inside
  85. the application directory for further information.
  86.  
  87. TaskTypes now uses FiletypeExtend so that the unregistered task types can be
  88. moved into the extended filetype space, and hence will no longer clash with
  89. other types in the 12-bit range. I thank Alan Glover (Acorn) for his offer
  90. to register the types in the 12-bit range (after Acorn initially rejected
  91. them in 1993), but to do so would violate Acorn's philosophy of "one data
  92. format, one editor, one type." The philosophy must change, not simply be
  93. overlooked.
  94.  
  95. Known bugs
  96.  
  97. I am aware of an elusive bug which has haunted the FileBox code variables
  98. since their development. I believe that the OS manual doesn't give full
  99. enough parameters for what a code variable is and is not allowed to do. I
  100. suspect the problem is a stack overflow or a corrupted register which causes
  101. nasty data aborts and the like. I will say that they used to work fine (on
  102. Edit on an A3000), but in recent times (running Zap on my RiscPC) they have
  103. failed to work consistently.
  104.  
  105. At any rate, I am hereby advising users that the use of the code variables
  106. is deprecated, and may not be supported in future versions of FileBox. I am
  107. planning to write a command shell which fakes the processing of FileBox code
  108. variables, which will look essentially the same, but get things right where
  109. I suspect the OS goes wrong.
  110.  
  111. Correspondence
  112.  
  113. Any queries about this software, suggestions for improvement, bug reports or
  114. other requests pertaining to this software or its documentation are
  115. welcomed. The address to write to is:
  116.  
  117. Kade Hansson
  118. Kasoft Software
  119. 4/73 Alexander Street
  120. Shearwater 7307
  121. AUSTRALIA
  122.  
  123. Telephone (International): [61] 3 64287448
  124. Telephone (Australia): (03) 64287448
  125. e-mail: kade_fh@postoffice.utas.edu.au
  126.  
  127. -
  128.  
  129. Copyright © Kasoft Software 1997. All rights reserved.
  130.  
  131. The relocatable module 'FileBox' was programmed by Kade Hansson. This module
  132. is suitable for use with all ARM-based computers running Acorn RISC OS
  133. version 3.10 or later.
  134.  
  135. KASOFT and the Kasoft device are trademarks of Kasoft Software, and owned by
  136. Kade Hansson.
  137.  
  138. ACORN is a trademark of Acorn Computers Limited.
  139.  
  140. Published September 1997; Issue 1
  141. Written by Kade Hansson
  142. Published by Kasoft Typesetting
  143. Code KR09602,0601
  144.