{"thread":{"id":"13148","subject":"Man pages lack of exit status information","startedAt":"2008-04-17T07:45:09Z","lastAt":"2008-04-17T17:38:12Z","messageCount":4,"participants":["Francis Moreau","Wincent Colaiuta","David Mansfield"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"74620","messageId":"38b2ab8a0804170045xa542274pa9f1e434f428b1cd@mail.gmail.com","threadId":"13148","inReplyTo":null,"subject":"Man pages lack of exit status information","fromName":"Francis Moreau","fromEmail":"francis.moro@gmail.com","sentAt":"2008-04-17T07:45:09Z","receivedAt":"2008-04-17T07:45:09Z","isPatch":false,"sender":{"key":"francis.moro@gmail.com","avatar":null},"body":"Hello,\n\nI checked on a couple of git commands' man pages and I couldn't find\nthe exit status of these commands.\n\nFor example: git-status, git-diff man pages don't tell anything.\n\nAm I missing something ?\n\nThanks\n-- \nFrancis\n"},{"id":"74621","messageId":"BE732D9B-D2C2-4578-BC9D-52473C37EA74@wincent.com","threadId":"13148","inReplyTo":"38b2ab8a0804170045xa542274pa9f1e434f428b1cd@mail.gmail.com","subject":"Re: Man pages lack of exit status information","fromName":"Wincent Colaiuta","fromEmail":"win@wincent.com","sentAt":"2008-04-17T08:17:28Z","receivedAt":"2008-04-17T08:17:28Z","isPatch":false,"sender":{"key":"greg@hurrell.net","avatar":"https://avatars.githubusercontent.com/u/7074?v=4"},"body":"El 17/4/2008, a las 9:45, Francis Moreau escribió:\n> Hello,\n>\n> I checked on a couple of git commands' man pages and I couldn't find\n> the exit status of these commands.\n>\n> For example: git-status, git-diff man pages don't tell anything.\n>\n> Am I missing something ?\n\nThe \"git-diff\" man page documents this under the --exit-code option.  \nIt probably would be nice to have an \"EXIT STATUS\" section added to  \nthe man pages of those commands for which it would be interesting  \n(like \"git-diff\") and perhaps to the main \"git\" man page as well (with  \ngeneral info).\n\nIf there is interest in this I'll whip up a doc patch.\n\nCheers,\nWincent\n"},{"id":"74622","messageId":"38b2ab8a0804170138u717fb753me45ead12720c9e3d@mail.gmail.com","threadId":"13148","inReplyTo":"BE732D9B-D2C2-4578-BC9D-52473C37EA74@wincent.com","subject":"Re: Man pages lack of exit status information","fromName":"Francis Moreau","fromEmail":"francis.moro@gmail.com","sentAt":"2008-04-17T08:38:44Z","receivedAt":"2008-04-17T08:38:44Z","isPatch":false,"sender":{"key":"francis.moro@gmail.com","avatar":null},"body":"On Thu, Apr 17, 2008 at 10:17 AM, Wincent Colaiuta <win@wincent.com> wrote:\n> El 17/4/2008, a las 9:45, Francis Moreau escribió:\n> > I checked on a couple of git commands' man pages and I couldn't find\n> > the exit status of these commands.\n> >\n> > For example: git-status, git-diff man pages don't tell anything.\n> >\n> > Am I missing something ?\n> >\n>\n>  The \"git-diff\" man page documents this under the --exit-code option. It\n> probably would be nice to have an \"EXIT STATUS\" section added to the man\n> pages of those commands for which it would be interesting (like \"git-diff\")\n> and perhaps to the main \"git\" man page as well (with general info).\n>\n>  If there is interest in this I'll whip up a doc patch.\n>\n\nI think it makes sense to have such section specially since git plumbings are\nalso designed to be used in higher level scripts.\n\nI really use to searching for RETURN VALUE section in man pages when I need\nwhat a command returns. And it's a pain to have to read the whole man page for\nfinding such important information.\n\nThanks\n-- \nFrancis\n"},{"id":"74652","messageId":"1208453892.16608.44.camel@gandalf.cobite.com","threadId":"13148","inReplyTo":"38b2ab8a0804170138u717fb753me45ead12720c9e3d@mail.gmail.com","subject":"Re: Man pages lack of exit status information","fromName":"David Mansfield","fromEmail":"david@cobite.com","sentAt":"2008-04-17T17:38:12Z","receivedAt":"2008-04-17T17:38:12Z","isPatch":false,"sender":{"key":"david@cobite.com","avatar":null},"body":"\nOn Thu, 2008-04-17 at 10:38 +0200, Francis Moreau wrote:\n> On Thu, Apr 17, 2008 at 10:17 AM, Wincent Colaiuta <win@wincent.com> wrote:\n> > El 17/4/2008, a las 9:45, Francis Moreau escribió:\n> > > I checked on a couple of git commands' man pages and I couldn't find\n> > > the exit status of these commands.\n> > >\n> > > For example: git-status, git-diff man pages don't tell anything.\n> > >\n> > > Am I missing something ?\n> > >\n> >\n> >  The \"git-diff\" man page documents this under the --exit-code option. It\n> > probably would be nice to have an \"EXIT STATUS\" section added to the man\n> > pages of those commands for which it would be interesting (like \"git-diff\")\n> > and perhaps to the main \"git\" man page as well (with general info).\n> >\n> >  If there is interest in this I'll whip up a doc patch.\n> >\n> \n> I think it makes sense to have such section specially since git plumbings are\n> also designed to be used in higher level scripts.\n> \n> I really use to searching for RETURN VALUE section in man pages when I need\n> what a command returns. And it's a pain to have to read the whole man page for\n> finding such important information.\n> \n\n+1 for adding a RETURN VALUE section to the docs.\n\nYes, please!  We need this.  I got burned because git-status does\nsomething which is non-intuitive, and just yesterday I was asking about\ngit-merge, which I can only assume returns (exits) with 1 if there was a\nconflict.\n\nDavid\n"}]}