Fix asciidoc formatting warnings and issues

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

3 files changed, 14 insertions, 14 deletions

diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt
index f8ed7f26..e1ea632b 100644
--- a/doc/PKGBUILD.5.txt
+++ b/doc/PKGBUILD.5.txt
@@ -65,19 +65,19 @@ similar to `$_basekernver`.
 	This field specifies the license(s) that apply to the package.
 	Commonly-used licenses are found in '/usr/share/licenses/common'. If you
 	see the package's license there, simply reference it in the license
-	field (e.g. `$$license=('GPL')$$`). If the package provides a license not
+	field (e.g. `license=('GPL')`). If the package provides a license not
 	found in '/usr/share/licenses/common', then you should include the license
-	in the package itself and set `$$license=('custom')$$` or
-	`$$license=('custom:LicenseName')$$`. The license should be placed in
+	in the package itself and set `license=('custom')` or
+	`license=('custom:LicenseName')`. The license should be placed in
 	'$pkgdir/usr/share/licenses/$pkgname' when building the package. If
 	multiple licenses are applicable for a package, list all of them:
-	`$$license=('GPL' 'FDL')$$`.
+	`license=('GPL' 'FDL')`.
 
 *install*::
 	Specifies a special install script that is to be included in the package.
 	This file should reside in the same directory as the PKGBUILD, and will
 	be copied into the package by makepkg. It does not need to be included
-	in the source array (e.g. `$$install=pkgname.install$$`).
+	in the source array (e.g. `install=pkgname.install`).
 
 *source (array)*::
 	An array of source files required to build the package. Source files
@@ -90,7 +90,7 @@ similar to `$_basekernver`.
 +
 It is also possible to specify an optional filename, which is helpful
 with weird URLs and for handling multiple source files with the same
-name. The syntax is: `$$source=('filename::url')$$`
+name. The syntax is: `source=('filename::url')`.
 
 *noextract (array)*::
 	An array of filenames corresponding to those from the source array. Files
@@ -118,7 +118,7 @@ name. The syntax is: `$$source=('filename::url')$$`
 
 *arch (array)*::
 	Defines on which architectures the given package is available (e.g.
-	`$$arch=('i686' 'x86_64')$$`).
+	`arch=('i686' 'x86_64')`).
 
 *backup (array)*::
 	A space-delimited array of filenames, without preceding slashes, that
@@ -238,8 +238,8 @@ use during the build and install process. These three variables are as follows:
 *startdir*::
 	This contains the absolute path to the directory where the PKGBUILD was
 	located, which is usually the output of `$(pwd)` when makepkg is started.
-	$$startdir$$ was most often used in combination with `/src` or `/pkg`
-	postfixes, but use of the `srcdir` and `pkgdir` variables is preferred.
+	`$startdir` was most often used in combination with `/src` or `/pkg`
+	postfixes, but use of the `$srcdir` and `$pkgdir` variables is preferred.
 
 *srcdir*::
 	This points to the directory where makepkg extracts or copies all source
diff --git a/doc/index.txt b/doc/index.txt
index f2e2304a..1040af3a 100644
--- a/doc/index.txt
+++ b/doc/index.txt
@@ -1,7 +1,7 @@
 Pacman Home Page
 ================
 
-A simple library-based package manager
+A simple library-based package manager.
 
 Introduction
 ------------
@@ -16,10 +16,10 @@ automatically and can download packages from a remote server.
 
 History
 ~~~~~~~
-Version 2.0 of pacman introduced the ability to sync packages (the `$$--sync$$`
+Version 2.0 of pacman introduced the ability to sync packages (the `--sync`
 option) with a master server through the use of package databases. Prior to
-this, packages would have to be installed manually using the `$$--add$$` and
-`$$--upgrade$$` operations.
+this, packages would have to be installed manually using the `--add` and
+`--upgrade` operations.
 
 Version 3.0 was the switch to a two-part pacman- a backend named libalpm
 (library for Arch Linux Package Management), and the familiar pacman frontend.
diff --git a/doc/makepkg.8.txt b/doc/makepkg.8.txt
index 4bb37808..fb2e8054 100644
--- a/doc/makepkg.8.txt
+++ b/doc/makepkg.8.txt
@@ -43,7 +43,7 @@ Options
 *-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.
+	outdated and not updated with an `arch=('yourarch')` field.
 
 *-c, \--clean*::
 	Clean up leftover work files and directories after a successful build.