Comment Help Badly Broken

[mattpwhite]

System Details

[PS 5.1] ~ $ code -v
1.27.1
5944e81f3c46a3938a82c701f96d7a59b074cfdc
x64
[PS 5.1] ~ $ $pseditor.EditorServicesVersion

Major  Minor  Build  Revision
-----  -----  -----  --------
1      8      4      0


[PS 5.1] ~ $ code --list-extensions --show-versions
[createInstance] extensionManagementService depends on downloadService which is NOT registered.
DotJoshJohnson.xml@2.3.2
eamodio.gitlens@8.5.6
k--kato.docomment@0.1.2
ms-vscode.cpptools@0.18.1
ms-vscode.csharp@1.16.1
ms-vscode.PowerShell@1.8.4
robertohuertasm.vscode-icons@7.26.0
[PS 5.1] ~ $ $PSVersionTable

Name                           Value
----                           -----
PSVersion                      5.1.15063.1292
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.15063.1292
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

Issue Description

Using ## to insert a help block seems to be broken pretty badly. See below.

Attached Logs

1537544346-abc98747-b062-4656-813c-b7a3fb0a1f0b1537544225572.zip

[rjmholt]

This is a duplicate of #1509.

Originally caused by PowerShell/PowerShellEditorServices#715, and fixed in PowerShell/PowerShellEditorServices#740.

[mattpwhite]

Sorry for the dupe (and the bug, which I guess was mine) :/

[rjmholt]

Haha, no worries! It ain't fixed til it's released -- so I'm hoping we can do that next week at some point.

We got comment help above the function working and released first, so one "workaround" is to expand the comment help snippet above the function and then cut/paste it below the function.