src/png/INSTALL

   1
   2 Installing libpng version 1.0.3 - January 14, 1999
   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.3" or "lpng103" and "zlib-1.1.3"
  14 or "zlib113") 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.hux  =>  HPUX (10.20 and 11.00) makefile
  46       makefile.sgi  =>  Silicon Graphics IRIX makefile
  47       makefile.sun  =>  Sun makefile
  48       makefile.s2x  =>  Solaris 2.X makefile (gcc, creates libpng.so.2.1.0)
  49       makefile.lnx  =>  Linux/ELF makefile (gcc, creates libpng.so.2.1.0)
  50       makefile.mip  =>  MIPS makefile
  51       makefile.aco  =>  Acorn makefile
  52       makefile.ama  =>  Amiga makefile
  53       smakefile.ppc =>  AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
  54                         (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
  55       makefile.atr  =>  Atari makefile
  56       makefile.bor  =>  Borland makefile
  57       build.bat     =>  MS-DOS batch file for Borland compiler
  58       makefile.dj2  =>  DJGPP 2 makefile
  59       makefile.msc  =>  Microsoft C makefile
  60       makefile.w32  =>  makefile for Microsoft Visual C++ 4.0 and later
  61       makefile.tc3  =>  Turbo C 3.0 makefile
  62       makefile.os2  =>  OS/2 Makefile (gcc and emx, requires pngos2.def)
  63       pngos2.def    =>  OS/2 module definition file used by makefile.os2
  64       makefile.wat  =>  Watcom 10a+ Makefile, 32-bit flat memory model
  65       makevms.com   =>  VMS build script
  66       pngdll.mak    =>  To make a png32bd.dll with Borland C++ 4.5
  67       pngdef.pas    =>  Defines for a png32bd.dll with Borland C++ 4.5
  68
  69 Copy the file (or files) that you need from the
  70 scripts directory into this directory, for example
  71
  72    MSDOS example: copy scripts\makefile.msd makefile
  73    UNIX example:    cp scripts/makefile.std makefile
  74
  75 Read the makefile to see if you need to change any source or
  76 target directories to match your preferences.
  77
  78 Then read pngconf.h to see if you want to make any configuration
  79 changes.
  80
  81 Then just run "make test" which will create the libpng library in
  82 this directory and run a quick test that reads the "pngtest.png"
  83 file and writes a "pngout.png" file that should be identical to it.
  84
  85 Most of the makefiles will allow you to run "make install" to
  86 put the library in its final resting place (if you want to
  87 do that, run "make install" in the zlib directory first if necessary).
  88
  89 Further information can be found in the README and libpng.txt
  90 files, in the individual makefiles, and in png.h, and the manual
  91 pages libpng.3 and png.5.