home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / resmgr.zip / source.zip / rdc.ipf < prev    next >
Text File  |  1996-02-16  |  15KB  |  357 lines
  1. .* EBOOKIE (IPFTAGS.DEF)
  2. .* Copyright (c) 1995, 1996 Martin Lafaix. All Rights Reserved.
  3. :userdoc.
  4. :h1 x=left y=bottom width=27% height=100% scroll=none.Resource Decompiler
  5. :p.Select one:
  6. :p.:link reftype=hd res=200 auto.
  7. :link reftype=hd res=200.Introduction:elink.
  8. .br
  9. :link reftype=hd res=210 viewport group=1.Help:elink.
  10. .br
  11. :link reftype=hd res=220 viewport group=1.Using:elink.
  12. .br
  13. :link reftype=hd res=230 viewport group=1.Options:elink.
  14. .br
  15. :link reftype=hd res=240 viewport group=1.Bug report:elink.
  16. .br
  17. :link reftype=hd res=250 viewport group=1.Copyright:elink.
  18. .br
  19. :link reftype=hd res=260 viewport group=1.History:elink.
  20. :h1 res=200 x=right y=bottom width=73% height=100% hide.Resource Decompiler - Introduction
  21. :lm margin=1.
  22. :p.The OS/2* Resource Decompiler (RDC) is an application-development
  23. tool that lets you extract application resources, such as message
  24. strings, pointers, menus, and dialog boxes, from the executable file
  25. of your application.  The Resource Decompiler is primarily intended to
  26. prepare data for OS/2 applications that use functions such as
  27. WinLoadString, WinLoadPointer, WinLoadMenu, and WinLoadDlg.  These
  28. functions load resources from the executable file of your application
  29. or another specified executable file.  The application can then use
  30. the loaded resources as needed.
  31. :p.The Resource Decompiler and the resource functions let you quickly
  32. modify application resources without recompiling the application
  33. itself.  That is, RDC can modify the resources in an executable file
  34. at any time without affecting the rest of the file.  This means that
  35. you can create custom applications from a single executable file - you
  36. just use RDC to edit the custom resources you need to each
  37. application.
  38. :p.The Resource Decompiler is especially important for international
  39. applications  because it lets you define all language-dependent data,
  40. such as message strings,  as resources.  Preparing the application for
  41. a new language is simply a matter of editing new resources from the
  42. existing executable file.
  43. :note.Make sure the file RDCPP.EXE (the Resource Decompiler
  44. preprocessor) is available for the use of the Resource Decompiler.  It
  45. can be in the current directory, or in a directory to which there is a
  46. path.
  47. :h1 res=210 x=right y=bottom width=73% height=100% hide.Resource Decompiler - Help
  48. :lm margin=1.
  49. :p.To display Resource Decompiler help, type RDC at the prompt, with
  50. no parameters.  The appropriate copyright statement will be displayed,
  51. along with a list of Resource Decompiler options.
  52. :xmp.
  53. Usage:  rdc [<option>] <.EXE input file> [<.RC output file>]
  54.         -r              - Extract .res file
  55.         -l              - List resources (but do not extract)
  56.         -h              - Access Help
  57.  
  58. Environment variables:
  59.         TMP=temporary file path
  60.         TEMP=temporary file path
  61. :exmp.
  62. :h1 res=220 x=right y=bottom width=73% height=100% hide.Resource Decompiler - Using
  63. :lm margin=1.
  64. :p.The Resource Decompiler (RDC) extracts a binary resource
  65. file from the executable file of the application.
  66. :p.The binary resource file is decompiled in a resource script
  67. file.
  68. :p.You can start RDC in any of three ways.
  69. :ul compact.
  70. :li.Extract and decompile a binary resource file from an executable
  71. file.
  72. :li.Extract a binary resource file from an executable file.
  73. :li.Decompile a binary resource file.
  74. :eul.
  75. :p.The RDC command line has the following three basic forms:
  76. :xmp.
  77. rdc executable-file [resource-script-file]
  78.  
  79. rdc binary-resource-file [resource-script-file]
  80.  
  81. rdc -r executable-file [binary-resource-file]
  82. :exmp.
  83. :note.The third option does not decompile the binary resource file.
  84. :p.The :hp2.resource-script-file:ehp2. field must be the filename of
  85. the resource script file to be decompiled.  If the file is not in the
  86. current directory, you must provide a full path.  If you provide a
  87. filename without specifying a filename extension, RDC automatically
  88. appends the &per.RC2 extension to the name.  If you omit the
  89. resource-script-file field, RDC puts the decompiled resources to the
  90. executable file that has the same name as the binary resource file but
  91. which has the &per.RC2 filename extension.
  92. :p.The :hp2.executable-file:ehp2. field must be the name of the
  93. executable file from which to extract the compiled resources.  This is
  94. a file having a filename extension of either .EXE or .DLL.  If the
  95. file is not in the current directory, you must provide a full path.
  96. If you specify the executable-file field but omit the filename
  97. extension, RC will append the .EXE extension.  If this executable file
  98. does not exist, RDC displays an error message.
  99. :p.The :hp2.-r:ehp2. option directs RDC to extract the binary
  100. resource file without decompiling it to a resource script file.  You
  101. can use this option to prepare a binary resource file that you can
  102. decompile to a resource script file at a later time.  If you do not
  103. explicitly name a binary resource file along with the -r option, RDC
  104. uses the same name as the executable file but with the .RES filename
  105. extension.
  106. :p.The :hp2.binary-resource-file:ehp2. field must be the name of the
  107. binary resource file to be extracted from the executable file.  If the
  108. binary resource file does not already exist, rdc creates it;
  109. otherwise, rdc replaces the existing file.  If the file is not in the
  110. current directory, you must provide a full path.  The binary resource
  111. file must have the .RES filename extension.
  112. :p.For example, to extract the binary resource file EXAMPLE.RES from
  113. the executable file EXAMPLE.EXE and decompile it to the resource
  114. script file EXAMPLE.RC2, use the following command:
  115. :xmp.
  116.    rdc example.exe
  117. :exmp.
  118. :p.RDC creates the binary resource file EXAMPLE.RES and puts the
  119. decompiled resources to the resource script file EXAMPLE.RC2.
  120. :p.To extract the binary resource file from EXAMPLE.EXE without
  121. decompiling the resources to a resource script file, use the following
  122. command:
  123. :xmp.
  124.    rdc -r example.exe
  125. :exmp.
  126. :p.The decompiler creates the binary resource file EXAMPLE.RES.  To
  127. create a binary resource file that has a name different from the
  128. executable file, use the following command:
  129. :xmp.
  130.    rdc -r example.exe newfile.res
  131. :exmp.
  132. :p.To decompile the compiled resources in the binary resource file
  133. EXAMPLE.RES to a resource script file, use the following command:
  134. :xmp.
  135.    rdc example.res
  136. :exmp.
  137. :p.To specify the name of the resource script file, if the name is
  138. different from the resource file, use the following command:
  139. :xmp.
  140.    rdc example.res newfile.rc
  141. :exmp.
  142. :p.To extract the compiled resources of a dynamic-link-library (.DLL)
  143. file, use the following command:
  144. :xmp.
  145.    rdc -r dynalink.dll
  146. :exmp.
  147. :p.In addition to -r, RC offers one other command-line option: -l.
  148. The -l option lets you view the resources contained in an
  149. executable file.  The syntax is as follows:
  150. :xmp.
  151.    rdc -l executable-file
  152. :exmp.
  153. :h1 res=230 x=right y=bottom width=73% height=100% hide.Resource Decompiler - Options
  154. :lm margin=1.
  155. :p.The following options can be specified on the Resource Decompiler
  156. command line:
  157. :dl.
  158. :dt.-r
  159. :dd.Extract .res file
  160. :dt.-l
  161. :dd.List content of a .exe file
  162. :dt.-h
  163. :dd.Access Help
  164. :edl.
  165. :h1 res=240 x=right y=bottom width=73% height=100% hide.Resource Decompiler - Bug Report
  166. :p.If you encounter a bug while using RDC or RESMGR, please send a
  167. description of it to the following address:
  168. :xmp.
  169.    lafaix&atsign.alto.unice.fr
  170. :exmp.
  171. or
  172. :xmp.
  173.    Martin Lafaix
  174.    16, rue de Dijon
  175.    06000 Nice
  176.    FRANCE
  177. :exmp.
  178. :p.Be sure to include at least your calling command and the output
  179. produced by RDC or RESMGR.  Thank you&xclm.
  180. :h1 res=250 x=right y=bottom width=73% height=100% hide.Resource Decompiler - Copyright
  181. :p.The term :hp2.OS/2:ehp2. is a trademark of the IBM Corporation.
  182. :p.RDC and RESMGR (c) Martin Lafaix 1994, 1995, 1996.
  183. :p.Author: Martin Lafaix
  184. .br
  185. Address:
  186. :xmp.
  187.     16, rue de Dijon
  188.     06000 Nice
  189.     France
  190.  
  191.     email: lafaix@alto.unice.fr
  192. :exmp.
  193. :h1 x=left y=bottom width=27% height=100% scroll=none.Resource Manager
  194. :p.Select one:
  195. :p.:link reftype=hd res=300 auto.
  196. :link reftype=hd res=300.Introduction:elink.
  197. .br
  198. :link reftype=hd res=310 viewport group=1.Help:elink.
  199. .br
  200. :link reftype=hd res=320 viewport group=1.Using:elink.
  201. .br
  202. :link reftype=hd res=330 viewport group=1.Options:elink.
  203. .br
  204. :link reftype=hd res=240 viewport group=1.Bug report:elink.
  205. .br
  206. :link reftype=hd res=250 viewport group=1.Copyright:elink.
  207. .br
  208. :link reftype=hd res=360 viewport group=1.History:elink.
  209. :h1 res=300 x=right y=bottom width=73% height=100% hide.Resource Manager - Introduction
  210. :lm margin=1.
  211. :p.The OS/2* Resource Manager (RESMGR) is an application-development
  212. tool that lets you manage application resources, such as
  213. message, strings, pointers, menus, and dialog boxes.
  214. :p.You can start RESMGR with a single command from the command line.
  215. :p.With RESMGR, you can:
  216. :ul compact.
  217. :li.Extract specified resources from a file.
  218. :li.Add resources to a file.
  219. :li.View the resources included in a file.
  220. :li.Delete specified resources from a file.
  221. :eul.
  222. :note.In the previous list, "file" can be a binary resource file or an
  223. executable file.
  224. :h1 res=310 x=right y=bottom width=73% height=100% hide.Resource Manager - Help
  225. :lm margin=1.
  226. :p.To display Resource Manager help, type RESMGR at the prompt, with
  227. no parameters.  The appropriate copyright statement will be displayed,
  228. along with a list of Resource Manager options.
  229. :xmp.
  230. Usage:  resmgr <option> <.RES file> [id.type] [file]
  231.         -a              - Add specified resources (default)
  232.         -d              - Delete specified resources
  233.         -l              - List resources (short format)
  234.         -v              - List resources (long format)
  235.         -x              - Extract specified resources
  236.         -h              - Access Help
  237.  
  238.         .RES file       = .RES, .EXE or .DLL filename
  239.         file            = Input or output file name
  240.         type            = Resource type or *
  241.         id              = Resource ID or *
  242.  
  243. Possible type value (with -d, -l, -v or -x):
  244.  
  245.   Acceltable Bitmap   Chartbl Dialog  Displayinfo  Dlginclude Fd     Fddir
  246.   Fkalong    Fkashort Font    Fontdir Helpsubtable Helptable  Keytbl Menu
  247.   Messagetable        Pointer RCData  Stringtable  Vkeytbl
  248.  
  249. Environment variables:
  250.         TMP=temporary file path
  251.         TEMP=temporary file path
  252. :exmp.
  253. :h1 res=320 x=right y=bottom width=73% height=100% hide.Resource Manager - Using
  254. :lm margin=1.
  255. :p.The Resource Manager (RESMGR) manages resources from binary
  256. resource files or executable files.
  257. :p.You can start RESMGR in any of four ways.
  258. :ul compact.
  259. :li.Add a binary resource file to a file.
  260. :li.Extract specified resources from a file.
  261. :li.Remove specified resouces from a file.
  262. :li.List specified resources from a file.
  263. :eul.
  264. :p.The RESMGR command line has the following four basic forms:
  265. :xmp.
  266. resmgr -a file binary-resource-file
  267.  
  268. resmgr -x file [id.type] [binary-resource-file]
  269.  
  270. resmgr -d file [id.type]
  271.  
  272. resmgr -l file [id.type]  -or-  resmgr -v file [id.type]
  273. :exmp.
  274. :p.The :hp2.file:ehp2. field must be the name of the executable or
  275. binary resource file from which to manage the resources.  This is a
  276. file having a filename extension of either .RES, .EXE or .DLL.  If the
  277. file is not in the current directory, you must provide a full path.
  278. If this file does not exist, RESMGR displays an error message.
  279. :note.You cannot perform "destructive" actions (:hp2.-A:ehp2. or
  280. :hp2.-D:ehp2.) if the file is in use.  If you want to do so, close
  281. the program using the file, or make your modifications over a copy of
  282. the file, and replace it later when it is no longer used.
  283. :p.The :hp2.id.type:ehp2. field can be used to specify a range of
  284. resources.  The :hp2.id:ehp2. part is either "*" or a number (the
  285. resource ID), while the :hp2.type:ehp2. part can be "*", a resource
  286. type name (such as DIALOG, STRING, or ...) or a number (the resource
  287. type ID).  If this field is specified, the requested command will only
  288. affect the specified resources.
  289. :p.The :hp2.binary-resource-file:ehp2. field must be the name of the
  290. binary resource file to be added or extracted from the file. If the
  291. binary resource file does not already exist, rdc creates it;
  292. otherwise, rdc replaces the existing file.  If the file is not in the
  293. current directory, you must provide a full path.  The binary resource
  294. file must have the .RES filename extension.
  295. :p.For example, to view all resources included in the binary
  296. resource file EXAMPLE.RES, use the following command:
  297. :xmp.
  298.    resmgr -v example.res
  299. :exmp.
  300. :p.To only view all Dialog resources included in the binary
  301. resource file EXAMPLE.RES, use the following command instead:
  302. :xmp.
  303.    resmgr -v example.res *.dialog
  304. :exmp.
  305. :p.To extract the all string resources included in EXAMPLE.EXE, use
  306. the following command:
  307. :xmp.
  308.    resmgr -x example.exe *.string example.res
  309. :exmp.
  310. :p.The manager creates the binary resource file EXAMPLE.RES.  To add
  311. resources to a file, use the following command:
  312. :xmp.
  313.    resmgr -a example.exe newfile.res
  314. :exmp.
  315. :p.The resources included in NEWFILES.RES will be added in
  316. EXAMPLE.EXE.  If a resource already exists in the file, it will be
  317. replaced (but if a resource is present in EXAMPLE.RES but not in
  318. NEWFILE.RES, it will be preserved).
  319. :p.To remove the resource 123.999 from EXEMPLE.RES, use the
  320. following command:
  321. :xmp.
  322.    resmgr -d example.res 123.999
  323. :exmp.
  324. :p.123 is the resource ID and 999 is the resource type ID (a
  325. user-defined one).
  326. :h1 res=330 x=right y=bottom width=73% height=100% hide.Resource Manager - Options
  327. :lm margin=1.
  328. :p.The following options can be specified on the Resource Manager
  329. command line:
  330. :dl.
  331. :dt.-a
  332. :dd.Add resources to a file
  333. :dt.-d
  334. :dd.Remove specified resources from a file
  335. :dt.-l
  336. :dd.List specified resource content of a file (short form)
  337. :dt.-v
  338. :dd.List specified resource content of a file (long form)
  339. :dt.-x
  340. :dd.Extract specified resources from a file
  341. :dt.-h
  342. :dd.Access Help
  343. :edl.
  344. :h1 res=260 x=right y=bottom width=73% height=100% hide.Resource Decompiler - History
  345. :font facename=Helv size=12x12.
  346. :xmp.
  347. .im HISTORY.RDC
  348. :exmp.
  349. :font facename=default.
  350. :h1 res=360 x=right y=bottom width=73% height=100% hide.Resource Manager - History
  351. :font facename=Helv size=12x12.
  352. :xmp.
  353. .im HISTORY.MGR
  354. :exmp.
  355. :font facename=default.
  356. :euserdoc.
  357.