home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / open201.zip / readme.doc < prev    next >
Text File  |  1998-03-08  |  7KB  |  180 lines
  1. Open 2.01                     (C) 1997 Samuel Audet <guardia@cam.org>
  2.  
  3. THIS IS A FREEWARE UTILITY!!  Please send an e-mail if are using this
  4. program, thank you!  If you can spare some money for a pre-university
  5. student, it would be very much appreciated.
  6.  
  7. Introduction
  8. ============
  9.  
  10. This OS/2 command line utility lets you open objects the command line as if
  11. you opened them from the WPS.
  12.  
  13. I also recommend the contrary to this utility (ie.: opening command lines
  14. from folders), Command Folder.  You can get a copy on my web page
  15. http://www.cam.org/~guardia
  16.  
  17. Installation
  18. ============
  19.  
  20. To be able to filter the contents of a folder using open.exe, you will need
  21. to register a new folder class found in WPSExtS.dll.  This DLL also
  22. includes a fix to the background open.  If you want to install both or
  23. either of them, you will need OS/2 Warp 3 or higher and will need to run
  24. "reg.exe i". It is preferable that the DLL be placed in a system DLL
  25. directory (for example x:\os2\dll), unless you specify a directory, ex.:
  26. "reg.exe i x:\open" This is the same DLL than in Hot Corners 2.0 package,
  27. but register with reg.exe just to be sure everything is OK for Open.
  28. Current version of WPS Extention DLL is 1.0, I will try to make all new
  29. versions backward compatible.
  30.  
  31. Note that the Include page in folder's setting pages is the solution for a
  32. permanent filtering since open.exe filtering is dismissed on folder close.
  33.  
  34. Usage
  35. =====
  36.  
  37. open [/?] [/F filter] [/Oview] [objects] [/F filter] [/Oview] [objects] ...
  38.  
  39. where
  40.  
  41.   [/?]        shows this help screen.
  42.   [/F filter] specifies a title wildcard filter for folder objects.
  43.   [/Oview]    specifies the view to open.  Possible views are:
  44.                    blank : default view (same as double-click),
  45.                        P : properties view,
  46.                        I : icon view,
  47.                        T : tree view, and
  48.                        D : details view.
  49.   [objects] are the names of the objects to open (file system name or
  50.             object IDs).  Wildcards and multiple entries are accepted!
  51.  
  52. The specified objects will be opened as if they were opened from the WPS.
  53. If no parameters are specified, the current directory is opened as a
  54. folder, with default view and no filter.
  55.  
  56. Of course, some of the view options only apply to folders.
  57.  
  58. To have a full list of Object IDs available on your system, run
  59. objectid.cmd provided, you will be able to guess most of them.  Various
  60. utilities including UniMaintenance and Object Desktop can determine the
  61. Object ID of an object.  Object IDs are useful because not all objects are
  62. found as files or directories. Object IDs specified on open.exe command
  63. will need to be in quotes because < and > characters are normally used for
  64. output and input redirection on the command line.  Remember that Object IDs
  65. are CaSe SeNsItIvE.
  66.  
  67. A '-' can be used instead of a '/' for options, and the options are case
  68. insensitive.  The options are also "linear".  This means they will take
  69. effect on all objects following the declaration of this option and not on
  70. the ones preceding it.
  71.  
  72. The return code indicates how many error occured (ie.: how many objects
  73. were not successfully opened).
  74.  
  75. ex.:  [C:\open]open "<WP_OS2SYS>" f:\config.0?? e:\gif\naughty\*.gif i: g:\ /F *.zip c:\incoming /od . ..
  76.  
  77.       In order, it will open the "OS/2 System" folder, all files matching
  78.       f:\config.0?? and e:\gif\naughty\*.gif, drive i:, drive g:, folder
  79.       c:\incoming with *.zip filter (only showing ZIP files), and the current
  80.       directory and the parent directory in details view with *.zip filter.
  81.  
  82. For Programmers
  83. ===============
  84.  
  85. If you want to include folder filtering or the background open fix in your
  86. own program, read wpsext.doc.
  87.  
  88. Known bugs or limitations
  89. =========================
  90.  
  91. - Icons position are not retained when using folder filtering.
  92. - Sometimes, the filtering routine goes mad and filters everything out...
  93.   if you manage to get a reproducable situation, let me know.
  94.  
  95. Legal stuff
  96. ===========
  97.  
  98. This freeware product is used at your own risk, although it is highly
  99. improbable it can cause any damage.
  100.  
  101. If you plan on copying me, please give me the credits, thanks.
  102.  
  103. Contacting the author
  104. =====================
  105.  
  106. Samuel Audet
  107.  
  108. E-mail:    guardia@cam.org
  109. Homepage:  http://www.cam.org/~guardia
  110. IRC nick:  Guardian_ (be sure it is I before starting asking questions though)
  111.  
  112. Snail Mail:
  113.  
  114.    377, rue D'Argenteuil
  115.    Laval, Quebec
  116.    H7N 1P7   CANADA
  117.  
  118.  
  119. Thanks for using this wonderful product!
  120.  
  121.  
  122. Original README
  123. ---------------
  124.  
  125. Open - a useful OS/2 WPS utility.
  126.  
  127. I first wrote this little utility basically because I discovered
  128. how to use the WinSetObjectData API to open a Workplace Shell
  129. object, and I thought it was cool.    It has since turned out to be
  130. an extremely handy little tool, which is not bad for something
  131. whose source code is a whopping 33 lines long, including the
  132. help.
  133.  
  134. What does it do?  Basically, it opens WPS objects, using their
  135. default open setting.  So, for example, you can type
  136.  
  137. open c:\os2
  138.  
  139. and it will open the drives folder for c:\os2.    Even handier, typing
  140.  
  141. open .
  142.  
  143. will open the drives folder for whatever the current directory you
  144. are in is.    I tend to use this when I have been doing some stuff from
  145. the command line, and suddenly want to delete a bunch of subdirectories,
  146. which is a lot easier to do from the WPS than from the command line.
  147. This saves navigating all the way through the drives object to get
  148. to the folder you want.
  149.  
  150. Another handy use is if you want to be able to open a folder
  151. from an object's menu.  There is no way to add a folder object to a menu
  152. normally, but if you create a little dummy program object that uses
  153. open.exe to open the folder, you can put _that_ on the menu, and
  154. get the same result.
  155.  
  156. The other really cool thing you can do is something like
  157.  
  158. open os2.bmp
  159.  
  160. This will automatically run whatever the program associated with os2.bmp
  161. is (usually either Windows Paint or the icon editor, but on my system
  162. I have changed it so that bmps are associated with PMView) and load
  163. os2.bmp into it automatically.    Basically, it is the same as
  164. double-clicking on the file object for os2.bmp.
  165.  
  166. So, anyway, I hereby release this little utility as freeware.  I couldn't
  167. see charging any money for something this simple.  The source code is
  168. included if you want to monkey with it.  However, you may not charge
  169. anyone for this software, other than a reasonable fee for duplication,
  170. and all such other legal mumbo-jumbo that is normally associated
  171. with freeware.
  172.  
  173. Please feel free to send me e-mail if you like this little program, or
  174. if you have any questions.
  175.  
  176. -- Rob McDermid
  177. rmcderm@ibm.net
  178.  
  179.  
  180.