]> git.lyx.org Git - lyx.git/blobdiff - README.OS2
remove wrong comments and add 1.3.6 to the list of releases
[lyx.git] / README.OS2
index 4491efd1e49b7dd3ed1ea534c4741b0276aee023..29bbe08414bd6c3b07b7e7c612c85f716bbb95f6 100644 (file)
+These are temporary instructions from Shigeru Miyata <miyata@kusm.kyoto-u.ac.jp>
+===========================================================================
+
+(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 <miyata@kusm.kyoto-u.ac.jp>
 modified by Arnd Hanses <Arnd.H.Hanses@rz.ruhr-uni-bochum.de>
 ##############################################################
 
 
 README file for OS/2 version of LyX 1.0.1
 by Shigeru Miyata <miyata@kusm.kyoto-u.ac.jp>
 modified by Arnd Hanses <Arnd.H.Hanses@rz.ruhr-uni-bochum.de>
 ##############################################################
 
-- 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.
 
   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.
 
   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
   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-
 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,
 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
 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].
 
        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.
 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.
 
 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
 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.
 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.
 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,
           ------------
 
 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.
 
    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\.
 
 
 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.
    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.
 
    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'!
 
    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.:
 
    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
 
 * 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
   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:
   -----
 
 * 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:
 
    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
        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}'.
 
           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
    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
        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
 
 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
    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
        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.
 
 
    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.
 
 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
    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.
 
 
 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
        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,
   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:
           -----------------------
 
 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'
        '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.
 
   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'
        '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.
 
   console window and LyX does not appear in the PM task list.
 
-\1a
\ No newline at end of file