Correct puppet-strings documentation (#192)

In various places @attr was used instead of @param. It also didn't use
the @summary tag which led to odd summaries. Then some indenting was
incorrect.

It also uses a newer version of puppet-strings which generates a
list of parameters with links.