Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 705744 - Update list of devmanual contributors
Summary: Update list of devmanual contributors
Status: RESOLVED FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Devmanual Team
URL:
Whiteboard:
Keywords: PATCH
Depends on:
Blocks:
 
Reported: 2020-01-18 17:42 UTC by Ulrich Müller
Modified: 2021-07-02 20:50 UTC (History)
7 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
appendices/contributors: Update list of contributors. (0001-appendices-contributors-Update-list-of-contributors.patch,5.05 KB, patch)
2020-01-18 17:42 UTC, Ulrich Müller
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Ulrich Müller gentoo-dev 2020-01-18 17:42:14 UTC
Created attachment 603676 [details, diff]
appendices/contributors: Update list of contributors.

I am aware this has caused a lot of discussions in the past, but I think it's time to update the list of contributors again.

Please review attached patch. I've set an (arbitrary) threshold of 40 lines, in order to include only contributions that are somewhat substantial. (That won't prevent us from adding smaller contributors, if they explicitly ask for it.)

CCing all people who would be added, if they still have a bugzilla account. Please speak up if you don't want to be listed, or listed differently (e.g. spelling of name, different or no e-mail address).
Comment 1 Larry the Git Cow gentoo-dev 2020-02-03 00:08:14 UTC
The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=0e002d195a18a3c1ee57605cc0783298106fe060

commit 0e002d195a18a3c1ee57605cc0783298106fe060
Author:     Ulrich Müller <ulm@gentoo.org>
AuthorDate: 2020-01-18 17:18:23 +0000
Commit:     Ulrich Müller <ulm@gentoo.org>
CommitDate: 2020-02-03 00:02:38 +0000

    appendices/contributors: Update list of contributors.
    
    - Add contributors when they have added at least 40 lines (yes, this
    is quite arbitrary) to a file, based on the script below. This was
    followed by some manual sanity checks, e.g., whether the line count
    doesn't originate only from paragraph reformatting.
    
        for i in $(find . -name .git -prune -o -type f -print); do
            echo $i
            git blame -e -w $i
        done \
        | awk '
            /^\./ { file=$1; next }
            { lines[gensub(/.*\(<([^@]*)@.*/, "\\1", 1, $0), file]++ }
            END {
                for (x in lines) {
                    split(x, y, SUBSEP)
                    if (lines[x] >= 40)
                        printf "%-15s  %-50s  %4d\n", y[1], y[2], lines[x]
                }
            }' \
        | sort
    
    Where contributions to more than three (or to all) subdocuments of any
    document would have been listed, only the parent document is listed
    instead.
    
    - Remove zhen as contributor for appendices/devbook-guide, because all
    nontrivial lines written by him have been removed (or moved elsewhere),
    most of them already in 2003:
    https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo/xml/htdocs/doc/en/xml-guide.xml?r1=1.19&r2=1.20
    
    - Change description of halcy0n from "current maintainer" to "previous
    maintainer", because his last commit was in 2010.
    
    Closes: https://bugs.gentoo.org/705744
    Signed-off-by: Ulrich Müller <ulm@gentoo.org>

 appendices/contributors/text.xml | 53 ++++++++++++++++++++++++++++++++++------
 1 file changed, 45 insertions(+), 8 deletions(-)
Comment 2 Ulrich Müller gentoo-dev 2020-02-03 00:11:31 UTC
Two weeks have passed, and I see no objections.
Therefore pushed and bug closed.