src/png/INSTALL

   1
   2 Installing libpng version 1.0.1 March 15, 1998
   3
   4 Before installing libpng, you must first install zlib.  zlib
   5 can usually be found wherever you got libpng.  zlib can be
   6 placed in another directory, at the same level as libpng.
   7 Note that your system might already have a preinstalled
   8 zlib, but you will still need to have access to the
   9 zlib.h and zconf.h include files that correspond to the
  10 version of zlib that's installed.
  11
  12 You can rename the directories that you downloaded (they
  13 might be called "libpng-1.0.1 or "lpng100" and "zlib-1.1.1"
  14 or "zlib111") so that you have directories called "zlib" and "libpng".
  15
  16 Your directory structure should look like this:
  17
  18    ..       (the parent directory)
  19       libpng  (this directory)
  20           INSTALL (this file)
  21           README
  22           *.h
  23           *.c
  24           scripts
  25              makefile.*
  26           pngtest.png
  27           etc.
  28       zlib
  29           README
  30           *.h
  31           *.c
  32           contrib
  33           etc.
  34
  35 First enter the zlib directory and follow the instructions
  36 in zlib/README.  Then come back here and choose the
  37 appropriate makefile.sys in the scripts directory.
  38 The files that are presently available in the scripts directory
  39 include
  40
  41       descrip.mms   =>  VMS makefile for MMS or MMK
  42       makefile.std  =>  Generic UNIX makefile
  43       makefile.knr  =>  Archaic UNIX Makefile that converts files with ansi2knr
  44       makefile.dec  =>  DEC Alpha UNIX makefile
  45       makefile.sgi  =>  Silicon Graphics IRIX makefile
  46       makefile.sun  =>  Sun makefile
  47       makefile.s2x  =>  Solaris 2.X makefile (gcc, creates libpng.so.2.1.0)
  48       makefile.lnx  =>  Linux/ELF makefile (gcc, creates libpng.so.2.1.0)
  49       makefile.mip  =>  MIPS makefile
  50       makefile.aco  =>  Acorn makefile
  51       makefile.ama  =>  Amiga makefile
  52       smakefile.ppc =>  AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
  53                         (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
  54       makefile.atr  =>  Atari makefile
  55       makefile.bor  =>  Borland makefile
  56       build.bat     =>  MS-DOS batch file for Borland compiler
  57       makefile.dj2  =>  DJGPP 2 makefile
  58       makefile.msc  =>  Microsoft C makefile
  59       makefile.tc3  =>  Turbo C 3.0 makefile
  60       makefile.os2  =>  OS/2 Makefile (gcc and emx, requires pngos2.def)
  61       pngos2.def    =>  OS/2 module definition file used by makefile.os2
  62       makefile.wat  =>  Watcom 10a+ Makefile, 32-bit flat memory model
  63       makevms.com   =>  VMS build script
  64
  65 Copy the file (or files) that you need from the
  66 scripts directory into this directory, for example
  67
  68    MSDOS example: copy scripts\makefile.msd makefile
  69    UNIX example:    cp scripts/makefile.std makefile
  70
  71 Read the makefile to see if you need to change any source or
  72 target directories to match your preferences.
  73
  74 Then read pngconf.h to see if you want to make any configuration
  75 changes.
  76
  77 Then just run "make test" which will create the libpng library in
  78 this directory and run a quick test that reads the "pngtest.png"
  79 file and writes a "pngout.png" file that should be identical to it.
  80
  81 Most of the makefiles will allow you to run "make install" to
  82 put the library in its final resting place (if you want to
  83 do that, run "make install" in the zlib directory first if necessary).
  84
  85 Further information can be found in the README and libpng.txt
  86 files, in the individual makefiles, and in png.h, and the manual
  87 pages libpng.3 and png.5.