No commit message

buildpns.md

-# Push and Shove branch build instructions
-
-Majority of current Linux distributions contain the stable version of
-KiCad which is fairly old and does not include the Push and Shove
-router, which in my opinion is vital for PCB design. Therefore, here are
-short instructions for getting the newest version to work.  
+# KiCad product branch build instructions
+
+There is an [official install
+script](http://bazaar.launchpad.net/~kicad-product-committers/kicad/product/view/head:/scripts/kicad-install.sh)
+available on the KiCad website, but it is currently hardcoded to
+download & build revision 4756, which is tagged as 'pre-kiway'. The tag
+name indicates that it is the last commit before an introduction of big
+changes to KiCad. The changes are still in progress and may cause some
+troubles every now and then ([more
+details](https://blueprints.launchpad.net/kicad/+spec/modular-kicad)).  
+If you want to run the bleeding-edge KiCad, you have two possible ways.
+One is to modify the install script, so it fetches the newest version.
+Still, sometimes you may find problems using the script, therefore here
+you can find alternative, short instructions for getting the newest
+version to work. Another difference is the manual below setups your
+environment to use local footprint libraries instead of ones stored in
+Github.  
 If you meet any problems - please let me know. I would rather make KiCad
 easy to build for everyone than force you to use tricks.
 
@@ -43,14 +54,14 @@ need to be given your credentials:
 
     $ bzr whoami "Name Surname <name.surname@mail.com>"
 
-For the time being, the newest Push and Shove is not merged to the
-master repository, therefore we are going to use a different one:
+Getting the source code & building:
 
-    $ bzr checkout --lightweight lp:~twlostow/kicad/tom-pns-v2 kicad
+    $ bzr checkout --lightweight lp:kicad
     $ mkdir kicad/build
     $ cd kicad/build
     $ cmake .. -DCMAKE_BUILD_TYPE=Release
     $ make -j<number of CPU cores>
+    <get yourself a cup of tea>
     $ sudo make install
 
 KiCad is now installed and ready to run.
@@ -93,6 +104,7 @@ Now you have to set enviromental variables (though I recommend using
     $ bzr checkout --lightweight lp:~kicad-developers/kicad/doc
 
 You may install it in a similar manner to symbol libraries, but these
-files are not critical to be placed in a specific location. Just check
-the contents, that should be enough.
+files are not critical to be placed in a specific location. Just
+downlaod the contents and store it wherever you like (read that as
+well\! there are a lot of useful hints inside).