]> git.ipfire.org Git - people/ms/pakfire.git/commitdiff
man: Document all pakfire commands
authorMichael Tremer <michael.tremer@ipfire.org>
Wed, 8 Dec 2021 18:49:16 +0000 (18:49 +0000)
committerMichael Tremer <michael.tremer@ipfire.org>
Wed, 8 Dec 2021 18:49:33 +0000 (18:49 +0000)
Signed-off-by: Michael Tremer <michael.tremer@ipfire.org>
man/pakfire.txt

index 5a13d28e57faf0c162c1bece268be2047531864f..cdae958e93760b0900ddbf6f027d780e8dc2413d 100644 (file)
@@ -5,7 +5,19 @@ pakfire - The package management system for IPFire
 
 == SYNOPSIS
 [verse]
-`pakfire install ...`
+`pakfire check`
+`pakfire clean`
+`pakfire execute [--bind PATH] [--non-interactive] COMMAND`
+`pakfire info [--long] PACKAGE [PACKAGE ...]`
+`pakfire install [--without-recommended] [--allow-uninstall] [--allow-downgrade] PACKAGE [PACKAGE ...]`
+`pakfire key TODO`
+`pakfire provides [FEATURE]`
+`pakfire requires [FEATURE]`
+`pakfire remove [--keep-dependencies] PACKAGE [PACKAGE ...]`
+`pakfire repolist`
+`pakfire search PATTERN`
+`pakfire sync [--keep-orphaned]`
+`pakfire update [--exclude PATTERN|-x PATTERN] [--allow-uninstall] [--allow-downgrade] [PACKAGE ...]`
 
 == DESCRIPTION
 `pakfire` is the command that controls the IPFire Package Management system.
@@ -37,7 +49,66 @@ pakfire - The package management system for IPFire
 
 == COMMANDS
 
-TODO
+'check'::
+       This command checks the integrity of the installation.
+       If any errors are returned they can be fixed with the 'sync' command.
+
+'clean'::
+       Cleans all temporary and downloaded files.
+
+'execute [--bind PATH] [--non-interactive] COMMAND'::
+       Executes a command inside a Pakfire environment (useful in combination with
+       '--root=' and '--arch=').
+       +
+       '--non-interactive' makes the shell non-interactive and using '--bind' parts of the
+       local file system can be made available inside the environment.
+
+'info [--long] PACKAGE [PACKAGE ...]'::
+       Shows information about the given package. '--long' will show additional information.
+
+'install [--without-recommended] [--allow-uninstall] [--allow-downgrade] PACKAGE [PACKAGE ...]'::
+       Installs one or more packages.
+       +
+       By default, Pakfire installs packages that are recommended for use with the
+       installed set of packages. This can be disabled with '--without-recommended'.
+       +
+       If the package cannot be installed due to dependency problems, the solver can
+       be allowed to allow uninstalling other packages ('--allow-uninstall') or to
+       downgrade already installed packages ('--allow-downgrade').
+
+key::
+       TODO
+
+'provides [FEATURE]'::
+       Shows a list of packages that provide a certain feature.
+
+'requires [FEATURE]'::
+       This shows a list of all packages that require a certain feature.
+       The operating is basically the opposite of 'provides'.
+
+'remove [--keep-dependencies] PACKAGE [PACKAGE ...]'::
+       Uninstalls the given package and all dependencies that are no longer needed.
+       Those can be kept using the '--keep-dependencies' switch.
+
+'repolist'::
+       Shows information about all available repositories and their configuration.
+
+'search PATTERN'::
+       Searches for packages that match PATTERN. Globbing can be used.
+
+'sync [--keep-orphaned]'::
+       Synchronises the local system with the upstream repositories.
+       All packages will be updated to their latest version and orphaned packages will be
+       uninstalled. '--keep-orphaned' disables this behaviour.
+
+'update [--exclude PATTERN|-x PATTERN] [--allow-uninstall] [--allow-downgrade] [PACKAGE ...]'::
+       Updates all installed packages to their latest versions.
+       If packages are passed, only those and their dependencies will be updated.
+       +
+       Using '--exclude' or '-x' allows excluding one or more packages that won't be
+       updated.
+       +
+       See 'install' on '--allow-uninstall' and '--allow-downgrade'.
 
 == BUG REPORTS
 Please report all bugs to the bugtracker at https://bugzilla.ipfire.org/;