Skip to content

Latest commit

 

History

History
107 lines (75 loc) · 3.15 KB

README.md

File metadata and controls

107 lines (75 loc) · 3.15 KB
Raw

Dlackware Gnome build system and installer

Build Status License

This is the build system used to build systemd and Dlackware Gnome distribution for Slackware Linux.

This repository doesn't contain any packages, please refer to another repositories in the Dlackware organization if you are looking for packages.

Build and install Dlackware build system

  1. Install Haskell stack:
wget -qO- https://get.haskellstack.org/ | sh
  1. Clone this repository:
git clone https://github.com/Dlackware/dlackware.git
  1. Then switch to the cloned directory:
cd dlackware
  1. Build the build system:
stack build

It will take some time to download the dependencies on first run.

  1. After that you can run the build system with:
stack exec dlackware -- …

Just replace … with the arguments that should be passed to the build system. You can get a list of supported commands and command line arguments with:

stack exec dlackware -- --help

Configuration

The configuration is described by a YAML file, that should be in ./etc/dlackware.yaml.

Sample configuratin can be found in ./etc/dlackware.yaml.new. Just copy this file to ./etc/dlackware.yaml and change as appropriate.

The configuration is very simple and all options can be found in the sample configuration file mentioned above.

  • reposRoot specifies the root directory used to find the packages to be built.
  • loggingDirectory is the directory there the build system writes its log files, one file per built package.
  • temporaryDirectory is the directory used to build the actual software. This directory should have enough free space to be able to build large projects, like Gnome.
  • repos is a list of directories (relative to reposRoot) that contain compile-order files, text files with a list of packages in the order these should be built. Dlackware doesn't look into the directory structure to find the packages; only the packages mentioned in compile-orders are built.
  • gnomeVersion is the Gnome version to work with.

Running the tests

stack test --pedantic

stack build hlint
stack exec hlint -- src test

Auto-updater

Dlackware has capabilities to update many Gnome build scripts to newer versions automatically. It relies on information provided by Gnome maintainers to do so. Following information is required:

  • Versions file (text file)
  • BuildStream meta data (.tar-archive)

These can be downloaded from https://download.gnome.org/teams/releng. Extract gnome-GNOME.VERSION.tar.xz, rename the directory inside it into gnome and put it into ./etc. Place versions in ./etc as well.

Now you can execute:

stack exec dlackware -- update-gnome

The updater makes its best effort to recognize the packages that need to be updated and modify the .info files, you still need to check whether the updates are made correctly.