This file is part of
<URL:ftp://bourbon.cs.umd.edu/pub/tgif/tools/netpbm/netpbm-15nov1997.tar.gz>.

Since ftp://ftp.x.org is so very difficult to get on these days, I've made
a copy of ftp://ftp.x.org/R5contrib/netpbm-1mar1994.tar.gz here in
ftp://bourbon.cs.umd.edu/pub/tgif/tools/netpbm/.

I've also made minor modifications to netpbm-1mar1994.tar.gz and created
netpbm-15nov1997.tar.gz.  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 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-15nov1997
        cp netpbm-15nov1997.tar.gz ~/src/netpbm-15nov1997
        cd ~/src/netpbm-15nov1997
        gunzip -c netpbm-15nov1997.tar.gz | tar xf -
        cd netpbm
        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)
        #
        cd pbm
        bsdinst -c -s pbmtoepsi pbmtoxbm xbmtopbm ~/bin
        cd ../pgm
        bsdinst -c -s pgmtoppm pgmtopbm pbmtopgm rawtopgm \
                pgmcrater pgmedge pgmenhance pgmhist pgmnoise pgmnorm \
                pgmoil pgmtexture ~/bin
        cd ../ppm
        bsdinst -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 ~/bin
        cd ../pnm
        bsdinst -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 \
                pstopnm rasttopnm tifftopnm xwdtopnm ~/bin

Last modified: Nov 15, 1997
--
Bill Cheng // bill.cheng@acm.org <URL:http://bourbon.cs.umd.edu:8001/william/>