GNU Texinfo

Tools and libraries ported to build and test GCC for OS/2. These packages are provided AS-IS without support of any kind. ¸ 2002-2004 InnoTek Systemberatung GmbH.

/*--------------- README -texinfo-4.0.os2 for zip archive ------------------ */ *** **** * *** *** ** * *** *** ** ** *** ****** **** ***** ******** **** *** ***** **** *** ** ** *** * *** **** *** *** ** ** *** *** *** *** * *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ******** *** *** *** *** *** *** *** *** *** **** *** *** *** *** *** *** *** *** * * *** *** *** *** *** *** *** *** * *** * * *** *** *** *** *** ** ** **** **** **** *************** **** ***** **** OS/2 port release 3 Table of Contents ================= Introduction @int New Features of OS/2 port @new Required Environment @req Installation @ins Compressed Info Files @com Documentations and Manuals @doc Sample Usage @sam Make from source @mak Make rpm package @rpm Introduction @int ============ GNU texinfo version 4.0 is an official release next to version 3.12. OS/2 porting of this Texinfo distribution was easy, because I was able to utilize OS/2 patch for last officical version (3.11). A good news for 8 bit code world (Japanese, Korean, etc..) is that by default 8 bit code is accepted in this version. This means you can see Japanese Info mannual using "info". Upto now, we were not able to see Japanese Info without mule (multi-lingualversion of emacs). New Features of OS/2 port @new ========================= Release 3 `makeinfo' accepts Japanese SJIS coded source file. Release 2 ALT-key can be used as Meta-key (ESC) when argument of Meta-key is only one. c.f. "ALT + x " for "ESC x" Japanese message is available. DEFAULT_INFO_PRINT_COMMAND is changed from ">PRN" to "expand --tabs=4 >>InfoLog.tmp" Release 1 `texindex.exe' can process Japanese Shift JIS code. `info.exe' can be used in XFree86 for OS/2 terminals; kterm, xterm, rxvt... IF XINFO environment variable is not empty, or if TERM environment variable is equal to "xterm", "kterm", or "rxvt", `info' behaves as X client. Required Environment @req ==================== 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/emxrt.zip or ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/emxrt.zip Installation @ins ============ This manual is OS/2 ported GNU texinfo 4.0 for zip archive, not for rpm. You will find in the current directory, `emx-texinfo.zip' which contains all files to be installed and `texinfo-list.dat'listing files to be installed. Standard Installation ~~~~~~~~~~~~~~~~~~~~~ If you have installed emx runtime in a drive 'x' with following directory structure, you can easily install texinfo. - emx executables are in `x:/emx/bin' - emx DLLs in `x:/emx/dll' - Info manuals in `x:/emx/info' - Documents in `x:/emx/doc' - Man files in `x:/emx/man' - "x:\emx\bin" is included in PATH environment variable - LIBPATH contains "x:\emx\dll" in your `config.sys' Unzip `emx-texinfo.zip' in drive 'x'. \foo> unzip emx-texinfo -d x:\ Custom Installation ~~~~~~~~~~~~~~~~~~~ If you do NOT want to install files in emx tree (x:/emx/bin, x:/emx/dll..), unzip `emx-texinfo.zip' in the temporary directory and copy files to proper directories like this. \foo> unzip emx-texinfo -d c:\tmp \foo> c: c:\> cd tmp\emx c:\tmp\emx> copy bin\* PATH_DIRECTORY (c.f. "d:\usr\local\bin") c:\tmp\emx> copy dll\* LIBPATH_DIRECTORY (c.f. "c:\OS2\DLL") c:\tmp\emx> copy bin\info INFOPATH_DIRECTORY (c.f. "d:\usr\local\info") c:\tmp\emx> xcopy /s doc\* DOC_DIRECTORY (c.f. "d:\usr\local\doc") c:\tmp\emx> xcopy /s man\* MAN_DIRECTORY (c.f. "d:\usr\local\man") c:\tmp\emx> xcopy /s share\locale\* LOCALE_DIRECTORY (c.f. "d:\usr\local\locale") c:\tmp\emx> xcopy /s src\* SRC_DIRECTORY (c.f. "d:\usr\local\src") c:\tmp\emx> xcopy /s etc\* ETC_DIRECTORY (c.f. "d:\usr\local\etc") After you have installed files in such a way, you must setup or confirm, environment variables (PATH, INFOPATH, GNULOCALEDIR, MANPATH) carefully. Setup Language ~~~~~~~~~~~~~~ Set environment variable `GNULOCALEDIR' in your `config.sys' like this set GNULOCALEDIR=c:/emx/share/locale (Never use '\' in the variable) You can choose one language cs : Czech de, de_AT : German fr : French ja : Japanese (SJIS) nl : Dutch no : Norwegian ru : Russian eo : Esperanto See `COUNTRY' for complete list of languages If you'd like to see Russain message: set LANGUAGE=ru (in `config.sys') If the environment variable `LANGUAGE' is not set, English messages are shown by programs. Setup environment variable for texinfo Confirm environment 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;l:/emacs-20.4/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 ~~~~~~~~~~~~~~~~~ As mentioned above, if XINFO environment variable is not empty, or if TERM environment varialbe is one of "xterm", "kterm", and "rxvt", `info' behave like X client. Add a line, 'set XINFO=SOME_STRING', to your `/XFree86/lib/x11/xinit/xinitrc.cmd' or `/XFree86/bin/startx.cmd' in X11ROOT drive. NOTE1: Do not omit the letter ' at the beginning and the end of the line!! NOTE2: Do not set XINFO variable in `config.sys'. Setup for Print Command ~~~~~~~~~~~~~~~~~~~~~~~ When you execute "M-x(ALT+x) print-node", `info' outputs a currend node to a file named `InfoLog.tmp' in append mode. If you'd like to change default output of "print-node", set environment variable INFO_PRINT_COMMAND. IMPORTANT NOTICE You can't use '>' or '|' for environment variables in OS/2 command line or in batch file. You can contain '>' or '|' in environment variables, when you set variables in `config.sys'. If you use unix like shell (ksh, bash,..) for shell, you can freely use '>' or '|'. You can do like this. In `config.sys': set INFO_PRINT_COMMAND=expand --tabs=2 >>Info.log set INFO_PRINT_COMMAND=>prn set INFO_PRINT_COMMAND=a2ps -E -2 |gsos2 - -sDEVICE=bjc600 -c quit In `~/.bashrc' for bash: export INFO_PRINT_COMMAND='expand --tabs=2 >>Info.log' export INFO_PRINT_COMMAND='>prn' export INFO_PRINT_COMMAND='a2ps -E -2 |gsos2 - -sDEVICE=bjc600 -c quit' Compresed Info Files @com ==================== Compressed Info mannuals are available. Use 'gzip' or 'bzip2', and install gunzip.exe or bunzip2.exe if needed. 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 there are `a.info', `b.info', `c.info', ... `*.info' in INFO dire- ctory. DO like this $ for %a in (*.info) do gzip %a You'll get `a.info.gz', `b.info.gz', `c.info.gz', .... `*.info.gz'. Documentations and Manuals @doc ========================== /emx/doc/texinfo-4.0 COPYING INTRODUCTION README-texinfo-4.0.os2 (This manual you are reading) README COUNTRY - Pre-defined Country Codes FTP ---- How to get GNU Software by Internet FTP or by UUCP KEYS_emacs-jp.os2 # Read these file to know basic KEYS_emacs.os2 # command of `info'. By default, key mode KEYS_vi-jp.os2 # If you invoke `info' with "info --vi-keys", KEYS_vi.os2 # key mode become vi mode. These files are # are printed with "ALT+x(M-x) print-node". /emx/man/man1/*.1 /emx/man/man5/*.5 /emx/info/{info-stnd.info.gz,info.info.gz,texinfo.gz} If you have not installed manpage system, you can get OS/2 ported copy from following URLs. English only version ftp://hobbes,hobbes.nmsu.edu/pub/os2/dev/help/ gnuman.zip 44610 1995/01/31 GNU man 1.0 (for use with groff) ftp://hobbes,hobbes.nmsu.edu/pub/os2/tex/ gnugroff.zip 2153647 1996/05/07 GNU groff v1.10 Japanized version ( in my web page) http://www2s.biglobe.ne.jp/~vtgf3mpr/manpage/groff-man.tar.bz2 Sample Usage @sam ============ About commands ~~~~~~~~~~~~~~ Invoke `info' with "info", "info --vi-keys"....... In emacs mode (default), type BACKSPACE or 'Ctrl+h' for help; type 'h' for tutorial In vi mode, type `h' for help; type 'ESC h' or 'ALT + h' for tutorial In the HELP screen, you'll see following lines (emacs mode) ESC b (backward-word) Move backward a word ESC f (forward-word) Move forward a word ESC r (move-to-window-line) Move the cursor to a specific line of the window ESC v (scroll-backward) Scroll backward in this window ESC x (execute-command) Read a command name in the echo area and execute it ESC DEL (scroll-other-window-backward) Scroll the other window backward OS/2 ported `info' release 2 is modified to accept ALT key as meta key, when an argument of meta key is only one. Exceptionally, you can't use 'ALT + TAB' and 'ALT + ESC' for info command, because these are trapped by OS/2 system. So, you can execute "backward-word" by typing `ALT' and `b' simultaneously, instead of typing `ESC' followed by typing `b'. Interpret 'ESC ONE_KEY' as 'ALT + ONE_KEY'. Processing texinfo source file ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 EUC sources. If needed, convert to Japanese SJIS. To create HTML documents $ makeinfo --force --no-split --html TEXINFO_SOURCE NOTE: makeinfo cannot create HTML from Japanese JIS or EUC sources. If needed, convert to Japanese SJIS. 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 You can also use `texi2dvi.cmd' to make DVI from TeX or LaTeX source. If you process Japanese TeX source, set environment variables like this in your `config.sys', in your batch file, or command line. set TEX=ptex set LATEX=platex set BIBTEX=jbibtex set MAKEINDEX=mendex Make from source @mak ================ <Without rpm> Get texinfo-4.0.tar.gz from following URLS. <Primary site> ftp://ftp.gnu.org/gnu/texinfo/texinfo-4.0.tar.gz <Some Mirrors> California - labrea.stanford.edu/pub/gnu, gatekeeper.dec.com/pub/GNU New York - ftp.cs.columbia.edu/archives/gnu/prep Japan - tron.um.u-tokyo.ac.jp/pub/GNU/prep Japan - ftp.cs.titech.ac.jp/pub/gnu Japan - mirror.nucba.ac.jp/mirror/GNU/ Read `FTP' for complete list of mirror sites. Unpack and apply patch, `texinfo-4.0-OS2.diff.gz' $ tar zxvf texinfo-4.0.tar.gz $ cd texinfo-4.0 $ patch -p1 < c:/emx/src/redhat/SOURCRS/texinfo-4.0-OS2.diff.gz Meaning of CFLAGS are: -DINFOX: enable XFree86 feature -DSJIS: to process Japanese Shift JIS source ; makeinfo.c -DEUC : to process Japanese EUC source ; makeinfo.c By default programs are compiled and linked with "-Zomf" option for gcc. If you'd like to do without "-Zomf", edit these line of `config.status'. s%@CFLAGS@%-D__EMX__ -DOS2 -Zmtd -D__ST_MT_ERRNO__ -O2 -Zomf%g s%@LDFLAGS@%-s -Zsysv-signals %g s%@EMX_OBJ@%obj%g s%@EMX_LIB@%lib%g s%@EMX_AR@%emxomfar%g s%@LIBOBJS@% strcasecmp.obj strncasecmp.obj%g Compile and link like this way $ 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 Add lines to `config.status' with "-Zomf" s%@EMX_OBJ@%obj%g s%@EMX_LIB@%lib%g s%@EMX_AR@%emxomfar%g without "-Zomf" s%@EMX_OBJ@%o%g s%@EMX_LIB@%a%g s%@EMX_AR@%ar%g Change two line of `config.status' with "-Zomf" s%@CFLAGS@%-D__EMX__ -DOS2 -Zmtd -D__ST_MT_ERRNO__ -O2 -Zomf%g s%@LIBOBJS@% strcasecmp.obj strncasecmp.obj%g ksh> exit $ sh config.status $ make To check $ make check To install $ make install prefix=SOMEWHERE <With rpm> Be sure that you already have a diff file and a spec file. c:/emx/src/redhat/SOURCES/texinfo-4.0-OS2.diff.gz c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec Get `texinfo-4.0.tar.gz' and install it in `c:/emx/src/redhat/SOURCES/'. x:\foo> rpm -bc c:/emx/src/redhat/SPECS/texinfo-4.0-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 @rpm ================ For binary rpm x:\foo> rpm -bb --clean c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec For binary and source rpm x:\foo> rpm -ba --clean c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec Or in source directory $ make -f Makefile.rpm rpm Comments, suggestions, or requests are alwary wellcome. Happy computing life with OS/2!! Thu Apr 6 18:15:31 JST 2000 SAWATAISHI Jun, YOKOHAMA, JAPAN <jsawa@attglobal.net> http://www2s.biglobe.ne.jp/~vtgf3mpr/indxos2.htm