{"thread":{"id":"35707","subject":"Anomalous AUTHOR and DOCUMENTATION sections in manpages","startedAt":"2014-01-22T11:22:23Z","lastAt":"2014-01-22T21:41:49Z","messageCount":8,"participants":["Michael Haggerty","Duy Nguyen","Johan Herland","Johannes Schindelin","Junio C Hamano","Shawn Pearce","Ilari Liusvaara"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"233505","messageId":"52DFA9EF.4080309@alum.mit.edu","threadId":"35707","inReplyTo":null,"subject":"Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Michael Haggerty","fromEmail":"mhagger@alum.mit.edu","sentAt":"2014-01-22T11:22:23Z","receivedAt":"2014-01-22T11:22:23Z","isPatch":false,"sender":{"key":"mhagger@alum.mit.edu","avatar":"https://avatars.githubusercontent.com/u/119718?v=4"},"body":"I just noticed that there are exactly four Git manpages with an \"AUTHOR\"\nsection and five with a \"DOCUMENTATION\" section:\n\n    $ make doc\n    $ grep -nIE -e '^\\.SH \"DOCUMENTATION|AUTHOR\"' Documentation/*.[0-9]\n    Documentation/git-column.1:80:.SH \"AUTHOR\"\n    Documentation/git-for-each-ref.1:272:.SH \"AUTHOR\"\n    Documentation/git-for-each-ref.1:275:.SH \"DOCUMENTATION\"\n    Documentation/git-http-backend.1:404:.SH \"AUTHOR\"\n    Documentation/git-http-backend.1:407:.SH \"DOCUMENTATION\"\n    Documentation/git-notes.1:395:.SH \"AUTHOR\"\n    Documentation/git-notes.1:398:.SH \"DOCUMENTATION\"\n    Documentation/git-remote-ext.1:133:.SH \"DOCUMENTATION\"\n    Documentation/git-remote-fd.1:71:.SH \"DOCUMENTATION\"\n\nThese sections are inconsistent with the other manpages and seem\nsuperfluous in a project that has, on the one hand, a public history\nand, on the other hand, hundreds of contributors.  Would the mentioned\nauthors (CCed) consent to the removal of these sections?\n\nI don't want to step on any feet here.  If you want to keep these\nsections, I have no objection.  But my guess is that people added them\nin these few instances without realizing that these sections are not\ncommonly used in Git documentation.\n\nMichael\n\n-- \nMichael Haggerty\nmhagger@alum.mit.edu\nhttp://softwareswirl.blogspot.com/\n"},{"id":"233507","messageId":"CACsJy8AEU2dQPNknazRxEh12MNd=3Kw3+_tc3meS_Bs961ERkA@mail.gmail.com","threadId":"35707","inReplyTo":"52DFA9EF.4080309@alum.mit.edu","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Duy Nguyen","fromEmail":"pclouds@gmail.com","sentAt":"2014-01-22T11:39:52Z","receivedAt":"2014-01-22T11:39:52Z","isPatch":false,"sender":{"key":"pclouds@gmail.com","avatar":"https://avatars.githubusercontent.com/u/720?v=4"},"body":"On Wed, Jan 22, 2014 at 6:22 PM, Michael Haggerty <mhagger@alum.mit.edu> wrote:\n> These sections are inconsistent with the other manpages and seem\n> superfluous in a project that has, on the one hand, a public history\n> and, on the other hand, hundreds of contributors.  Would the mentioned\n> authors (CCed) consent to the removal of these sections?\n\nNo problem from me.\n-- \nDuy\n"},{"id":"233508","messageId":"CALKQrgdvgxAW50-YdKTd-fo7r6S5Hf8jA4Eh1VtzFhvytOzqYg@mail.gmail.com","threadId":"35707","inReplyTo":"CACsJy8AEU2dQPNknazRxEh12MNd=3Kw3+_tc3meS_Bs961ERkA@mail.gmail.com","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Johan Herland","fromEmail":"johan@herland.net","sentAt":"2014-01-22T12:06:09Z","receivedAt":"2014-01-22T12:06:09Z","isPatch":false,"sender":{"key":"johan@herland.net","avatar":"https://avatars.githubusercontent.com/u/547031?v=4"},"body":"On Wed, Jan 22, 2014 at 12:39 PM, Duy Nguyen <pclouds@gmail.com> wrote:\n> On Wed, Jan 22, 2014 at 6:22 PM, Michael Haggerty <mhagger@alum.mit.edu> wrote:\n>> These sections are inconsistent with the other manpages and seem\n>> superfluous in a project that has, on the one hand, a public history\n>> and, on the other hand, hundreds of contributors.  Would the mentioned\n>> authors (CCed) consent to the removal of these sections?\n>\n> No problem from me.\n\nNo problems here.\n\n\n-- \nJohan Herland, <johan@herland.net>\nwww.herland.net\n"},{"id":"233511","messageId":"alpine.DEB.1.00.1401221542190.14982@s15462909.onlinehome-server.info","threadId":"35707","inReplyTo":"52DFA9EF.4080309@alum.mit.edu","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2014-01-22T14:43:03Z","receivedAt":"2014-01-22T14:43:03Z","isPatch":false,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"Hi Michael,\n\nOn Wed, 22 Jan 2014, Michael Haggerty wrote:\n\n> Would the mentioned authors (CCed) consent to the removal of these\n> sections?\n\nFine by me!\nDscho\n\nP.S.: Congrats on your new job!\n"},{"id":"233518","messageId":"xmqqfvogypyu.fsf@gitster.dls.corp.google.com","threadId":"35707","inReplyTo":"52DFA9EF.4080309@alum.mit.edu","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2014-01-22T15:51:37Z","receivedAt":"2014-01-22T15:51:37Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Michael Haggerty <mhagger@alum.mit.edu> writes:\n\n> I just noticed that there are exactly four Git manpages with an \"AUTHOR\"\n> section and five with a \"DOCUMENTATION\" section:\n>\n>     $ make doc\n>     $ grep -nIE -e '^\\.SH \"DOCUMENTATION|AUTHOR\"' Documentation/*.[0-9]\n>     Documentation/git-column.1:80:.SH \"AUTHOR\"\n>     Documentation/git-for-each-ref.1:272:.SH \"AUTHOR\"\n>     Documentation/git-for-each-ref.1:275:.SH \"DOCUMENTATION\"\n>     Documentation/git-http-backend.1:404:.SH \"AUTHOR\"\n>     Documentation/git-http-backend.1:407:.SH \"DOCUMENTATION\"\n>     Documentation/git-notes.1:395:.SH \"AUTHOR\"\n>     Documentation/git-notes.1:398:.SH \"DOCUMENTATION\"\n>     Documentation/git-remote-ext.1:133:.SH \"DOCUMENTATION\"\n>     Documentation/git-remote-fd.1:71:.SH \"DOCUMENTATION\"\n>\n> These sections are inconsistent with the other manpages and seem\n> superfluous in a project that has, on the one hand, a public history\n> and, on the other hand, hundreds of contributors.\n\nWe decided at 48bb914e (doc: drop author/documentation sections from\nmost pages, 2011-03-11) to remove them for that exact reason.  I'd\nbe happy to see the one in for-each-ref under my name go.\n\nThanks.\n"},{"id":"233530","messageId":"CAJo=hJuW3BdZUpvGL3fgry=w04YpwZTUZkMW6BeeTXfMbyKK6A@mail.gmail.com","threadId":"35707","inReplyTo":"52DFA9EF.4080309@alum.mit.edu","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Shawn Pearce","fromEmail":"spearce@spearce.org","sentAt":"2014-01-22T19:49:46Z","receivedAt":"2014-01-22T19:49:46Z","isPatch":false,"sender":{"key":"spearce@spearce.org","avatar":"https://avatars.githubusercontent.com/u/34844?v=4"},"body":"On Wed, Jan 22, 2014 at 3:22 AM, Michael Haggerty <mhagger@alum.mit.edu> wrote:\n> I just noticed that there are exactly four Git manpages with an \"AUTHOR\"\n> section and five with a \"DOCUMENTATION\" section:\n>\n>     $ make doc\n>     $ grep -nIE -e '^\\.SH \"DOCUMENTATION|AUTHOR\"' Documentation/*.[0-9]\n>     Documentation/git-column.1:80:.SH \"AUTHOR\"\n>     Documentation/git-for-each-ref.1:272:.SH \"AUTHOR\"\n>     Documentation/git-for-each-ref.1:275:.SH \"DOCUMENTATION\"\n>     Documentation/git-http-backend.1:404:.SH \"AUTHOR\"\n>     Documentation/git-http-backend.1:407:.SH \"DOCUMENTATION\"\n>     Documentation/git-notes.1:395:.SH \"AUTHOR\"\n>     Documentation/git-notes.1:398:.SH \"DOCUMENTATION\"\n>     Documentation/git-remote-ext.1:133:.SH \"DOCUMENTATION\"\n>     Documentation/git-remote-fd.1:71:.SH \"DOCUMENTATION\"\n>\n> These sections are inconsistent with the other manpages and seem\n> superfluous in a project that has, on the one hand, a public history\n> and, on the other hand, hundreds of contributors.  Would the mentioned\n> authors (CCed) consent to the removal of these sections?\n\nFine by me, authorship is documented by history and blame anyway.  :-)\n"},{"id":"233535","messageId":"20140122201507.GA15111@LK-Perkele-VII","threadId":"35707","inReplyTo":"52DFA9EF.4080309@alum.mit.edu","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Ilari Liusvaara","fromEmail":"ilari.liusvaara@elisanet.fi","sentAt":"2014-01-22T20:15:07Z","receivedAt":"2014-01-22T20:15:07Z","isPatch":false,"sender":{"key":"ilari.liusvaara@elisanet.fi","avatar":null},"body":"On Wed, Jan 22, 2014 at 12:22:23PM +0100, Michael Haggerty wrote:\n> I just noticed that there are exactly four Git manpages with an \"AUTHOR\"\n> section and five with a \"DOCUMENTATION\" section:\n> \n> These sections are inconsistent with the other manpages and seem\n> superfluous in a project that has, on the one hand, a public history\n> and, on the other hand, hundreds of contributors.  Would the mentioned\n> authors (CCed) consent to the removal of these sections?\n \nSure (it has been copyedited a lot anyway).\n\n-Ilari\n"},{"id":"233548","messageId":"52E03B1D.4060207@alum.mit.edu","threadId":"35707","inReplyTo":"52DFA9EF.4080309@alum.mit.edu","subject":"Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages","fromName":"Michael Haggerty","fromEmail":"mhagger@alum.mit.edu","sentAt":"2014-01-22T21:41:49Z","receivedAt":"2014-01-22T21:41:49Z","isPatch":false,"sender":{"key":"mhagger@alum.mit.edu","avatar":"https://avatars.githubusercontent.com/u/119718?v=4"},"body":"On 01/22/2014 12:22 PM, Michael Haggerty wrote:\n> I just noticed that there are exactly four Git manpages with an \"AUTHOR\"\n> section and five with a \"DOCUMENTATION\" section:\n> \n>     $ make doc\n>     $ grep -nIE -e '^\\.SH \"DOCUMENTATION|AUTHOR\"' Documentation/*.[0-9]\n>     Documentation/git-column.1:80:.SH \"AUTHOR\"\n>     Documentation/git-for-each-ref.1:272:.SH \"AUTHOR\"\n>     Documentation/git-for-each-ref.1:275:.SH \"DOCUMENTATION\"\n>     Documentation/git-http-backend.1:404:.SH \"AUTHOR\"\n>     Documentation/git-http-backend.1:407:.SH \"DOCUMENTATION\"\n>     Documentation/git-notes.1:395:.SH \"AUTHOR\"\n>     Documentation/git-notes.1:398:.SH \"DOCUMENTATION\"\n>     Documentation/git-remote-ext.1:133:.SH \"DOCUMENTATION\"\n>     Documentation/git-remote-fd.1:71:.SH \"DOCUMENTATION\"\n> \n> These sections are inconsistent with the other manpages and seem\n> superfluous in a project that has, on the one hand, a public history\n> and, on the other hand, hundreds of contributors.  Would the mentioned\n> authors (CCed) consent to the removal of these sections?\n> \n> I don't want to step on any feet here.  If you want to keep these\n> sections, I have no objection.  But my guess is that people added them\n> in these few instances without realizing that these sections are not\n> commonly used in Git documentation.\n\nThanks for the quick responses, everybody.  I'll prepare a patch.\n\nMichael\n\n-- \nMichael Haggerty\nmhagger@alum.mit.edu\nhttp://softwareswirl.blogspot.com/\n"}]}