-# This file is intended to be zero maintenance, that's why it relies
-# on the Makefile (and specifically on the nmhdist target). If you
-# really want to start with rpmbuild from a clean distribution, look
-# at the rpm target in the main Makefile.in to see what it does.
+# 1) Start from an nmh workspace, run configure as desired and then "make rpm".
+# For example:
+# $ git clone git://git.savannah.nongnu.org/nmh.git
+# $ cd nmh
+# $ ./autogen.sh
+# $ ./configure --with-cyrus-sasl --with-locking=fcntl && make rpm
+#
+# 2) Start with a source RPM and use rpmbuild. Configure options are hard
+# coded below, but they can be overridden on the rpmbuild command line
+# with --define 'configure_opts --opt=value [...]'.
+# For example:
+# $ rpm -i nmh-1.4-0.fc16.src.rpm
+# $ rpmbuild --rmsource --rmspec \
+# --define 'configure_opts --with-cyrus-sasl --with-locking=fcntl' \
+# --bb ~/lib/rpmbuild/SPECS/nmh.spec
+#
+# If configure has previously been run successfully in the workspace,
+# it will not be invoked again, even if configure_opts is defined.
+#
+# Note that "make rpm" sets _sysconfdir. If configuring to install
+# anyplace other than the default _sysconfdir, typically /etc, and
+# you're not using this through "make rpm", be sure to set _sysconfdir.
+#
+# With kernel (fcntl, flock, or lockf) locking, or with dot locking
+# and a lockdir that's writable by the user, bin/inc does not need to
+# be setgid. This spec assumes that. But if needed, add something
+# like this to the %files section to make bin/inc setgid:
+# %attr(2755,-,mail) /usr/local/nmh/bin/inc