From 11efe492ac916774d146106a3e321468264ff53b Mon Sep 17 00:00:00 2001
From: Tzafrir Cohen <tzafrir@debian.org>
Date: Mon, 29 Dec 2014 11:56:53 +0200
Subject: hyphen/minus issues in man pages

A '-' in groff translates to a hyphen. For a minus sign, you should use
'-'. Otherwise you may get odd results when copying commands from man
pages.
---
 docs/mock.1      | 72 ++++++++++++++++++++++++++++----------------------------
 docs/mockchain.1 | 10 ++++----
 2 files changed, 41 insertions(+), 41 deletions(-)

diff --git a/docs/mock.1 b/docs/mock.1
index e55dcfa..b499b50 100644
--- a/docs/mock.1
+++ b/docs/mock.1
@@ -6,7 +6,7 @@ mock \- build SRPMs in a chroot
 .LP
 mock  [options] \fB\-\-rebuild\fR \fISRPM [\fISRPM...\fR]
 .LP
-mock  [options] \fB\-\-buildsrpm\fR {--spec \fIspec\fR --sources \fIsrc\fR --symlink-dereference | --scm-enable}
+mock  [options] \fB\-\-buildsrpm\fR {\-\-spec \fIspec\fR \-\-sources \fIsrc\fR \-\-symlink\-dereference | \-\-scm\-enable}
 .LP
 mock  [options] \fB\-\-chroot\fR \fI<cmd>\fR
 .LP
@@ -71,7 +71,7 @@ To use mock, a user should become a member of the \fBmock\fR group by
 adding their username to the \fBmock\fR line in /etc/group. This can
 be done with the following command:
 .P
-        \fBsudo /usr/sbin/usermod -a -G mock $USER\fR
+        \fBsudo /usr/sbin/usermod \-a \-G mock $USER\fR
 
 Note that mock is not intended to be run directly as root.
 
@@ -88,16 +88,16 @@ Completely remove the specified chroot or cache dir or all of the chroot and cac
 Initialize a chroot (clean, install chroot packages, etc.)
 .TP
 \fB\-\-rebuild\fP
-If no command is specified, rebuild is assumed. Rebuilds the specified SRPM(s). The buildroot is cleaned first, unless --no-clean is specified.
+If no command is specified, rebuild is assumed. Rebuilds the specified SRPM(s). The buildroot is cleaned first, unless \-\-no\-clean is specified.
 .TP
 \fB\-\-buildsrpm\fP
-Builds the specified SRPM either from a spec file and source file/directory or from SCM. The buildroot is cleaned first, unless --no-clean is specified.
+Builds the specified SRPM either from a spec file and source file/directory or from SCM. The buildroot is cleaned first, unless \-\-no\-clean is specified.
 .TP
 \fB\-\-sources\fR\fISOURCES\fP
-Specifies sources (either a single file or a directory of files) to use to build an SRPM (used only with --buildsrpm).
+Specifies sources (either a single file or a directory of files) to use to build an SRPM (used only with \-\-buildsrpm).
 .TP
 \fB\-\-spec\fR\fISPEC\fP
-Specifies spec file to use to build an SRPM (used only with --buildsrpm).
+Specifies spec file to use to build an SRPM (used only with \-\-buildsrpm).
 .TP
 \fB\-\-shell\fP
 Run the specified command interactively within the chroot (no 'clean' is performed). If no command specified, /bin/sh is run.
