Update README files

Author: gjbex

source-code/cmd/README.md

@@ -1,8 +1,10 @@
 # Cmd
+
 Standard Python library framework to facilitate writing command line
 driven interpreters.
 
 ## What is it?
+
 1. `simple.py`: a very simmple example that keeps track of a list of
     friends.  A friend is added by saying `hi` to her, and is removed by
     saying `bye` to her.  You can't say `hi` to someone who is your friend

source-code/code-evaluation/README.md

@@ -1,12 +1,11 @@
-EvaluateCode
-============
+# Code evaluation
 
 Python allows executino of Python source code at runtime.  Although this
 is a powerful feature, it should be used with extreme care, since it can
 give rise to serious security issues.
 
-What is it?
------------
+## What is it?
+
 1. `evaluate.py`: short example that reads a code fragment, evaluates it,
     and prints all values of variables defined in that code fragment.
     Only variables of type `int`, '`float`, `str`, `bool` and `list` will

source-code/command-line-arguments/README.md

@@ -1,4 +1,4 @@
-# CommandLineArgs
+# Command line arguments
 
 How to handle command line arguments in Python scripts.
 

source-code/config-parser/README.md

@@ -1,11 +1,10 @@
-ConfigParser
-============
+# ConfigParser
 
 ConfigParser is a module in Python's standard library to handle
 configuration files easily.
 
-What is it?
------------
+## What is it?
+
 1. `config_reader.py`: reads a configuration file provided on the command
    line, or `default.conf`.  It prints the sections of the configuration
    files, and the key/value pairs defined therein.

source-code/file-system/README.md

@@ -1,4 +1,5 @@
-# OsFileSystem
+# File system
+
 Examples of code interacting with the operating system or performing
 file system operations.
 

source-code/hydra/README.md

@@ -7,6 +7,7 @@ It support configuration file handling, command line arguments, logging,
 multiruns and so on.
 
 ## What is it?
+
 1. `gen_rand.py`: Python script to write random numbers to standard
    output.
 1. `conf/`: directory containing the configuration files.

source-code/logging/README.md

@@ -1,12 +1,10 @@
-Logging
-=======
+# Logging
 
 Using logging facilities rather than print or sys.stderr.write calls
 adds a lot of flexibility to more complex programs.  These facilities
 are provided through Python's standard library.
 
-What is it?
------------
+## What is it?
+
 `log_it_all.py`: illustration of how to use the default logging mechanisms,
 how to set the log level the destination, and the log format
-

source-code/paramiko/README.md

@@ -1,9 +1,11 @@
 # Paramiko
+
 Paramiko is a non-standard Python library for working with SSH.  It can
 be used to execute command on a remote host, or perform file transfers
 using the SFTP protocol.
 
 ## What is it?
+
 1. `ssh.py`: module with some SSH connection utitlity functions, imported
     in the scripts.
 1. `ls.py`: performs an `ls` command for the specified directory on a

source-code/subprocess/README.md

@@ -1,14 +1,12 @@
-Executing external programs or shell commands
-=============================================
+# Executing external programs or shell commands
 
 Executing external programs or shell commands can conveniently be done
 using Python's `subprocess` module in the standard library.  It allows
 to send input to the external command (if necessary), and capture
 what is sent to standard output and/or standard error by that command.
 The exit code can also be retrieved.
 
-What is it?
------------
+## What is it?
+
 `wc_metrics.py`: this script computes the number of characters, words, and
 lines in a file using the shell's `wc` commaand.
-

source-code/xml-generator/README.md

@@ -1,10 +1,9 @@
-XmlGenerator
-============
+# XML generator
 
 Generates random XML documents, the number of different tags, the number
 of elements, whether or not the elements contain text, as well as their
 length can all be configured.
 
-What is it?
------------
+## What is it?
+
 1. `gen_xml.py`: generator for random XML documents.