The strange looking syntax the head-of-file docs are in is in
compliance with the new puppet-strings system for inline documentation
This enables neato stuff like 'puppet string <modulename>' to get docs
on the command line, and generating html, which we could then ship to
somewhere.
Change-Id: Icb0be2c733e4d3ee6beff32780c171b9f750b06f