[pacman-dev] [PATCH] repo-add.8: Provide example usage

Allan McRae allan at archlinux.org
Tue Oct 15 08:21:45 EDT 2013

Detail the current standard of generating two databases - with and
without the file list.

Signed-off-by: Allan McRae <allan at archlinux.org>
 doc/repo-add.8.txt | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/repo-add.8.txt b/doc/repo-add.8.txt
index e51fadf..d44a8a7 100644
--- a/doc/repo-add.8.txt
+++ b/doc/repo-add.8.txt
@@ -82,6 +82,19 @@ repo-add Options
 	Remove old package files from the disk when updating their entry in the
+'repo-add' is often invoked twice to create two separate databases; a smaller
+database used by pacman and a large database containing package file lists for
+use by other utilities.
+'repo-add' foo.db.tar.xz <pkg1> [<pkg2> ...]
+'repo-add' -f foo.files.tar.xz <pkg1> [<pkg2> ...]
+While pacman can use the large database (if given a db.tar* extension), there
+is currently no additional benefit for the larger download.
 See Also
 linkman:makepkg[8], linkman:pacman[8], linkman:pkgdelta[8]

More information about the pacman-dev mailing list