Updated metadata syntax doc.

To reflect new support for merge keys and message string substitution.
Doxygen docs improvements.

Added (sparse) version history section, and mention of GitHub Flavored
Markdown formatting in message strings.
Updated archive script.

Tidied it up a bit, and also added creation of a separate archive for
the API files.