--- doc/repo-add.8.txt	2011-10-12 15:04:25.000000000 -0400
+++ doc/repo-add.8.txt	2012-12-03 15:46:23.626873850 -0500
@@ -67,6 +67,13 @@
 	Tells repo-add also to create and include a list of the files in the
 	specified packages. This is useful for creating databases listing all files
 	in a given sync repository for tools that may use this information.
+	
+	Consider invoking repo-add twice in order to minimize pacman db size. The 
+	first invocation should create the datebase and the second should create
+	the corresponding list of files. For example:
+
+	repo-add foo.db.tar.xz ...
+	repo-add -f foo.files.tar.xz ...
 
 See Also
 --------