Rebased on master. Pointing to selective builds in d/configure

Author: smoe

debian/configure

@@ -196,3 +196,10 @@ fi
 
 rm -f ../build-stamp
 echo "successfully configured for '$DISTRIB_NAME'.."
+
+echo "I: You can now start the build of LinuxCNC Debian packages."
+echo "   To build and test everything: fakeroot debian/rules binary"
+echo "   To build the executables and man pages only: fakeroot debian/rules binary-arch"
+echo "   To avoid tests: DEB_BUILD_OPTIONS=nocheck debian/rules binary"
+echo "   To avoid documentation: DEB_BUILD_OPTIONS=nodocs fakeroot debian/rules binary"
+echo "   The DEB_BUILD_OPTIONS environment variable also works with dpkg-buildpackage."

debian/rules.in

@@ -131,6 +131,9 @@ ifeq (,$(filter nodocs,$(DEB_BUILD_OPTIONS)))
 		$(RM) debian/tmp/usr/share/doc/linuxcnc/LinuxCNC_*_$$l.pdf; \
 	done
 	$(RM) debian/tmp/usr/share/doc/linuxcnc/*_es.adoc
+else
+	# Avoiding error message because of examples
+	$(RM) -fr debian/tmp/usr/share/doc/
 endif
 
 override_dh_compress: