README
1/* $XConsortium: README /main/3 1996/07/15 14:04:13 drk $ */
2
3This demo is pretty much the "more" program Motif-ied and internationalized.
4You can view files in your language !
5
6This demo only works if your Operating System supports setlocale()
7and Xlib supports the same locale as your OS.
8
9The program MUST be executed through the sh script "xmfile"
10This script is a Korn Shell script currently running on
11 ULTRIX 4.1 or ULTRIX 4.2
12 HPUX 8.05
13 OSF1.0.4
14
15You may have to do some work for running on your OS and your shell.
16
17Steps to follow:
18
19 1) Check your Operating System Reference Manual for supported locales
20 (usually "man setlocale") to know your locale names.
21
22 2) Edit the xmfile script. The script contains association
23 between languages and locales names
24 For example if you want to run in French, and the name
25 of the french locale on your system is FROG_REDMEAT
26 then
27 1) make sure that the variable $sysname contains
28 the name of your OS
29 2) add a case in the case statement for french under your OS
30 that sets the LANG variable
31
32 LANG=FROG_REDMEAT
33
34 3) The UID files are searched in the directory named with
35 the language name.
36
37
38 4) If you want to add a new language
39 add a case branch for the language.
40 create a directory of that name. Go into this directory.
41 Create adequate X resource files and uil files.
42 compile the uil file
43
44 5) Come back to the xmfile directory
45 Execute "xmfile language".
46 where "language" is one the arguments listed in the script
47 : french, english, german.
48
49 Of course you may only view files in the specified language
50
51 If you execute "xmfile" with no argument,
52 the default language is French.
53
54
55==========================================
56After the program has started:
57
58Allow a user to view files in separate windows.
59There is one top level shell created per file opened.
60The first top level shell created (application shell) is called
61the Primary shell. Others are Secondary.
62
63Each top level shell is parent of a Main Window, the work area
64of which is a PanedWindow.
65
66The menu bar has entries
67 File for opening/closing file, exiting
68 View for controlling the panes in the pane window
69
70The File menu contains commands Open, and Exit or Close
71In the primary shell, Exit exits the client
72In the secondaries, Close closes the shell
73
74The Open menu:
75 On selecting Open/File in the menu bar, a file selection box
76 is mapped to choose the file.
77
78 If OpenFile is successful, close first the current file opened,
79 destroy all existing panes, and display the new file.
80
81 Close: this entry only exists on the secondary windows.
82 It destroys the top level shell and closes the file.
83
84 Exit: this entry only exists on the primary shell
85 closes the file and the shell.
86
87The View menu:
88
89 New Pane: Creates a new pane in the paned window
90 Delete Pane: delete the current pane.
91 Search: pops a dialogue box for searching text in the file
92 On the OK callback of the dialogue box
93 search the string.
94 if found show in current pane
95 else pop up dialogue box again.
96
97
98