Remove everything resembling a comment from "refuse" and put the

explanations into a new file "refuse.README".  Some users are simply
copying these files and expecting them to work -- without even
reading them.  I don't want to spend any more time closing bogus
PRs from that.

Also correct an error or two in the patterns.

2 files changed, 49 insertions, 35 deletions

diff --git a/share/examples/cvsup/refuse b/share/examples/cvsup/refuse
index 4bb44f3..d638ed3 100644
--- a/share/examples/cvsup/refuse
+++ b/share/examples/cvsup/refuse
@@ -1,35 +1,8 @@
-# $FreeBSD$
-#
-#This is an example "refuse file".  CVSup will not touch anything listed
-#in the refuse file.
-#
-#You can copy this file to your sup directory and uncomment or add
-#whatever you would like.  If you are using the default setting for the
-#CVSup "base" directory, your sup directory is /usr/sup.  If you have
-#changed your base directory, your sup directory is /path/to/base/sup.
-#
-#NOTE:  CVSup currently does not understand comments (lines beginning
-#with a `#' character) in refuse files, so please remember to remove all
-#such comments if you intend to use this file as a starting point for
-#creating your own refuse file.
-#
-#Use this example if you have modified /usr/src/etc/sendmail/freebsd.mc
-#to reflect your local configuration, and you do not want CVSup to
-#overwrite it:
-#
-#etc/sendmail/freebsd.mc
-#
-#If you list a directory, changes to any files beneath that directory
-#will be rejected.  For example, if you are an English speaker and are
-#not tracking the foreign-language ports, you can uncomment the following.
-#
-#ports/chinese
-#ports/german
-#ports/hebrew
-#ports/japanese
-#ports/korean
-#ports/russian
-#ports/vietnamese
-#
-#Use this feature with care -- many parts of the src distribution depend
-#on files in completely different parts.
+src/etc/sendmail/freebsd.mc*
+ports/chinese
+ports/german
+ports/hebrew
+ports/japanese
+ports/korean
+ports/russian
+ports/vietnamese
diff --git a/share/examples/cvsup/refuse.README b/share/examples/cvsup/refuse.README
new file mode 100644
index 0000000..71735cd
--- /dev/null
+++ b/share/examples/cvsup/refuse.README
@@ -0,0 +1,41 @@
+$FreeBSD$
+
+This describes the "refuse" file found in this directory.  The
+explanation cannot be put inside the file itself because:
+
+    COMMENTS ARE NOT ALLOWED IN refuse FILES!
+
+Each line of the refuse file contains one or more filename patterns
+separated by white space.  Everything matched by a pattern will be
+left untouched by CVSup.  If a pattern matches a directory, then
+everything beneath that directory will be left alone.
+
+You can copy "refuse" to your sup directory and add or remove
+whatever you like.  The example supfiles in this directory set
+CVSup's base directory to "/usr".  The sup directory is in the base
+directory; i.e., it is "/usr/sup".  If you have changed your base
+directory, your sup directory is /path/to/base/sup.
+
+Use the following pattern if you have modified
+/usr/src/etc/sendmail/freebsd.mc to reflect your local configuration,
+and you do not want CVSup to overwrite it:
+
+    src/etc/sendmail/freebsd.mc*
+
+If you are an English speaker and don't wish to receive the
+foreign-language ports, use the following patterns:
+
+    ports/chinese
+    ports/german
+    ports/hebrew
+    ports/japanese
+    ports/korean
+    ports/russian
+    ports/vietnamese
+
+Use refuse files with care.  Some parts of the src distribution
+depend on files in completely different parts.
+
+For more information about refuse files see cvsup(1), which is
+installed by the "cvsup" and "cvsup-bin" ports.  See also the CVSup
+FAQ at <http://www.polstra.com/projects/freeware/CVSup/>.