.Dd November 6, 2012
.Os Void Linux
.Dt xbps-remove 8
.Sh NAME
.Nm xbps-remove
.Nd XBPS utility to remove packages
.Sh SYNOPSYS
.Nm xbps-remove
.Op OPTIONS
.Op PKGNAME...
.Sh DESCRIPTION
The
.Nm
utility removes installed packages in the target root directory.
Removing a package involves some steps:
.Pp
.Sy *
Executes the
.Sy pre-remove
action on its
.Sy REMOVE
script.
.Pp
.Sy *
Package files are removed if those have not been modified.
The
.Ar -f
option overrides this behaviour and forcefully removes the files.
.Pp
.Sy *
Executes the
.Sy post-remove
action on its
.Sy REMOVE
script.
.Pp
.Sy *
Changes package state to
.Sy XBPS_PKG_STATE_HALF_REMOVED .
.Pp
.Sy *
Executes the
.Sy purge
action on its
.Sy REMOVE
script.
.Pp
.Sy *
Package metadata files are removed.
.Pp
.Sy *
Package is unregistered from package database.
.Pp
.Sh OPTIONS
.Bl -tag -width -x
.It Fl C, Fl -config Ar file
Specifies a full path to the XBPS configuration file.
.It Fl c, Fl -cachedir Ar dir
Specifies a full path to the cache directory, where binary packages are stored.
.It Fl d, Fl -debug
Enables extra debugging shown to stderr.
.It Fl f, Fl -force
Forcefully remove package files even if they have been modified.
.It Fl h, Fl -help
Show the help usage.
.It Fl i, Fl -ignore-revdeps
Ignore reverse dependencies when removing packages.
.It Fl n, Fl -dry-run
Dry-run mode. Show what actions would be done but don't remove anything.
.It Fl O, Fl -clean-cache
Cleans cache directory removing obsolete binary packages.
.It Fl o, Fl -remove-orphans
Removes installed package orphans that were installed automatically
(as dependencies) and are not currently dependencies of any installed package.
.It Fl p, Fl -print-format Ar fmt
Specifies the
.Xr printf 3
format used by the
.Ar dry-run
mode.
.It Fl R, Fl -recursive
Recursively remove packages that were installed by
.Ar PKGNAME
and aren't required by other installed packages.
.It Fl r, Fl -rootdir Ar dir
Specifies a full path for the target root directory.
.It Fl v, Fl -verbose
Enables verbose messages.
.It Fl y, Fl -yes
Assume yes to all questions and avoid interactive questions.
.It Fl V, Fl -version
Shows the XBPS version.
.Sh FILES
.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
.It Ar /etc/xbps/xbps.conf
Default XBPS configuration file.
.It Ar /var/cache/xbps
Default XBPS cache directory.
.Sh SEE ALSO
.Xr xbps-create 8 ,
.Xr xbps-dgraph 8 ,
.Xr xbps-install 8 ,
.Xr xbps-pkgdb 8 ,
.Xr xbps-query 8 ,
.Xr xbps-reconfigure 8 ,
.Xr xbps-rindex 8
.Sh AUTHORS
.An Juan Romero Pardines <xtraeme@gmail.com>
.Sh BUGS
Probably, but I try to make this not happen. Use it under your own
responsability and enjoy your life.
.Pp
Report bugs in http://code.google.com/p/xbps.