/*------- groff version 1.11.1 for OS/2 release 1  (Fri Jan 22) ------------*/


Table of contents
=================

Introduction                  @int
History of OS/2 Port          @his
Required Executables          @req
OS/2 Note                     @os2
Installation                  @ins
Setup Language                @lan
IMPORTANT NOTICE              @not
LICENSE                       @lic
Mannuals                      @man
About `viewman.cmd'           @vie
Pager for X terminal          @pag
Compile from Source           @com


Introduction	@int
============

Kai Uwe Rommel (KUR) ported GNU groff document formatting system version 1.10 
to OS/2 in 1994. 

I used his patch included in `gnugroff.zip'. 

      ftp://hobbes.nmsu.edu/pub/os2/apps/wp/
      ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/doc/
                 gnugroff.zip    2153647 1996/05/07  GNU groff v1.10

I thank a lot for his splendid work.

For Japanese users, a Japanization patch is also used. 

Difference between KUR's implementation and this groff system is as follows:

   - new cp437 and cp850 devices ==> not included in this package 
   - dev prefix is NOT removed from device subdirectories
   - tmac. prefix is NOT removed from macro files in tmac/
   - doc- prefix is NOT removed from files in tmac/mdoc/ 

                         (about this, read KUR's documentation `README.os2')



  If you have questions and suggestions, please mail me. 
 


                                             SAWATAISHI JUN, YOKOHAMA JAPAN
                                                       <jsawa@attglobal.net>
                           http://www2s.biglobe.ne.jp/~vtgf3mpr/indxos2.htm



History of OS/2 Port	@his
====================

Release 1                               Sat Jan 22 2000
-   groff 1.15 + Japanization patch



Required Executables	@req
====================

   HOBBES=ftp://hobbes.nmsu.edu/pub/os2
   LEO=ftp://ftp.leo.org/pub/comp/os/os2/leo
   JSAWA=http://www2s.biglobe.ne.jp/~vtgf3mpr
 
 emx runtime version 0.9d (or later): Not included
     HOBBES/dev/emx/v0.9d/emxrt.zip
     LEO/dev/emx/v0.9d/emxrt.zip

 `man' (requires GNU groff)
      HOBBES/dev/help/gnuman.zip        ; v1.0
      LEO/gnu/doc/man11a.zip            ; v1.1a
      JSAWA/gnu/man.htm                 ; v1.5g


 Pager : I strongly recommend you to install `less'

      less 332 with Japanese patch: 

               http://hp.vector.co.jp/authors/VA000199/os2/

         You can use this in virtual terminal (xterm etc) of XFree86 for OS/2. 
         You should get this one if you'd like to see manpages in XFree86. 

      less 329 without XFree86 capability
               LEO/unix/gnu/less329-2.zip
               HOBBES/unix/util/util/file/less329-2.zip

`gzip' and `bzip2'
    [gzip]
        HOBBES/util/archiver/gz124_32.zip
        LEO/gnu/archiver/gz124-32.zip
    [bzip2]
        HOBBES/util/archiver/bzip090b.zip
        LEO/archiver/bzip090b.zip
        http://www.muraroa.demon.co.uk/
        JSAWA/rpm/bzip2.htm  ; v0.9.5d --- this version preserve time stamp
        http://netpassport-wc.netpassport.or.jp/~wmakoto/CLUB-bzip2.html


 `sh' included in KSH package
     LEO/shells/pdksh-5.2.13-emx.zip
     HOBBES/util/shell/ksh527rt.zip



OS/2 Note @os2
=========

OS/2 uniq executables are `printdvi.exe' and `printlp.exe'. 
These program were written by KUR, to read `README.os2' about them. 

Shell script using `sh' or `perl' are modified and renamed as `*.cmd'. 

		afmtodit.cmd
		grog.cmd  
		neqn.cmd 
		nroff.cmd 


Installation @ins
============

I assume you have installed emx runtime in drive 'E'. 
Installing groff system in the same drive is simply and easy. 


    c:\> mkdir tmp
    c:\> cd tmp
    c:\tmp> unzip SOMEWHERE/groff115.zip
    c:\tmp> ls -l

	-rw-rw---a     5724 Jan 22 19:47 README-groff.os2 
	-rw-rw---a  1290873 Jan 22 19:47 emx-groff.tar.bz2
	-rw-rw---a    22290 Jan 22 19:48 groff-list.dat

                       You'd better see `groff-list.dat' to know total size 
                       of files to be installed. 
    c:\tmp> e:
    e:\> bzip2 -dc c:/tmp/emx-groff.tar.bz2 | tar xvf -
    e:\> copy c:\tmp\README-groff.os2 emx\doc\groff-1.15\



Setup environment variables

  In your `config.sys'

        set GROFF_TMAC_PATH=e:/emx/share/groff/tmac      # required
        set GROFF_FONT_PATH=e:/emx/share/groff/font      # required
        set GROFF_TMPDIR=x:/tmp                          # optional

  If you have finished intalling `man'

        set MANPATH=e:/emx/man;e:/emx/man/ja_JP.ujis;

  If you'd like to see manpages more beautifully, use my configuration

       set TERMCAP=e:/emx/etc/termcap.good
       set TERM=os2


XFree86 utility

    e:\> copy \emx\doc\GXditview.ad %X11ROOT%\lib\X11\app-defaults\GXditview

                                       You may want to modify `GXditview'



Setup Language	@lan
==============

In your `config.sys' define GROFF_TYPESETTER environment variable

    set GROFF_TYPESETTER=nippon    ------ for Japanese Users
    set GROFF_TYPESETTER=ascii     ------ for English Users
    set GROFF_TYPESETTER=latin1    ------ for European Language Users



