Pcb is a CAD (computer aided design) program for the physical
design of printed circuit boards.

For installing the release refer to the file 'INSTALL'.
For additional information read the manual (doc/pcb.pdf)

If you are updating to a new snapshot, you may wish to read
the ChangeLog file.  People using git are expected to look
at the git commit messages, instead.

There is also a bug tracking system available which can
be found from http://pcb.geda-project.org.


-------------------------------------------------------------------------
                            COPYRIGHT

PCB is covered by the GNU General Public License.  See the individual
files for the exact copyright notices.

  Contact addresses for paper mail and Email:
  harry eaton
  6697 Buttonhole Court
  Columbia, MD 21044
  haceaton@aplcomm.jhuapl.edu

=======================
 Building PCB from git
=======================

This file describes how to build from git sources.  If you are
building from a released version or snapshot, please refer to the
'INSTALL' document instead.  Take the time to read this file, it's not
that long and it addresses some questions which come up with some
frequency.

-------------
Prerequisites
-------------

You will need the following tools to obtain and build a git version of
PCB:

git       -- To download and track sources you will need the 'git'
             version control tool installed.

To compile you will need a C compiler (such as 'gcc'), a 'lex' (or
'flex') and a 'yacc' (or 'bison') implementation.  If you do not have
'lex' or 'yacc', try installing:

bison     -- ftp://ftp.gnu.org/pub/gnu/bison/
flex      -- ftp://ftp.gnu.org/pub/non-gnu/flex/

In addition you will need recent versions of:

autoconf  -- ftp://ftp.gnu.org/pub/gnu/autoconf/
             Please note that version 2.13 is too old.  Current development
             is done with 2.59.

automake  -- ftp://ftp.gnu.org/pub/gnu/automake/
             The developers use the 1.9.* versions of automake.  Older
             versions have not been as well tested (or tested at all).
             Versions 1.7 and older are too old and will not work.

gettext   -- ftp://ftp.gnu.org/pub/gnu/gettext/
             You will need version 0.14.x, or 0.16.x or higher

intltool  -- https://edge.launchpad.net/intltool/+download
             You will need version 0.35.0 or higher

texinfo   -- ftp://ftp.gnu.org/pub/gnu/texinfo/
             You will need at least version 4.6 to be able to build
             the documentation.

perl      -- Version 5 or newer.  This is needed for building the
             documentation.

latex     -- This is needed for building the documentation.

You can find the version of autoconf, automake, and makeinfo by
running them with the '--version' flag.

If you do not wish to build the documentation, use '--disable-doc'
when you run configure.  When building from a release tarball, the
documentation comes preformatted.

------------------------
Clone the PCB repository
------------------------

If you have previously cloned the PCB source tree, please proceed to
the updating section.

To clone the PCB repository to your computer, run:

  git clone git://git.geda-project.org/pcb.git

This will download the entire version control history for PCB to
your computer, and will take some time.

--------
Updating
--------

To update your git repository with the latest changes, simply run:

  git pull

----------------------------------
Bootstrapping with the auto* tools
----------------------------------
To create the configure script and the Makefile.in's
you will need to run:

  ./autogen.sh

from the top level PCB directory.  This will run various programs
from the GNU autotools to create the 'configure' script, the
'config.h.in' file and the various 'Makefile.in's.

At this point you can proceed to configure and build PCB as outlined
in the 'INSTALL' document.

-------------------
Building a Snapshot
-------------------

The file 'README.snapshots' documents what is currently done to create
a snapshot release for PCB.  Most of what is in there has to do with
the cvs repository and how we tag and branch the sources.  If you are
interested in building your own .tar.gz file from git sources, you can
still use the information in 'README.snapshots' as a guide.

------------------
Advanced git usage
------------------

If you wish to use git to track your own changes to PCB, use git to
contribute patches back to the community, or gain 'push' permissions
for the PCB git repository, please see the gEDA wiki for more
information:

  http://wiki.geda-project.org/geda:scm

------------------------
Using CVS instead of git
------------------------

It is still possible to use CVS to access the PCB sources.  You can
checkout the latest version using the command:

  cvs -z3 -d:pserver:anonymous@git.geda-project.org/home/git/pcb.git co master

And update them using:

  cvs -z3 update -PdA

..
        Local Variables:
        mode: rst
        End:

Building PCB for Windows with a MinGW cross-compiler

1) Install a MinGW cross-compiler.
On Debian and derivatives, you can type 'sudo apt-get install mingw32.'.
You can also build your own by using the build script provided by the
MinGW project.

On NetBSD use the cross/mingw package.

2) Install native (non-cross) dependencies.

* autoconf
* automake
* libtool, gettext, intltool.
* glib and gtk+.
* wget (used for fetching tarballs)
* wine (the tiff build fails without it)

3) Edit the w32/minipack.conf file to suit your compiler setup.
   FIXME -- can we make this take arguments?

4) Copy the pcb tarball to w32/sources

5) Enter the w32 directory and run ./build_all.

6) Wait while the script fetches and compiles the PCB dependencies and PCB itself.

7) Run the result with wine: wine result/bin/pcb.exe
   [NOTE:  This didn't work for me but copying everything to an actual windows machine worked]

8) Copy the result directory to a Windows installation (packaging script is not supplied).

These are instructions on building a windows installer under cygwin but
with mingw toolchain and libraries.  The result is an install which
does not depend on cygwin.

If you are looking for instructions on cross-compiling from linux
or other systems, then refer to README.w32

---------------------------------------------------------------------

These instructions were written based on cygwin64.  When you install
cygwin64 on your system, you will need to ensure that you have installed:

- autoconf
- automake
- bash
- bison
- flex
- gawk
- intltool
- make
- m4
- sed

In addition, you will need the mingw cross compilation packages.  At the
time of writing this, the the list of packages installed which have
been shown to work is contained in win32/mings_required_pkgs.  That
list was obtained via:

$ cygcheck -c | grep mingw

In addition I have:
w32api-headers                        4.0.4-1                      OK
w32api-runtime                        4.0.4-1                      OK


Once these have all been installed then when building from a tarball,
extract, cd win32 and run

./build_pcb

This will create a windows installer.

If you are building from git you will need additional tools to build
the documentation which can be skipped using

./build_pcb --disable-doc