@@ -108,7 +108,7 @@ Run the specified command non-interactively within the chroot (no 'clean' is per
 \fB\-\-installdeps\fP 
 Find out deps for SRPM or RPM, and do a yum install to put them in the buildroot. No 'clean' is performed
 .TP
-\fB-i\fR, \fB\-\-install\fP
+\fB\-i\fR, \fB\-\-install\fP
 Do a yum install PACKAGE inside the buildroot. No 'clean' is performed
 .TP
 \fB\-\-update\fP 
@@ -117,7 +117,7 @@ Do a yum update inside the buildroot. No 'clean' is performed
 \fB\-\-remove\fP 
 Do a yum remove PACKAGE inside the buildroot. No 'clean' is performed
 .TP
-\fB-p\fR, \fB\-\-print-root-path\fP
+\fB\-p\fR, \fB\-\-print\-root\-path\fP
 Prints a path to the currently used buildroot directory.
 .TP
 \fB\-\-orphanskill\fP
@@ -131,11 +131,11 @@ the specified destination path.
 Copies the source paths (files or directory trees) from the chroot to
 the specified destination path. 
 .TP
-\fB\-\-scm-enable\fP
+\fB\-\-scm\-enable\fP
 Enable building from an SCM (CVS/Git/SVN). The SCM repository must be
-configured in site-defaults.cfg before SCM checkouts are possible. SCM
-package and branch can be defined with \fB\-\-scm-option\fP arguments,
-see site-defaults.cfg for more information.
+configured in site\-defaults.cfg before SCM checkouts are possible. SCM
+package and branch can be defined with \fB\-\-scm\-option\fP arguments,
+see site\-defaults.cfg for more information.
 .TP
 \fB\-\-snapshot\fP
 Make a snapshot of the current state of the buildroot. That snapshot will be set
@@ -143,17 +143,17 @@ as the current base to which \fV\-\-clean\fP and implicit clean happening during
 rebuild command will return.
 This feature is available only when lvm_root plugin is installed and enabled.
 .TP
-\fB-l\fR, \fB\-\-list-snapshots\fP
+\fB\-l\fR, \fB\-\-list\-snapshots\fP
 List all existing snapshots of the buildroot belonging to current configuration.
 Current base snapshot is marked with an asterisk (\fB*\fR)
 .TP
-\fB\-\-rollback-to\fP
+\fB\-\-rollback\-to\fP
 Return buildroot to the state in specified snapshot and set it as the current
 base to which clean actions will return. It won't delete nor modify the snapshot
 that was set as base previously.
 This feature is available only when lvm_root plugin is installed and enabled.
 .TP
-\fB\-\-remove-snapshot\fP
+\fB\-\-remove\-snapshot\fP
 Remove given snapshot freeing the space it occupied. This action cannot be
 undone.
 This feature is available only when lvm_root plugin is installed and enabled.
@@ -166,14 +166,14 @@ that might have been a LVM volume or TMPFS.
 Umount all everything mounted in the buildroot path including the root itself
 that might have been a LVM volume or TMPFS.
 .TP
-\fB\-\-pm-cmd\fP
+\fB\-\-pm\-cmd\fP
 Execute following arguments with current package manager with installroot set to
 the buildroot path.
 .TP
-\fB\-\-yum-cmd\fP
+\fB\-\-yum\-cmd\fP
 Execute following arguments with yum with installroot set to the buildroot path.
 .TP
-\fB\-\-dnf-cmd\fP
+\fB\-\-dnf\-cmd\fP
 Execute following arguments with DNF with installroot set to the buildroot path.
 DNF must be installed on the system.
 
@@ -191,7 +191,7 @@ config linked to by /etc/mock/default.cfg.
 \fB\-\-offline\fR
 Run in 'offline' mode where we tell 'yum' to run completely from local cache. Also disables cache expiry for the mock yum cache.
 .TP
-\fB-n\fR, \fB\-\-no\-clean\fR
+\fB\-n\fR, \fB\-\-no\-clean\fR
 Do not clean chroot before building package.
 .TP
 \fB\-\-cleanup\-after\fR
@@ -201,10 +201,10 @@ Clean chroot after building. Use with \-\-resultdir. Only active for '\-\-rebuil
 Don't clean chroot after building. If automatic cleanup is enabled, use this to disable.
 .TP
 \fB\-\-cache\-alterations\fR
-Rebuild the root cache after making alterations to the chroot (i.e. --install). Only useful when using tmpfs plugin.
+Rebuild the root cache after making alterations to the chroot (i.e. \-\-install). Only useful when using tmpfs plugin.
 .TP
 \fB\-\-target=\fR\fIARCH\fP
-This argument is passed to rpmbuild to specify the target arch to build. It defaults to whatever is specified for --arch, or whatever is specified in the config file as config_opts['target_arch'].
+This argument is passed to rpmbuild to specify the target arch to build. It defaults to whatever is specified for \-\-arch, or whatever is specified in the config file as config_opts['target_arch'].
 .TP
 \fB\-\-arch=\fR\fIARCH\fP
 Calls the linux personality() syscall to tell the kernel to emulate a secondary architecture. For example, building i386 packages on an x86_64 buildhost.
@@ -227,11 +227,11 @@ Disable configure OPTION for build.  This option may be used multiple times.  Fo
 
 \fB\-\-without=anchovies\fR
 .TP
-\fB\-\-old-chroot\fR
+\fB\-\-old\-chroot\fR
 use old chroot instead of systemd-nspawn.
 .TP
-\fB\-\-new-chroot\fR
-use new chroot (systemd-nspawn) - this is experimental and will break existing scripts.
+\fB\-\-new\-chroot\fR
+use new chroot (systemd\-nspawn) - this is experimental and will break existing scripts.
 .TP
 \fB\-\-resultdir=\fR\fIRESULTDIR\fP
 Change directory where resulting files (RPMs and build logs) are written. Resultdir can contain python-string substitutions for any variable in the chroot config. For example:
@@ -248,10 +248,10 @@ Change directory where config files are found
 Fail build if rpmbuild takes longer than 'timeout' seconds
 .TP
 \fB\-\-unpriv\fR
-Drop privileges before running command when using --chroot
+Drop privileges before running command when using \-\-chroot
 .TP
 \fB\-\-cwd=\fR\fIDIR\fP
-Change to the specified directory (relative to the chroot) before running command when using --chroot
+Change to the specified directory (relative to the chroot) before running command when using \-\-chroot
 .TP
 \fB\-q\fR, \fB\-\-quiet\fR
 Be quiet.
@@ -268,7 +268,7 @@ Enable the specified plugin.  This option may be used multiple times.
 \fB\-\-disable\-plugin=\fR\fIPLUGIN\fP
 Disable the specified plugin.  This option may be used multiple times.
 .TP
-\fB\-\-plugin-option \fR\fIPLUGIN\fR\fB:\fR\fIKEY\fR\fB=\fR\fIVALUE\fP
+\fB\-\-plugin\-option \fR\fIPLUGIN\fR\fB:\fR\fIKEY\fR\fB=\fR\fIVALUE\fP
 Set plugin specific parameter. This option may be used multiple times.
 .TP
 \fB\-\-yum\fR
@@ -285,13 +285,13 @@ It can be specified multiple times.
 Pass \fB\-\-disablerepo\fR option to package manager to disable a repository.
 It can be specified multiple times.
 .TP
-\fB\-\-short-circuit=\fR\fISTAGE\fR
+\fB\-\-short\-circuit=\fR\fISTAGE\fR
 Use rpmbuild's short-circuit mechanism to skip already executed stages of build.
 It doesn't produce RPMs, it's useful only for debugging packaging. Implies
-\fI\-\-no-clean\fR. STAGE specifies which stage will be executed as the first.
+\fI\-\-no\-clean\fR. STAGE specifies which stage will be executed as the first.
 Available values: prep, build, install, binary.
 .TP
-\fB\-\-rpmbuild-opts=OPTIONS\fR
+\fB\-\-rpmbuild\-opts=OPTIONS\fR
 Pass additional options to rpmbuild. To pass more options, put them in quotes.
 .TP
 \fB\-h\fR, \fB\-\-help\fR
@@ -304,10 +304,10 @@ Show version number and exit.
 define an SCM option (may be used more than once).
 .TP
 \fB\-\-nocheck\fR
-Pass --nocheck to rpmbuild to skip 'make check' tests.
+Pass \-\-nocheck to rpmbuild to skip 'make check' tests.
 .TP
-\fB\-\-symlink-dereference\fR
-Follow symlinks in sources (used only with --buildsrpm).
+\fB\-\-symlink\-dereference\fR
+Follow symlinks in sources (used only with \-\-buildsrpm).
 
 .SH "FILES"
 .LP
@@ -319,7 +319,7 @@ Follow symlinks in sources (used only with --buildsrpm).
 To rebuild test.src.rpm using the Fedora 14 configuration for x86_64
 .LP
 .RS 5
-\fBmock -r fedora-14-x86_64 --rebuild /path/to/test.src.rpm
+\fBmock \-r fedora\-14\-x86_64 \-\-rebuild /path/to/test.src.rpm
 .RE
 .LP
 Note that the available configurations are found in the /etc/mock
@@ -329,13 +329,13 @@ filename without the trailing .cfg extension.
 To place the output RPMs and logs in a specified location.
 .LP
 .RS 5
-\fBmock \-r fedora\-14\-i386 --resultdir=./my-results /path/to/your.src.rpm\fR
+\fBmock \-r fedora\-14\-i386 \-\-resultdir=./my\-results /path/to/your.src.rpm\fR
 .RE
 .LP
 To build a package from the default SCM repository configured in site-defaults.cfg use the following arguments.
 .LP
 .RS 5
-\fBmock \-r fedora\-14\-i386 --scm-enable --scm-option package=pkg\fR
+\fBmock \-r fedora\-14\-i386 \-\-scm-enable \-\-scm\-option package=pkg\fR
 .RE
 .SH "BUGS"
 .LP
diff --git a/docs/mockchain.1 b/docs/mockchain.1
index 7f164e0..ab9d2b0 100644
--- a/docs/mockchain.1
+++ b/docs/mockchain.1
@@ -1,9 +1,9 @@
 .\" mockchain
 .TH "mockchain" "1" "" "Seth Vidal" ""
 .SH "NAME"
-mockchain - chain package builder.
+mockchain \- chain package builder.
 .SH "SYNOPSIS"
-\fBmockchain\fP -r chroot_config [options]  [package...]
+\fBmockchain\fP \-r chroot_config [options]  [package...]
 .SH "DESCRIPTION"
 .PP
 \fBmockchain\fP builds a series of srpms in mock one at a time. After each 
@@ -14,7 +14,7 @@ repo which are available to the next package to satisfy buildreqs.
 This does not try to sort the packages by build order b/c that is too much 
 effort and not obviously doable with the buildreq information we have.
 .PP
-The build process when you use -l is idempotent so a package which has 
+The build process when you use \-l is idempotent so a package which has 
 already been successfully built will not be built again.
 .PP
 If you want to force the rebuild of a package which has been built 
@@ -44,7 +44,7 @@ log to the file named by this option, defaults to not
 logging
 
 .TP
-\fB\-m\fR OPTION, \fB\-\-mock-option\fR=\fIOPTION\fR
+\fB\-m\fR OPTION, \fB\-\-mock\-option\fR=\fIOPTION\fR
 pass the OPTION to mock. Can be used several times. For example:
 
 \fB\-m \-\-define="packager Monkey"\fR
@@ -57,7 +57,7 @@ chroot config name to use in the mock build
 \fB\-\-recurse\fR
 build all pkgs, record the failures and try to rebuild them
 again and again until everything gets built (or until the 
-set of pkgs failing to build are the same over) sets --continue
+set of pkgs failing to build are the same over) sets \-\-continue
 
 .SH "AUTHORS"
 Seth Vidal <skvidal@fedoraproject.org>
-- 
2.1.4

