(maint) PUP-3638 clarify puppet-doc manpage re: rdoc on manifests

remove the manifest examples and related doc
this functionality has been removed in PUP-3638