This file is part of
<URL:ftp://bourbon.usc.edu/pub/tgif/tools/netpbm/netpbm-20may1999.tar.gz>.

A copy of ftp://ftp.x.org/R5contrib/netpbm-1mar1994.tar.gz is placed
in ftp://bourbon.usc.edu/pub/tgif/tools/netpbm/.  I've also made minor
modifications to netpbm-1mar1994 and created netpbm-20may1999.  Here
are the things I've changed:

1)  Support the use of the environment variable RGB_DB so that one binary
    can work on multiple hosts.

    In the original release, the path of the rgb.txt file is compiled into
    the binaries.  Therefore, if you run certain binaries (such as ppmtogif)
    from a host where the rgb.txt file is located in a path different from
    that of the compile host, you get an error.

    In this patch, the environment variable RGB_DB can be used to override
    the path of rgb.txt compiled into the binaries.  For example, if your
    rgb.txt is located in an unusual place (e.g., /unusual/lib/X11/rgb.txt),
    you can do the following in your login script:

        setenv RGB_DB /unusual/lib/X11/rgb.txt

2)  Add a [ -scale value ] command line option to pbmtoepsi so that it can
    be used with a modified version of pstoepsi (which knows how to handle
    the [ -2x ] command line option) to generate 2x resolution EPS preview
    bitmaps.

3)  Add relative symbolic links so that the whole thing can be built easily.
    All you have to do to get everything compiled now is (assuming your
    imake is installed properly):

        mkdir ~/src
        mkdir ~/src/netpbm
        mv netpbm-20may1999.tar.gz ~/src/netpbm
        cd ~/src/netpbm
        gunzip -c netpbm-20may1999.tar.gz | tar xf -
        cd netpbm-20may1999
        (check RGB_DB in "pbmplus.h" and see if it's valid)
        (on Solaris 2.7, you may have to uncomment a few lines at the top of
            Pbmplus.tmpl)
        xmkmf
        foreach dir (libtiff pbm pgm ppm pnm)
            cd $dir
            xmkmf
            cd ..
        end
        make clean
        foreach dir (libtiff pbm pgm ppm pnm)
            cd $dir
            make all
            cd ..
        end
        #
        # now you can copy all your favorite netpbm programs to somewhere
        #       in your path, for example, ~/bin
        #
        # here are my favorites (please replace bsdinst with your favorite
        #       install program)
        #
        set inst_dir=~/bin
        set inst=bsdinst
        set inst=install
        cd pbm
        $inst -c -s pbmtoepsi pbmtoxbm xbmtopbm $inst_dir
        cd ../pgm
        $inst -c -s pgmtopbm pbmtopgm rawtopgm \
                pgmcrater pgmedge pgmenhance pgmhist pgmnoise pgmnorm \
                pgmoil pgmtexture $inst_dir
        cd ../ppm
        $inst -c -s ppmtobmp ppmtogif ppmtopgm ppmtorgb3 ppmtoxpm \
                ppmbrighten ppmchange ppmdim ppmdist ppmdither ppmflash \
                ppmforge ppmhist ppmmake ppmmix ppmnorm ppmntsc ppmpat \
                ppmquant ppmrelief ppmshift ppmspread ppmtobmp ppmtogif \
                ppmtopgm ppmtoxpm bmptoppm pgmtoppm rawtoppm xpmtoppm $inst_dir
        cd ../pnm
        $inst -c pstopnm $inst_dir
        $inst -c -s pnmalias pnmarith pnmcat pnmcomp pnmconvol pnmcrop \
                pnmcut pnmdepth pnmenlarge pnmfile pnmflip pnmhistmap \
                pnminvert pnmnlfilt pnmnoraw pnmpad pnmpaste pnmscale \
                pnmtile pnmtops pnmtorast pnmtotiff pnmtoxwd giftopnm \
                rasttopnm tifftopnm xwdtopnm $inst_dir

4)  If the only reason you want to use this netpbm is to make eq4-2x.sym
    work, please try the following simplified procedure to build and
    install only "pbmtoepsi":

        mkdir ~/src
        mkdir ~/src/netpbm
        mv netpbm-20may1999.tar.gz ~/src/netpbm
        cd ~/src/netpbm
        gunzip -c netpbm-20may1999.tar.gz | tar xf -
        cd netpbm-20may1999
        (check RGB_DB in "pbmplus.h" and see if it's valid)
        (on Solaris 2.7, you may have to uncomment a few lines at the top of
            Pbmplus.tmpl)

        xmkmf
        cd pbm
        xmkmf
        make clean
        make libpbm.a
        make pbmtoepsi
        #
        # You just need to install pbm/pbmtoepsi to somewhere in your path,
        #       for example, ~/bin
        #
        set inst_dir=~/bin
        set inst=bsdinst
        set inst=install
        $inst -c -s pbmtoepsi $inst_dir

    If you are running cygwin and you get an error when you do
    "make pbmtoepsi", you would first need to add "#include <errno.h>" in
    "libpbm1.c", do "make libpbm.a" again.  Instead of doing "make pbmtoepsi",
    you should do:

        gcc -o pbmtoepsi -O2 -fno-strength-reduce -L/usr/X11R6/lib \
                pbmtoepsi.o libpbm.a

Last modified:       Dec 19, 2002
Previously modified: May 20, 1999
--
Bill Cheng // bill.cheng@acm.org <URL:http://bourbon.usc.edu:8001/william/>