From 35f468fa55c0e86d6e7ff10f1e693d1a0b3995b2 Mon Sep 17 00:00:00 2001
From: Juan RP <xtraeme@gmail.com>
Date: Sat, 3 Nov 2012 11:18:10 +0100
Subject: [PATCH] xbps-reconfigure: added a manual page.

---
 bin/xbps-reconfigure/Makefile           |  3 +-
 bin/xbps-reconfigure/xbps-reconfigure.8 | 64 +++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 2 deletions(-)
 create mode 100644 bin/xbps-reconfigure/xbps-reconfigure.8

diff --git a/bin/xbps-reconfigure/Makefile b/bin/xbps-reconfigure/Makefile
index 3887b17f..3f50d931 100644
--- a/bin/xbps-reconfigure/Makefile
+++ b/bin/xbps-reconfigure/Makefile
@@ -2,7 +2,6 @@ TOPDIR = ../..
 -include $(TOPDIR)/config.mk
 
 BIN =	xbps-reconfigure
-OBJS =	main.o
-#MAN = $(BIN).8
+MAN =	$(BIN).8
 
 include $(TOPDIR)/mk/prog.mk
diff --git a/bin/xbps-reconfigure/xbps-reconfigure.8 b/bin/xbps-reconfigure/xbps-reconfigure.8
new file mode 100644
index 00000000..7637a174
--- /dev/null
+++ b/bin/xbps-reconfigure/xbps-reconfigure.8
@@ -0,0 +1,64 @@
+.Dd November 3, 2012
+.Os Void GNU/Linux
+.Dt xbps-reconfigure 8
+.Sh NAME
+.Nm xbps-reconfigure
+.Nd XBPS utility to configure installed packages
+.Sh SYNOPSYS
+.Nm xbps-reconfigure
+.Op OPTIONS
+.Op PKGNAME...
+.Sh DESCRIPTION
+The
+.Nm
+command configures packages in target root directory. Configuration
+involves two steps:
+.Pp
+.Sy *
+Executes the
+.Sy post-install
+action on its
+.Sy INSTALL
+script.
+.Pp
+.Sy *
+Changes package state to
+.Sy XBPS_PKG_STATE_INSTALLED
+if previous step ran successfully.
+.Pp
+Only packages that weren't configured previously will be processed,
+unless the
+.Ar -f
+option is specified.
+.Sh OPTIONS
+.Bl -tag -width xxxxxxxxxxxxxxxxxxxxxxx
+.It Fl a, -all
+Configures all packages.
+.It Fl C, -config Ar file
+Specifies a full path to the XBPS configuration file.
+.It Fl d, -debug
+Enables extra debugging shown to stderr.
+.It Fl f, -force
+Forcefully reconfigure package even if it was configured previously.
+.It Fl h, -help
+Show the help usage.
+.It Fl r, -rootdir Ar dir
+Specifies a full path for the target root directory.
+.It Fl v, -verbose
+Enables verbose messages.
+.It Fl V, -version
+Shows the XBPS version.
+.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-remove 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.