home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / makobj05.zip / MakeObj.DOC < prev    next >
Text File  |  1999-06-29  |  5KB  |  104 lines
  1.                  MAKEOBJ
  2.                  =======
  3.  
  4. MakeObj.CMD (C) 1999 John Merryweather Cooper, College Place,
  5. WA, USA, e-mail jmcoopr@webmail.bmi.net
  6.  
  7. Inspired by:  Ingo Pflanz's version (I like the icon . . . :-)
  8.               M. Kimes's version included with FM/2 Utilities
  9.            (I just wanted a little more . . .)
  10.  
  11.                    Installation
  12.                    ------------
  13.  
  14. This Rexx script is intended to create all sorts of common WPS program
  15. objects.  In particular, I wanted to save some time applying titles to
  16. INF and HLP OS/2 files.
  17.  
  18. To install, copy "makeobj.cmd" and "makeobj.ico" into a directory in
  19. your PATH. On my system, they reside in D:\FM2 (a great file
  20. management system for OS/2), but anywhere else in the PATH will be fine
  21. so long as it is ahead of any other "makeobj.cmd" in the PATH.  Once you
  22. have copied these files to a suitable directory, open an OS/2 Command
  23. Prompt Window and type:
  24.  
  25.     [D:\fm2] makeobj makeobj.cmd [ENTER]
  26.  
  27. The MAKEOBJ Icon should appear on your desktop.
  28.  
  29. You can now either drag appropriate program objects to MAKEOBJ for
  30. creation on your desktop, or run MAKEOBJ from the command line.
  31.  
  32. The command line syntax for MAKEOBJ is:
  33.  
  34.     MAKEOBJ [] [-?] [--help] filespec
  35.  
  36. "[]" represents no arguments, which will present you with a Usage
  37. message.  A usage message will also result with parameters "-?" and
  38. "--help".  The "filespec" may consist of a drive:\path\filename argument
  39. in the usual OS/2 manner.  Wildcard characters "*" and "?" are
  40. recognized--and will be expanded--in filenames.  You may also provide a
  41. subdirectory argument (called a folder in WPS-speak) which will create a
  42. shadow folder on the desktop of that subdirectory.
  43.  
  44. The default behavior of MAKEOBJ is to create a shadow-object if it
  45. cannot determine any other special processing needed for the program
  46. object.
  47.  
  48. For files marked with the OS/2 EA "Executable", "OS/2 Command File",
  49. "DOS Command File", or the traditional executable extensions, a program
  50. object will be created on the desktop.
  51.  
  52. For files marked with the OS/2 EA "HTML" or "text/html", a URL object
  53. with the title coded in the HTML file between <TITLE> and </TITLE> will
  54. be created on the desktop.  By default, MAKEOBJ supplies the "-k"
  55. parameter to the your system's default browser.  If your system is like
  56. mine and the default browser is Netscape (2.x or 4.x), the window will
  57. be opened in "Kiosk" mode.  If your default browser is NOT Netscape or
  58. you don't like "Kiosk" mode, you'll need to edit
  59.  
  60.     browser_option = '-k'
  61.  
  62. in makeobj.cmd to an appropriate string or to '' (null string).
  63.  
  64. In a similar manner, you may alter the browser used for Adobe
  65. Acrobat(tm), postscript, INF, and HLP files by modifying
  66.  
  67.     browser =
  68.  
  69. to point to an appropriate string.  Unless your directory structure is
  70. identical to mine, you'll probably have to modify the "browser"
  71. variables for Adobe Acrobat(tm) and postscript files to point to a
  72. viewer present on your system with an absolute pathname unless the
  73. browser is in the PATH on your system.
  74.  
  75. INF and HLP files will also have the title extracted, if it exists.
  76. This isn't perfect yet because some undocumented "escaping" appears to
  77. be necessary for certain characters.  Since I haven't divined what the
  78. "escaping" method is yet, my solution is to translate certain characters
  79. to more mundane ones that won't cause REXXUTIL to truncate the titles.
  80.  
  81. This is also somewhat of a problem with HTML titles.  I've also made
  82. some attempt to filter out "&html-code" sequences in a somewhat sane
  83. manner.  I've attempted to make this fairly comprehensive, but I've left
  84. out the hex and decimal coded variants.  I think this is a minor
  85. "feature", but I haven't run into titles with this variant of
  86. "&html-code" and so I'll give my fingers a rest from beating in all
  87. those codes!  :-)  In return, this version of MAKEOBJ deals with program
  88. documentation written in HTML format in a sane and consistent manner
  89. readily accessible from your favorite folder(s).
  90.  
  91. It is my intent to save all you OS/2 programmer's, enthusiasts, and
  92. user's wear-and-tear on your fingers.  I tried to test this script
  93. pretty thoroughly (the path-completion logic and HTML title processing
  94. proved to be somewhat picky :-), but I make no WARRANTies, express or
  95. implied, for any purpose.
  96.  
  97. In return, this script is subject to the GNU General Public License
  98. which is incorporated in the script.  You may distribute and use this
  99. script freely in accordance with that license.
  100.  
  101. jmc
  102. jmcoopr@webmail.bmi.net
  103.  
  104.