fix up function documentation

[plastikfan]

See https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_comment_based_help?view=powershell-7

branch: function-doc