Add Synopsis section to man 5 pages.

Signed-off-by: Andrew Fyfe <andrew@neptune-one.net>

doc/Makefile.am

@@ -25,8 +25,9 @@ MOSTLYCLEANFILES = $(man_MANS) man3/*.3 *.xml
 
 ASCIIDOC_OPTS = \
 	-f asciidoc.conf \
-	-apacman_version="$(PACKAGE_VERSION)" \
+	-a pacman_version="$(PACKAGE_VERSION)" \
-	-apacman_date="`date +%Y-%m-%d`"
+	-a pacman_date="`date +%Y-%m-%d`" \
+	-a sysconfdir=$(sysconfdir)
 
 if HAS_DOXYGEN
 all: doxygen.in

doc/PKGBUILD.5.txt

@@ -6,6 +6,11 @@ Name
 PKGBUILD - Arch Linux package build description file
 
 
+Synopsis
+--------
+PKGBUILD
+
+
 Description
 -----------
 This manual page is meant to describe general rules about PKGBUILDs. Once a

doc/makepkg.conf.5.txt

@@ -6,6 +6,11 @@ Name
 makepkg.conf - makepkg configuration file
 
 
+Synopsis
+--------
+{sysconfdir}/makepkg.conf, ~/.makepkg.conf
+
+
 Description
 -----------
 Configuration options for makekpg are stored in makepkg.conf. This file is

doc/pacman.conf.5.txt

@@ -6,6 +6,11 @@ Name
 pacman.conf - pacman package manager configuration file
 
 
+Synopsis
+--------
+{sysconfdir}/pacman.conf
+
+
 Description
 -----------
 Pacman, using manlink:libalpm[3], will attempt to read `pacman.conf` each