{"thread":{"id":"35027","subject":"[PATCH] RelNotes/1.8.5: direct script writers to \"git status --porcelain\"","startedAt":"2013-09-26T13:23:35Z","lastAt":"2013-09-28T00:08:53Z","messageCount":5,"participants":["Matthieu Moy","Jakub Narebski","Keshav Kini","Jonathan Nieder"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"228276","messageId":"1380201815-14140-1-git-send-email-Matthieu.Moy@imag.fr","threadId":"35027","inReplyTo":null,"subject":"[PATCH] RelNotes/1.8.5: direct script writers to \"git status --porcelain\"","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2013-09-26T13:23:35Z","receivedAt":"2013-09-26T13:23:35Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"Signed-off-by: Matthieu Moy \n---\n\nNot terribly important, but the old item alone may sound like \"we\nbroke your script purposely, good luck with the new version\" to a\nscript writer.\n\n Documentation/RelNotes/1.8.5.txt | 3 +++\n 1 file changed, 3 insertions(+)\n\ndiff --git a/Documentation/RelNotes/1.8.5.txt b/Documentation/RelNotes/1.8.5.txt\nindex ac5c3fa..f100a0f 100644\n--- a/Documentation/RelNotes/1.8.5.txt\n+++ b/Documentation/RelNotes/1.8.5.txt\n@@ -96,6 +96,9 @@ UI, Workflows & Features\n \n * \"git status\" now omits the prefix to make its output a comment in a\n commit log editor, which is not necessary for human consumption.\n+ Scripts that parse the output of \"git status\" are advised to use\n+ \"git status --porcelain\", which is both easier to parse and stable,\n+ instead.\n \n * Make \"foo^{tag}\" to peel a tag to itself, i.e. no-op., and fail if\n \"foo\" is not a tag. \"git rev-parse --verify v1.0^{tag}\" would be\n-- \n1.8.4.474.g128a96c\n"},{"id":"228282","messageId":"loom.20130926T201754-563@post.gmane.org","threadId":"35027","inReplyTo":"1380201815-14140-1-git-send-email-Matthieu.Moy@imag.fr","subject":"Re: [PATCH] RelNotes/1.8.5: direct script writers to \"git status --porcelain\"","fromName":"Jakub Narebski","fromEmail":"jnareb@gmail.com","sentAt":"2013-09-26T18:19:35Z","receivedAt":"2013-09-26T18:19:35Z","isPatch":true,"sender":{"key":"jnareb@gmail.com","avatar":"https://avatars.githubusercontent.com/u/2706?v=4"},"body":"Matthieu Moy imag.fr> writes:\n\n\n> * \"git status\" now omits the prefix to make its output a comment in a\n> commit log editor, which is not necessary for human consumption.\n> + Scripts that parse the output of \"git status\" are advised to use\n> + \"git status --porcelain\", which is both easier to parse and stable,\n> + instead.\n\nGood addition.\n\nPerhaps \"to use instead ...\" would be easier to understand than\nproposed \"to use ..., instead.\" (with \"...\" being one line long).\n\n-- \nJakub Narebski.\n"},{"id":"228302","messageId":"1380220420-27064-1-git-send-email-Matthieu.Moy@imag.fr","threadId":"35027","inReplyTo":"loom.20130926T201754-563@post.gmane.org","subject":"[PATCH v2] RelNotes/1.8.5: direct script writers to \"git status --porcelain\"","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@imag.fr","sentAt":"2013-09-26T18:33:40Z","receivedAt":"2013-09-26T18:33:40Z","isPatch":true,"sender":{"key":"git@matthieu-moy.fr","avatar":"https://avatars.githubusercontent.com/u/14709?v=4"},"body":"Signed-off-by: Matthieu Moy \n---\nJakub Narebski writes:\n\n> Perhaps \"to use instead ...\" would be easier to understand than\n> proposed \"to use ..., instead.\" (with \"...\" being one line long).\n\nActually, I had the version below staged, but forgot to \"commit\n--amend\" before sending. Should be clear enough.\n\n Documentation/RelNotes/1.8.5.txt | 3 +++\n 1 file changed, 3 insertions(+)\n\ndiff --git a/Documentation/RelNotes/1.8.5.txt b/Documentation/RelNotes/1.8.5.txt\nindex ac5c3fa..e295266 100644\n--- a/Documentation/RelNotes/1.8.5.txt\n+++ b/Documentation/RelNotes/1.8.5.txt\n@@ -96,6 +96,9 @@ UI, Workflows & Features\n \n * \"git status\" now omits the prefix to make its output a comment in a\n commit log editor, which is not necessary for human consumption.\n+ Scripts that parse the output of \"git status\" are advised to use\n+ \"git status --porcelain\" instead. Its format is both easier to\n+ parse and stable.\n \n * Make \"foo^{tag}\" to peel a tag to itself, i.e. no-op., and fail if\n \"foo\" is not a tag. \"git rev-parse --verify v1.0^{tag}\" would be\n-- \n1.8.4.474.g128a96c\n"},{"id":"228290","messageId":"87y56jl3bz.fsf@gmail.com","threadId":"35027","inReplyTo":"loom.20130926T201754-563@post.gmane.org","subject":"Re: [PATCH] RelNotes/1.8.5: direct script writers to \"git status --porcelain\"","fromName":"Keshav Kini","fromEmail":"keshav.kini@gmail.com","sentAt":"2013-09-26T20:45:20Z","receivedAt":"2013-09-26T20:45:20Z","isPatch":true,"sender":{"key":"keshav.kini@gmail.com","avatar":"https://avatars.githubusercontent.com/u/691290?v=4"},"body":"Jakub Narebski writes:\n> Matthieu Moy imag.fr> writes:\n>> * \"git status\" now omits the prefix to make its output a comment in a\n>> commit log editor, which is not necessary for human consumption.\n>> + Scripts that parse the output of \"git status\" are advised to use\n>> + \"git status --porcelain\", which is both easier to parse and stable,\n>> + instead.\n>\n> Good addition.\n>\n> Perhaps \"to use instead ...\" would be easier to understand than\n> proposed \"to use ..., instead.\" (with \"...\" being one line long).\n\nFWIW, I find \"to use instead ___\" slightly stilted. I'd suggest \"to\ninstead use\", but rewording it to the following is much better, IMHO:\n'... are advised to use \"git status --porcelain\" instead, as it is both\nstable and easier to parse.'\n\n-Keshav\n"},{"id":"228338","messageId":"20130928000853.GQ9464@google.com","threadId":"35027","inReplyTo":"87y56jl3bz.fsf@gmail.com","subject":"Re: [PATCH] RelNotes/1.8.5: direct script writers to \"git status --porcelain\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-09-28T00:08:53Z","receivedAt":"2013-09-28T00:08:53Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Keshav Kini wrote:\n> Jakub Narebski writes:\n>> Matthieu Moy writes:\n\n>>> * \"git status\" now omits the prefix to make its output a comment in a\n>>> commit log editor, which is not necessary for human consumption.\n>>> + Scripts that parse the output of \"git status\" are advised to use\n>>> + \"git status --porcelain\", which is both easier to parse and stable,\n>>> + instead.\n>>\n>> Good addition.\n[...]\n> rewording it to the following is much better, IMHO:\n> '... are advised to use \"git status --porcelain\" instead, as it is both\n> stable and easier to parse.'\n\nThanks, all.\n"}]}