From 076b6184de2b20e9b26225d93f6f3a7030504109 Mon Sep 17 00:00:00 2001 From: Eli Schwartz Date: Thu, 3 May 2018 00:10:21 -0400 Subject: 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 Signed-off-by: Allan McRae --- doc/repo-add.8.asciidoc | 94 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 doc/repo-add.8.asciidoc (limited to 'doc/repo-add.8.asciidoc') 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] [ ...] + +'repo-remove' [options] [ ...] + + +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* :: + 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 [ ...] + +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[] -- cgit v1.2.3-54-g00ecf