/*--------------- README -texinfo3.12u.os2 ----------------------------------- */ Texinfo 3.12u is an alpha version of GNU info documenting system. OS/2 porting of this Texinfo distribution was easy, because I was able to utilize OS/2 patch for last officical version (3.12). A good news for 8 bit code world (Japanese, Korean, etc..) is that by default 8 bit code is OKAY in this latest "info" executable. This means you can see Japanse Info mannual using "info". Upto now, we were not able to see Japanese Info without mule (multi-lingualversion of emacs). New Features of this OS/2 distribution texindex.exe can process Japanese Shift JIS code. info.exe can be used in XFree86 for OS/2 terminals; kterm, xterm, rxtv... EMX RUNTIME 0.9d IS REQUIRED!! Without emx 0.9d runtime, you cannot use precompiled executables. If your emx runtime version is 0.9c or older, get and install emx 0.9d from ftp sites. ftp://hobbes.nmsu.edu/pub/os2/dev/emx/v0.9d/ or ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/ emxrt.zip 549675 1998/12/22 emx runtime package INSTALLATION ============ Becuase you are reading this file, installation of files shoud have been nearly finished. I assume that environment variable RPMDRV is "c:" or "c", this means texinfo related files have been installed in `c:/emx'. Set environmental variable `GNULOCALEDIR' in your `config.sys' like this set GNULOCALEDIR=c:/emx/share/locale (Never use '\' in the variable) You can choose one language from the next list. cs : Czech de, de_AT : German fr : French nl : Dutch no : Norwegian ru : Russian If you'd like to see Russain message: set LANGUAGE=ru (in `config.sys') If the environmental variable `LANGUAGE' is not set, English messages are shown by programs. Setup environment variable for texinfo Confirm environmental variables, TERMCAP and TERM, are already set. If you are new to EMX RUNTIME and don't know how to setup termcap, see `INSTALL.DOC' included in `emxrt.zip'. Set the INFOPATH environment variable for info, like below set INFOPATH=.;c:/emx/info;k:/doc/info; Edit a textfile "dir_example" and copy it to "c:/emx/info/dir", only if you are setting up GNU info system for the firest time. c:\emx\info> copy dir_example dir Setup for XFree86 for OS/2 In the presence of environmental variable XINFO, `info.exe' behave like X client. Add a line, 'set XINFO=SOME_STRING', to your `/XFree86/lib/x11/xinit/xinitrc.cmd' or `/XFree86/bin/startx.cmd' Do not omit the letter ' at the beginning and the end of the line!! Do not set XINFO variable in `config.sys'. COMPRESSED INFO FILES ===================== Compressed Info mannuals are available. Use 'gzip' or 'bzip2', and install gunzip.exe or bunzip2.exe. If you have gzip.exe or bzip2.exe and don't have gunzip.exe or bzip2.exe, $ copy gzip.exe gunzip.exe or $ copy bzip2.exe bunzip2.exe When Info files directory has a.info, b.info, c.info, ... *.info DO like this $ for %a in (*.info) do gzip %a You'll get a.info.gz, b.info.gz, c.info.gz, .... *.info.gz. MUSE_READ_DOCUMENTATIONS ======================== /emx/doc/texinfo-3.12u --- Do obey Copyright and GPL COPYING INTRODUCTION README README-alpha /emx/man/man1/*.1 Manpages and manuals /emx/man/man5/*.5 /emx/info/{info-stnd.info.gz,info.info.gz,texinfo.gz} SIMPLE USAGE ============ info.exe: simply execute it. Type "h" will let you be in tutorial. makeinfo.exe: You make an Info mannual or HTML document with makeinfo. To create Info mannuals $ makeinfo --force --no-split TEXINFO_SOURCE NOTE: makeinfo cannot create Info from Japanese JIS or SJIS sources. If needed, convert to Japanese EUC. To create HTML documents $ makeinfo --force --no-split --html TEXINFO_SOURCE NOTE: makeinfo cannot create HTML from Japanese JIS or SJIS sources. If needed, convert to Japanese EUC. texindex.exe: Japanese Shift JIS is okay to process. To compile English Texinfo source to DVI $ tex FOO.texi $ texindex FOO.?? $ tex FOO.texi $ tex FOO.texi To compile Japanese Texinfo source to DVI KANJI code must be Shift JIS!! If needed, convert to SJIS and process Texinfo source like this. $ ptex FOO.texi $ texindex FOO.?? $ ptex FOO.texi $ ptex FOO.texi MAKE_FROM_SOURCE ================ Get texinfo-3.12u.tar.gz from following URLS. ftp://alpha.gnu.org/gnu/, ftp://ftp.cs.umb.edu/private/tex/, or from http://texinfo.org/. Unpack and apply patch, `texinfo-3.12u-OS2.diff.gz' $ tar zxvf texinfo-3.12u.tar.gz $ cd texinfo-3.12u $ patch -p1 < c:/emx/src/redhat/SOURCRS/texinfo-3.12u-OS2.diff.gz Meaning of CFLAGS are: -DINFOX: enable XFree86 feature -DSJIS: to process Japanese Shift JIS source -DEUC : to process Japanese EUC source To make executables $ touch config.cache $ touch config.status $ sh config.status $ make If you want to run `configure' script, do like this. $ cp configure configure.orig Open `os2conf.cmd' by your editor, and modify it if needed $ os2conf configure.orig > configure $ ksh ksh> ./configure ksh> exit $ make To check $ make check To install $ make install prefix=SOMEWHERE Be sure that you already have a diff file and a spec file. c:/emx/src/redhat/SOURCES/texinfo-3.12u-OS2.diff.gz c:/emx/src/redhat/SPECS/texinfo-3.12u-os2.spec Get `texinfo-3.12u.tar.gz' and install it in `c:/emx/src/redhat/SOURCES/'. x:\foo> rpm -bc c:/emx/src/redhat/SPECS/texinfo-3.12u-os2.spec x:\foo> c: c:\> cd emx\src\redhat\BUILD c:\emx\src\redhat\BUILD> dir /s *.exe If `dir' shows all executable names, do check. c:\emx\src\redhat\BUILD> make ckeck Installtion is simple c:\emx\src\redhat\BUILD> make install prefix=SOMEWHERE Make rpm package ================ For binary rpm x:\foo> rpm -bb --clean c:/emx/src/redhat/SPECS/texinfo-3.12u-os2.spec For binary and source rpm x:\foo> rpm -ba --clean c:/emx/src/redhat/SPECS/texinfo-3.12u-os2.spec Or in source directory $ make -f Makefile.rpm rpm Comments, suggestions, or requests are alwary wellcome. Happy computing life with OS/2!! 1999/10/29 SAWATAISHI Jun, YOKOHAMA, JAPAN http://www2s.biglobe.ne.jp/~vtgf3mpr/indxos2.htm