Update and clean up docs

More truth, less BS.

README.md

@@ -28,7 +28,7 @@ Binary dump.  Reads STDIN, 4 bytes at a time and displays it in similar way as
 
 Example:
 
-    $ echo "Hello world" | ./bd.pl
+    $ echo "Hello world" | ./bd
     00000000  01001000 01100101 01101100 01101100  |Hell|
     00000004  01101111 00100000 01110111 01101111  |o wo|
     00000008  01110010 01101100 01100100 00001010  |rld.|
@@ -65,25 +65,26 @@ mode, where you can enter URLs one per line.  Quit this mode by entering *EOF*
 
 ### mkexec ###
 
-Make executable script for you and heat up vim.  Accepts filename as parameter.
+    mkexec [-f] [-e] name [type] [purpose]
 
-1.  try to guess type from name (e.g. .pl -> perl)
-2.  if filename does not exist, create it with shebang (based on `which` call)
-3.  chmod it to `0755` (yeah, hardcoded `0755`, no smartness here whatsoever)
-4.  try to heat up `vim` or `editor` for you.
+Make executable script, i.e. create new file, add shebang line and template,
+and mark it executable (0755).  type (py, pl, bash...) and purpose (test
+or nothing) are used to choose the right template.  If not supplied, attempt
+is made to guess from the filename.
 
+If the file already  exist, gives up, unless *-f* option is passed.  *-e*
+option causes default editor to be spawned with the new file loaded.
 
-### pfile ###
 
-Wrapper around *file* utility that reads STDIN, stores it in a temporary file
-(using Python's *tmpfile.mkstemp*),calls the utility on it and returns output
-(and of course, deletes the tmpfile afterwards).
+### pfile ###
 
-This is useful in cases like when debugging a HTTP server with utility like
-*curl*, and when we don't want to see the actual output, yet still want to know
-what it looks like.  Using pfile on pipe, we can easily combine the power
-of *file* with the simplicity of *curl*:
+Wrapper around *file* utility.  Reads STDIN, stores it in a temporary file
+(using Python's *tmpfile.mkstemp*), calls *file* on it and returns output.
 
+This is useful in cases like debugging a HTTP server with utility like
+*curl*, and when we don't want to see the actual output, yet still want to
+know what it looks like.  Using pfile on pipe, we can easily combine the
+power of *file* with the simplicity of *curl*:
 
     us@here:~$ curl -4 -v http://www.example.com/ | pfile
     * About to connect() to www.example.com port 80 (#0)
@@ -115,23 +116,20 @@ of *file* with the simplicity of *curl*:
 
 ### pl2yml, yml2pl ###
 
-Simple scripts to read YAML/Perl data structure from a file and dump it in
-the other format to STDIN.  Uses [YAML::Tiny][4] for YAML jobs.
+Read YAML/Perl data structure from a file and dump it in the other format
+to STDIN.  Uses [YAML::Tiny][4] for YAML jobs.
 
   [4]: https://metacpan.org/module/YAML::Tiny
 
 
 ### se ###
 
-Translate to and from Czech.  Especially sweet if you need to concentrate
-on the work, i.e. avoid all the blinking flashing smiling Internets looks.
-This guy only tells you the woords.
+Translate to and from Czech using slovnik.cz service.
 
     se [options] word
 
-Throw a word at it and by default, it will throw you back few Czech
-translations of it, one pair per line.  Sweet.  Also supports other languages
-(about 10 in total).
+By default, outputs few Czech translations of it, one per line.  Also
+supports other languages (about 10 in total).
 
 Most useful options are `--lines` (default is 25), `--long`, as shorthand
 to `--lines=50`, and `--direction`, which supports direction keyword in form
@@ -169,8 +167,7 @@ just because I did a minor typo-fix later.
 
 ### watchdump ###
 
-Trivial utility that prints a text file, clears the screen and pauses for 2s
-over and over.
+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