home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 223.lha / RalphTools_v1.0 / Help < prev    next >
Text File  |  1989-04-09  |  8KB  |  157 lines
  1. +-------------------------------------------------------------------+
  2. |          Documentation for "RalphTools" version 1.0.              |
  3. |          -------------------------------------------              |
  4. |            "Nothing earthshaking, but darn handy"                 |
  5. +-------------------------------------------------------------------+
  6. Introduction:
  7. -------------
  8. Here are a few Workbench Icon tools I've whipped up to make life using the
  9. Workbench a little easier. They are first versions of the programs, and if
  10. you find any problems running them or have suggestions for new features or
  11. tools, or know a better way to go about what I'm trying to program, please
  12. send me a message. I access BIX and PLINK once every week or two. I read my
  13. Usenet/Internet mail every other day.
  14.  
  15. Legal stuff:
  16. ------------
  17. These executable programs, their source code and this document are
  18. ©Copyright 1988 by Ralph L. Vinciguerra. They are freely redistributable,
  19. but may not be sold for profit without my permission. If you have ideas
  20. about special distributions or products which could include all or part of
  21. these programs you should contact me. If you are creating other Freely
  22. Redistributable, Public Domain, or Freeware programs please feel free to
  23. use my examples.
  24.  
  25. Contacting me:
  26. --------------
  27. I am available several ways:
  28.  
  29. BIX & PLINK: ralphv
  30. Usenet:      ...!mit-eddie!mit-atrp!davinci!rlv
  31.              ...!mit-eddie!mit-atrp!ralph
  32. Internet:    davinci!rlv@atrp.media.mit.edu
  33.              ralph@atrp.media.mit.edu
  34.  
  35. Usage of these programs:
  36. ------------------------
  37. (General)
  38. These programs use the Workbench concept of Shift-Selection. Each tool can
  39. be considered an "operator" and the icons you wish to alter considered
  40. "arguments". Thus to operate on some arguments use this procedure:
  41.  
  42.   - Hold down the left or right shift key.
  43.   - Click on the tool once.
  44.   - Click once on each icon to be processed, except...
  45.   - ...Double click the last one.
  46.   - Let go of the Shift key.
  47.  
  48. For all these tools, just double-clicking the tool alone (shift key
  49. ignored) will give a short description of function and use.
  50.  
  51. (FloatIcon)
  52. The tool FloatIcon processes it's shift-selected arguments and makes them
  53. have a special property offered by the Workbench: they have no fixed
  54. position in their Workbench windows. Rather, they will float to an open
  55. position determined by the Workbench. Double click this tool with no
  56. arguments to receive instructions. The algotihm used seems to be the same
  57. as the one in the "Cleanup" menu choice in the Workbench menus.
  58.  
  59. (CopyIconImage)
  60. The tool CopyIconImage processes the icon image of it's first selected
  61. argument and copies that image to the remaining shift-selected arguments.
  62. Double click this tool with no arguments also to receive instructions.
  63.  
  64. (3) BecomeTool
  65. This tool makes the shift-selected icons into tool icons.
  66.  
  67. (4) BecomeProject
  68. This tool makes the shift-selected icons into project icons.
  69.  
  70. Shortcomings:
  71. -------------
  72. Due to a problem of the workbench, it is necessary to close and reopen the
  73. window containing any icons you modify using these programs. For some
  74. reason, the workbench will not see the changes until it is forced to read
  75. the icon data into memory again. Hopefully this will be fixed in a newer
  76. version of the Workbench.
  77.  
  78. These programs also cannot process the icons for Drawers and Disks. They
  79. attempt to exit gracefully with an error indication in this case.
  80.  
  81. I have plans to improve these programs along these lines but I'm not there
  82. yet. These operations are not as easy to figure out. I am releasing them in
  83. this earlier form because I believe they are already useful now. I intend
  84. to improve them as I learn more about the Workbench.
  85.  
  86. Using the Source Code:
  87. ----------------------
  88. I wrote and debugged these programs using the Manx Aztec C compiler version
  89. 3.6a. Also, I did all my work using AmigaDOS 1.2.
  90.  
  91. I have included the makefile so you cansee which pieces are used to create
  92. each tool.
  93.  
  94. Also, I have included icons for every file contained in this package. The
  95. default tool I use for my text editor is "Edit:Edit". This allows me to
  96. dynamically assign a symbol called "Edit" to point to where ever I feel
  97. like having my editor (named Edit) come from. I find this flexibility
  98. useful, but if you'd rather use something like "C:Ed" then just use the
  99. CopyDefTool program to fix things up right away !
  100.  
  101. Philosophy:
  102. -----------
  103. The Amiga is what I consider a new breed of personal computer, with it's
  104. powerful graphics, advanced operating system, and competitive price. It
  105. saddens me, however, to see programs for the Amiga which do not properly
  106. support the Workbench. I am also disturbed by the fact that books which
  107. describe how to program the Amiga ignore the Icon and Workbench
  108. environment. I feel that the bulk of future Amiga users will operate their
  109. machines using the Workbench and NOT the CLI. Therefore, the future of this
  110. machine is intimately related to it's ability to be easy and INTUITIVE to
  111. use via the Workbench. I personally perform nearly ALL my day to day
  112. operations using the Workbench, unless I am forced to use the CLI by a
  113. short-sighted program. We should all be allowed the choice to operate from
  114. EITHER environment properly. This is a special advantage of the Amiga !
  115.  
  116. The programs included here demonstrate a technique to make an invokation
  117. from the CLI be similar to an invokation from the Workbench. Thus the same
  118. front-end instructions can be placed in many programs and they will run
  119. smoothly and properly from both the CLI and the workbench. These programs
  120. also show how it is relatively easy to use the icon data structures. It is
  121. interesting to note that this approach is the opposite to one used by some
  122. folks who covert the workbench arguments into CLI style ones. This is
  123. inappropriate when one wants to be able to manipulate the Icon data
  124. structures.
  125.  
  126. Most programs should also work from the CLI, since the expression of
  127. programs via ARexx or other command scripting languages requires access to
  128. tools via the CLI style of calling. Thus the support of the CLI environment
  129. is also important.
  130.  
  131. Some additional philosophy at work here is related to why I choose to make
  132. very small separate tools instead of large multi-functioned ones. This
  133. comes to some extent from my experiences with the UNIX operating system.
  134. There many different programmers creating small tools which can work in
  135. concert on larger problems. I hope to maintain a similar attitude here and
  136. have small tools that each perform their individual jobs well without
  137. trying to do too much. This also allows the users to select just those
  138. tools for the tasks of interest to them instead of carrying around the
  139. baggage of a oversized multi-functional program. This attitude is also
  140. prevalent in the ARexx enviroment that is now coming about on the Amiga.
  141. Here it is best to let smaller programs each do their own tasks best and
  142. allow them to communicate through a common environment so the each user can
  143. select their favorite tools to get any particular job done without being
  144. forced to use an "integrated" enviroment with no flexibilty. If you think
  145. Hypertext is a "big" concept, you should really think about the
  146. significance of ARexx. I predict that the Amiga community will get far more
  147. mileage out of the ARexx environment then the Macintosh community will get
  148. from HyperCard.
  149.  
  150. Conclusion:
  151. -----------
  152. Thanks for reading so far. I hope some of the information (and opinions)
  153. provided here along with these tools are useful to you.
  154.  
  155.                                                        Ralph
  156.  
  157.