build-packages: remove obsolete script and link to VyOS documentation

The referenced scripts/build-packages script was a proof of concept from me
some time ago to build VyOS packages through a more or less tiny wrapper. The
script was not maintained at any time and randomly caused more harm then good.

The script has been abandoned and the documentation has been updated on how to
build individual VyOS packages.

1 files changed, 5 insertions, 210 deletions

diff --git a/README.md b/README.md
index 88767431..c41847de 100644
--- a/README.md
+++ b/README.md
@@ -47,218 +47,13 @@ There are several directories with their own purpose:
                purposes, but not during ISO build process
  * `vars/`     Jenkins Pipeline library for reusable functions
 
-# Building images using Docker
+# Building VyOS
 
-Using our [Dockerfile](docker/Dockerfile) you create your own Docker container
-that is used to build a VyOS ISO image or other required VyOS packages. The
-[Dockerfile](docker/Dockerfile) contains some of the most used packages needed
-to build a VyOS ISO, a qemu image, and several of the submodules.
+In order to have a single manual and not maintining multiple copies the
+instructions on how to build VyOS either in a Docker container or natively can
+be found in our [Documentation - Build VyOS](https://docs.vyos.io/en/latest/contributing/build-vyos.html).
 
-To build the docker image ensure you have a working [Docker](https://www.docker.com)
-environment and then run the following commands:
-
-```bash
-$ docker build -t vyos-builder docker
-```
-
-Run newly built container:
-```bash
-$ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos-builder bash
-```
-
-This will drop you into a bash shell with this vyos-build repo mounted at
-`/vyos`. Then follow the instructions bellow to build the VyOS ISO and QEMU
-image.
-
-```bash
-vyos_bld@948a2be7c52c:/vyos$ uname -a
-Linux 948a2be7c52c 3.16.0-7-amd64 #1 SMP Debian 3.16.59-1 (2018-10-03) x86_64 GNU/Linux
-```
-
-**NOTE:**
-
-* Docker container must be run with `--privileged` flag
-* We recommended to run the container with a volume mapped in order to easy
-  export built VyOS ISO images to the "external" world
-* UNIX ownership is automatically inherited from your host directory but can be
-  altered by specifying the following environment variables when running the
-  container: `-e GOSU_UID=$(id -u)` and/or `-e GOSU_GID=$(id -g)`
-
-After the Docker container is running you can follow up the instructions below in
-order to build the VyOS ISO image.
-
-## Building the ISO image
-
-The `./configure` script will warn you if any dependencies are missing. Individual
-packages may have other build dependencies. If some dependencies are missing,
-package build scripts will tell you.
-
-```bash
-$ ./configure --help
-usage: configure [-h] [--build-by BUILD_BY] [--version VERSION]
-                 [--pbuilder-debian-mirror PBUILDER_DEBIAN_MIRROR]
-                 [--debian-security-mirror DEBIAN_SECURITY_MIRROR]
-                 [--architecture ARCHITECTURE] [--vyos-mirror VYOS_MIRROR]
-                 [--build-type BUILD_TYPE] [--debian-mirror DEBIAN_MIRROR]
-                 [--debug] [--custom-apt-entry CUSTOM_APT_ENTRY]
-                 [--custom-apt-key CUSTOM_APT_KEY]
-                 [--custom-package CUSTOM_PACKAGE]
-
-optional arguments:
-  -h, --help            show this help message and exit
-  --build-by BUILD_BY   Builder identifier (e.g. jrandomhacker@example.net)
-  --version VERSION     Version number (release builds only)
-  --pbuilder-debian-mirror PBUILDER_DEBIAN_MIRROR
-                        Debian repository mirror for pbuilder env bootstrap
-  --debian-security-mirror DEBIAN_SECURITY_MIRROR
-                        Debian security updated mirror
-  --architecture ARCHITECTURE
-                        Image target architecture (amd64 or i386 or armhf)
-  --vyos-mirror VYOS_MIRROR
-                        VyOS package mirror
-  --build-type BUILD_TYPE
-                        Build type, release or development
-  --debian-mirror DEBIAN_MIRROR
-                        Debian repository mirror for ISO build
-  --debug               Enable debug output
-  --custom-apt-entry CUSTOM_APT_ENTRY
-                        Custom APT entry
-  --custom-apt-key CUSTOM_APT_KEY
-                        Custom APT key file
-  --custom-package CUSTOM_PACKAGE
-                        Custom package to install from repositories
-```
-
-Before you can build an image, you need to configure your build.
-
-Each build needs to run the `./configure` step first where you can extend your
-ISO by additional packages (`--custom-package`) or specify who build this nice
-ISO image (`--build-by`). If you have local Debian mirrors, you can select them
-by `--debian-mirror` or `--debian-security-mirror`.
-
-```bash
-$ ./configure --custom-package vim --build-by jrandom@hacker.com
-$ sudo make iso
-```
-
-After some time you will find the resulting ISO image in the `build` folder.
-
-### Building images for virtualization platforms
-
-#### QEMU
-
-Run following command after building the ISO image.
-
-```bash
-$ make qemu
-```
-
-#### VMware
-
-Run following command after building the QEMU image.
-
-```bash
-$ make vmware
-```
-
-## Building subpackages inside Docker
-
-VyOS requires a bunch of packages which are VyOS specific and thus can not be
-found in any Debian Upstream mirrror. Those packages can be found at the VyOS
-GitHub project (https://github.com/vyos) and there is a nice helper script
-available to build and list those individual packages.
-
-[scripts/build-packages](scripts/build-packages) provides an easy interface
-to automate the process of building all VyOS related packages that are not part
-of the upstream Debian version. Execute it in the root of the `vyos-build`
-directory to start compilation.
-
-```bash
-$  scripts/build-packages -h
-usage: build-packages [-h] [-c | -k | -f] [-v] [-l] [-b BUILD [BUILD ...]]
-                      [-p] [--blacklist BLACKLIST [BLACKLIST ...]]
-
-optional arguments:
-  -h, --help            show this help message and exit
-  -c, --clean           Re-clone required Git repositories
-  -k, --keep            Keep modified Git repositories
-  -f, --fetch           Fetch sources only, no build
-  -v, --verbose         Increase logging verbosity for each occurance
-  -l, --list-packages   List all packages to build
-  -b BUILD [BUILD ...], --build BUILD [BUILD ...]
-                        Whitespace separated list of packages to build
-  -p, --parallel        Build on all CPUs
-  --blacklist BLACKLIST [BLACKLIST ...]
-                        Do not build/report packages when calling --list
-```
-
-Git repositories are automatically fetched and build on demand. If you want to
-work offline you can fetch all source code first with the `-f` option.
-
-The easiest way to compile is with the above mentioned [Docker](docker/Dockerfile)
-container, it includes all dependencies for compiling supported packages.
-
-```bash
-$ docker run --rm -it -v $(pwd):/vyos -w /vyos \
-             --sysctl net.ipv6.conf.lo.disable_ipv6=0 \
-             vyos-builder scripts/build-packages
-```
-
-**NOTE:** `--sysctl net.ipv6.conf.lo.disable_ipv6=0` is required to build the
-`vyos-strongswan` package
-
-**NOTE:** Prior to executing this script you need to create or build the Docker
-container and checkout all packages you want to compile.
-
-### Building single package(s)
-
-To build a single package use the same script as above but specify packages with `-b`:
-
-Executed from the root of `vyos-build`
-
-```bash
-$ docker run --rm -it -v $(pwd):/vyos -w /vyos \
-             --sysctl net.ipv6.conf.lo.disable_ipv6=0 \
-             vyos-builder scripts/build-packages -b <package>
-```
-
-**NOTE:** `--sysctl net.ipv6.conf.lo.disable_ipv6=0` is only needed when
-building `vyos-strongswan` and can be ignored on other packages.
-
-**NOTE:** `vyos-strongswan` will only compile on a Linux system, running on macOS
-or Windows might result in a unittest deadlock (it never exits).
-
-#### Building single packages from your own repositories
-
-You can also build packages that are not from the default git repositories,
-for example from your own forks of the official vyos repositories.
-
-First create a directory "packages" at the top level of the vyos-build repository
-and clone your package into it (creating a subdirectory with the package contents).
-Then checkout the correct branch or commit you want to build before building the package.
-
-Example using `git@github.com:myname/vyos-1x.git` repository to build vyos-1x:
-
-```bash
-$ mkdir packages
-$ cd packages
-$ git clone git@github.com:myname/vyos-1x.git
-$ cd ..
-$ docker run --rm -it -v $(pwd):/vyos -w /vyos \
-             --sysctl net.ipv6.conf.lo.disable_ipv6=0 \
-             vyos-builder scripts/build-packages -b vyos-1x
-```
-
-**NOTE:** You need to git pull manually after you commit to the remote and before rebuilding,
-the local repository won't be updated automatically.
-
-**WARNING:** Any packages in the packages directory will be added to the iso during build,
-replacing the upstream ones. Make sure you delete them (both the source directories and built
-deb packages) if you want to build an iso from purely upstream packages.
-
-# Development process
-
-## Git branches
+# Development Branches
 
 The default branch that contains the most recent VyOS code is called `current`
 rather than `master`. We know it's confusing, but it's not easy to fix. In a