summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAllan McRae <allan@archlinux.org>2013-10-15 22:20:43 +1000
committerAllan McRae <allan@archlinux.org>2013-10-31 16:20:02 +1000
commitd4ba5bdda6595db83babbac1c59fac129fcaff24 (patch)
tree6dc8412ed470c8f1a3c6912a1f0fa8d0fad2f03d
parentd63313efe1502f97757028f55876f8accd9d9fe2 (diff)
downloadpacman-d4ba5bdda6595db83babbac1c59fac129fcaff24.tar.xz
repo-add.8: Provide example usage
Detail the current standard of generating two databases - with and without the file list. Signed-off-by: Allan McRae <allan@archlinux.org>
-rw-r--r--doc/repo-add.8.txt13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/repo-add.8.txt b/doc/repo-add.8.txt
index e51fadf6..d44a8a7e 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]