Setting the Environment

For a locale-sensitive application, set the UID file to the appropriate directory. Set the UIDPATH or XAPPLRESDIR environment variable to the appropriate value.

For example, to run the uil_sample program with an English environment (LANG environment variable is en_US), set uil_sample.uid with Latin characters at the $HOME/en_US directory, or set uil_sample.uid to a directory and set the UIDPATH environment variable to the full path name of the uil_sample.uid file.

To run the uil_sample program with a Japanese environment (LANG environment variable is ja_JP), create a uil_sample.uid file with Japanese (multibyte) characters at the $HOME/ja_JP directory, or place uil_sample.uid to a unique directory and set the UIDPATH environment variable to the full path name of the uil_sample.uid file. The following list specifies the possible variables:

%U

Specifies the UID file string.

%N

Specifies the class name of the application.

%L

Specifies the value of the xnlLanguage resource or LC_CTYPE category.

%l

Specifies the language component of the xnlLanguage resource or the LC_CTYPE category.

If the XAPPLRESDIR environment variable is set, the MrmOpenHierarchy() function searches the UID file in the following order:

1. UID file path name

2. $UIDPATH

3. %U

4. $XAPPLRESDIR/%L/uid/%N/%U

5. $XAPPLRESDIR/%l/uid/%N/%U

6. $XAPPLRESDIR/uid/%N/%U

7. $XAPPLRESDIR/%L/uid/%U

8. $XAPPLRESDIR/%l/uid/%U

9. $XAPPLRESDIR/uid/%U

10. $HOME/uid/%U

11. $HOME/%U

12. /usr/lib/X11/%L/uid/%N/%U

13. /usr/lib/X11/%l/uid/%N/%U

14. /usr/lib/X11/uid/%N/%U

15. /usr/lib/X11/%L/uid/%U

16. /usr/lib/X11/%l/uid/%U

17. /usr/lib/X11/uid/%U

18. /usr/include/X11/uid/%U

    If the XAPPLRESDIR environment variable is not set, the MrmOpenHierarchy() function uses $HOME instead of the XAPPLRESDIR environment variable.