1 These are temporary instructions from Shigeru Miyata <miyata@kusm.kyoto-u.ac.jp>
2 ===========================================================================
4 (The top level) configure.cmd is obsoleted by. Please follow the
7 1. Install GNU m4, gnu?utils, aclocal/2, autoheader/2, automake/2,
8 autoconf/2, perl, GNU patch and a UNIX type shell like pdksh.
9 2. Apply the patch development/OS2/quick_fix.patch
10 // os2_defines.h needs a modification because bmtable.c is C.
11 // Now it hits me, why don't we patch "test -x" (gnufutils)?
12 // However, we can't modify the behavior of "test -f", so
13 // it is still necessary to modify script files for LyX.
14 3. Install xforms 0.88 and rename
17 // Ever since 1.1.5pre1, you cannot link xforms dynamically.
18 // If you don't like this, please ask Holger Veit to export
19 // fl_get_scrollbar_bounds, fl_get_scrollbar_increment and
20 // fl_get_scrollbar_value from the DLL. They're already there!
21 4. Install Hung-Chi Chu's port of GNU gettext. Other ports will
23 5. Set environment variables
25 LIBS=-lulib -lsocket -lbsd -lshm -lstdcpp
26 // ulib must be linked if we use static xforms library.
27 // Unless you are using pgcc, we use gcc rather than g++.
28 // Hence stdc++ must be linked explicitely. Also please
29 // note that ld for pgcc often fails to link big executables
30 // like unstripped lyx.exe
31 6. From sh prompt, type
34 configure --prefix=/XFree86 --datadir=/XFree86/lib/X11
36 // Please do not use make.cmd make.exe should be OK.
37 // x11make.exe is the safest choice
38 // While you are running configure, make sure that it is not
39 // a background process to other CPU intensive processes.
40 // While OS/2 kernel is much more efficient, faster and
41 // more responsive than other systems like LINUX (you can
42 // easily *FEEL* this if you stop PM/WPS and run XFree86
43 // only), its TTY interface is lousy, to say the least.
44 // If the synchronization to the children breaks, configure
45 // often detects wrongfully.
47 > Or it is possible to download the compiled program?
49 7. If you are going to make a binary distribution, you have
50 to prepare lib/configure.cmd noweb2lyx.cmd and reLyX.cmd,
51 since end users may not have a UNIX type shell installed.
52 At this stage, lib/configure.cmd in the 1.1.5pre1 should work
54 // If Dekel Tsur introduces the converter_command tag to lyxrc,
55 // the situation changes.
56 In order to create noweb2lyx.cmd and reLyX.cmd, first rename
57 noweb2lyx and reLyX and open them in a text editor. You
58 have to remove hardcoded path in the first line:
60 Also in reLyX.cmd, $lyxdir should be changed to include the
61 drive letter (the line 21):
62 $lyxdir = "$ENV{X11ROOT}/XFree86/lib/X11/lyx";
63 Finally, prepend a line
65 so that cmd.exe pass the execution control to perl.
66 // I know configure.cmd had done this automatically.
67 // So you can compare the result with the scripts in 1.0.4
71 ===========================================================================
73 README file for OS/2 version of LyX 1.0.1
74 by Shigeru Miyata <miyata@kusm.kyoto-u.ac.jp>
75 modified by Arnd Hanses <Arnd.H.Hanses@rz.ruhr-uni-bochum.de>
76 ##############################################################
78 - This README.OS2 addresses experienced users of XFree86 and
79 LyX on OS/2 and covers in very short form the steps for
80 updating (installing) LyX.
82 - For general information on LyX please refer to the generic
83 README. For generic compiling instructions refer to INSTALL.
85 - For a more detailed step by step guide on installing (or compiling)
86 LyX and other related useful (or even necessary) optional programs
87 on OS/2 please refer to INSTALL.OS2. If you are not already an
88 experienced user of LyX an OS/2 you are advised to read it.
90 - For a description of the binary distribution and any necessary
91 support libraries please refer to README.bin, which comes with the
95 LyX has been ported to OS/2 with XFree86 by Shigeru Miyata and
96 has been installed and used successfully by many people.
97 Unfortunately there is yet no easy to install and complete distribu-
98 tion of XFree86-related software for OS/2. Despite increasing popula-
99 rity of X on OS/2, extensive printed documentation about XFree/2 and
100 related programs like LyX is still not available. So you will
101 have to study the available documentation (man pages, READMEs, faq,
102 etc.) thoroughly to avoid unnecessary grief for you and for other
103 people, trying to help you on the net. Nevertheless, there are
104 existing tutorials and manuals covering X on UNIX family operating
105 systems, which do contain some valuable information even for X on
107 [A hint as a starting point for users speaking German:
108 http://www.rrzn-uni-hannover.de/Umdrucke/WSC.5/WSC5_1.html].
110 This release is considered to be stable for general use, but - like
111 any other piece of software - certainly is not bug free.
112 So take the usual precautions like adopting a regular backup policy.
113 Standard disclaimers of non liability apply.
115 As this is a voluntary project with a large number of contributions
116 by many people, hints and bug fixes to the program and/or the
117 documentation are always appreciated and thoroughly considered. If
118 you have the necessary skills (or want to take the chance to acquire
119 them) for programming in LaTeX or C++ you can become a LyX developer.
120 You can support further development by making a donation, if you feel
121 that LyX made your live a bit easier or you want to support open source
123 Please refer to the links at www.lyx.org for details.
125 ==============================================================
130 0) Only for update: If you are upgrading from LyX v. 0.12.0,
131 any old documentation files in %HOME%/.lyx/doc/ and
132 %X11ROOT%/XFree86/lib/X11/lyx/doc should be removed before
133 unpacking (since they are read only). You might wish to make
134 a backup, if you want to keep old docs.
136 1) Unpack the archive at %X11ROOT%.
138 2) Run lyx and let the program copy configuration files to
141 3) If you don't have %HOME%\.lyx\lyxrc then move
142 %X11ROOT%\XFree86\lyxrc.example to %HOME%\.lyx\lyxrc.
143 If updating, make a backup of old version, if you want.
144 Read README and WHATSNEW about updating and run
145 Options->Reconfigure as indicated.
147 4) Verify if LYX is able to find the programs mentioned
148 in %HOME%\.lyx\lyxrc and in %HOME%\.lyx\lyxrc.defaults; if not,
149 change name and path as required.
151 Note: Remember to repeat the check after any 'Reconfigure'!
153 5) In config.sys SET LANG and LANGUAGE according to
154 your preferences. Beware: All programs supporting local
155 languages will be affected, e.g.:
157 SET LANG=de_DE rem german helpfiles will be used
158 SET LANGUAGE=de_DE rem german menus and messages
160 6) Restart OS/2 and run LyX. Have fun!
167 * Please refer to the manpage (type 'man lyx' on the command line or
170 * If you encounter apparently OS/2 specific bugs, (i.e. bugs not
171 already mentioned in the documentation or the buglist) you can report
172 them to the XFree86/OS2 mailing list as well as to the LyX developer
175 * For any questions on using LyX please subscribe to the the LyX user
178 - To subscribe to the XFree86 mailing list send mail to
179 majordomo@borneo.gmd.de
180 with "subscribe" as the subject.
181 To contribute to the mailing list, mail to
182 xfreeos2@borneo.gmd.de
184 - For subscription to lyx-user list (general help on LyX) go to
186 and search for subscription info.
190 1. To prevent 'file not found' with EmTeX and some non-US versions
191 of Warp, I recommend:
193 1) In filenames use only A-Z, a-z, 1-9.
195 2) Use a recent LaTeX package inputenc.sty. Select
196 Layout->Document->Encoding:latin1, so that LyX adds
197 the LaTeX command '\usepackage[latin1]{inputenc}'.
199 2. LaTeX import occasionally produces buggy *.lyx files. LyX tries
200 to save data in case of problems (and does a good job here),
203 To import LaTeX close down and restart LyX (or close all
204 documents, you are working on) and try the import, so that
205 in case of any problems none of your existing documents will
208 3. Inline preview of inline images sometimes does not show the
209 image: If you want to preview the image, just click on it and
210 select fullscreen preview.
212 4. Some XFree/2 programs (as ported from UNIX) expect a sh.exe
213 in \bin directory: I recommend to install sh.exe of pdksh.zip
214 in x:\bin (x: drive of %X11ROOT%). To work around problems you
216 set EMXSHELL=x:\bin\sh.exe
217 before starting the programs. As far as I know, LyX runs without
218 problems in this way.
221 Some suggestions in case of problems:
222 ------------------------------------
223 1) Please check, if your x:\xfree86\lib does appear correctly in
226 2) Please check against the file list, if you did install all files of
229 3) Remove all installed files and
233 and a consistency check of your lyx binary package (unzip -tv
236 4) Reinstall the complete package and check out if everything appears,
237 no truncated files, no crc errors, etc.
240 lyx -dbg 1026 >lyxerrors.log 2>&1
241 or, if you have tee.exe,
242 lyx -dbg 1026 2>&1|tee lyxerrors.log
243 and watch out for any error messages. Report any remaining problems.
244 As this is a completely voluntary project, everybody involved will be
245 grateful for user efforts like detailed bug reports, suggestions,
246 fixes, additions to the documentation, etc.
248 6) Have fun! (I'm sure).
251 C. Tips for Advanced Users:
252 -----------------------
253 * You can start LyX automatically by adding
254 'start/min/n xconsole.exe'
255 'set EMXSHELL=x:\bin\sh.exe'
256 'start/min/n lyx >/dev/console$ 2>&1'
257 to xinitrc.cmd before the line that invokes the
258 window manager, so that LyX' messages appear in the
259 console window and LyX appears in the pm-task list.
261 * You can start LyX automatically by adding
262 'detach xconsole.exe'
263 'detach lyx >/dev/console$ 2>&1'
264 to xinitrc.cmd before the line that invokes the
265 window manager, so that LyX' messages appear in the
266 console window and LyX does not appear in the PM task list.