IMPORTANT NOTICE  @not
================

   For Japanese users

       Only Japanese EUC code is supported !



License			@lic
=======

   Read GNU General Public License;  `\emx\doc\GNU\COPYING'


Mannuals	@man
========

   Manpages are in `\emx\man'

   Documentations in `\emx\doc\groff-1.15'

            *.jp ; description on Japanization patch
            README.OS2 ; Kai Uwe Rommel's documentation on OS/2 ported 
                         groff version 1.10 
            Manuals written in postscript
               meintro.ps ; Writing Papers with GROFF usnig -me
               meref.ps   ; ME REFERENCE MANUAL
               pic.ps     ; Making Pictures With GNU PIC



About `viewman.cmd'           @vie
==================

`viewman.cmd' : A shell script to view given manpage 
     - recognize whether manpage is formatted or not; compressed or not.

  
-- Setting up

  Open `viewman.cmd' with your editor and modity lines if needed.

           line 45:  device=nippon

    This line specifies default device in VIO mode. If you are not Japanese, 
    device should be "ascii" or "latin1". 

           line 64:  device=X100-12

    When `viewman' is invoked with "-x" option, "X100-12" device is 
    used. Choose a device for X window among  "X100", "X100-12", "X75", 
    and "X75-12". 


  When `viewman' is invoked without option nor argument, it outputs usage 
information. 

		x:\src> viewman

		Read manpage with 'groff' and PAGER
		  If PAGER environment variable in not set,
		    OS/2 default 'more' is used
    
		    Usage:  viewman [-x] x:/foo/bar/manpage.3.gz
		    echo -x: output in X window

  View manpages like this.

			x:\src> viewman e:/emx/man/man1/foo.1.bz2
			x:\src> viewman e:/emx/man/man1/bar.1
			x:\src> viewman e:/emx/man/man1/hoge.1.gz
			x:\src> viewman k:/src/FOO/moge.1
  
    In `xterm'
			x:\src> viewman e:/emx/man/man1/bar.1.bz2     
			x:\src> viewman -x e:/emx/man/man1/bar.1.bz2



Pager for X terminal          @pag
====================

As mentioned above, you can view manpage in X terminals, xterm, rxvt, kterm.., 
if and only if `less' supporting XFree86 is installed. 

`gxditview.exe' included in this package is X window based viewer, which 
is invoked by `groff' with option like "-TX100". 

I recommend you to use `viewman.cmd' with "-x" option in XFree86. 


      x:\> viewman -x SOMEWHERE/man/man1/foo.1.gz


  You will see manpage "foo" in `gxditview's window. 

  Options for X terminal output are "X100", "X100-12", "X75", "X75-12". 
  



Compile from source	@com
===================

Prerequisites
~~~~~~~~~~~~~
                     HOBBES=ftp://hobbes.nmsu.edu/pub/os2
                        LEO=ftp://ftp.leo.org/pub/comp/os/os2/leo
                      JSAWA=http://www2s.biglobe.ne.jp/~vtgf3mpr


- GNU patch 
   JSAWA/gnu/patch.htm               ; v2.5.4
   LEO/gnu/systools/gnupatch.zip     ; v2.1
   HOBBES//dev/util/gnupatch.zip     ; v2.5

       `patch.exe' installed from OS/2 installation CDROM/diskette 
       can't be used !!!

- GNU file utilities
   LEO/gnu/systools/gnufutil.zip     ; v3.13
   HOBBES/util/file/gnufutil.zip     ; v3.13
   JSAWA/gnu/fileutils.htm           ; v3.16

- GNU text utilities
   LEO/gnu/systools/gnututil.zip     ; v1.19
   HOBBES/util/file/gnututil.zip     ; v1.19
   JSAWA/gnu/text-util.htm           ; v1.22f or later

- GNU DEVELOPMENT TOOLS              ; emx0.9d
   LEO/gnu/emx+gcc/*
   HOBBES//dev/emx/v0.9c/*



Source
~~~~~~
   groff-1.15.tar.gz 
   
        You can get this from GNU ftp mirror sites; see "/emx/doc/GNU/FTP"



OS/2 patch
~~~~~~~~~~
    http://homepage1.nifty.com/jsawa/gnu/groff-1.15-OS2.diff.gz [274 kb]

                                     This contains Japanization patch. 


Make and Install
~~~~~~~~~~~~~~~~

     c:\src> tar zxvf SOMEWHERE/groff-1.15.tar.gz
     c:\src> cd groff-1.15
     c:\src\groff-1.15> chmod +rw -R *  ( or attrib -r /s * )
     c:\src\groff-1.15> gzip -dc SOMEWHERE/groff-1.15-OS2.diff.gz | patch -p1
     c:\src\groff-1.15> make
     c:\src\groff-1.15> make install prefix=x:/foo

Setup
~~~~~
     Define environment variables in your `config.sys'

         GROFF_TMAC_PATH=x:/foo/share/groff/tmac      # required
         GROFF_FONT_PATH=x:/foo/share/groff/font      # required
         GROFF_TYPESETTER=ascii (or latin1, nippon)   # optional
         GROFF_TMPDIR=x:/tmp                          # optional



That' all


                                             SAWATAISHI JUN, YOKOHAMA JAPAN
                                                      <jsawa@attglobal.net>
                           http://www2s.biglobe.ne.jp/~vtgf3mpr/indxos2.htm


/*----- end of document -----------------------------------------------------*/
