Add a manpage for bm help (thanks to Johnny A. Solbu)

1 files changed, 184 insertions, 0 deletions

diff --git a/man/bm.8 b/man/bm.8
new file mode 100644
index 0000000..692327a
--- /dev/null
+++ b/man/bm.8
@@ -0,0 +1,184 @@
+.\" Text automatically generated by txt2man
+.TH bm 8 "11 september 2015" "" "System Manager's Manual"
+.SH NAME
+\fBbm \fP- rpm package buildmanager
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBbm\fP [\fIoptions\fP] [<rpm dir>] [<spec file>] [<srpm file>]
+
+.fam T
+.fi
+.fam T
+.fi
+.SH DESCRIPTION
+\fBBuildManager\fP, or \fBbm\fP, is an alternative for rpmbuild that wraps and extends RPM while building packages. Its features allow one to batch process thousand of RPMs at once, controlling logs, RPM and SRPM moving, filtering the list of files, ignoring given packages, completely cleaning the build directories, and many other features.
+.SH OPTIONS
+.TP
+.B
+\fB--version\fP
+show program's version number and exit
+.TP
+.B
+\fB-h\fP, \fB--help\fP
+show this help message and exit
+.TP
+.B
+\fB-a\fP
+do everything and build source and binary packages (default)
+.TP
+.B
+\fB-u\fP
+just unpack
+.TP
+.B
+\fB-p\fP
+unpack and run %prep stage
+.TP
+.B
+\fB-c\fP
+unpack, run %prep, and compile
+.TP
+.B
+\fB-i\fP
+unpack, run %prep, compile and install
+.TP
+.B
+\fB-s\fP
+do everything and build source packages
+.TP
+.B
+\fB-b\fP
+do everything and build binary packages
+.TP
+.B
+\fB-l\fP
+show rpm output, besides copying to the log file
+.TP
+.B
+\fB-j\fP N
+specify number of packages to build in parallel
+.TP
+.B
+\fB-o\fP OPT
+pass given parameters directly to rpm
+.TP
+.B
+\fB--unpack-dir\fP=DIR
+specify directory where to unpack \fBfile\fP(s)
+.TP
+.B
+\fB--build-log\fP=FILE
+specify where to put the build log for each package
+.TP
+.B
+\fB--move-srpm\fP=DIR
+move built srpm packages to given directory
+.TP
+.B
+\fB--move-rpm\fP=DIR
+move built rpm packages to given directory
+\fB--move-failed-srpm\fP=DIR
+move original srpm packages to given directory, if failed
+\fB--copy-failed-srpm\fP=DIR
+copy original srpm packages to given directory, if failed
+.TP
+.B
+\fB--remove-failed-srpm\fP
+remove original srpm packages, if failed
+\fB--move-succeeded-srpm\fP=DIR
+move original srpm packages to given directory, if succeeded
+\fB--copy-succeeded-srpm\fP=DIR
+copy original srpm packages to given directory, if succeeded
+\fB--remove-succeeded-srpm\fP
+remove original srpm packages, if succeeded
+.TP
+.B
+\fB--move-log\fP=DIR
+move log files to given directory
+\fB--move-failed-log\fP=DIR
+move log files to given directory, if failed
+.TP
+.B
+\fB--filter-renew\fP=DIR
+don't build packages if a newer version exists in given directory
+.TP
+.B
+\fB--filter-refresh\fP=DIR
+only build packages if an older version exists in given directory
+.TP
+.B
+\fB--clean\fP
+recursively remove directory used as topdir after the build process
+.TP
+.B
+\fB--clean-on-success\fP
+same as \fB--clean\fP, but only remove if build has succeeded
+.TP
+.B
+\fB--ignore\fP=PKGNAME
+ignore given package names (shell globbing allowed)
+.TP
+.B
+\fB--sign\fP
+sign packages using GPG
+.TP
+.B
+\fB--nodeps\fP
+pass this option to rpm
+.TP
+.B
+\fB--debug\fP
+pass this option to rpm
+.TP
+.B
+\fB--short-circuit\fP
+pass this option to rpm
+.TP
+.B
+\fB--with\fP
+pass this option to rpm
+.TP
+.B
+\fB--without\fP
+pass this option to rpm
+.TP
+.B
+\fB--define\fP
+pass this option to rpm
+.TP
+.B
+\fB--target\fP
+pass this option to rpm
+.TP
+.B
+\fB--dryrun\fP
+do not commit changes to the system
+.TP
+.B
+\fB--log\fP=LEVEL
+set logging level to LEVEL (debug, info, warning, error)
+.SH EXAMPLES
+If you are in $HOME/foo which contain SOURCES and SPECS and want to build foo and see the output:
+.PP
+.nf
+.fam C
+    bm -l
+
+.fam T
+.fi
+To build, sign packages using your default GPG key and see the output:
+.PP
+.nf
+.fam C
+    bm -l --sign
+
+.fam T
+.fi
+.SH BUGS
+\fB-u\fP doesn't seem to do anything.
+.SH AUTHOR
+This manpage was created by Johnny A. Solbu <johnny@solbu.net>.
+.SH SEE ALSO
+\fBrpmbuild\fP(8).