XWorkplace strictly separates language-dependent resources from the rest of the program. To make things easier, all language-dependent resources are in the "001" subtree of the main XWorkplace directory, which holds all English NLS files. Here's a list of things you need to do before you can begin translations.
  1. The first thing you need to do is find out your three-digit language code. Open the OS/2 Command Reference, "Country" page, and find the code for your country.

  2. Make a copy of the entire 001 directory tree within the XWorkplace source tree, renaming it to your country code. For example, if your language is Italian, you should have a 039 tree next to the 001 tree.

  3. Some files in the 001 directory carry a three-digit language code in their respective names. For your language, you need to change all the filenames with "001" in their names to your country code (e.g. 039 for Italian). For example, rename dll\xfldr001.dlg to dll\xfldr039.dlg.

  4. You will also have to change the dll\*.def file and dll\makefile, which assume a country code of 001 at this point. Required changes are noted in the files themselves.

  5. Open dll\xfldrXXX.rc (with "xxx" being your country code) and find the strings "ID_XSSI_DLLLANGUAGE" and "ID_XSSI_NLS_AUTHOR". Change those two to match your language and name; this is the information that is displayed to the user in the "Language" drop-down box in the "XWorkplace Setup" settings object.
You should now be ready to recompile the NLS DLL for the first time.

If you have IBM VAC++, you can simply use nmake.exe to have the DLL recreated. Before doing so, you have to set up the build environment. Open the file CONFIG.IN and adjust it according to your system. Change XWP_LANG_CODE to your country code. Now everything should work fine since all the necessary files are included. Execute the following command: nmake nls

Otherwise, things get a bit more complicated. Since the resource compiler (RC.EXE) is already included with every OS/2 installation, you can try the following:

  1. Copy an existing XWorkplace resource DLL (e.g., xfldr001.dll) into your new NLS directory; rename it so that it contains your language code (e.g., xfldr039.dll).

  2. Open a command line in that directory.

  3. Type rc xfldr039.rc xfldr039.dll (replace "039" with your language code), which should create a new .RES file and link it against the existing DLL.
After recompiling, you can test the DLL as described in "Testing the DLL".