X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=README.OS2;h=29bbe08414bd6c3b07b7e7c612c85f716bbb95f6;hb=b6cb6b2a38eaa03607f605d162609d4e46426319;hp=4491efd1e49b7dd3ed1ea534c4741b0276aee023;hpb=27de1486ca34aaad446adb798d71a77d6f6304da;p=lyx.git diff --git a/README.OS2 b/README.OS2 index 4491efd1e4..29bbe08414 100644 --- a/README.OS2 +++ b/README.OS2 @@ -1,52 +1,123 @@ +These are temporary instructions from Shigeru Miyata +=========================================================================== + +(The top level) configure.cmd is obsoleted by. Please follow the +step like this: + +1. Install GNU m4, gnu?utils, aclocal/2, autoheader/2, automake/2, + autoconf/2, perl, GNU patch and a UNIX type shell like pdksh. +2. Apply the patch development/OS2/quick_fix.patch + // os2_defines.h needs a modification because bmtable.c is C. + // Now it hits me, why don't we patch "test -x" (gnufutils)? + // However, we can't modify the behavior of "test -f", so + // it is still necessary to modify script files for LyX. +3. Install xforms 0.88 and rename + forms.a -> forms_d.a + forms_s.a -> forms.a + // Ever since 1.1.5pre1, you cannot link xforms 0.88 dynamically. + // If you don't like this, please ask Holger Veit to export + // fl_get_scrollbar_bounds, fl_get_scrollbar_increment and + // fl_get_scrollbar_value from the DLL. They're already there! + // I will try to release xforms 0.89 ASAP. +4. Install Hung-Chi Chu's port of GNU gettext. Other ports will + not work. +5. Set environment variables + MAKE_SHELL=sh + LIBS=-lulib -lsocket -lbsd -lshm -lstdcpp + CXXFLAGS=-g -O2 -m486 -Zmt -DOS2 -fno-rtti -fno-exceptions + // ulib must be linked if we use static xforms library 0.88. + // If xforms 0.89 is used -lulib must be removed from above. + // Unless you are using pgcc, we use gcc rather than g++. + // Hence stdc++ must be linked explicitely. Also please + // note that ld for pgcc often fails to link big executables + // like unstripped lyx.exe + // Due to a bug (actually a limitation) of autoconf/2, + // you have to set CXXFLAGS explicitely in order to compile + // CVS version newer than 11 Oct. 2000. +6. From sh prompt, type + autogen.sh; rm -f config.cache + and then + configure --prefix=/XFree86 --datadir=/XFree86/lib/X11 --with-included-string + x11make + // Please do not use make.cmd make.exe should be OK. + // x11make.exe is the safest choice + // While you are running configure, make sure that it is not + // a background process to other CPU intensive processes. + // While OS/2 kernel is much more efficient, faster and + // more responsive than other systems like LINUX (you can + // easily *FEEL* this if you stop PM/WPS and run XFree86 + // only), its TTY interface is lousy, to say the least. + // If the synchronization to the children breaks, configure + // often detects wrongfully. + +7. If you are going to make a binary distribution, you have + to prepare lib/configure.cmd noweb2lyx.cmd and reLyX.cmd, + since end users may not have a UNIX type shell installed. + In order to create noweb2lyx.cmd and reLyX.cmd, first rename + noweb2lyx and reLyX and open them in a text editor. You + have to remove hardcoded path in the first line: +#!perl + Also in reLyX.cmd, $lyxdir should be changed to include the + drive letter (the line 21): +$lyxdir = "$ENV{X11ROOT}/XFree86/lib/X11/lyx"; + Finally, prepend a line +extproc perl.exe -S + so that cmd.exe pass the execution control to perl. + // I know configure.cmd had done this automatically. + // So you can compare the result with the scripts in 1.0.4 + // distribution. + + +=========================================================================== README file for OS/2 version of LyX 1.0.1 by Shigeru Miyata modified by Arnd Hanses ############################################################## -- This README.OS2 addresses experienced users of XFree86 and - LyX on OS/2 and covers in very short form the steps for +- This README.OS2 addresses experienced users of XFree86 and + LyX on OS/2 and covers in very short form the steps for updating (installing) LyX. - For general information on LyX please refer to the generic README. For generic compiling instructions refer to INSTALL. -- For a more detailed step by step guide on installing (or compiling) - LyX and other related useful (or even necessary) optional programs +- For a more detailed step by step guide on installing (or compiling) + LyX and other related useful (or even necessary) optional programs on OS/2 please refer to INSTALL.OS2. If you are not already an experienced user of LyX an OS/2 you are advised to read it. -- For a description of the binary distribution and any necessary +- For a description of the binary distribution and any necessary support libraries please refer to README.bin, which comes with the binary distribution. LyX has been ported to OS/2 with XFree86 by Shigeru Miyata and -has been installed and used successfully by many people. +has been installed and used successfully by many people. Unfortunately there is yet no easy to install and complete distribu- tion of XFree86-related software for OS/2. Despite increasing popula- -rity of X on OS/2, extensive printed documentation about XFree/2 and -related programs like LyX is still not available. So you will +rity of X on OS/2, extensive printed documentation about XFree/2 and +related programs like LyX is still not available. So you will have to study the available documentation (man pages, READMEs, faq, -etc.) thoroughly to avoid unnecessary grief for you and for other -people, trying to help you on the net. Nevertheless, there are +etc.) thoroughly to avoid unnecessary grief for you and for other +people, trying to help you on the net. Nevertheless, there are existing tutorials and manuals covering X on UNIX family operating -systems, which do contain some valuable information even for X on -OS/2. - [A hint as a starting point for users speaking German: +systems, which do contain some valuable information even for X on +OS/2. + [A hint as a starting point for users speaking German: http://www.rrzn-uni-hannover.de/Umdrucke/WSC.5/WSC5_1.html]. -This release is considered to be stable for general use, but - like +This release is considered to be stable for general use, but - like any other piece of software - certainly is not bug free. -So take the usual precautions like adopting a regular backup policy. +So take the usual precautions like adopting a regular backup policy. Standard disclaimers of non liability apply. -As this is a voluntary project with a large number of contributions -by many people, hints and bug fixes to the program and/or the +As this is a voluntary project with a large number of contributions +by many people, hints and bug fixes to the program and/or the documentation are always appreciated and thoroughly considered. If -you have the necessary skills (or want to take the chance to acquire +you have the necessary skills (or want to take the chance to acquire them) for programming in LaTeX or C++ you can become a LyX developer. -You can support further development by making a donation, if you feel +You can support further development by making a donation, if you feel that LyX made your live a bit easier or you want to support open source software. Please refer to the links at www.lyx.org for details. @@ -57,29 +128,29 @@ Please refer to the links at www.lyx.org for details. ------------ 0) Only for update: If you are upgrading from LyX v. 0.12.0, - any old documentation files in %HOME%/.lyx/doc/ and - %X11ROOT%/XFree86/lib/X11/lyx/doc should be removed before - unpacking (since they are read only). You might wish to make + any old documentation files in %HOME%/.lyx/doc/ and + %X11ROOT%/XFree86/lib/X11/lyx/doc should be removed before + unpacking (since they are read only). You might wish to make a backup, if you want to keep old docs. -1) Unpack the archive at %X11ROOT%. +1) Unpack the archive at %X11ROOT%. 2) Run lyx and let the program copy configuration files to %HOME%\.lyx\. -3) If you don't have %HOME%\.lyx\lyxrc then move - %X11ROOT%\XFree86\lyxrc.example to %HOME%\.lyx\lyxrc. +3) If you don't have %HOME%\.lyx\lyxrc then move + %X11ROOT%\XFree86\lyxrc.example to %HOME%\.lyx\lyxrc. If updating, make a backup of old version, if you want. - Read README and WHATSNEW about updating and run + Read README and WHATSNEW about updating and run Options->Reconfigure as indicated. -4) Verify if LYX is able to find the programs mentioned - in %HOME%\.lyx\lyxrc and in %HOME%\.lyx\lyxrc.defaults; if not, +4) Verify if LYX is able to find the programs mentioned + in %HOME%\.lyx\lyxrc and in %HOME%\.lyx\lyxrc.defaults; if not, change name and path as required. Note: Remember to repeat the check after any 'Reconfigure'! -5) In config.sys SET LANG and LANGUAGE according to +5) In config.sys SET LANG and LANGUAGE according to your preferences. Beware: All programs supporting local languages will be affected, e.g.: @@ -98,10 +169,10 @@ SET LANGUAGE=de_DE rem german menus and messages * If you encounter apparently OS/2 specific bugs, (i.e. bugs not already mentioned in the documentation or the buglist) you can report - them to the XFree86/OS2 mailing list as well as to the LyX developer - mailing list. + them to the XFree86/OS2 mailing list as well as to the LyX developer + mailing list. -* For any questions on using LyX please subscribe to the the LyX user +* For any questions on using LyX please subscribe to the the LyX user mailing list. - To subscribe to the XFree86 mailing list send mail to @@ -116,34 +187,34 @@ SET LANGUAGE=de_DE rem german menus and messages * Hints: ----- -1. To prevent 'file not found' with EmTeX and some non-US versions +1. To prevent 'file not found' with EmTeX and some non-US versions of Warp, I recommend: - 1) In filenames use only A-Z, a-z, 1-9. - + 1) In filenames use only A-Z, a-z, 1-9. + 2) Use a recent LaTeX package inputenc.sty. Select - Layout->Document->Encoding:latin1, so that LyX adds + Layout->Document->Encoding:latin1, so that LyX adds the LaTeX command '\usepackage[latin1]{inputenc}'. -2. LaTeX import occasionally produces buggy *.lyx files. LyX tries +2. LaTeX import occasionally produces buggy *.lyx files. LyX tries to save data in case of problems (and does a good job here), but I recommend: To import LaTeX close down and restart LyX (or close all - documents, you are working on) and try the import, so that - in case of any problems none of your existing documents will + documents, you are working on) and try the import, so that + in case of any problems none of your existing documents will be affected. 3. Inline preview of inline images sometimes does not show the - image: If you want to preview the image, just click on it and - select fullscreen preview. + image: If you want to preview the image, just click on it and + select fullscreen preview. 4. Some XFree/2 programs (as ported from UNIX) expect a sh.exe - in \bin directory: I recommend to install sh.exe of pdksh.zip + in \bin directory: I recommend to install sh.exe of pdksh.zip in x:\bin (x: drive of %X11ROOT%). To work around problems you - can try the commands + can try the commands set EMXSHELL=x:\bin\sh.exe - before starting the programs. As far as I know, LyX runs without + before starting the programs. As far as I know, LyX runs without problems in this way. @@ -155,43 +226,42 @@ Some suggestions in case of problems: 2) Please check against the file list, if you did install all files of the distribution. -3) Remove all installed files and - %.home%/.lyx/ - and perform a - chkdsk /f +3) Remove all installed files and + %.home%/.lyx/ + and perform a + chkdsk /f and a consistency check of your lyx binary package (unzip -tv - foo.zip). + foo.zip). 4) Reinstall the complete package and check out if everything appears, no truncated files, no crc errors, etc. -5) Run +5) Run lyx -dbg 1026 >lyxerrors.log 2>&1 or, if you have tee.exe, lyx -dbg 1026 2>&1|tee lyxerrors.log - and watch out for any error messages. Report any remaining problems. + and watch out for any error messages. Report any remaining problems. As this is a completely voluntary project, everybody involved will be grateful for user efforts like detailed bug reports, suggestions, - fixes, additions to the documentation, etc. + fixes, additions to the documentation, etc. 6) Have fun! (I'm sure). C. Tips for Advanced Users: ----------------------- -* You can start LyX automatically by adding +* You can start LyX automatically by adding 'start/min/n xconsole.exe' 'set EMXSHELL=x:\bin\sh.exe' 'start/min/n lyx >/dev/console$ 2>&1' - to xinitrc.cmd before the line that invokes the - window manager, so that LyX' messages appear in the + to xinitrc.cmd before the line that invokes the + window manager, so that LyX' messages appear in the console window and LyX appears in the pm-task list. -* You can start LyX automatically by adding +* You can start LyX automatically by adding 'detach xconsole.exe' 'detach lyx >/dev/console$ 2>&1' - to xinitrc.cmd before the line that invokes the - window manager, so that LyX' messages appear in the + to xinitrc.cmd before the line that invokes the + window manager, so that LyX' messages appear in the console window and LyX does not appear in the PM task list. - \ No newline at end of file