contributors.py: Exclude robots and change sorting so that

                 among most recent contributors people with
                 earlier entry date appear at the top.

Add description to scripts/README.txt

Author: techtonik

scripts/README.txt

@@ -31,3 +31,6 @@ imapServer.py
  This IMAP server script that runs in the background and checks for new
  email from a variety of mailboxes.
 
+contributors.py
+ Analyzes Mercurial log, filters and compiles list of committers with years
+ of contribution. Can be useful for updating COPYING.txt

scripts/contributors.py

@@ -30,6 +30,7 @@
   'John P. Rouillard <[email protected]>':
       ['rouilj'],
 }
+ROBOTS = ['No Author <[email protected]>']
 # /-- 
 
 
@@ -93,11 +94,15 @@ def compress(years):
   years = {}  # year -> set(author1, author2, ...)
   names = {}  # author -> set(years)
   for year, author in authorship:
+    if author in ROBOTS:
+      continue
     # process aliases
     for name, aliases in ALIASES.items():
       if author in aliases:
         author = name
         break
+    author = author.replace('<', '(')
+    author = author.replace('>', ')')
     # years
     if not year in years:
       years[year] = set()
@@ -134,19 +139,21 @@ def first_year(name):
     def year_cmp(name1, name2):
       """
       Year comparison function. First sort by latest contribution year (desc).
-      If it matches, compare first contribution year (desc).
+      If it matches, compare first contribution year (asc). This ensures that
+      the most recent and long-term contributors are at the top.
       """
       if last_year(name1) != last_year(name2):
         return last_year(name1) - last_year(name2)
       else:
-        return first_year(name1) - first_year(name2)
+        return first_year(name2) - first_year(name1)
 
+    print("Copyright (c)")
     for author in sorted(list(names), cmp=year_cmp, reverse=True):
       years = list(names[author])
       yearstr = compress(years)
 
       if 0: #DEBUG
         print(years, yearstr, author)
       else:
-        print("Copyright (c) %s %s" % (yearstr, author))
+        print("    %s %s" % (yearstr, author))
     print('')