{"thread":{"id":"16949","subject":"[PATCH] Documentation/gitcli.txt: dashed forms not allowed anymore","startedAt":"2009-01-01T04:39:39Z","lastAt":"2009-01-01T21:00:39Z","messageCount":3,"participants":["jidanni@jidanni.org","Miklos Vajna","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"99077","messageId":"87ljtvmygk.fsf@jidanni.org","threadId":"16949","inReplyTo":null,"subject":"[PATCH] Documentation/gitcli.txt: dashed forms not allowed anymore","fromName":"","fromEmail":"jidanni@jidanni.org","sentAt":"2009-01-01T04:39:39Z","receivedAt":"2009-01-01T04:39:39Z","isPatch":true,"sender":{"key":"jidanni@jidanni.org","avatar":"https://gravatar.com/avatar/36568d4af4c8d3e71627ef3b8c8d00e39065b12f29676cccd38ced75e68fa2a6?d=mp&s=160"},"body":"Non dashed command forms now mandatory.\n\nSigned-off-by: jidanni <jidanni@jidanni.org>\n---\n Documentation/gitcli.txt |    4 ++--\n 1 files changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/gitcli.txt b/Documentation/gitcli.txt\nindex 29e5929..9f582f6 100644\n--- a/Documentation/gitcli.txt\n+++ b/Documentation/gitcli.txt\n@@ -45,8 +45,8 @@ disambiguating `\\--` at appropriate places.\n Here are the rules regarding the \"flags\" that you should follow when you are\n scripting git:\n \n- * it's preferred to use the non dashed form of git commands, which means that\n-   you should prefer `\"git foo\"` to `\"git-foo\"`.\n+ * it's required to use the non dashed form of git commands, which means that\n+   you must use `\"git foo\"` and not `\"git-foo\"`. The latter no longer works.\n \n  * splitting short options to separate words (prefer `\"git foo -a -b\"`\n    to `\"git foo -ab\"`, the latter may not even work).\n-- \n1.6.0.6\n"},{"id":"99083","messageId":"20090101144045.GC21154@genesis.frugalware.org","threadId":"16949","inReplyTo":"87ljtvmygk.fsf@jidanni.org","subject":"Re: [PATCH] Documentation/gitcli.txt: dashed forms not allowed anymore","fromName":"Miklos Vajna","fromEmail":"vmiklos@frugalware.org","sentAt":"2009-01-01T14:40:45Z","receivedAt":"2009-01-01T14:40:45Z","isPatch":true,"sender":{"key":"vmiklos@frugalware.org","avatar":"https://gravatar.com/avatar/401c1cbbb3a5d13e650c691a2c71d6fd0b80df1a01bc74d9f1972675dd58f2bd?d=mp&s=160"},"body":"On Thu, Jan 01, 2009 at 12:39:39PM +0800, jidanni@jidanni.org wrote:\n> - * it's preferred to use the non dashed form of git commands, which means that\n> -   you should prefer `\"git foo\"` to `\"git-foo\"`.\n> + * it's required to use the non dashed form of git commands, which means that\n> +   you must use `\"git foo\"` and not `\"git-foo\"`. The latter no longer works.\n\nI would append: \"unless you add the output of `git --exec-path` to your\nPATH.\"\n"},{"id":"99110","messageId":"7vabaaivwo.fsf@gitster.siamese.dyndns.org","threadId":"16949","inReplyTo":"20090101144045.GC21154@genesis.frugalware.org","subject":"Re: [PATCH] Documentation/gitcli.txt: dashed forms not allowed anymore","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2009-01-01T21:00:39Z","receivedAt":"2009-01-01T21:00:39Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Miklos Vajna <vmiklos@frugalware.org> writes:\n\n> On Thu, Jan 01, 2009 at 12:39:39PM +0800, jidanni@jidanni.org wrote:\n>> - * it's preferred to use the non dashed form of git commands, which means that\n>> -   you should prefer `\"git foo\"` to `\"git-foo\"`.\n>> + * it's required to use the non dashed form of git commands, which means that\n>> +   you must use `\"git foo\"` and not `\"git-foo\"`. The latter no longer works.\n>\n> I would append: \"unless you add the output of `git --exec-path` to your\n> PATH.\"\n\nI actually wouldn't.\n\nThere needs to be a description about use of PATH=$(git --exec-path):$PATH\nif you choose to use the dashed forms in your script.  Don't we already\nhave that elsewhere more basic in the documentation set?\n\nThe quoted part of the documentation talks about the syntax and convention\nused while scripting, and what it wants to say with the sentence is that\nthe dashless form is preferred, even with PATH=$(git --exec-path):$PATH\n(iow, it was preferred before 1.6.0, and it still is preferred with the\n$PATH adjustments after 1.6.0).\n\nI think it muddies the point of the list if you talk about the necessity\nof $PATH adjustment, which is a irrelevant detail.\n"}]}