X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=README.OS2;h=7acd19ad02562c70f1f004866a76526fd26dd9bc;hb=5020a84fc118eb68904258526eb10ffd5053144a;hp=71464b502228549b3ba23792add29dc66a13bc54;hpb=7581869fc6b5fe8e31d520d04af7af3fc53fa235;p=lyx.git diff --git a/README.OS2 b/README.OS2 index 71464b5022..7acd19ad02 100644 --- a/README.OS2 +++ b/README.OS2 @@ -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,42 +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.