[pacman-dev] [PATCH] update repo-add documentation for removal of -f flag
Allan McRae
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
--- a/doc/repo-add.8.txt
+++ b/doc/repo-add.8.txt
@@ -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.
Common Options
@@ -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.
-*-f, \--files*::
- 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.
-
*-n, \--new*::
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
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.
+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.
See Also
--
2.2.2
More information about the pacman-dev
mailing list