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

ensured force option was still documented in PKGBUILD.5.

TODO.dan

@@ -93,3 +93,10 @@ Refine makepkg error codes. Each kind of failure could have its own code:
   --failed integ checks
   --failed build
   --etc.
+
+Add utility function to either frontend or backend to convert sizes: e.g. bytes
+to KB, MB, GB.
+
+Revamp the downloadprog function a bit. Seems kind of messy.
+
+Add localized pkgdesc variables to makepkg.

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

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