diff --git a/README.mkd b/README.mkd
index 49d3ada..dbc2741 100644
--- a/README.mkd
+++ b/README.mkd
@@ -1,9 +1,11 @@
+# main README file for gitolite -- start here!
+
 <a name="start"></a>
 
 ***IMPORTANT NOTE: v2.0rc1 is out; all development will be on that now.
 Please see new doc/developer-notes.mkd***
 
-# gitolite
+----
 
 Gitolite is an access control layer on top of git, which allows access control
 down to the branch level, including specifying who can and cannot *rewind* a
diff --git a/contrib/autotoc b/contrib/autotoc
deleted file mode 100755
index 964baa9..0000000
--- a/contrib/autotoc
+++ /dev/null
@@ -1,35 +0,0 @@
-#!/usr/bin/perl -w
-
-use strict;
-
-# filter gitolite's mkd files through this; it's designed to be idempotent of
-# course
-
-sub make_anchor {
-    # make an anchor out of a section heading
-    my $sh = shift;
-    $sh =~ s/\W+/_/g;
-    $sh =~ s/^_//;
-    return $sh;
-}
-
-undef $/;
-my $doc = <>;
-
-$doc =~ s/^<a name="_.*"><\/a>\n\n//mg;
-$doc =~ s/^<a name="AUTO_.*"><\/a>\n\n//mg;
-
-my @toc = $doc =~ /^###+ .*/mg;
-$doc =~ s/^(###+) (.*)/"<a name=\"_" . make_anchor($2) . "\"><\/a>\n\n$1 $2"/mge;
-
-for (@toc) {
-    s/^(###+) (.*)/'    ' x (length($1)-3) . '  * <a href="#_' . make_anchor($2) . "\">$2<\/a>"/e;
-}
-
-my $toc  = "In this document:\n\n";
-$toc .= join("\n", @toc);
-$toc .= "\n\n";
-
-$doc =~ s/^In this document:\n\n.*?\n\n/$toc/sm;
-
-print $doc;
diff --git a/contrib/ldap/README.mkd b/contrib/ldap/README.mkd
index a7dc764..05d6312 100644
--- a/contrib/ldap/README.mkd
+++ b/contrib/ldap/README.mkd
@@ -1,3 +1,5 @@
+# ldap helper programs
+
 These programs were contributed by the Nokia MeeGo folks.
 
 The first 2 are perl and shell verisions of programs meant to be used as
diff --git a/doc/monkeysphere.mkd b/doc/monkeysphere.mkd
old mode 100755
new mode 100644
index 0d81c1b..e613a9d
--- a/doc/monkeysphere.mkd
+++ b/doc/monkeysphere.mkd
@@ -1,3 +1,5 @@
+(contributed doc: integrating gitolite with monkeysphere)
+
 This document attempts to describe one way to integrate
 [Monkeysphere](http://web.monkeysphere.info/) authentication
 with [gitolite](http://github.com/sitaramc/gitolite).
diff --git a/doc/progit-article.mkd b/doc/progit-article.mkd
index 2667c9b..62652b6 100644
--- a/doc/progit-article.mkd
+++ b/doc/progit-article.mkd
@@ -1,3 +1,5 @@
+(master copy of progit chapter on gitolite)
+
 ## Gitolite ##
 
 Note: the latest copy of this section of the ProGit book is always available within the [gitolite documentation][gldpg].  The author would also like to humbly state that, while this section is accurate, and *can* (and often *has*) been used to install gitolite without reading any other documentation, it is of necessity not complete, and cannot completely replace the enormous amount of documentation that gitolite comes with.