Respect default values specified via `default`

The existing documentation generator doesn't take into consideration
defaults declared like so:

    default :codec => 'json'

This fixes issue #1827.