diff options
authorGyörgy Balló <>2017-02-01 23:21:56 +0100
committerGyörgy Balló <>2017-02-01 23:21:56 +0100
commit7f3f9cc5e1cc371e98fde0cfee6a62d034519138 (patch)
parent50f4d93c23f41e5372e44795c65dae1806e8a0e4 (diff)
Initial plan
1 files changed, 45 insertions, 0 deletions
diff --git a/ b/
new file mode 100644
index 0000000..aaed199
--- /dev/null
+++ b/
@@ -0,0 +1,45 @@
+The build system is the heart of the project. On this page you can see the initial plan.
+## Files in git repository
+For packages that need some customizations, the build system will use a repository that consist from the following files:
+- _[package_name]_/_[architecture_name] shell script, which will run in the same directory where the original PKGBUILD found. It can do the following things: apply sed lines, apply patches, or even replace the original PKGBUILD file with a custom one.
+- blacklist: text file, list of packages that will be ignored by the build system (e.g. cannot build for this architecture).
+- build-manually: text file, list of packages that will be added to the build list on update, but need manual interaction before build. Packages that depend on this package will be also hold back.
+- update-once: text file, list of packages that will be updated next time even if nothing changed. This list will be cleared out on next update.
+## Processes
+The build system will consist from the following shell scripts:
+- get-package-updates: check for packages that need to be built, and build a list in the proper build order
+- build-packages: build packages one by one, then upload the binary package to the repository server
+- arch32build: build packages in a clean chroot (a fork of [archbuild](
+- db-update: add binary packages to the repository, and remove them from the build list (a fork of [db-update](
+## get-package-updates
+1. Create a lock file for build list.
+2. Update git repositories ([official packages](, [community packages]( and the repository of package customizations).
+3. Read previous git revision numbers from files.
+4. Check modified packages from the last update, and put them on a list.
+5. Merge the list of newly modified packages with the existing build list, and put them in the proper build order.
+6. Write the current git revision numbers to files.
+7. Remove the lock file.
+## build-packages
+1. Read the build list and try to build the packages one by one.
+3. Check if the current package or any of its dependencies are locked, broken or blocked. If not, then lock the package.
+2. Create a lock file for the current package. If it's already exist, jump to the next package.
+4. Copy (or download) the source package and the customizations locally.
+5. If it's an architecture-independent package (marked as 'any'), then copy the built package from the official repository, and skip the following three steps.
+5. Apply customizations by running the script if exist in a chroot.
+6. Run arch32build.
+7. If the package fails to build, then try again once. If fails again, then mark it as broken.
+8. After a successful build, sign the package with the server's PGP key, and add (or upload) the binary package to the staging directory.
+9. Run db-update.
+## arch32build
+Build the package in a clean chroot environment with a custom makefile.conf.
+## db-update
+1. Create a lock file for build list.
+2. Add binary packages to the repository.
+3. Remove the package from the build list.
+4. Remove the lock file. \ No newline at end of file