git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages

From
Shawn Pearce <spearce@spearce.org>
Date
Jan 22, 2014, 19:49 UTC
Message-ID
<CAJo=hJuW3BdZUpvGL3fgry=w04YpwZTUZkMW6BeeTXfMbyKK6A@mail.gmail.com>
In-Reply-To
<52DFA9EF.4080309@alum.mit.edu>
On Wed, Jan 22, 2014 at 3:22 AM, Michael Haggerty <mhagger@alum.mit.edu> wrote:
Show 19 quoted lines
> I just noticed that there are exactly four Git manpages with an "AUTHOR"
> section and five with a "DOCUMENTATION" section:
>
>     $ make doc
>     $ grep -nIE -e '^\.SH "DOCUMENTATION|AUTHOR"' Documentation/*.[0-9]
>     Documentation/git-column.1:80:.SH "AUTHOR"
>     Documentation/git-for-each-ref.1:272:.SH "AUTHOR"
>     Documentation/git-for-each-ref.1:275:.SH "DOCUMENTATION"
>     Documentation/git-http-backend.1:404:.SH "AUTHOR"
>     Documentation/git-http-backend.1:407:.SH "DOCUMENTATION"
>     Documentation/git-notes.1:395:.SH "AUTHOR"
>     Documentation/git-notes.1:398:.SH "DOCUMENTATION"
>     Documentation/git-remote-ext.1:133:.SH "DOCUMENTATION"
>     Documentation/git-remote-fd.1:71:.SH "DOCUMENTATION"
>
> These sections are inconsistent with the other manpages and seem
> superfluous in a project that has, on the one hand, a public history
> and, on the other hand, hundreds of contributors.  Would the mentioned
> authors (CCed) consent to the removal of these sections?
Fine by me, authorship is documented by history and blame anyway.  :-)
Previous: Junio C HamanoNext: Ilari Liusvaara
Message 6 of 8 in “Anomalous AUTHOR and DOCUMENTATION sections in manpages”
  1. Michael HaggertyJan 22, 2014
  2. Duy NguyenJan 22, 2014
  3. Johan HerlandJan 22, 2014
  4. Johannes SchindelinJan 22, 2014
  5. Junio C HamanoJan 22, 2014
  6. Shawn PearceJan 22, 2014
  7. Ilari LiusvaaraJan 22, 2014
  8. Michael HaggertyJan 22, 2014

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.