doc: Consistency and formatting cleanups

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

2 files changed, 9 insertions, 9 deletions

diff --git a/doc/makepkg.conf.5.txt b/doc/makepkg.conf.5.txt
index b5398af7..9fd52e64 100644
--- a/doc/makepkg.conf.5.txt
+++ b/doc/makepkg.conf.5.txt
@@ -112,10 +112,10 @@ Options
 
 	*docs*;;
 		Save doc and info directories. If you wish to delete doc and info
-		directories, specify `!docs' in the array.
+		directories, specify `!docs` in the array.
 
 	*libtool*;;
-		Leave libtool (.la) files in packages. Specify `!libtool' to remove
+		Leave libtool (.la) files in packages. Specify `!libtool` to remove
 		them.
 
 	*emptydirs*;;
@@ -130,13 +130,13 @@ Options
 	`md5`, `sha1`, `sha256`, `sha384`, and `sha512`.
 
 **DOC_DIRS=(**usr/{,share/}{info,doc} ...**)**::
-	If "!docs" is specified in the OPTIONS array, this variable will
+	If `!docs` is specified in the OPTIONS array, this variable will
 	instruct makepkg where to look to remove docs. If you build packages
 	that are located in opt/, you may need to add the directory to this
 	array. *NOTE:* Do not add the leading slash to the directory name.
 
 **STRIP_DIRS=(**bin lib sbin usr/{bin,lib} ...**)**::
-	If "strip" is specified in the OPTIONS array, this variable will
+	If `strip` is specified in the OPTIONS array, this variable will
 	instruct makepkg where to look to for files to strip. If you build
 	packages that are located in opt/, you may need to add the directory
 	to this array. *NOTE:* Do not add the leading slash to the directory
@@ -153,7 +153,7 @@ Options
 	in the current directory. Many people like to keep all source files in
 	a central location for easy cleanup, so this path can be set here.
 
-**PACKAGER=**"John Doe <john@doe.com>"::
+**PACKAGER=**"John Doe <john@example.com>"::
 	This value is used when querying a package to see who was the builder.
 	It is recommended you change this to your name and email address.
 
diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 6f071bac..c5748724 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -22,8 +22,8 @@ hooks, and the ability to sync your local machine with a remote ftp server to
 automatically upgrade packages. Pacman packages are a zipped tar format.
 
 Since version 3.0.0, pacman has been the frontend to linkman:libalpm[3], the
-"Arch Linux Package Management" library. This library allows alternative front
-ends to be written (for instance, a GUI front end).
+``Arch Linux Package Management'' library. This library allows alternative
+front ends to be written (for instance, a GUI front end).
 
 
 Operations
@@ -73,7 +73,7 @@ to determine which packages need upgrading. This behavior operates as follows:
 
 *-U, \--upgrade*::
 	Upgrade or add a package to the system. Either a URL or file path can be
-	specified. This is a "remove-then-add" process. See <<HCF,Handling Config
+	specified. This is a ``remove-then-add'' process. See <<HCF,Handling Config
 	Files>> for an explanation on how pacman takes care of config files.
 
 *-V, \--version*::
@@ -141,7 +141,7 @@ Options
 	the installation root setting.
 
 *\--noconfirm*::
-	Bypass any and all "Are you sure?" messages. It's not a good idea to do
+	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.
 
 *\--noprogressbar*::