From ae56a32273df8a36f4e84e0f37ce1f34e84f15a3 Mon Sep 17 00:00:00 2001 From: Gordian Edenhofer Date: Sun, 4 Sep 2016 18:14:06 +0200 Subject: bacman: add manual page Signed-off-by: Gordian Edenhofer Signed-off-by: Allan McRae --- contrib/doc/bacman.8.txt | 67 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 contrib/doc/bacman.8.txt (limited to 'contrib/doc/bacman.8.txt') diff --git a/contrib/doc/bacman.8.txt b/contrib/doc/bacman.8.txt new file mode 100644 index 00000000..dc5af481 --- /dev/null +++ b/contrib/doc/bacman.8.txt @@ -0,0 +1,67 @@ +///// +vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us: +///// +bacman(8) +========== + +Name +---- +bacman - recreate installed packages + + +Synopsis +-------- +'bacman' [options] + + +Description +----------- +'bacman' was designed to reassemble installed packages using pacman's database +and system files. +It is useful for regenerating an installed package that you are unable to +download that is also not available in your package cache. + +'bacman' honors packaging settings from linkman:makepkg.conf[8]. + + +Options +------- +*-h, \--help*:: + Display usage information. + +*-q, \--quiet*:: + Silence most of the status reporting. + +*-m, \--nocolor*:: + Disable colored output. + +*-o, \--out *:: + Write the assembled package(s) to the specified directory. + +*\--pacnew*:: + Package `.pacnew` files if available instead of the (possibly modified) + versions in place on the filesystem. + + +Examples +-------- + +The following are example usages of the 'bacman' utility: + +$ bacman linux-headers:: + Recreate the package ``linux-headers''. + +$ bacman gzip make binutils -o ~/packages:: + Assemble the packages ``gzip'', ``make'', and ``binutils'' and place + the packages in the ``~/packages'' directory. + +$ bacman --nocolor --pacnew -o ~/backup $(pacman -Qq):: + Assemble all currently installed packages using ``.pacnew'' whenever + available, suppress colored output and place the desired packages in + the ``~/backup''. directory + +See Also +-------- +linkman:makepkg[8], linkman:pacman[8] + +include::footer.txt[] -- cgit v1.2.3-24-g4f1b