Try showing tools in a table.

README.md

@@ -25,47 +25,20 @@ e.g. After cloning do:
 
 ### Tools
 
-#### py
+Extensions | Tools
-    python_syntax python_unittests pydoc mypy python_coverage python_profile pycodestyle pyflakes pylint python_gut python_modulefinder python_mccabe bandit
+---------- | -----
-
+.py | python_syntax python_unittests pydoc mypy python_coverage python_profile pycodestyle pyflakes pylint python_gut python_modulefinder python_mccabe bandit
-#### pyc
+.pyc | disassemble_pyc
-    disassemble_pyc
+.pl .pm .t | perl_syntax perldoc perltidy
-
+.pod .pod6 | perldoc
-#### pl pm t
+.java | uncrustify
-    perl_syntax perldoc perltidy
+.c .h | splint uncrustify
-
+.o | objdump_headers objdump_disassemble readelf
-#### pod pod6
+.cpp | bcpp uncrustify
-    perldoc
+.pdf | pdf2txt
-
+.html | html_syntax tidy html2text
-#### java
+.php | php5_syntax
-    uncrustify
+.zip | unzip
-
+.tar.gz .tgz | tar_gz
-#### c h
+.tar.bz2 | tar_bz2
-    splint uncrustify
+.a .so | nm
-
-#### o
-    objdump_headers objdump_disassemble readelf
-
-#### cpp
-    bcpp uncrustify
-
-#### pdf
-    pdf2txt
-
-#### html
-    html_syntax tidy html2text
-
-#### php
-    php5_syntax
-
-#### zip
-    unzip
-
-#### tar.gz tgz
-    tar_gz
-
-#### tar.bz2
-    tar_bz2
-
-#### a so
-    nm

make-readme.py

@@ -33,8 +33,10 @@ e.g. After cloning do:
 
     # git checkout ubuntu-15.10
 
-### Tools""")
+### Tools
+
+Extensions | Tools
+---------- | -----""")
 for extensions, tools_ in tools.TOOLS_FOR_EXTENSIONS:
-    print()
+    print("%s | %s" % (" ".join("." + extension for extension in extensions),
-    print("#### " + " ".join(extensions))
+                       " ".join(tool.__name__ for tool in tools_)))
-    print("    " + " ".join(tool.__name__ for tool in tools_))