[pacman-dev] [PATCH 3/5] Document database checking options

[Allan McRae]

The required adding a Database Option section to the pacman man page
and adding more complete documentation for --asdeps and --asexplicit
as well.

Signed-off-by: Allan McRae <allan at archlinux.org>
---
 doc/pacman.8.txt | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 7443615..3fef08d 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -35,10 +35,10 @@ as an argument, targets will be read from stdin.
 Operations
 ----------
 *-D, \--database*::
-	Modify the package database. This operation allows you to modify certain
-	attributes of the installed packages in pacman's database. At the
-	moment, you can only change the install reason using '\--asdeps' and
-	'\--asexplicit' options.
+	Operate on the package database. This operation allows you to modify
+	certain attributes of the installed packages in pacman's database. It
+	also allows you to check the databases for internal consistency.
+	See <<DO,Database Options>> below.
 
 *-Q, \--query*::
 	Query the package database. This operation allows you to view installed
@@ -431,6 +431,27 @@ system upgrade and install/upgrade the "foo" package in the same operation.
 	to-date.
 
 
+Database Options[[QO]]
+----------------------
+*\--asdeps* <package>::
+	Mark a package as non-explicitly installed; in other words, set their install
+	reason to be installed as a dependency.
+
+*\--asexplicit<package>*::
+	Mark a package as explicitly installed; in other words, set their install
+	reason to be explicitly installed. This is useful it you want to keep a
+	package installed even when it was initially installed as a dependency
+	of another package.
+
+*-k \--check*::
+	Check the local package database is internally consistent. This will
+	check all required files are present and that installed packages have
+	the required dependencies, do not conflict and that multiple packages
+	do not own the same file. Specifying this option twice will perform
+	a check on the sync databases to ensure all specified dependencies
+	are available.
+
+
 Handling Config Files[[HCF]]
 ----------------------------
 Pacman uses the same logic as 'rpm' to determine action against files that are
-- 
2.2.1