From 017ec72df257c209d2dcb2e7671eba898c4e37cb Mon Sep 17 00:00:00 2001 From: mobinmob Date: Fri, 16 Aug 2024 21:47:59 +0300 Subject: /docs : initial documentation commit. --- doc/apkg.conf.md | 30 ++++++++++++++++++++++++++++++ doc/apkg.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/revdep.md | 22 ++++++++++++++++++++++ 3 files changed, 108 insertions(+) create mode 100644 doc/apkg.conf.md create mode 100644 doc/apkg.md create mode 100644 doc/revdep.md (limited to 'doc') diff --git a/doc/apkg.conf.md b/doc/apkg.conf.md new file mode 100644 index 0000000..83f4277 --- /dev/null +++ b/doc/apkg.conf.md @@ -0,0 +1,30 @@ +# NAME + +**apkg.conf** - configuration file for apkg + + +# 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 contends are sourced by the **apkg** script and are in the posix shell *key="value"* format. + + +# CONFIGURATION KEYS + +- **APKG_NOPROMPT** If set, it enabled 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 actuall building proccess 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 + +# AUTHORS +emmett1 Author of the program and creator of alice linux. +mobinmob Author of the man page. diff --git a/doc/apkg.md b/doc/apkg.md new file mode 100644 index 0000000..e3dbe57 --- /dev/null +++ b/doc/apkg.md @@ -0,0 +1,56 @@ +# NAME + +**apkg** - package building tool and package manager for alice linux + +# SYNOPSIS + +**apkg** [-i] [-I] [-d] [-D] [-j] [-u] [-r] [-t] [-U ] [-f] [-o] [-p] [-s] [-h] [*pkg(s)*] + +# DESCRIPTION + +**apkg** is the package build tool and package installer, along with **spm** for the alice linux destribution. +It is written in posix shell with the goal to be simple and effective. It can consume package building templates in the abuild format +and automate the building and installing of packages. + +# OPTIONS + + +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 +- **-D** ** List all dependencies for package(s) +- **-j** ** List all reverse dependencies for the package (packages that depend on it). + + + +# EXAMPLES + +# 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-seperated 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 actuall building proccess 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). + +# FILES + +- **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) + +# 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 + +# AUTHORS +emmett1 Author of the program and creator of alice linux. +mobinmob Author of the man page. diff --git a/doc/revdep.md b/doc/revdep.md new file mode 100644 index 0000000..be1bdf2 --- /dev/null +++ b/doc/revdep.md @@ -0,0 +1,22 @@ +# NAME + +**revdep** - utility to discover and rebuild reverse deps + + +# DESCRIPTION +**revdep** is a utility inspired by the gentoo program revdep-rebuild. It is written in posix shell and +it can discover programs that need to be rebuild after library upgrades or are missing libraries. +It should probably run after any big upgrade, especially those that feature lib version bumps. + + +# OPTIONS +- **-h** Show program help. +- **-v** Be verbose in the operation. +- +# 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 + +# AUTHORS +emmett1 Author of the program and creator of alice linux. +mobinmob Author of the man page. -- cgit v1.2.3