Add documentation for freebsd{} and freebsd_portmaster{}

Redmine#3616 - added documentation for freebsd and freebsd_portmaster methods for 3.5.3. 
Removed one comment; can't use RPM for it anyway due to pkg/pkgng behaviors with descriptions.