From 547a2fe7eebdddca691c2be312d6704772cf8f89 Mon Sep 17 00:00:00 2001 From: mobinmob Date: Sat, 17 Aug 2024 19:39:15 +0300 Subject: /doc: fixes and additions. --- doc/apkg.conf.md | 44 +++++++++++++++++++++++++++++--------------- doc/apkg.md | 50 +++++++++++++++++++++++++++++++++----------------- doc/revdep.md | 2 +- 3 files changed, 63 insertions(+), 33 deletions(-) diff --git a/doc/apkg.conf.md b/doc/apkg.conf.md index 6623016..b3b4647 100644 --- a/doc/apkg.conf.md +++ b/doc/apkg.conf.md @@ -5,26 +5,40 @@ # DESCRIPTION **apkg.conf** is the configuration file for the **apkg** package manager for the alice linux distribution. -It resides by default under /etc in an alice linux installation. -The contents are sourced by the **apkg** script and are in the posix shell *key="value"* format. +It resides by default under `/etc` in an alice linux installation. +The contents are sourced by the **apkg** program and are in the posix shell `key="value"` format. # CONFIGURATION KEYS -- **APKG_NOPROMPT** If set, it enables non-interactive use by disabling user confirmation prompt. -- **APKG_PACKAGE_DIR** Directory where the compiled packages will reside. -- **APKG_SOURCE_DIR** Directory that will hold the downloaded sources. -- **APKG_WORK_DIR** Directory where the actual building process will take place. This happens in subdirectories which are cleaned after completion. -- **APKG_LOG** If set, it enables the creation of a log for the program output. -- **export CFLAGS=""** Default are *-O3 -march=x86-64 -pipe* -- **export CXXFLAGS="$CFLAGS"** -- **export NINJAJOBS="<-x>"** Replace <-x> with the number of jobs the ninja build system with use. Without this it will use the maximum amount of threads the processor suports. -- **export MAKEFLAGS="-jx"** Replace with the number of jobs the make build system with use. - -# BUGS - -**apkg** is in a working stage but also under heavy development. Please report and bugs/issues in the project issue tracker: https://codeberg.org/emmett1/autils/issues +- `APKG_NOPROMPT` If set, it enables non-interactive use by disabling user confirmation prompt. +- `APKG_PACKAGE_DIR` Directory where the compiled packages will reside. +- `APKG_SOURCE_DIR` Directory that will hold the downloaded sources. +- `APKG_WORK_DIR` Directory where the actual building process will take place. This happens in subdirectories which are cleaned after completion. +- `APKG_LOG` If set, it enables the creation of a log for the program output. +- `export CFLAGS=""` Default are *-O3 -march=x86-64 -pipe* +- `export CXXFLAGS="$CFLAGS"` +- `export NINJAJOBS="<-x>"` Replace <-x> with the number of jobs the ninja build system with use. Without this it will use the maximum amount of threads the processor suports. +- `export MAKEFLAGS="-jx"` Replace with the number of jobs the make build system with use. + +EXAMPLES + +``` +### example of a valid apkg.conf ### +export CFLAGS="-O3 -march=x86-64 -pipe" +export CXXFLAGS="$CFLAGS" +export MAKEFLAGS="-j12" +export NINJAJOBS="12" +APKG_REPO="/var/lib/alicelinux/repos/core /var/lib/alicelinux/repos/extra /var/lib/alicelinux/repos/xorg /var/lib/alicelinux/repos/wayland" +APKG_PACKAGE_DIR=/var/cache/pkg +APKG_SOURCE_DIR=/var/cache/src +APKG_WORK_DIR=/var/cache/work +``` # AUTHORS emmett1 Author of the program and creator of alice linux. mobinmob Author of the man page. + +# REPORTING BUGS + +**apkg** is in a working stage but also under heavy development. Please report and bugs/issues in the project issue tracker: https://codeberg.org/emmett1/autils/issues \ No newline at end of file diff --git a/doc/apkg.md b/doc/apkg.md index 45d5604..cc844c3 100644 --- a/doc/apkg.md +++ b/doc/apkg.md @@ -16,25 +16,31 @@ and automate the building and installing of packages. Arguments for apkg are as follows: -- **-h** Prints help. -- **-i** ** Installs package(s) without taking dependencies into account. Building will fail if the dependencies are not present in the system. -- **-I** ** Installs package(s) with dependencies. -- **-d** ** Lists package dependencies +- **-h** Print help. +- **-i** ** Install package(s) without taking dependencies into account. Building will fail if the dependencies are not present in the system. +- **-I** ** Install package(s) with dependencies. +- **-d** ** List only direct package dependencies - **-D** ** List all dependencies for package(s) - **-j** ** List all reverse dependencies for the package (packages that depend on it). - -# EXAMPLES +- **-u** ** Upgrade package(s) +- **-r** ** Remove package(s) +- **-t** ** Run scripts for package(s) that update cache or dbs (mime, font cache e.t.c) +- **-U** Update system +- **-f** Force rebuild a package. +- **-o** ** Only download source for package(s), do not build and install +- **-p** ** Print full path to the package build template directory +- **-s** ** Search for packages # ENVIRONMENT VARIABLES -- *APKG_ROOT* Overrides default root location (/), where sw is installed -- *APKG_CONF* Overrides default location for the configuration file apkg.conf. The default is under /etc on an installed alice linux system. -- *APKG_NOPROMPT* If set, it enabled non-interactive use by disabling user confirmation prompt. -- *APKG_REPO* Double-quoted, space-separated list for the local directories that contain build templates. -- *APKG_PACKAGE_DIR* Directory where the compiled packages will reside. -- *APKG_SOURCE_DIR* Directory that will hold the downloaded sources. -- *APKG_WORK_DIR* Directory where the actual building process will take place. This happens in subdirectories which are cleaned after completion. -- *APKG_LOG* If set, it enables the creation of a log for the program output. +- `APKG_ROOT` Overrides default root location (/), where sw is installed +- `APKG_CONF` Overrides default location for the configuration file apkg.conf. The default is under /etc on an installed alice linux system. +- `APKG_NOPROMPT` If set, it enabled non-interactive use by disabling user confirmation prompt. +- `APKG_REPO` Double-quoted, space-separated list for the local directories that contain build templates. +- `APKG_PACKAGE_DIR` Directory where the compiled packages will reside. +- `APKG_SOURCE_DIR` Directory that will hold the downloaded sources. +- `APKG_WORK_DIR` Directory where the actual building process will take place. This happens in subdirectories which are cleaned after completion. +- `APKG_LOG` If set, it enables the creation of a log for the program output. **Note:** Usually, APKG_REPO, APKG_PACKAGE_DIR, APKG_SOURCE_DIR and APKG_WORK_DIR are declared in the apkg.conf configuration file. For more information, please see apkg.conf(5). @@ -42,13 +48,23 @@ Arguments for apkg are as follows: - **apkg.conf(5)** is the default configuration file, it resides by default under /etc. - **abuild** is the name of the package templates that apkg uses, along with relevant files in order to -build and installed packages. For example, one can look to the alice linux repos, under [alicelinux/repos at main - emmett1/alicelinux - Codeberg.org](https://codeberg.org/emmett1/alicelinux/src/branch/main/repos) +build and installed packages. For example, one can look to the alice linux repos, under https://codeberg.org/emmett1/alicelinux/src/branch/main/repos -# BUGS +# EXAMPLES -**apkg** is in a working stage but also under heavy development. Please report and bugs/issues in the project issue tracker: https://codeberg.org/emmett1/autils/issues +`apkg -i linux` - Install the *linux* package + +`apkg -f jupp` - Force rebuild the *jupp* package. If someone tries with just `-i`, `apkg` will produce the following message +if the package is already installed: `[...] Package 'jupp' already installed.` + +`apkg -s icon` - Search for packages names that contain "icon", it will produce a list with one +package per line. # AUTHORS emmett1 Author of the program and creator of alice linux. mobinmob Author of the man page. + +# REPORTING BUGS + +**apkg** is in a working stage but also under heavy development. Please report and bugs/issues in the project issue tracker: https://codeberg.org/emmett1/autils/issues diff --git a/doc/revdep.md b/doc/revdep.md index 44eef7a..fd50104 100644 --- a/doc/revdep.md +++ b/doc/revdep.md @@ -13,7 +13,7 @@ It should probably run after any big upgrade, especially those that feature lib - **-h** Show program help. - **-v** Verbose output of the operation. -# BUGS +# REPORTING BUGS **apkg** is in a working stage but also under heavy development. Please report and bugs/issues in the project issue tracker: https://codeberg.org/emmett1/autils/issues -- cgit v1.2.3