Checklink: syntax for command-line arguments for suppressing warnings

This email is about a checklink patch that adds new flags for suppressing
warnings.  The flags are useful to prevent the checklink output from
becoming cluttered with known problems.  There is unanimous support for
this patch, but we need to decide the syntax of the command-line flag
arguments.  Let's consider the --suppress-fragment command-line flag.

One possibility for the syntax is to use an embedded "#" character:

  --suppress-fragment http://foo.com/bar.html#baz

Another possibility is to use an embedded space character:

  --suppress-fragment http://foo.com/bar.html\ baz
or
  --suppress-fragment "http://foo.com/bar.html baz"

The first possibility has the advantage of being identical to the URI that
is causing the problem, namely "http://foo.com/bar.html#baz".  This form
will look familiar even to users may not know the term "fragment".  This
syntax also makes it easy to use cut-and-paste to check this URI.  (For
instance, if the URI is no longer broken, the command-line argument is not
necessary; a user may wish to check that by hand periodically and then
adjust the command-line arguments.)

The second possibility has the advantage of using a consistent separator
everywhere.  In particular, the --masquerade command-line argument takes a
single argument that is a string with an embedded space that separates a
directory name from a URI.

Thoughts?

                    -Mike

Received on Saturday, 4 April 2009 04:04:35 UTC