[pacman-dev] [PATCH] update repo-add documentation for removal of -f flag
allan at archlinux.org
Tue Jan 27 12:40:02 UTC 2015
Signed-off-by: Allan McRae <allan at archlinux.org>
doc/repo-add.8.txt | 22 +++++++---------------
1 file changed, 7 insertions(+), 15 deletions(-)
diff --git a/doc/repo-add.8.txt b/doc/repo-add.8.txt
index f096d71..564ee75 100644
@@ -34,9 +34,9 @@ delta specified on the command line. Multiple packages and/or delta to remove
can be specified on the command line.
A package database is a tar file, optionally compressed. Valid extensions are
-``.db'' or ``.files'' followed by an archive extension of ``.tar'',
-``.tar.gz'', ``.tar.bz2'', ``.tar.xz'', or ``.tar.Z''. The file does not need
-to exist, but all parent directories must exist.
+``.db'' followed by an archive extension of ``.tar'', ``.tar.gz'', ``.tar.bz2'',
+``.tar.xz'', or ``.tar.Z''. The file does not need to exist, but all parent
+directories must exist.
@@ -71,11 +71,6 @@ repo-add Options
Automatically generate and add a delta file between the old entry and the
new one, if the old package file is found next to the new one.
- 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.
Only add packages that are not already in the database. Warnings will be
printed upon detection of existing packages, but they will not be re-added.
@@ -87,15 +82,12 @@ repo-add Options
-'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.
+This creates two separate databases; a smaller database ``foo.db.tar.xz'' used by
+pacman and a large database containing package file lists ``foo.files.tar.xz'' for
+use by other utilities. While pacman can use the large database (if renamed with a
+db.tar* extension), there is currently no additional benefit for the larger download.
More information about the pacman-dev