X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=README.OS2;h=29bbe08414bd6c3b07b7e7c612c85f716bbb95f6;hb=b6cb6b2a38eaa03607f605d162609d4e46426319;hp=895baf6aff370ec218fcd9e2785d4b3bcf566200;hpb=1fc767159174b183bc8356728b194f1f73e3b3e8;p=lyx.git diff --git a/README.OS2 b/README.OS2 index 895baf6aff..29bbe08414 100644 --- a/README.OS2 +++ b/README.OS2 @@ -14,24 +14,30 @@ step like this: 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 dynamically. + // 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 - // ulib must be linked if we use static xforms library. + 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 + autogen.sh; rm -f config.cache and then - configure --prefix=/XFree86 --datadir=/XFree86/lib/X11 + 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 @@ -44,15 +50,9 @@ step like this: // If the synchronization to the children breaks, configure // often detects wrongfully. -> Or it is possible to download the compiled program? - 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. - At this stage, lib/configure.cmd in the 1.1.5pre1 should work - without change. - // If Dekel Tsur introduces the converter_command tag to lyxrc, - // the situation changes. 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: @@ -75,49 +75,49 @@ 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. @@ -128,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.: @@ -169,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 @@ -187,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. @@ -226,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