From 087eb29037dcc075fc67726dfe75b12dab3855e6 Mon Sep 17 00:00:00 2001 From: Xavier Date: Fri, 17 Nov 2023 01:11:58 -0500 Subject: [PATCH] Applied 1c7f48dd81e718f13057c63f08a61fbbf7d32d9a --- docs/manual.md | 76 +++++++++++++++++++++++++------------------------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/docs/manual.md b/docs/manual.md index 4e19fd0..652d648 100644 --- a/docs/manual.md +++ b/docs/manual.md @@ -1,95 +1,96 @@ # Pacwrap User Manual -This document was generated by the pacwrap binary on 25-10-2023 with version 0.4.1-1a11c7c of the program. +This document was generated by the pacwrap binary on 17/11/2023 00:49:30 with version 0.5.0-b9b5ea8 of the program. ## NAME pacwrap - Command-line application which facilitates the creation, management, and execution of unprivileged, sandboxed containers with bubblewrap and libalpm. ## SYNOPSIS -pacwrap [**OPERATIONS**] [**ARGuMENTS**] [**TARGET(S)**] +pacwrap [**OPERATIONS**] [**ARGUMENTS**] [**TARGET(S)**] ## OPERATIONS -* -S, --sync** +* **-S, --sync** Synchronize package databases and update packages in target containers. -* -U, --utils** +* **-U, --utils** Invoke miscellaneous utilities to manage containers. -* -P, --process** +* **-P, --process** Manage and show status of running container processes. -* -E, --execute** +* **-E, --execute** Executes application in target container using bubblewrap. -* -h, --help** -Invoke a printout of this manual to **stdout**. Specify an option verbatim for further information. +* **-h, --help=OPTION** +Invoke a printout of this manual to **STDOUT**. -* -V, --version** +* **-V, --version** Display version and copyright information in **STDOUT**. ## EXECUTE -* -r, --root** +* **-r, --root** Execute operation with fakeroot and fakechroot. Facilitates a command with faked privileges. -* -s, --shell** +* **-s, --shell** Invoke a bash shell ## SYNCHRONIZATION -* -y, --refresh** +* **-y, --refresh** Synchronize remote package databases. Specify up to 2 times to force a refresh. -* -u, --upgrade** +* **-u, --upgrade** Execute aggregate upgrade routine on all or specified containers. Use **-t, --target=TARGET** to limit -package synhronization operations to the specified target containers. Packages applicable to a target **must** -be specified only after the target operand. e.g. '-t electron element-desktop -t mozilla firefox thunderbird' +package synhronization operations to the specified target containers. Packages applicable to +a target **must** be specified only after the target operand. +e.g. '-t electron element-desktop -t mozilla firefox thunderbird' -* -f, --filesystem** +* **-f, --filesystem** Force execution of filesystem synchronization target on all or specified containers. In combination with **-o/--target-only**, in addition to no other specified targets, filesystem slices will be synchronized without package synchronization on all applicable containers. -* -c, --create** +* **-c, --create** Create a container with the first specified target. A container type argument is also required. -* -b, --base** +* **-b, --base** Base container type. Specify alongside **-c, --create** to assign this container type during creation. This container type is used as the base layer for all downstream containers. Only one base container -dependency per slice or per root is supported. Filesystem and package deduplication via slices and root -containers is recommended, but optional. +dependency per slice or per root is supported. Filesystem and package deduplication via slices +and root containers is recommended, but optional. -* -d, --slice** +* **-d, --slice** Slice container type. Specify alongside **-c, --create** to assign this container type during creation. Requires a base dependency target, and optionally sliced dependency target(s), in order to ascertain -foreign packages and influence ordering of downstream synchronization target(s). Container slicing provides -the ability to install packages in a lightweight, sliced filesytem, which aid in the deduplication of -common downstream package and filesystem dependencies (e.g. graphics drivers, graphical toolkits, fonts, -and display server dependencies, etc.). +foreign packages and influence ordering of downstream synchronization target(s). Container slicing +provides the ability to install packages in a lightweight, sliced filesytem, which aid in the +deduplication of common downstream package and filesystem dependencies e.g. graphics drivers, +graphical toolkits, fonts, etc.. -* -r, --root** +* **-r, --root** Root container type. Specify alongside **-c, --create** to this assign container type during creation. Requires a base dependency target, and optionally sliced dependency targets, in order to ascertain foreign packages and influence ordering of this target. These containers are ideal for installing software in with the least amount of filesystem and package synchronization overhead. -* -t, --target=TARGET** +* **-t, --target=TARGET** Specify a target container for the specified operation. -* -o, --target-only** +* **-o, --target-only** Apply specified operation on the specified target only. -* --force-foreign** +* **--force-foreign** Force synchronization of foreign packages on resident container. Useful for when installing a new package in a root container without all the prerequisite foreign dependencies synchronized to this container's package database. -* --dbonly** +* **--dbonly** Transact on resident containers with a database-only transaction. -* --noconfirm** +* **--noconfirm** Override confirmation prompts and confirm all operations. ## PROCESS @@ -100,26 +101,25 @@ Override confirmation prompts and confirm all operations. ## HELP -* -m, --more** +* **-m, --more** When specifying a topic to display, show the default topic in addition to specified options. -* -f, --format=FORMAT** +* **-f, --format=FORMAT** Change output format of help in **STDOUT**. Format options include: 'ansi', 'dumb', 'markdown', and 'man'. This option is for the express purposes of generating documentation at build time, and has little utility outside the context of package maintenance. 'man' option produces troff-formatted documents for man pages. - -* -a, --all, --help=all** +* **-a, --all, --help=all** Display all help topics. ## VERSION -* -v, --version, --version=min** +* **-V, --version, --version=min** Sends version information to **STDOUT** with colourful ASCII art. The 'min' option provides a minimalistic output as is provided to non-colour terms. -This documentation was generated by pacwrap v0.4.1-1a11c7c-DEV (25-10-2023). -Please seek relevant documentation if 'pacwrap -v' mismatches with the aforementioned. +This documentation was generated by pacwrap v0.5.0-b9b5ea8-DEV (17/11/2023 00:49:30). +Please seek relevant documentation if 'pacwrap -V' mismatches with the aforementioned. ## COPYRIGHT