diff --git a/README.md b/README.md index befffa81e0..74f362205f 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,8 @@ for details of how to create source packages. ### Table of Contents - [Requirements](#requirements) +- [Quick start](#quick-start) - [chroot methods](#chroot-methods) -- [Quick setup in Void](#quick-setup) - [Install the bootstrap packages](#install-bootstrap) - [Configuration](#configuration) - [Directory hierarchy](#directory-hierarchy) @@ -58,6 +58,43 @@ multiple utilities to accomplish this task: > NOTE: `xbps-src` does not allow building as root anymore. Use one of the chroot methods shown above. + +### Quick start + +Clone the `void-packages` git repository and install the bootstrap packages: + +``` +$ git clone git://github.com/void-linux/void-packages.git +$ cd void-packages +$ ./xbps-src binary-bootstrap +``` + +Build a package by specifying the `pkg` target and the package name: + +``` +$ ./xbps-src pkg +``` + +Use `./xbps-src -h` to list all available targets and options. + +To build packages marked as 'restricted', modify `etc/conf`: + +``` +$ echo XBPS_ALLOW_RESTRICTED=yes >> etc/conf +``` + +Once built, the package will be available in `hostdir/binpkgs` or an appropriate subdirectory (e.g. `hostdir/binpkgs/nonfree`). To install the package: + +``` +# xbps-install --repository hostdir/binpkgs +``` + +Alternatively, packages can be installed with the `xi` utility, from the `xtools` package. `xi` takes the repository of the current working directory into account. + +``` +# xi +``` + ### chroot methods @@ -112,24 +149,6 @@ To enable it: $ cd void-packages $ echo XBPS_CHROOT_CMD=proot >> etc/conf - -### Quick setup in Void - -Clone the `void-packages` git repository, install the bootstrap packages: - -``` -$ git clone git://github.com/void-linux/void-packages.git -$ cd void-packages -$ ./xbps-src binary-bootstrap -``` - -Type: - - $ ./xbps-src -h - -to see all available targets/options and start building any available package -in the `srcpkgs` directory. - ### Install the bootstrap packages