home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / txinf403.zip / readtxin.os2 < prev    next >
Text File  |  2000-05-10  |  16KB  |  513 lines
  1. /*--------------- README -texinfo-4.0.os2 ----------------------------------- */
  2.  
  3.                                                                   
  4.                                 ***               ****            
  5.        *                        ***             *** **            
  6.        *                        ***             *** **            
  7.       **                                        ***               
  8.     ******    ****   ***** ******** **** ***   *****    ****      
  9.      ***     **  **   ***   *   ***  **** ***   ***    **  **     
  10.      ***    ***  ***   *** *    ***  ***  ***   ***   ***  ***    
  11.      ***    ***  ***    ***     ***  ***  ***   ***   ***  ***    
  12.      ***    ********     ***    ***  ***  ***   ***   ***  ***    
  13.      ***    ***         ****    ***  ***  ***   ***   ***  ***    
  14.      ***    ***    *    * ***   ***  ***  ***   ***   ***  ***    
  15.      ***  *  ***  *    *   ***  ***  ***  ***   ***    **  **     
  16.       ****    ****   **** *************** **** *****    ****      
  17.                                                               
  18.                                                  OS/2 port release 2
  19.  
  20.  
  21. Table of Contents
  22. =================
  23. Introduction                    @int
  24. New Features of OS/2 port       @new
  25. Required Environment            @req
  26. Installation                    @ins
  27. Compressed Info Files           @com
  28. Documentations and Manuals      @doc
  29. Sample Usage                    @sam
  30. Make from source                @mak
  31. Make rpm package                @rpm
  32.  
  33.  
  34.  
  35.  
  36. Introduction    @int
  37. ============
  38.  
  39.   GNU texinfo version 4.0 is an official release next to version 3.12. 
  40.   OS/2 porting of this Texinfo distribution was easy, because I was 
  41. able to utilize OS/2 patch for last officical version (3.11). 
  42.  
  43.   A good news for 8 bit code world (Japanese, Korean, etc..) is that by 
  44. default 8 bit code is accepted in this version. This means you can
  45. see Japanese Info mannual using "info". Upto now, we were not able to see 
  46. Japanese Info without mule (multi-lingualversion of emacs). 
  47.  
  48.  
  49.  
  50. New Features of OS/2 port    @new
  51. =========================
  52.  
  53. Release 2
  54.  
  55.   ALT-key can be used as Meta-key (ESC) when argument of Meta-key is only one. 
  56.      c.f. "ALT + x " for "ESC x"
  57.  
  58.  
  59.   Japanese message is available. 
  60.  
  61.   
  62.   DEFAULT_INFO_PRINT_COMMAND is changed from 
  63.                  ">PRN" 
  64.             to 
  65.                  "expand --tabs=4 >>InfoLog.tmp"
  66.  
  67. Release 1
  68.  
  69.   `texindex.exe' can process Japanese Shift JIS code. 
  70.  
  71.   `info.exe' can be used in XFree86 for OS/2 terminals; kterm, xterm, rxvt...
  72.  
  73.     IF XINFO environment variable is not empty, or if TERM environment 
  74.     variable is equal to "xterm", "kterm", or "rxvt", `info' behaves 
  75.     as X client. 
  76.  
  77.  
  78. Required Environment    @req
  79. ====================
  80.  
  81.     Without emx 0.9d runtime, you cannot use precompiled executables. 
  82.     If your emx runtime version is 0.9c or older, get and install emx 0.9d
  83.   from ftp sites. 
  84.  
  85.        ftp://hobbes.nmsu.edu/pub/os2/dev/emx/v0.9d/emxrt.zip
  86.                         or
  87.        ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/emxrt.zip
  88.            
  89.  
  90.  
  91.  
  92. Installation    @ins
  93. ============
  94.  
  95.  
  96.   Becuase you are reading this file, installation of files shoud have 
  97. been nearly finished. I assume that environment variable RPMDRV is 
  98. "c:" or "c", this means texinfo related files have been installed in 
  99. `c:/emx'. 
  100.  
  101.  
  102. Setup Language
  103. ~~~~~~~~~~~~~~
  104.  
  105.     Set environment variable `GNULOCALEDIR' in your `config.sys' like this
  106.     
  107.            set GNULOCALEDIR=c:/emx/share/locale
  108.            
  109.                              (Never use '\' in the variable)
  110.  
  111.     You can choose one language
  112.     
  113.            cs : Czech
  114.            de, de_AT : German
  115.            fr : French
  116.            ja : Japanese (SJIS)
  117.            nl : Dutch
  118.            no : Norwegian
  119.            ru : Russian
  120.            eo : Esperanto
  121.            
  122.  
  123.        See `COUNTRY' for complete list of languages
  124.  
  125.  
  126.     If you'd like to see Russain message:
  127.  
  128.            set LANGUAGE=ru           (in `config.sys')
  129.            
  130.  
  131.     If the environment variable `LANGUAGE' is not set, English messages 
  132.     are shown by programs. 
  133.  
  134.  
  135.   Setup environment variable for texinfo
  136.  
  137.      Confirm environment variables, TERMCAP and TERM, are already set. 
  138.            
  139.            If you are new to EMX RUNTIME and don't know how to setup
  140.           termcap, see `INSTALL.DOC' included in `emxrt.zip'. 
  141.  
  142.      Set the INFOPATH environment variable for info, like below
  143.  
  144.          set INFOPATH=.;c:/emx/info;k:/doc/info;l:/emacs-20.4/info;
  145.                                          
  146.      
  147.      Edit a textfile "dir_example" and copy it to "c:/emx/info/dir", 
  148.      only if you are setting up GNU info system for the firest time. 
  149.  
  150.           c:\emx\info> copy dir_example dir
  151.  
  152.   
  153. Setup for XFree86 
  154. ~~~~~~~~~~~~~~~~~
  155.     As mentioned above, if XINFO environment variable is not empty, or 
  156.     if TERM environment varialbe is one of "xterm", "kterm", and "rxvt", 
  157.      `info' behave like X client. 
  158.  
  159.     Add a line, 'set XINFO=SOME_STRING', 
  160.                to your `/XFree86/lib/x11/xinit/xinitrc.cmd' or 
  161.                `/XFree86/bin/startx.cmd' in X11ROOT drive. 
  162.  
  163.          NOTE1: Do not omit the letter ' at the beginning 
  164.                and the end of the line!!
  165.     
  166.          NOTE2: Do not set XINFO variable in `config.sys'. 
  167.  
  168.  
  169. Setup for Print Command
  170. ~~~~~~~~~~~~~~~~~~~~~~~
  171.   When you execute "M-x(ALT+x) print-node", `info' outputs a currend node 
  172. to a file named `InfoLog.tmp' in append mode. 
  173.      
  174.   If you'd like to change default output of "print-node", set environment 
  175. variable INFO_PRINT_COMMAND. 
  176.  
  177.  
  178.      IMPORTANT NOTICE
  179.  
  180.          You can't use '>' or '|' for environment variables in OS/2 command 
  181.          line or in batch file. 
  182.          
  183.          You can contain '>' or '|' in environment variables, when you set 
  184.          variables in `config.sys'. 
  185.  
  186.          If you use unix like shell (ksh, bash,..) for shell, you can freely 
  187.          use '>' or '|'. 
  188.  
  189.  
  190.   You can do like this.
  191.  
  192.          In `config.sys':
  193.  
  194.            set INFO_PRINT_COMMAND=expand --tabs=2 >>Info.log
  195.            set INFO_PRINT_COMMAND=>prn
  196.            set INFO_PRINT_COMMAND=a2ps -E -2 |gsos2 - -sDEVICE=bjc600 -c quit
  197.  
  198.  
  199.          In `~/.bashrc' for bash:
  200.  
  201.            export INFO_PRINT_COMMAND='expand --tabs=2 >>Info.log'
  202.            export INFO_PRINT_COMMAND='>prn'
  203.            export INFO_PRINT_COMMAND='a2ps -E -2 |gsos2 - -sDEVICE=bjc600 -c quit'
  204.  
  205.  
  206.  
  207. Compresed Info Files    @com
  208. ====================
  209.  
  210.     Compressed Info mannuals are available. 
  211.     Use 'gzip' or 'bzip2', and install gunzip.exe or bunzip2.exe if needed. 
  212.  
  213.     If you have gzip.exe or bzip2.exe and don't have gunzip.exe or bzip2.exe, 
  214.  
  215.                    $ copy gzip.exe gunzip.exe
  216.                               or
  217.                    $ copy bzip2.exe bunzip2.exe
  218.  
  219.  
  220.     When there are `a.info', `b.info', `c.info', ... `*.info' in INFO dire-
  221.     ctory. 
  222.  
  223.        DO like this
  224.           
  225.               $ for %a in (*.info) do gzip %a
  226.             
  227.         You'll get `a.info.gz', `b.info.gz', `c.info.gz', .... `*.info.gz'. 
  228.  
  229.  
  230.  
  231. Documentations and Manuals    @doc
  232. ==========================
  233.  
  234. In drive defined by RPMDRV environment variable:
  235.  
  236.    /emx/doc/texinfo-4.0
  237.         COPYING 
  238.         INTRODUCTION
  239.         README-texinfo-4.0.os2 (This manual you are reading)
  240.         README  
  241.         COUNTRY -  Pre-defined Country Codes 
  242.         FTP  ----  How to get GNU Software by Internet FTP or by UUCP
  243.         KEYS_emacs-jp.os2  # Read these file to know basic
  244.         KEYS_emacs.os2     # command of `info'. By default, key mode 
  245.         KEYS_vi-jp.os2     # If you invoke `info' with "info --vi-keys",
  246.         KEYS_vi.os2        # key mode become vi mode. These files are
  247.                            # are printed with  "ALT+x(M-x) print-node". 
  248.  
  249.    /emx/man/man1/*.1
  250.    /emx/man/man5/*.5
  251.    /emx/info/{info-stnd.info.gz,info.info.gz,texinfo.gz}
  252.  
  253.  
  254.   If you have not installed manpage system, you can get OS/2 ported copy 
  255. from following URLs. 
  256.   
  257.     English only version
  258.  
  259.       ftp://hobbes,hobbes.nmsu.edu/pub/os2/dev/help/
  260.          gnuman.zip        44610 1995/01/31  GNU man 1.0 (for use with groff)
  261.  
  262.       ftp://hobbes,hobbes.nmsu.edu/pub/os2/tex/
  263.          gnugroff.zip    2153647 1996/05/07  GNU groff v1.10
  264.  
  265.     Japanized version ( in my web page)
  266.  
  267.        http://www2s.biglobe.ne.jp/~vtgf3mpr/manpage/groff-man.tar.bz2
  268.           
  269.  
  270.  
  271. Sample Usage    @sam
  272. ============
  273.  
  274. About commands
  275. ~~~~~~~~~~~~~~
  276. Invoke `info' with "info", "info --vi-keys".......
  277.  
  278.  
  279. In emacs mode (default), type BACKSPACE or 'Ctrl+h' for help;
  280. type 'h' for tutorial
  281.  
  282. In vi mode, type `h' for help; type 'ESC h' or 'ALT + h' for tutorial
  283.  
  284.  
  285.   In the HELP screen, you'll see following lines (emacs mode)
  286.   
  287.      ESC b   (backward-word)         Move backward a word
  288.      ESC f   (forward-word)          Move forward a word
  289.      ESC r   (move-to-window-line)
  290.           Move the cursor to a specific line of the window
  291.      ESC v   (scroll-backward)       Scroll backward in this window
  292.      ESC x   (execute-command)
  293.           Read a command name in the echo area and execute it
  294.      ESC DEL (scroll-other-window-backward)  Scroll the other window backward
  295.  
  296.   OS/2 ported `info' release 2 is modified to accept ALT key as meta key, 
  297.   when an argument of meta key is only one. Exceptionally, you can't 
  298.   use 'ALT + TAB' and 'ALT + ESC' for info command, because these are 
  299.   trapped by OS/2 system. 
  300.   
  301.  
  302.   So, you can execute "backward-word" by typing `ALT' and `b' simultaneously, 
  303. instead of typing `ESC' followed by typing `b'. 
  304.   
  305.   Interpret 'ESC ONE_KEY' as 'ALT + ONE_KEY'. 
  306.   
  307.  
  308.  
  309. Processing texinfo source file
  310. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  311.     makeinfo.exe: You make an Info mannual or HTML document with makeinfo. 
  312.  
  313.      To create Info mannuals
  314.      
  315.        $ makeinfo --force --no-split TEXINFO_SOURCE
  316.  
  317.           NOTE: makeinfo cannot create Info from Japanese JIS or SJIS sources.
  318.                 If needed, convert to Japanese EUC. 
  319.  
  320.        
  321.      To create HTML documents
  322.      
  323.        $ makeinfo --force --no-split --html TEXINFO_SOURCE
  324.  
  325.           NOTE: makeinfo cannot create HTML from Japanese JIS or SJIS sources.
  326.                 If needed, convert to Japanese EUC. 
  327.  
  328.  
  329.     texindex.exe: Japanese Shift JIS is okay to process. 
  330.        To compile English Texinfo source to DVI
  331.      
  332.           $ tex FOO.texi
  333.           $ texindex FOO.??
  334.           $ tex FOO.texi
  335.           $ tex FOO.texi
  336.        
  337.        To compile Japanese Texinfo source to DVI
  338.  
  339.          KANJI code must be Shift JIS!! If needed, convert to SJIS and 
  340.          process Texinfo source like this. 
  341.           
  342.            $ ptex FOO.texi
  343.            $ texindex FOO.??
  344.            $ ptex FOO.texi
  345.            $ ptex FOO.texi
  346.      
  347.  
  348.  
  349.    You can also use `texi2dvi.cmd' to make DVI from TeX or LaTeX source. 
  350.  
  351.      If  you process Japanese TeX source, set environment variables like 
  352.      this in your `config.sys', in your batch file, or command line. 
  353.     
  354.               set TEX=ptex
  355.               set LATEX=platex
  356.               set BIBTEX=jbibtex
  357.               set MAKEINDEX=mendex
  358.  
  359.  
  360.  
  361. Make from source    @mak
  362. ================
  363.  
  364. <Without rpm>
  365.  
  366.   Get texinfo-4.0.tar.gz from following URLS. 
  367.      
  368.     <Primary site>
  369.  
  370.      ftp://ftp.gnu.org/gnu/texinfo/texinfo-4.0.tar.gz
  371.  
  372.     <Some Mirrors>
  373.  
  374.         California - labrea.stanford.edu/pub/gnu, gatekeeper.dec.com/pub/GNU
  375.         New York - ftp.cs.columbia.edu/archives/gnu/prep
  376.         Japan - tron.um.u-tokyo.ac.jp/pub/GNU/prep
  377.         Japan - ftp.cs.titech.ac.jp/pub/gnu
  378.         Japan - mirror.nucba.ac.jp/mirror/GNU/
  379.      
  380.       Read `FTP' for complete list of mirror sites. 
  381.      
  382.  
  383.   Unpack and apply patch, `texinfo-4.0-OS2.diff.gz'
  384.  
  385.         $ tar zxvf texinfo-4.0.tar.gz
  386.         $ cd texinfo-4.0
  387.         $ patch -p1 < c:/emx/src/redhat/SOURCRS/texinfo-4.0-OS2.diff.gz
  388.  
  389.  
  390.     Meaning of CFLAGS are:
  391.           -DINFOX: enable XFree86 feature
  392.           -DSJIS:  to process Japanese Shift JIS source ; makeinfo.c
  393.           -DEUC :  to process Japanese EUC source       ; makeinfo.c
  394.  
  395.  
  396.  
  397.     By default programs are compiled and linked with "-Zomf" option for gcc. 
  398.     If you'd like to do without "-Zomf", edit these line of `config.status'. 
  399.  
  400.          s%@CFLAGS@%-D__EMX__ -DOS2 -Zmtd -D__ST_MT_ERRNO__ -O2 -Zomf%g
  401.          s%@LDFLAGS@%-s -Zsysv-signals %g
  402.          s%@EMX_OBJ@%obj%g
  403.          s%@EMX_LIB@%lib%g
  404.          s%@EMX_AR@%emxomfar%g
  405.          s%@LIBOBJS@% strcasecmp.obj strncasecmp.obj%g
  406.  
  407.  
  408.     Compile and link like this way
  409.         
  410.         $ touch config.cache
  411.         
  412.         $ touch config.status
  413.         
  414.         $ sh config.status
  415.     
  416.         $ make
  417.  
  418.               If you want to run `configure' script, do like this. 
  419.               
  420.                         $ cp configure configure.orig
  421.                  
  422.                  Open `os2conf.cmd' by your editor, and modify it if needed
  423.  
  424.                         $ os2conf configure.orig > configure
  425.                         $ ksh
  426.                         ksh> ./configure
  427.                         
  428.                    Add lines to `config.status' 
  429.                        with "-Zomf"
  430.                             s%@EMX_OBJ@%obj%g 
  431.                             s%@EMX_LIB@%lib%g 
  432.                             s%@EMX_AR@%emxomfar%g
  433.                        without "-Zomf"
  434.                             s%@EMX_OBJ@%o%g 
  435.                             s%@EMX_LIB@%a%g 
  436.                             s%@EMX_AR@%ar%g
  437.                    Change two line of `config.status'
  438.                        with "-Zomf"
  439.                             s%@CFLAGS@%-D__EMX__ -DOS2 -Zmtd -D__ST_MT_ERRNO__ -O2 -Zomf%g
  440.                             s%@LIBOBJS@% strcasecmp.obj strncasecmp.obj%g
  441.  
  442.                         ksh> exit
  443.                         $ sh config.status
  444.                         $ make
  445.  
  446.     To check 
  447.  
  448.         $ make check
  449.         
  450.     To install
  451.      
  452.         $ make install prefix=SOMEWHERE
  453.  
  454.  
  455. <With rpm>
  456.  
  457.   Be sure that you already have a diff file and a spec file. 
  458.  
  459.      c:/emx/src/redhat/SOURCES/texinfo-4.0-OS2.diff.gz
  460.      c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec
  461.  
  462.   Get `texinfo-4.0.tar.gz' and install it in `c:/emx/src/redhat/SOURCES/'. 
  463.   
  464.   
  465.      x:\foo> rpm -bc c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec
  466.      x:\foo> c:
  467.      c:\> cd emx\src\redhat\BUILD
  468.      c:\emx\src\redhat\BUILD> dir /s *.exe
  469.  
  470.   If `dir' shows all executable names, do check. 
  471.  
  472.      c:\emx\src\redhat\BUILD> make ckeck
  473.  
  474.   
  475.   Installtion is simple
  476.   
  477.      c:\emx\src\redhat\BUILD> make install prefix=SOMEWHERE
  478.  
  479.  
  480.  
  481. Make rpm package    @rpm
  482. ================
  483.  
  484.   For binary rpm 
  485.   
  486.      x:\foo> rpm -bb --clean c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec
  487.  
  488.  
  489.   For binary and source rpm 
  490.   
  491.      x:\foo> rpm -ba --clean c:/emx/src/redhat/SPECS/texinfo-4.0-os2.spec
  492.  
  493.  
  494.   Or in source directory
  495.   
  496.     $ make -f Makefile.rpm rpm
  497.  
  498.  
  499. Comments, suggestions, or requests are alwary wellcome. 
  500.  
  501. Happy computing life with OS/2!!
  502.  
  503.  
  504. Thu Nov 18 01:55:15 JST 1999
  505.  
  506.  
  507.  
  508.                                              SAWATAISHI Jun, YOKOHAMA, JAPAN 
  509.                                                        <jsawa@attglobal.net>
  510.                              http://www2s.biglobe.ne.jp/~vtgf3mpr/indxos2.htm
  511.  
  512.  
  513.