Merge pull request #123 from fennecJ/patch

Generate contributor list as a modular inclusion

Author: jserv

.mailmap

@@ -0,0 +1,8 @@
+JianXing Wu <[email protected]> 吳建興 <[email protected]>
+fennecJ     <[email protected]> fennecJ   <[email protected]>
+fennecJ     <[email protected]> fennecj   <[email protected]>
+Jim Huang   <[email protected]> Jim Huang  <[email protected]>
+Jim Huang   <[email protected]> Jim Huang  <[email protected]>
+linD026     <[email protected]> linD026   <[email protected]>
+linD026     <[email protected]> linD026   <[email protected]>
+linD026     <[email protected]> linzhien  <[email protected]>

contrib.tex

@@ -0,0 +1,33 @@
+2011eric,                      % <[email protected]>
+25077667,                      % <[email protected]>
+Arush Sharma,                  % <[email protected]>
+asas1asas200,                  % <[email protected]>
+Benno Bielmeier,               % <[email protected]>
+Brad Baker,                    % <[email protected]>
+ccs100203,                     % <[email protected]>
+Chih-Yu Chen,                  % <[email protected]>
+ChinYikMing,                   % <[email protected]>
+Cyril Brulebois,               % <[email protected]>
+Daniele Paolo Scarpazza,       % <>
+David Porter,                  % <>
+demonsome,                     % <[email protected]>
+Dimo Velev,                    % <>
+Ekang Monyet,                  % <[email protected]>
+fennecJ,                       % <[email protected]>
+Francois Audeon,               % <>
+gagachang,                     % <[email protected]>
+Gilad Reti,                    % <[email protected]>
+Horst Schirmeier,              % <>
+Hsin-Hsiang Peng,              % <[email protected]>
+Ignacio Martin,                % <>
+JianXing Wu,                   % <[email protected]>
+linD026,                       % <[email protected]>
+Marconi Jiang,                 % <[email protected]>
+RinHizakura,                   % <[email protected]>
+Roman Lakeev,                  % <>
+Stacy Prowell,                 % <[email protected]>
+Tucker Polomik,                % <[email protected]>
+VxTeemo,                       % <[email protected]>
+Wei-Lun Tsai,                  % <[email protected]>
+xatier,                        % <[email protected]>
+Ylowy.                         % <[email protected]>

lkmpg.tex

@@ -82,7 +82,11 @@ \subsection{Authorship}
 \subsection{Acknowledgements}
 \label{sec:acknowledgements}
 
-The following people have contributed corrections or good suggestions: Ignacio Martin, David Porter, Daniele Paolo Scarpazza, Dimo Velev, Francois Audeon, Horst Schirmeier, and Roman Lakeev.
+The following people have contributed corrections or good suggestions: 
+
+\begin{flushleft}
+\input{contrib}
+\end{flushleft}
 
 \subsection{What Is A Kernel Module?}
 \label{sec:kernelmod}

scripts/Contributors

@@ -0,0 +1,33 @@
+2011eric,<[email protected]>
+25077667,<[email protected]>
+Arush Sharma,<[email protected]>
+asas1asas200,<[email protected]>
+Benno Bielmeier,<[email protected]>
+Brad Baker,<[email protected]>
+ccs100203,<[email protected]>
+Chih-Yu Chen,<[email protected]>
+ChinYikMing,<[email protected]>
+Cyril Brulebois,<[email protected]>
+Daniele Paolo Scarpazza,<>
+David Porter,<>
+demonsome,<[email protected]>
+Dimo Velev,<>
+Ekang Monyet,<[email protected]>
+fennecJ,<[email protected]>,<[email protected]>
+Francois Audeon,<>
+gagachang,<[email protected]>
+Gilad Reti,<[email protected]>
+Horst Schirmeier,<>
+Hsin-Hsiang Peng,<[email protected]>
+Ignacio Martin,<>
+JianXing Wu,<[email protected]>
+linD026,<[email protected]>,<[email protected]>,<[email protected]>
+Marconi Jiang,<[email protected]>
+RinHizakura,<[email protected]>
+Roman Lakeev,<>
+Stacy Prowell,<[email protected]>
+Tucker Polomik,<[email protected]>
+VxTeemo,<[email protected]>
+Wei-Lun Tsai,<[email protected]>
+xatier,<[email protected]>
+Ylowy,<[email protected]>

scripts/Exclude

@@ -0,0 +1 @@
+Jim Huang,              One of main author

scripts/Include

@@ -0,0 +1,7 @@
+Daniele Paolo Scarpazza,<>
+David Porter,<>
+Dimo Velev,<>
+Francois Audeon,<>
+Horst Schirmeier,<>
+Ignacio Martin,<>
+Roman Lakeev,<>

scripts/list-contributors.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+FORMAT="%aN,<%aE>"                   #Set git output format in "Name,<Email>" //Capital in aN and aE means replace str based on .mailmap
+TARGET=(examples lkmpg.tex)          #Target files we want to trace
+DIR=`git rev-parse --show-toplevel`  #Get root dir of the repo
+TARGET=("${TARGET[@]/#/$DIR/}")      #Concat $DIR BEFORE ALL elements in array TARGET
+
+#The str in each line should be Username,<useremail>
+function gen-raw-list()
+{
+    git log --pretty="$FORMAT" ${TARGET[@]} | sort -u
+}
+
+function parse-list()
+{
+    > Contributors  # Clear contributors' list (Overwrite with null)
+    while read -r line; do
+        User=`echo "$line" | awk -F "," '{print $1}'`   
+        if [[ `grep -w "$User" Exclude` ]]; then
+            echo "[skip] $User"
+            continue;
+        fi
+        echo "[Add] $User"
+        MainMail=`echo "$line" | awk -F "[<*>]" '{print $2}'`
+        Emails=(`cat $DIR/.mailmap | grep -w "$User" | awk -F "[<*>]" '{print $4}' | sort -u`)
+        for Email in ${Emails[@]}; do
+            if [[ "$Email" != "$MainMail" ]]; then
+                line="$line,<$Email>";
+            fi
+        done
+        echo "$line" >> Contributors
+    done <<< $(gen-raw-list)
+    cat Include >> Contributors
+}
+
+function sort-list()
+{
+    if [[ `git diff Contributors` ]]; then
+        sort -f -o Contributors{,}
+        git add $DIR/scripts/Contributors
+    fi
+}
+
+#For all lines before endline, print "name, % <email>"
+#For endline print "name. % <email>"
+function gen-tex-file()
+{
+    cat Contributors | awk -F "," \
+    '   BEGIN{k=0}{name[k]=$1;email[k++]=$2}
+        END{
+           for(i=0;i<k;i++){
+               name[i]=(i<k-1)?name[i]",":name[i]".";
+               printf("%-30s %% %s\n",name[i],email[i]);
+               }
+           }
+    '
+}
+
+parse-list
+sort-list
+gen-tex-file > $DIR/contrib.tex