Man pages, man pages, man pages. Just a few more additions and clarifications,

ensured force option was still documented in PKGBUILD.5.

2 files changed, 36 insertions, 14 deletions

diff --git a/doc/PKGBUILD.5 b/doc/PKGBUILD.5
index 8e07e4e1..00ee8f7b 100644
--- a/doc/PKGBUILD.5
+++ b/doc/PKGBUILD.5
@@ -144,12 +144,34 @@ though the package has moved.
 
 .TP
 .B options \fI(array)\fP
-This array allows you to override some of \fBmakepkg\fP's default behavior
-when building packages. To set an option, just include the option name
-in the \fBoptions\fP array.
-See
-.BR makepkg (8)
-for details on the options array.
+This array allows you to override some of \fBmakepkg\fP's default behavior when
+building packages. To set an option, just include the option name in the
+\fBoptions\fP array. To reverse the default behavior, place an "!" at the front
+of the option. Only specify the options you specifically want to override, the
+rest will be taken from \fBmakepkg.conf\fP. NOTE: 'force' is a special option
+only used in \fB\*(PB\fPs, do not use it unless you know what you are doing.
+.RS
+.TP
+.B strip
+Strip symbols from binaries and libraries. If you frequently use a debugger on
+programs or libraries, it may be helpful to disable this option.
+.TP
+.B docs
+Save doc and info directories. If you wish to delete doc and info directories,
+specify "!docs" in the array.
+.TP
+.B libtool
+Leave libtool (.la) files in packages. Specify "!libtool" to remove them.
+.TP
+.B emptydirs
+Leave empty directories in packages.
+.TP
+.B force
+Force the package to be upgraded by a \fBpacman\fP system upgrade operation,
+even if the version number would normally not trigger such an upgrade. This is
+useful when the version numbering scheme of a package changes (or is
+alphanumeric).
+.RE
 
 .SH INSTALL/UPGRADE/REMOVE SCRIPTING
 \fBPacman\fP has the ability to store and execute a package-specific script
diff --git a/doc/makepkg.conf.5 b/doc/makepkg.conf.5
index f5714c21..3c6a2980 100644
--- a/doc/makepkg.conf.5
+++ b/doc/makepkg.conf.5
@@ -55,17 +55,17 @@ enable or disable an option simply remove or place an "!" at the front of the
 option. Each works as follows:
 .RS
 .TP
-fakeroot
+.B fakeroot
 Allow building packages as a non-root user. This is \fIhighly\fP recommended.
 .TP
-distcc
+.B distcc
 Use the distributed C/C++/ObjC compiler to spread compilation among multiple
 machines. If this is enabled, \fBDISTCC_HOSTS\fP must be specified as well.
 .TP
-color
+.B color
 Colorize output messages, making output easier to read.
 .TP
-ccache
+.B ccache
 Use ccache to cache compilation by default. This allows for faster compiles if
 you are continuously recompiling the same packages. It can be disabled for
 individual packages by passing the \fB-B\fP or \fB--noccache\fP flag to
@@ -85,18 +85,18 @@ disable an option simply remove or place an "!" at the front of the option.
 Each works as follows:
 .RS
 .TP
-strip
+.B strip
 Strip symbols from binaries and libraries. If you frequently use a debugger on
 programs or libraries, it may be helpful to disable this option.
 .TP
-docs
+.B docs
 Save doc and info directories. If you wish to delete doc and info directories,
 specify "!docs" in the array.
 .TP
-libtool
+.B libtool
 Leave libtool (.la) files in packages. Specify "!libtool" to remove them.
 .TP
-emptydirs
+.B emptydirs
 Leave empty directories in packages.
 .RE
 .TP