threads / patch / 22520

patchgit-clean: fix the description of the default behavior

Subject: [PATCH] git-clean: fix the description of the default behavior

## tl;dr

4 messages between Feb 4, 2010 and Feb 5, 2010. Diffs are folded; open one to read it.

replies: 3people: 3as markdown or json

Michael J Gruber· Feb 4, 2010, 16:01 UTC · lore
Currently, when called without -n and -f, git clean issues
fatal: clean.requireForce not set and -n or -f not given; refusing to clean

which leaves the user wondering why force is required when requireForce is not set. Looking up in git-clean(1) does not help because its description is wrong.

Change it so that git clean issues
fatal: clean.requireForce defaults to true and -n or -f not given; refusing to clean

in this situation (and "...set to true..." when it is set) which makes it clearer that an unset config means true here, and adjust the documentation.

Signed-off-by: Michael J Gruber <git@drmicha.warpmail.net>
---
I'd actually suggest changing "and -n or -f not given" to "and neither -n nor -f given"
in addition to the above, but the above is a real fix, whereas the latter is a style
issue, and we're close to release.

In fact, having a variable where unset means true is rather unfortunate, but I don't expect that to be changing.

 Documentation/git-clean.txt |    4 ++--
 builtin-clean.c             |    4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)
Show changes to 2 files +4 −4

Documentation/git-clean.txt, builtin-clean.c

diff --git a/Documentation/git-clean.txt b/Documentation/git-clean.txt
index 335c885..a81cb6c 100644
--- a/Documentation/git-clean.txt
+++ b/Documentation/git-clean.txt
@@ -33,8 +33,8 @@ OPTIONS
 
 -f::
 --force::
-	If the git configuration specifies clean.requireForce as true,
-	'git clean' will refuse to run unless given -f or -n.
+	If the git configuration variable clean.requireForce is not set
+	to false, 'git clean' will refuse to run unless given -f or -n.
 
 -n::
 --dry-run::
diff --git a/builtin-clean.c b/builtin-clean.c
index 3a70fa8..6ad5892 100644
--- a/builtin-clean.c
+++ b/builtin-clean.c
@@ -67,8 +67,8 @@ int cmd_clean(int argc, const char **argv, const char *prefix)
 		die("-x and -X cannot be used together");
 
 	if (!show_only && !force)
-		die("clean.requireForce%s set and -n or -f not given; "
-		    "refusing to clean", config_set ? "" : " not");
+		die("clean.requireForce %s to true and -n or -f not given; "
+		    "refusing to clean", config_set ? "set" : "defaults");
 
 	if (force > 1)
 		rm_flags = 0;
-- 
1.7.0.rc1.199.g9253ab
Jay Soffian· Feb 4, 2010, 21:16 UTC · re: Michael J Gruber · lore

Re: [PATCH] git-clean: fix the description of the default behavior

On Thu, Feb 4, 2010 at 11:01 AM, Michael J Gruber <git@drmicha.warpmail.net> wrote:

> fatal: clean.requireForce defaults to true and -n or -f not given; refusing to clean
Bike shed:

fatal: clean.requireForce defaults to true and neither -n nor -f given; refusing to clean

j.
Michael J Gruber· Feb 5, 2010, 09:06 UTC · re: Jay Soffian · lore

Re: [PATCH] git-clean: fix the description of the default behavior

Jay Soffian venit, vidit, dixit 04.02.2010 22:16:
Show 10 quoted lines
> On Thu, Feb 4, 2010 at 11:01 AM, Michael J Gruber
> <git@drmicha.warpmail.net> wrote:
>> fatal: clean.requireForce defaults to true and -n or -f not given; refusing to clean
> 
> Bike shed:
> 
> fatal: clean.requireForce defaults to true and neither -n nor -f
> given; refusing to clean
> 
> j.

Assuming you're not git-am, you do read between "---" and diff, don't you? ;)

Michael

← back to recent threads