INSTALL

   1
   2                             COPYRIGHT
   3
   4   PCB, interactive printed circuit board design
   5   Copyright (C) 1994, 1995, 1996, 1997 Thomas Nau
   6   Copyright (C) 1998, 1999, 2000, 2001, 2002 harry eaton
   7   Copyright (C) 2001 C. Scott Ananian
   8
   9   This program is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU General Public License as published by
  11   the Free Software Foundation; either version 2 of the License, or
  12   (at your option) any later version.
  13
  14   This program is distributed in the hope that it will be useful,
  15   but WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17   GNU General Public License for more details.
  18
  19   You should have received a copy of the GNU General Public License
  20   along with this program; if not, write to the Free Software
  21   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22
  23   Contact addresses for paper mail and Email:
  24   harry eaton
  25   6697 Buttonhole Court
  26   Columbia, MD 21044 USA
  27   haceaton@aplcomm.jhuapl.edu
  28
  29
  30
  31 -----------------------------------------------------------------------------
  32
  33 Previous releases have been successfully compiled on the following platforms:
  34
  35 X11R4
  36         Check the GNU info file for problems.
  37         The dynamic offset for printouts is not supported because of the
  38         missing panner widget. This version NOW REQUIRES X11R6
  39
  40
  41 HP-UX 10.10
  42         All HP machines require the MIT release of X11R6
  43         HP does not ship the Athena Widgets with its release nor
  44         necessary tools like imake... but you can get them as a patch.
  45         You will also have to get yourself an ANSI compiler if you are stuck
  46         with HPs cc.
  47
  48 Sun Solaris 2.5.1
  49         You won't have any problems if you use X11R5 or later.
  50         Using OpenWindows will cause some of them. See the GNU info file for
  51         details about it.
  52
  53 Silicon Graphics IRIX 5.3, 6.2 and 6.4
  54         No problems beside additional CFLAGS in Imakefile. Check if you are
  55         using a R4 server and, if you do, read the GNU info file of pcb.
  56
  57 Linux 0.99pl14 and later, XFree 2.1.1 and later
  58         No problems; it's the developement platform.
  59
  60 SCO ODT 3.0 (probably, couldn't check the current release)
  61         Needs tls003 of the Athena Widget library from sosco.sco.com
  62         (mailed by John DuBois <spcecdt@deeptht.armory.com>).
  63
  64 FreeBSD (probably, couldn't check the current release)
  65
  66 NetBSD
  67         No problems
  68
  69 DEC UNIX V3.2, V4.0
  70
  71 This specific release has been installed and tested on GNU/Linux 2.4.10, X11R6,
  72 specifically linux-pmac! based on the 2.4.10 kernel. This is a
  73 redhat 7 based derivative, but few of the changes should materially
  74 affect the other platforms described above. The special caveats to
  75 those machines still apply.
  76
  77 -----------------------------------------------------------------------------
  78
  79 Quick install for the sloppy:
  80
  81 # ./configure
  82 # make
  83 # cd src
  84 # ./pcbtest.sh
  85
  86
  87 if everything is working good, quit then:
  88 # cd ..
  89 # make install
  90
  91 Do that last step as root.
  92
  93 More formal installation instructions:
  94
  95      ***** YOU MUST HAVE AN ANSI COMPILER TO COMPILE THESE SOURCES *****
  96
  97 Here's how to install:
  98
  99 1. Run the configure script.  This is a standard GNU configure script.
 100    In the simplest case you just run
 101
 102      ./configure
 103
 104    This will configure PCB to install to /usr/local
 105    To change the installation prefix to /opt/pcb , use
 106
 107      ./configure --prefix=/opt/pcb
 108
 109    See
 110
 111      ./configure --help
 112
 113    for a full list of options
 114
 115 2. Run make to compile the software
 116
 117      make
 118
 119 3. Get yourself a printed copy of the documentation (available in
 120    ./doc/).
 121    Read 'Whats_new*' to see if old file have to be updated.
 122
 123
 124 4. Test the program before you install it to see if the application defaults
 125    match your window environment.
 126        cd src
 127        ./pcbtest.sh
 128    does the trick.
 129
 130 5. Take the printed copies from (3) and check if the translations work
 131    (see chapter 'Getting Started') by running
 132        ./pcbtest.sh ../example/LED2
 133    It comes up with a LED board layout you can play with.
 134
 135    Take special care on the resources related to functions keys and the
 136    pointer buttons because most of the window managers use them too.
 137
 138 6. When you're satisfied with the defaults and the program run:
 139        cd ..
 140        make install
 141    as a user with the appropriate rights. Depending on the filemodes set
 142    by your X11 environment you must remove existing copies of fonts,
 143    manpage and program before you are able to install successfully.
 144    Set umask to 022 else the new created directories wont be world
 145    readable; the fonts cannot be found.
 146
 147 6. Read 'MAILING' in this directory.
 148
 149
 150 If you create any element files or package description files I would be glad
 151 to get a copy to include them into the next release or an additional archive.
 152
 153 Have fun with it.
 154
 155 harry