Updated document outline.

*   divided into bin, cgi-bin and lib sections
*   consolidated newlines before ##
*   changed heading 1 and 2 lvl style

README.md

-#minions#
+minions
+=======
 
 My favorite tiny Perl scripts for development and testing.
 
-##hello_host.cgi##
+
+
+bin - UNIX scripts
+------------------
+
+
+### autotest.pl ###
+
+Script to make it easier to start developing your new Perl module under
+pressure of unit tests written in [Test::More][1] and the likes.
+
+  [1]: (http://perldoc.perl.org/Test/More.html)
+
+Suggested use is to sit on the other monitor, run all *.t* files around
+and around and be annoying about the fact that they fail.  Then the rule
+of thumb goes without saying: "no green, no commit".
+
+
+### timestamp.pl ###
+
+Script to measure how long mone second takes.  For those that know how long
+one second takes, it can serve as a snippet for Perl `&stamp()`.
+
+
+### watchdump.pl ###
+
+Trivial utility that prints a text file, clears the screen and pauses for 2s
+over and over.
+
+Designed mainly for use with `helper::dmup();` to enable you to see changes
+in your dumped data structure continuously, but obviously you can use it for
+any text file that will fit your screen.
+
+For improved visual feedack, it will pre-pend the file contents with the file
+path and an "animation".  Display of the header can be controlled by options,
+see `--usage`.
+
+
+### pl2yml.pl, yml2pl.pl ###
+
+Simple scripts to read YAML/Perl data structure from a file and dump it in
+the other format to STDIN.  Uses YAML::tiny for YAML jobs.
+
+
+
+cgi-bin - CGI scripts
+---------------------
+
+
+### hello_host.cgi ###
 
 Prints overview of TCP connection details (IP addresses, ports, server
 user@host, time); 7 lines of plain text.
 
-##htlog.cgi##
+
+### htlog.cgi ###
 
 Collects GET requests with parameters *msg*, *tag* and *i* and logs them into
 single text file.
     it won't break your ability to use tags
 
 
-##htlogger.pm##
+### randomfile.pl ###
+
+Send a 7-bit plain-text file via HTTP.  One of these is sent:
+
+*   random content of random length given by parameters *min* and *max*
+
+*   EICAR test virus file
+
+Chance to receive EICAR is given by parameter *eicar* (0-100).
+
+
+
+lib - modules/libraries
+-----------------------
+
+
+### helper.pm ###
+
+Container module for some utility methods for Perl.  Probably only `dmup()`
+is interesting—it bears a nice quick and dirty way for dumping Perl
+data.
+
+
+### htlogger.pm ###
 
 API to make usage of *htlog.cgi* in Perl scripts even easier
 
         );
 
     }
-
-
-##autotest.pl##
-
-Script to make it easier to start developing your new Perl module under 
-pressure of unit tests written in [Test::More][1] and the likes.
-
-  [1]: (http://perldoc.perl.org/Test/More.html)
-
-Suggested use is to sit on the other monitor, run all *.t* files around 
-and around and be annoying about the fact that they fail.  Then the rule 
-of thumb goes without saying: "no green, no commit".
-
-
-##timestamp.pl##
-
-Script to measure how long mone second takes.  For those that know how long 
-one second takes, it can serve as a snippet for Perl `&stamp()`.
-
-
-
-##helper.pm##
-
-Container module for some utility methods for Perl.  Probably only `dmup()` 
-is interesting—it bears a nice quick and dirty way for dumping Perl 
-data.
-
-
-##watchdump.pl##
-
-Trivial utility that prints a text file, clears the screen and pauses for 2s
-over and over.
-
-Designed mainly for use with `helper::dmup();` to enable you to see changes
-in your dumped data structure continuously, but obviously you can use it for
-any text file that will fit your screen.
-
-For improved visual feedack, it will pre-pend the file contents with the file
-path and an "animation".  Display of the header can be controlled by options,
-see `--usage`.
-
-
-##randomfile.pl##
-
-Send a 7-bit plain-text file via HTTP.  One of these is sent:
-
-*   random content of random length given by parameters *min* and *max*
-
-*   EICAR test virus file
-
-Chance to receive EICAR is given by parameter *eicar* (0-100).
-
-
-##pl2yml.pl, yml2pl.pl##
-
-Simple scripts to read YAML/Perl data structure from a file and dump it in
-the other format to STDIN.  Uses YAML::tiny for YAML jobs.