diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt
index 9db10576..22c56be3 100644
--- a/doc/PKGBUILD.5.txt
+++ b/doc/PKGBUILD.5.txt
@@ -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
diff --git a/doc/repo-add.8.txt b/doc/repo-add.8.txt
index d3b85762..b9956e9b 100644
--- a/doc/repo-add.8.txt
+++ b/doc/repo-add.8.txt
@@ -16,9 +16,9 @@ repo-add - package database maintenance utility
 
 Synopsis
 --------
-repo-add [-q] <path-to-db> <package> ...
+repo-add [-q] <path-to-db> <package1> [<package2> ...]
 
-repo-remove [-q] <path-to-db> <packagename> ...
+repo-remove [-q] <path-to-db> <packagename> [<packagename2> ...]
 
 
 Description