Re: Anomalous AUTHOR and DOCUMENTATION sections in manpages
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Jan 22, 2014, 15:51 UTC
- Message-ID
- <xmqqfvogypyu.fsf@gitster.dls.corp.google.com>
- In-Reply-To
- <52DFA9EF.4080309@alum.mit.edu>
Michael Haggerty <mhagger@alum.mit.edu> writes:
Show 18 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.
We decided at 48bb914e (doc: drop author/documentation sections from most pages, 2011-03-11) to remove them for that exact reason. I'd be happy to see the one in for-each-ref under my name go.
Thanks.