Try showing tools in a table.

README.md

@@ -25,47 +25,20 @@ e.g. After cloning do:
 
 ### Tools
 
-#### py
-    python_syntax python_unittests pydoc mypy python_coverage python_profile pycodestyle pyflakes pylint python_gut python_modulefinder python_mccabe bandit
-
-#### pyc
-    disassemble_pyc
-
-#### pl pm t
-    perl_syntax perldoc perltidy
-
-#### pod pod6
-    perldoc
-
-#### java
-    uncrustify
-
-#### c h
-    splint uncrustify
-
-#### 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
+Extensions | Tools
+---------- | -----
+.py | python_syntax python_unittests pydoc mypy python_coverage python_profile pycodestyle pyflakes pylint python_gut python_modulefinder python_mccabe bandit
+.pyc | disassemble_pyc
+.pl .pm .t | perl_syntax perldoc perltidy
+.pod .pod6 | perldoc
+.java | uncrustify
+.c .h | splint uncrustify
+.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("#### " + " ".join(extensions))
-    print("    " + " ".join(tool.__name__ for tool in tools_))
+    print("%s | %s" % (" ".join("." + extension for extension in extensions),
+                       " ".join(tool.__name__ for tool in tools_)))