README.cvs

   1 # $Id$
   2 #
   3
   4 This file describes how to build from CVS sources.  If you are building from a
   5 released version or snapshot, please refer to the 'INSTALL' document instead.
   6 Take the time to read this file, it's not that long and it addresses some
   7 questions which come up with some frequency.
   8
   9 -------------
  10 Prerequisites
  11 -------------
  12
  13 You will need the following tools to obtain and build a CVS version of pcb:
  14
  15 To download and track sources you will need:
  16
  17 cvs
  18 ssh
  19
  20 To compile you will need a C compiler, a lex (or flex) and a yacc (or bison)
  21 implementation.  If you do not have lex or yacc, try installing:
  22
  23 bison     -- ftp://ftp.gnu.org/pub/gnu/bison/
  24 flex      -- ftp://ftp.gnu.org/pub/non-gnu/flex/
  25
  26 In addition you will need recent versions of:
  27
  28 autoconf  -- ftp://ftp.gnu.org/pub/gnu/autoconf/
  29              Please note that version 2.13 is too old.  Current development
  30              is done with 2.59.
  31
  32 automake  -- ftp://ftp.gnu.org/pub/gnu/automake/
  33              The developers use the 1.9.* versions of automake.  Older versions
  34              have not been as well tested (or tested at all).  Versions 1.7 and
  35              older are too old and will not work.
  36
  37 gettext   -- ftp://ftp.gnu.org/pub/gnu/gettext/
  38              You will need version 0.14.x, or 0.16.x or higher
  39
  40 intltool  -- ??
  41              You will need version 0.35.0 or higher
  42
  43 texinfo   -- ftp://ftp.gnu.org/pub/gnu/texinfo/
  44              You will need at least version 4.6 to be able to build
  45              the documentation.
  46
  47 You can find the version of autoconf, automake, and makeinfo by running them with the
  48 --version flag.
  49
  50 If you do not wish to build the documentation, use --disable-doc when you run
  51 configure.  If you do wish to build the documentation, you should enable
  52 maintainer-mode (--enable-maintainer-mode) which will turn on various
  53 dependency rules for documentation building.  In addition you must build
  54 pcb with the png export HID enabled (it is enabled by default) because some
  55 of the figures in the manual are drawn with pcb.
  56
  57 Please note that maintainer-mode and the png HID are only needed when building
  58 documentation from cvs sources.  If you are building pcb from a distfile you
  59 do not need maintainer-mode and the png export HID is optional.
  60
  61 Finally, if you edit any of the actions identified by
  62 /* ACTION(Foo,ActionFoo) */
  63 comments, you will need perl and in addition, you must have used
  64 the --enable-maintainer-mode flag to the configure script.
  65
  66 ---------
  67 Check out
  68 ---------
  69
  70 If you already have a checked out PCB source tree, please proceed to the
  71 'Updating' section.
  72
  73 To check out sources from the anonymous CVS server, run the following:
  74
  75         cvs -d:pserver:anonymous@pcb.cvs.sourceforge.net:/cvsroot/pcb login
  76         cvs -z3 -d:pserver:anonymous@pcb.cvs.sourceforge.net:/cvsroot/pcb co pcb
  77
  78 ---------
  79 Updating
  80 ---------
  81
  82 To update an already checked out copy of the PCB source tree, run these commands
  83 from your top level pcb directory:
  84
  85         cvs login
  86         cvs -z3 update -PdA
  87
  88 ----------------------------------
  89 Bootstrapping with the auto* tools
  90 ----------------------------------
  91 To create the configure script and the Makefile.in's
  92 you will need to run
  93
  94 ./autogen.sh
  95
  96 from the top level pcb directory.  This will run the various auto* tools
  97 which creates the configure script, the config.h.in file and the various
  98 Makefile.in's.
  99
 100 If you plan on making changes to configure.ac, Makefile.am's, or actions
 101 defined by the
 102 /* ACTION(Foo,ActionFoo) */
 103 comments, you may want to enable maintainer mode by passing the
 104 --enable-maintainer mode flag to ./autogen.sh
 105
 106 At this point you can proceed to configure and build PCB as outlined in
 107 the INSTALL document.
 108
 109 -------------------
 110 Building a Snapshot
 111 -------------------
 112 The file README.snapshots documents what is currently done to create a
 113 snapshot release for PCB.  Most of what is in there has to do with the
 114 cvs repository and how we tag and branch the sources.  If you are interested
 115 in building your own .tar.gz file from CVS sources, you can still use
 116 the information in README.snapshots as a guide.
 117