XBPS

A short guide on working with the Void Linux package repository. 13 Mar 2021

Void provides a comprehensive manual on how to work with the source packages.
This guide is focused on a small subset of tasks I often do myself.

Prerequisites

  1. Clone the void-packages repository and do the initial bootstrap:
$ git clone git://github.com/void-linux/void-packages.git
$ cd void-packages
$ ./xbps-src binary-bootstrap
  1. Install the xtools package:
$ xbps-install -S xtools
  1. Install and setup GitHub CLI:
$ xbps-install -S github-cli
$ gh auth login

Updating an outdated package

  1. Update your local repository:
$ git pull
  1. Make changes to package template in a new git branch (most of the time you
    only need to update the version):
$ git checkout -b package-name
$ vim srcpkgs/package-name/template
  1. Update the checksum:
$ xgensum -f -i package-name
  1. Lint the template for possible errors:
$ xlint package-name
  1. Build and install the updated package locally:
$ ./xbps-src pkg package-name
$ xi package-name
  1. Test the package to make sure it works;
  2. Generate a commit message for the update:
$ xbump package-name
  1. Create a PR:
$ gh pr create