home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / resmgr.zip / rdc.INF (.txt) < prev    next >
OS/2 Help File  |  1996-02-18  |  13KB  |  422 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Resource Decompiler ΓòÉΓòÉΓòÉ
  3.  
  4. Select one: 
  5.  
  6. Introduction 
  7. Help 
  8. Using 
  9. Options 
  10. Bug report 
  11. Copyright 
  12. History 
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - Introduction ΓòÉΓòÉΓòÉ
  16.  
  17.  The OS/2* Resource Decompiler (RDC) is an application-development tool that 
  18.  lets you extract application resources, such as message strings, pointers, 
  19.  menus, and dialog boxes, from the executable file of your application.  The 
  20.  Resource Decompiler is primarily intended to prepare data for OS/2 
  21.  applications that use functions such as WinLoadString, WinLoadPointer, 
  22.  WinLoadMenu, and WinLoadDlg.  These functions load resources from the 
  23.  executable file of your application or another specified executable file.  The 
  24.  application can then use the loaded resources as needed. 
  25.  
  26.  The Resource Decompiler and the resource functions let you quickly modify 
  27.  application resources without recompiling the application itself.  That is, 
  28.  RDC can modify the resources in an executable file at any time without 
  29.  affecting the rest of the file.  This means that you can create custom 
  30.  applications from a single executable file - you just use RDC to edit the 
  31.  custom resources you need to each application. 
  32.  
  33.  The Resource Decompiler is especially important for international applications 
  34.  because it lets you define all language-dependent data, such as message 
  35.  strings,  as resources.  Preparing the application for a new language is 
  36.  simply a matter of editing new resources from the existing executable file. 
  37.  
  38.  Note:  Make sure the file RDCPP.EXE (the Resource Decompiler preprocessor) is 
  39.  available for the use of the Resource Decompiler.  It can be in the current 
  40.  directory, or in a directory to which there is a path. 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - Help ΓòÉΓòÉΓòÉ
  44.  
  45.  To display Resource Decompiler help, type RDC at the prompt, with no 
  46.  parameters.  The appropriate copyright statement will be displayed, along with 
  47.  a list of Resource Decompiler options. 
  48.  
  49.   Usage:  rdc [<option>] <.EXE input file> [<.RC output file>]
  50.           -r              - Extract .res file
  51.           -l              - List resources (but do not extract)
  52.           -h              - Access Help
  53.  
  54.   Environment variables:
  55.           TMP=temporary file path
  56.           TEMP=temporary file path
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - Using ΓòÉΓòÉΓòÉ
  60.  
  61.  The Resource Decompiler (RDC) extracts a binary resource file from the 
  62.  executable file of the application. 
  63.  
  64.  The binary resource file is decompiled in a resource script file. 
  65.  
  66.  You can start RDC in any of three ways. 
  67.  
  68.      Extract and decompile a binary resource file from an executable file. 
  69.      Extract a binary resource file from an executable file. 
  70.      Decompile a binary resource file. 
  71.  
  72.  The RDC command line has the following three basic forms: 
  73.  
  74.   rdc executable-file [resource-script-file]
  75.  
  76.   rdc binary-resource-file [resource-script-file]
  77.  
  78.   rdc -r executable-file [binary-resource-file]
  79.  
  80.  Note:  The third option does not decompile the binary resource file. 
  81.  
  82.  The resource-script-file field must be the filename of the resource script 
  83.  file to be decompiled.  If the file is not in the current directory, you must 
  84.  provide a full path.  If you provide a filename without specifying a filename 
  85.  extension, RDC automatically appends the .RC2 extension to the name.  If you 
  86.  omit the resource-script-file field, RDC puts the decompiled resources to the 
  87.  executable file that has the same name as the binary resource file but which 
  88.  has the .RC2 filename extension. 
  89.  
  90.  The executable-file field must be the name of the executable file from which 
  91.  to extract the compiled resources.  This is a file having a filename extension 
  92.  of either .EXE or .DLL.  If the file is not in the current directory, you must 
  93.  provide a full path. If you specify the executable-file field but omit the 
  94.  filename extension, RC will append the .EXE extension.  If this executable 
  95.  file does not exist, RDC displays an error message. 
  96.  
  97.  The -r option directs RDC to extract the binary resource file without 
  98.  decompiling it to a resource script file.  You can use this option to prepare 
  99.  a binary resource file that you can decompile to a resource script file at a 
  100.  later time.  If you do not explicitly name a binary resource file along with 
  101.  the -r option, RDC uses the same name as the executable file but with the .RES 
  102.  filename extension. 
  103.  
  104.  The binary-resource-file field must be the name of the binary resource file to 
  105.  be extracted from the executable file.  If the binary resource file does not 
  106.  already exist, rdc creates it; otherwise, rdc replaces the existing file.  If 
  107.  the file is not in the current directory, you must provide a full path.  The 
  108.  binary resource file must have the .RES filename extension. 
  109.  
  110.  For example, to extract the binary resource file EXAMPLE.RES from the 
  111.  executable file EXAMPLE.EXE and decompile it to the resource script file 
  112.  EXAMPLE.RC2, use the following command: 
  113.  
  114.      rdc example.exe
  115.  
  116.  RDC creates the binary resource file EXAMPLE.RES and puts the decompiled 
  117.  resources to the resource script file EXAMPLE.RC2. 
  118.  
  119.  To extract the binary resource file from EXAMPLE.EXE without decompiling the 
  120.  resources to a resource script file, use the following command: 
  121.  
  122.      rdc -r example.exe
  123.  
  124.  The decompiler creates the binary resource file EXAMPLE.RES.  To create a 
  125.  binary resource file that has a name different from the executable file, use 
  126.  the following command: 
  127.  
  128.      rdc -r example.exe newfile.res
  129.  
  130.  To decompile the compiled resources in the binary resource file EXAMPLE.RES to 
  131.  a resource script file, use the following command: 
  132.  
  133.      rdc example.res
  134.  
  135.  To specify the name of the resource script file, if the name is different from 
  136.  the resource file, use the following command: 
  137.  
  138.      rdc example.res newfile.rc
  139.  
  140.  To extract the compiled resources of a dynamic-link-library (.DLL) file, use 
  141.  the following command: 
  142.  
  143.      rdc -r dynalink.dll
  144.  
  145.  In addition to -r, RC offers one other command-line option: -l. The -l option 
  146.  lets you view the resources contained in an executable file.  The syntax is as 
  147.  follows: 
  148.  
  149.      rdc -l executable-file
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - Options ΓòÉΓòÉΓòÉ
  153.  
  154.  The following options can be specified on the Resource Decompiler command 
  155.  line: 
  156.  
  157.  -r        Extract .res file 
  158.  
  159.  -l        List content of a .exe file 
  160.  
  161.  -h        Access Help 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - Bug Report ΓòÉΓòÉΓòÉ
  165.  
  166. If you encounter a bug while using RDC or RESMGR, please send a description of 
  167. it to the following address: 
  168.  
  169.    lafaix@alto.unice.fr
  170. or 
  171.  
  172.    Martin Lafaix
  173.    16, rue de Dijon
  174.    06000 Nice
  175.    FRANCE
  176.  
  177. Be sure to include at least your calling command and the output produced by RDC 
  178. or RESMGR.  Thank you! 
  179.  
  180.  
  181. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - Copyright ΓòÉΓòÉΓòÉ
  182.  
  183. The term OS/2 is a trademark of the IBM Corporation. 
  184.  
  185. RDC and RESMGR (c) Martin Lafaix 1994, 1995, 1996. 
  186.  
  187. Author: Martin Lafaix 
  188. Address: 
  189.  
  190.     16, rue de Dijon
  191.     06000 Nice
  192.     France
  193.  
  194.     email: lafaix@alto.unice.fr
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 2. Resource Manager ΓòÉΓòÉΓòÉ
  198.  
  199. Select one: 
  200.  
  201. Introduction 
  202. Help 
  203. Using 
  204. Options 
  205. Bug report 
  206. Copyright 
  207. History 
  208.  
  209.  
  210. ΓòÉΓòÉΓòÉ <hidden> Resource Manager - Introduction ΓòÉΓòÉΓòÉ
  211.  
  212.  The OS/2* Resource Manager (RESMGR) is an application-development tool that 
  213.  lets you manage application resources, such as message, strings, pointers, 
  214.  menus, and dialog boxes. 
  215.  
  216.  You can start RESMGR with a single command from the command line. 
  217.  
  218.  With RESMGR, you can: 
  219.  
  220.      Extract specified resources from a file. 
  221.      Add resources to a file. 
  222.      View the resources included in a file. 
  223.      Delete specified resources from a file. 
  224.  
  225.  Note:  In the previous list, "file" can be a binary resource file or an 
  226.  executable file. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ <hidden> Resource Manager - Help ΓòÉΓòÉΓòÉ
  230.  
  231.  To display Resource Manager help, type RESMGR at the prompt, with no 
  232.  parameters.  The appropriate copyright statement will be displayed, along with 
  233.  a list of Resource Manager options. 
  234.  
  235.   Usage:  resmgr <option> <.RES file> [id.type] [file]
  236.           -a              - Add specified resources (default)
  237.           -d              - Delete specified resources
  238.           -l              - List resources (short format)
  239.           -v              - List resources (long format)
  240.           -x              - Extract specified resources
  241.           -h              - Access Help
  242.  
  243.           .RES file       = .RES, .EXE or .DLL filename
  244.           file            = Input or output file name
  245.           type            = Resource type or *
  246.           id              = Resource ID or *
  247.  
  248.   Possible type value (with -d, -l, -v or -x):
  249.  
  250.     Acceltable Bitmap   Chartbl Dialog  Displayinfo  Dlginclude Fd     Fddir
  251.     Fkalong    Fkashort Font    Fontdir Helpsubtable Helptable  Keytbl Menu
  252.     Messagetable        Pointer RCData  Stringtable  Vkeytbl
  253.  
  254.   Environment variables:
  255.           TMP=temporary file path
  256.           TEMP=temporary file path
  257.  
  258.  
  259. ΓòÉΓòÉΓòÉ <hidden> Resource Manager - Using ΓòÉΓòÉΓòÉ
  260.  
  261.  The Resource Manager (RESMGR) manages resources from binary resource files or 
  262.  executable files. 
  263.  
  264.  You can start RESMGR in any of four ways. 
  265.  
  266.      Add a binary resource file to a file. 
  267.      Extract specified resources from a file. 
  268.      Remove specified resouces from a file. 
  269.      List specified resources from a file. 
  270.  
  271.  The RESMGR command line has the following four basic forms: 
  272.  
  273.   resmgr -a file binary-resource-file
  274.  
  275.   resmgr -x file [id.type] [binary-resource-file]
  276.  
  277.   resmgr -d file [id.type]
  278.  
  279.   resmgr -l file [id.type]  -or-  resmgr -v file [id.type]
  280.  
  281.  The file field must be the name of the executable or binary resource file from 
  282.  which to manage the resources.  This is a file having a filename extension of 
  283.  either .RES, .EXE or .DLL.  If the file is not in the current directory, you 
  284.  must provide a full path. If this file does not exist, RESMGR displays an 
  285.  error message. 
  286.  
  287.  Note:  You cannot perform "destructive" actions (-A or -D) if the file is in 
  288.  use.  If you want to do so, close the program using the file, or make your 
  289.  modifications over a copy of the file, and replace it later when it is no 
  290.  longer used. 
  291.  
  292.  The id.type field can be used to specify a range of resources.  The id part is 
  293.  either "*" or a number (the resource ID), while the type part can be "*", a 
  294.  resource type name (such as DIALOG, STRING, or ...) or a number (the resource 
  295.  type ID).  If this field is specified, the requested command will only affect 
  296.  the specified resources. 
  297.  
  298.  The binary-resource-file field must be the name of the binary resource file to 
  299.  be added or extracted from the file. If the binary resource file does not 
  300.  already exist, rdc creates it; otherwise, rdc replaces the existing file.  If 
  301.  the file is not in the current directory, you must provide a full path.  The 
  302.  binary resource file must have the .RES filename extension. 
  303.  
  304.  For example, to view all resources included in the binary resource file 
  305.  EXAMPLE.RES, use the following command: 
  306.  
  307.      resmgr -v example.res
  308.  
  309.  To only view all Dialog resources included in the binary resource file 
  310.  EXAMPLE.RES, use the following command instead: 
  311.  
  312.      resmgr -v example.res *.dialog
  313.  
  314.  To extract the all string resources included in EXAMPLE.EXE, use the following 
  315.  command: 
  316.  
  317.      resmgr -x example.exe *.string example.res
  318.  
  319.  The manager creates the binary resource file EXAMPLE.RES.  To add resources to 
  320.  a file, use the following command: 
  321.  
  322.      resmgr -a example.exe newfile.res
  323.  
  324.  The resources included in NEWFILES.RES will be added in EXAMPLE.EXE.  If a 
  325.  resource already exists in the file, it will be replaced (but if a resource is 
  326.  present in EXAMPLE.RES but not in NEWFILE.RES, it will be preserved). 
  327.  
  328.  To remove the resource 123.999 from EXEMPLE.RES, use the following command: 
  329.  
  330.      resmgr -d example.res 123.999
  331.  
  332.  123 is the resource ID and 999 is the resource type ID (a user-defined one). 
  333.  
  334.  
  335. ΓòÉΓòÉΓòÉ <hidden> Resource Manager - Options ΓòÉΓòÉΓòÉ
  336.  
  337.  The following options can be specified on the Resource Manager command line: 
  338.  
  339.  -a        Add resources to a file 
  340.  
  341.  -d        Remove specified resources from a file 
  342.  
  343.  -l        List specified resource content of a file (short form) 
  344.  
  345.  -v        List specified resource content of a file (long form) 
  346.  
  347.  -x        Extract specified resources from a file 
  348.  
  349.  -h        Access Help 
  350.  
  351.  
  352. ΓòÉΓòÉΓòÉ <hidden> Resource Decompiler - History ΓòÉΓòÉΓòÉ
  353.  
  354. 2.08.000    Feb 17 1996
  355.  
  356.  --- Bug fixes:
  357.      o Correct handling of '/' in filenames.
  358.  
  359. 2.07.000    Feb 16 1996
  360.  
  361.  --- Bug fixes:
  362.      o Fixed problem when module name has more than 8 characters.
  363.  
  364. 2.06.000    May 31 1995
  365.  
  366.  --- New features:
  367.      o Adding exit codes (0 when OK, 1 when error and 2 when no resources).
  368.  
  369. 2.05.002    May 28 1995
  370.  
  371.  --- Bug fixes:
  372.      o Font directory emitted as RESOURCE.
  373.      o Display info emitted as RESOURCE.
  374.      o Control characters are emitted as '\xnn'.
  375.  
  376. 2.05.001    May 27 1995
  377.  
  378.  --- Bug fixes:
  379.      o closing infile before COPYing it.
  380.  --- New features:
  381.      o Nothing done when there's no resource.
  382.  
  383. 2.04.002    May 26 1995
  384.  
  385.  --- Bug fixes:
  386.      o Special characters in strings are correctly emitted.
  387.      o Accelerators were incorrectly emitted.
  388.  --- New commands:
  389.      o Added a -l option (list content).
  390.  --- New features:
  391.      o Added packed (Iterated and Iterated II) resources support.
  392.      o Added direct EXE to RC translation.
  393.      o Improved error messages.
  394.      o Temporary files no longer overwrite pre-existing files.
  395.  
  396. 2.00.007    Apr 03 1994
  397.  
  398.  --- First release to the unsuspecting public.
  399.      Included in EDM 2_6 (real code in 2_7).
  400.  
  401.  
  402. ΓòÉΓòÉΓòÉ <hidden> Resource Manager - History ΓòÉΓòÉΓòÉ
  403.  
  404. 0.04.000    Feb 17 1996
  405.  
  406.  --- Bug fixes:
  407.      o Correct handling of '/' in filenames.
  408.  
  409. 0.03.000    Feb 16 1996
  410.  
  411.  --- Bug fixes:
  412.      o Minor fixes in the help message.
  413.  
  414. 0.02.000    Jun 19 1995
  415.  
  416.  --- Bug fixes:
  417.      o Drive name can be specified in filename.
  418.  
  419. 0.01.006    May 31 1995
  420.  
  421.  --- First release.
  422.