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

[Allan McRae]

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
 	database.
 
+Example
+-------
+
+'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]
-- 
1.8.4