Comment-Based Help

[AspenForester]

I can see from the source code that comment-based help should exist for, at least, Set-PolicyFileEntry, but after installing the module (v3.0.1) from PSGallery on a Win10 1709 machine, doing a `Get-Help Set-PolicyFileEntry -showwindow' is only giving me the basic, auto-generated help. That leads me to think there might be something wrong with the help block, but I haven't found it yet.

I'm going to fork the project and see what I can see in VSCode, and if I find something I'll make a pull request.

I just wanted you to be aware that I'm looking at it. If it's some sort of known issue, feel free to wave me off.

[dlwyatt]

Heh. I just spent some time diving through PS internals on this, and it's a stupid one.

See where I've wrapped the text and the first words on a line happen to be ".pol file"? PowerShell's parser says "well that line matches the pattern for things like .PARAMETER, etc, but we don't know what the heck ".pol" is, so this whole thing is not a valid comment-based help block."