Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/doc/repo-add.8.asciidoc
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz@archlinux.org>2018-05-03 00:10:21 -0400
committerAllan McRae <allan@archlinux.org>2018-05-14 09:59:17 +1000
commit076b6184de2b20e9b26225d93f6f3a7030504109 (patch)
treeca0e375b9fd89d6b6ce40026b732985c4b335841 /doc/repo-add.8.asciidoc
parent860e4c4943ad062bd0eff99f28e7d64804b3c08e (diff)
Ensure better text editor automatic filetype detection
Since we no longer use vim-specific modelines, use the .asciidoc file extension which is, well, reserved for asciidoc formatted files. This should presumably work everywhere without needing editor-specific workarounds and configuration. Also add a shebang to makepkg.conf to indicate it contains bash content. Signed-off-by: Eli Schwartz <eschwartz@archlinux.org> Signed-off-by: Allan McRae <allan@archlinux.org>
Diffstat (limited to 'doc/repo-add.8.asciidoc')
-rw-r--r--doc/repo-add.8.asciidoc94
1 files changed, 94 insertions, 0 deletions
diff --git a/doc/repo-add.8.asciidoc b/doc/repo-add.8.asciidoc
new file mode 100644
index 00000000..945fff75
--- /dev/null
+++ b/doc/repo-add.8.asciidoc
@@ -0,0 +1,94 @@
+repo-add(8)
+==========
+
+Name
+----
+repo-add - package database maintenance utility
+
+
+Synopsis
+--------
+'repo-add' [options] <path-to-db> <package|delta> [<package|delta> ...]
+
+'repo-remove' [options] <path-to-db> <packagename|delta> [<packagename|delta> ...]
+
+
+Description
+-----------
+'repo-add' and 'repo-remove' are two scripts to help build a package database for
+packages built with linkman:makepkg[8] and installed with linkman:pacman[8].
+They also handle package deltas produced by linkman:pkgdelta[8].
+
+'repo-add' will update a package database by reading a built package or package
+delta file. Multiple packages and/or deltas to add can be specified on the
+command line.
+
+If a matching ``.sig'' file is found alongside a package file, the signature
+will automatically be embedded into the database.
+
+'repo-remove' will update a package database by removing the package name or
+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'' 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
+--------------
+*-q, \--quiet*::
+ Force this program to keep quiet and run silently except for warning and
+ error messages.
+
+*-s, \--sign*::
+ Generate a PGP signature file using GnuPG. This will execute `gpg
+ --detach-sign --use-agent` on the generated database to generate a detached
+ signature file, using the GPG agent if it is available. The signature file
+ will be the entire filename of the database with a ``.sig'' extension.
+
+*-k, \--key* <key>::
+ Specify a key to use when signing packages. Can also be specified using
+ the GPGKEY environmental variable. If not specified in either location, the
+ default key from the keyring will be used.
+
+*-v, \--verify*::
+ Verify the PGP signature of the database before updating the database.
+ If the signature is invalid, an error is produced and the update does not
+ proceed.
+
+*\--nocolor*::
+ Remove color from 'repo-add' and 'repo-remove' output.
+
+
+repo-add Options
+----------------
+*-d, \--delta*::
+ 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.
+
+*-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.
+
+*-R, \--remove*::
+ Remove old package files from the disk when updating their entry in the
+ database.
+
+
+Example
+-------
+'repo-add' foo.db.tar.xz <pkg1> [<pkg2> ...]
+
+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
+--------
+linkman:makepkg[8], linkman:pacman[8], linkman:pkgdelta[8]
+
+include::footer.asciidoc[]