Man page revision time

Spruce up the asciidoc formatting, fix a few issues that we had. Formatting
now looks pretty good in both the manpage output and the XHTML output.

Also added some options that we have changed since 3.0, and a few wording
updates, etc.

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

1 files changed, 41 insertions, 25 deletions

diff --git a/doc/makepkg.8.txt b/doc/makepkg.8.txt
index 622423c9..02d29f32 100644
--- a/doc/makepkg.8.txt
+++ b/doc/makepkg.8.txt
@@ -25,91 +25,107 @@ The advantage to a script-based build is that the work is only done once. Once
 you have the build script for a package, makepkg will do the rest: download and
 validate source files, check dependencies, configure the build-time settings,
 build the package, install the package into a temporary root, make
-customizations, generate meta-info, and package the whole thing up for pacman to
-use.
+customizations, generate meta-info, and package the whole thing up for pacman
+to use.
 
-makeworld can be used to rebuild an entire package group or the entire build tree.
-See `makeworld --help` for syntax.
+makeworld can be used to rebuild an entire package group or the entire build
+tree. See `makeworld \--help` for syntax.
 
 Options
 -------
-*-b, --builddeps*::
+*-A, \--ignorearch*::
+	Ignore a missing or incomplete arch field in the build script. This is
+	for rebuilding packages from source when the PKGBUILD may be slightly
+	outdated and not updated with an `$$arch=('yourarch')$$` field.
+
+*-b, \--builddeps*::
 	Build missing dependencies from source. When makepkg finds missing
 	build-time or run-time dependencies, it will look for the dependencies'
 	PKGBUILD files under ABSROOT (set in makepkg.conf). If it finds them it
 	will call makepkg to build and install the missing dependencies. The
 	child calls will be made with the `-b` and `-i` options.
 
-*-c, --clean*::
+*-c, \--clean*::
 	Clean up leftover work files and directories after a successful build.
 
-*-C, --cleancache*::
+*-C, \--cleancache*::
 	Removes all cached source files from the directory specified in SRCDEST
 	in manlink:makepkg.conf[5].
 
-*-d, --nodeps*::
+*-d, \--nodeps*::
 	Do not perform any dependency checks. This will let you override and
 	ignore any dependencies required. There is a good chance this option
 	will break the build process if all of the dependencies are not
 	installed.
 
-*-e, --noextract*::
+*-e, \--noextract*::
 	Do not extract source files; use whatever source already exists in the
 	src/ directory. This is handy if you want to go into src and manually
 	patch or tweak code, then make a package out of the result. Keep in mind
 	that creating a patch may be a better solution to allow others to use
 	your PKGBUILD.
 
-*-f, --force*::
+*-f, \--force*::
 	makepkg will not build a package if a built package already exists in
 	the PKGDEST (set in manlink:makepkg.conf[5]) directory, which may
 	default to the current directory. This allows the built package to be
 	overwritten.
 
-*-g, --geninteg*::
+*-g, \--geninteg*::
 	For each source file in the source array of PKGBUILD, download the file
 	if required and generate integrity checks. The integrity checks
 	generated are determined by the value of the INTEGRITY_CHECK array in
 	manlink:makepkg.conf[5]. This output can be redirected into your
 	PKGBUILD for source validation (`makepkg -g >> PKGBUILD`).
 
-*-h, --help*::
+*-h, \--help*::
 	Output syntax and command line options.
 
-*-i, --install*::
-	Install or upgrade the package after a successful build using pacman.
+*-i, \--install*::
+	Install or upgrade the package after a successful build using
+	manlink:pacman[8].
 
-*-m, --nocolor*::
+*-m, \--nocolor*::
 	Disable color in output messages.
 
-*-o, --nobuild*::
+*-o, \--nobuild*::
 	Download and extract files only, but do not build them. Useful with the
-	`--noextract` option if you wish to tweak the files in src/ before
+	`\--noextract` option if you wish to tweak the files in src/ before
 	building.
 
-*-p* <'buildscript'>::
-	Read the package script buildscript instead of the default,
+*-p* <`buildscript`>::
+	Read the package script `buildscript` instead of the default, see
 	manlink:PKGBUILD[5].
 
-*-r, --rmdeps*::
+*-r, \--rmdeps*::
 	Upon successful build, remove any dependencies installed by makepkg
 	during dependency auto-resolution (using `-b` or `-s`).
 
-*-R, --repackage*::
+*-R, \--repackage*::
 	Repackage contents of pkg/ without rebuilding the package. This is
 	useful if you forgot a depend or install file in your PKGBUILD and the
 	build itself will not change.
 
-*-s, --syncdeps*::
+*-s, \--syncdeps*::
 	Install missing dependencies using pacman. When missing build-time or
 	run-time dependencies are found, pacman will try to resolve them. If
 	successful, the missing packages will be downloaded and installed.
 
-*--noconfirm*::
+*\--asroot*::
+	Allow makepkg to run as root. This is for security purposes as it is
+	normally dangerous to do so. This will also disable use of fakeroot and
+	sudo.
+
+*\--source*::
+	Do not actually build the package, but build a source-only tarball. This
+	is useful for passing a single tarball to another program such as a
+	chroot, remote builder, or an AUR upload.
+
+*\--noconfirm*::
 	(Passed to pacman) Prevent pacman from waiting for user input before
 	proceeding with operations.
 
-*--noprogressbar*::
+*\--noprogressbar*::
 	(Passed to pacman) Prevent pacman from displaying a progress bar;
 	useful if you are redirecting makepkg output to file.
 
@@ -117,7 +133,7 @@ Options
 Configuration
 -------------
 See manlink:makepkg.conf[5] for more details on configuring makepkg using the
-makepkg.conf file.
+'makepkg.conf' file.
 
 
 See Also