Documentation updates

Update description of path specifiers for both pacman and pacman.conf in
their respective manpages. Ensure it is obvious that they are absolute and
not relative paths.

Signed-off-by: Dan McGee <dan@archlinux.org>

2 files changed, 31 insertions, 14 deletions

diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 0ee8c6c0..99133dd9 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -79,8 +79,10 @@ Options
 	the package.
 
 *-b, \--dbpath* <'path'>::
-	Specify an alternative database location (default is ``/var/lib/pacman'').
-	This should not be used unless you know what you are doing.
+	Specify an alternative database location (a typical default is
+	``/var/lib/pacman'').  This should not be used unless you know what you are
+	doing. *NOTE*: if specified, this is an absolute path and the root path is
+	not automatically prepended. This behavior changed in pacman 3.1.0.
 
 *-d, \--nodeps*::
 	Skips all dependency checks. Normally, pacman will always check a
@@ -100,16 +102,22 @@ Options
 	temporary mounted partition which is "owned" by another system.
 
 *-v, --verbose*::
-	Output more status messages, such as the Root, DBPath, CacheDir, etc.
+	Output paths such as as the Root, Conf File, DB Path, Cache Dirs, etc.
 
 *\--cachedir* <'dir'>::
-	Specify an alternative package cache location (default is
+	Specify an alternative package cache location (a typical default is
 	``/var/cache/pacman/pkg''). Multiple cache directories can be specified,
-	and they are tried in the order they are passed to pacman.
+	and they are tried in the order they are passed to pacman. *NOTE*: if
+	specified, this is an absolute path and the root path is not automatically
+	prepended. This behavior changed in pacman 3.1.0.
 
 *\--config* <'file'>::
 	Specify an alternate configuration file.
 
+*\--logfile* <'file'>::
+	Specify an alternate log file. This is an absolute path, regardless of
+	the installation root setting.
+
 *\--noconfirm*::
 	Bypass any and all "Are you sure?" messages. It's not a good idea to do
 	this unless you want to run pacman from a script.
diff --git a/doc/pacman.conf.5.txt b/doc/pacman.conf.5.txt
index 958f6f71..f18244d1 100644
--- a/doc/pacman.conf.5.txt
+++ b/doc/pacman.conf.5.txt
@@ -44,21 +44,30 @@ Server = file:///home/pkgs
 Options
 -------
 *RootDir =* path/to/root::
-	Set the default root directory for pacman to install to.
+	Set the default root directory for pacman to install to. This option is
+	used if you want to install a package on a temporary mounted partition
+	which is "owned" by another system, or for a chroot install.
 
 *DBPath =* path/to/db/dir::
-	Overrides the default location of the toplevel database directory.
-	The default is ``/var/lib/pacman/''.
+	Overrides the default location of the toplevel database directory.  A
+	typical default is ``/var/lib/pacman/''. Most users will not need to set
+	this option. *NOTE*: if specified, this is an absolute path and the root
+	path is not automatically prepended. This behavior changed in pacman 3.1.0.
 
 *CacheDir =* path/to/cache/dir::
-	Overrides the default location of the package cache directory. The default
-	is ``/var/cache/pacman/pkg/''. Multiple cache directories can be specified,
-	and they are tried in the order they are listed in the config file. If a
-	file is not found in any cache directory, it will be downloaded to the
-	first cache directory with write access.
+	Overrides the default location of the package cache directory. A typical
+	default is ``/var/cache/pacman/pkg/''. Multiple cache directories can be
+	specified, and they are tried in the order they are listed in the config
+	file. If a file is not found in any cache directory, it will be downloaded
+	to the first cache directory with write access. *NOTE*: if specified, this
+	is an absolute path and the root path is not automatically prepended. This
+	behavior changed in pacman 3.1.0.
+
 
 *LogFile =* '/path/to/file'::
-	Log actions directly to a file. Default is ``/var/log/pacman.log''.
+	Log actions directly to a file. A typical default is
+	``/var/log/pacman.log''. As of pacman 3.1.0, this does not need to be
+	specified by default. This is an absolute path and root is not prepended.
 
 *HoldPkg =* package ...::
 	If a user tries to '\--remove' a package that's listed in `HoldPkg`,