make --help in CVS has been updated with the "recipe" clarification but
still says:

  -n, --just-print, --dry-run, --recon\n\
                              Don't actually run any recipe; just print
them.\n"

I agree that make --help is on particularly dubious ground when saying
"any recipe".  Saying something woolly and referring to the
documentation is one thing, but saying something definitive yet,
strictly speaking, incorrect, with no caveat or reference, is something
else.  We need to be concise, so people can find what they're looking
for, yet we still need to convey the sense of what the switch does.  How
about:

"Don't actually run normal recipes; just print them."

-----Original Message-----
From: bug-make-bounces+mdorey=bluearc....@gnu.org
[mailto:bug-make-bounces+mdorey=bluearc....@gnu.org] On Behalf Of
jida...@jidanni.org
Sent: Thursday, January 01, 2009 12:54
To: guent...@gmail.com
Cc: bug-make@gnu.org
Subject: Re: make --guaranteed-real-dry-run

PG> The GNU make manpage starts with this:
PG> WARNING
OK, but not make --help.

Anyway please change things like
  -n, --just-print, --dry-run, --recon
     Don't actually run any commands; just print them.
To
     Don't actually run any commands usually; just print them.

The exact wording I leave up to you.


_______________________________________________
Bug-make mailing list
Bug-make@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-make


_______________________________________________
Bug-make mailing list
Bug-make@gnu.org
http://lists.gnu.org/mailman/listinfo/bug-make

Reply via email to