eda-tools/kicad-patches/README

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

On Ubuntu and similar:

apt-get build-dep kicad


First build
-----------

bzr checkout -r 3494 lp:kicad kicad.bzr
cd kicad.bzr
ln -s wherever/eda-tools/kicad-patches patches
quilt push -a
cmake -DKICAD_TESTING_VERSION=ON .
make -j 5
make install


Rebuild with new/changed patches
--------------------------------

# update the patches
git pull

# rebuild KiCad
cd wherever/kicad.bzr
quilt pop -af
quilt push -a
cmake -DKICAD_TESTING_VERSION=ON .
make -j 5
make install


Rebuild with a new version of KiCad
-----------------------------------

cd wherever/kicad.bzr
quilt pop -a
bzr update
bzr update -r 3494	# if different from latest
quilt push -a
cmake -DKICAD_TESTING_VERSION=ON .
make -j 5
make install


Alternative process to uplevel patches to latest KiCad
------------------------------------------------------

git clone git@projects.qi-hardware.com:eda-tools.git

bzr branch lp:kicad
cp -a kicad kicad.<latest_kicad_rev>
cd kicad

# apply patches manually
patch --dry-run -p1 < ../eda-tools/kicad-patches/cmdline_{new,common,eeschema,pcbnew}.patch
# check with --dry-run, apply carefully, go through .rej files
# delete all .rej and .orig files

# build latest KiCad with upleveled patches
cmake -DKICAD_TESTING_VERSION=ON .
make -j 5

# test cmdline functionality
cd ../eda-tools/kicad-cmdline-testing
./kicmd_test clean
./kicmd_test test
# check that the output files look right, no crashes, no dialogs and
# that a subsequent ./kicmd_test clean will find and delete all
# expected files

./eda-tools/kicad-patches/kicad_diff.sh <latest_kicad_rev>
# check patches, move to eda-tools/kicad-patches, update doc, check
# that it applies clean, commit