xbps/bin/xbps-repo/xbps-repo.8.txt
Juan RP 4502155554 xbps-repo: explain in the manpage that outdated package files will
be removed automatically for the 'genindex' target.

--HG--
extra : convert_revision : xtraeme%40gmail.com-20091124031605-q9yaklspw504ordq
2009-11-24 03:16:05 +00:00

99 lines
2.8 KiB
Plaintext

XBPS-REPO(8)
===========
NAME
----
xbps-repo - XBPS command for binary package repositories
SYNOPSYS
--------
*xbps-repo* ['options'] 'target' ['arguments']
DESCRIPTION
-----------
The xbps-repo(1) command is used to handle local or remote binary
package repositories in the *XBPS binary package system*.
You can use it to create a package index for a local repository,
add or remove local and remote repositories, search for packages
and show information about a binary package in repository pool.
OPTIONS
-------
*-r* 'rootdir'::
Sets the 'root' directory. By default the root directory is
set to '/'. Please note that the database directory is always
set to '/var/db/xbps' independently of 'rootdir'. So if you
use a 'rootdir' of '/blah', metadata stuff will go into
'/blah/var/db/xbps'.
*-V*::
Shows the current XBPS release version (library and code).
TARGETS
-------
Please note that all targets are *case insensitive*.
*add* 'URI'::
Adds a repository as specified in 'URI' to the repository pool.
Local (by specifying a *directory*) and remote (by specifiying an
*HTTP/HTTPS/FTP URL*) repositories can be specified.
*genindex* '/path/to/local/repo'::
Generates a package index for a local repository as specified in
its argument. It will look for archives with *.xbps* extension
and will only add it into the index if version is newer than the one
available in the index. If a newer package is available, the file
for old package will be removed automatically.
The same argument should be used for the *add* and *remove* targets.
*list*::
Lists all currently registered repositories in repository pool.
*remove* 'URI'::
Removes a repository from repository pool as specified by the
'URI' argument. You have to use the same 'URI' that was used
in the *add* target.
*search* 'pattern'::
Search for packages containing the shell 'pattern' (see fnmatch(3)) in
its *pkgname* or *description* values.
*show 'pkgname'*::
Shows information about binary package 'pkgname'. This will print
the size it takes in filesystem, description, maintainer, architecture
and other information.
*sync*::
Syncs the package index file for all registered remote repositories.
The new file will be fetched if local and remote size/mtime do not match.
BUGS
----
Probably, but I try to make this not happen. Use it under your own
responsability and enjoy your life.
Report bugs in '<https://bugs.launchpad.net/xbps>'.
SEE ALSO
--------
*xbps-bin(8)*, *xbps-src(8)*
XBPS utilities: '<https://launchpad.net/xbps>'
To build binary packages, the xbps-src(8) shell script is the command
designed for this task. This must be retrieved from a GIT repository,
available at '<http://repo.or.cz/w/xbps.git>'.
AUTHORS
-------
The *XBPS binary package system* has been designed and implemented by
Juan Romero Pardines <xtraeme@gmail.com>.