diff --git a/PowerShellSyntax.tmLanguage b/PowerShellSyntax.tmLanguage
index 11bab40..a055c13 100644
--- a/PowerShellSyntax.tmLanguage
+++ b/PowerShellSyntax.tmLanguage
@@ -388,10 +388,10 @@
commentLine
begin
- (?<![`\\-])#
+ (?<![`\\-])(#)#*
captures
- 0
+ 1
name
punctuation.definition.comment.powershell
@@ -556,8 +556,10 @@
keyword.operator.documentation.powershell
+ comment
+ these embedded doc keywords do not support arguments, must be the only thing on the line
match
- ^(?i:(?:\s?|#)+(\.)(COMPONENT|DESCRIPTION|EXAMPLE|EXTERNALHELP|FORWARDHELPCATEGORY|FORWARDHELPTARGETNAME|FUNCTIONALITY|INPUTS|LINK|NOTES|OUTPUTS|REMOTEHELPRUNSPACE|ROLE|SYNOPSIS))
+ (?:^|\G)(?i:\s*(\.)(COMPONENT|DESCRIPTION|EXAMPLE|FUNCTIONALITY|INPUTS|LINK|NOTES|OUTPUTS|ROLE|SYNOPSIS))\s*$
name
comment.documentation.embedded.powershell
@@ -580,8 +582,10 @@
keyword.operator.documentation.powershell
+ comment
+ these embedded doc keywords require arguments though the type required may be inconsistent, they may not all be able to use the same argument match
match
- (?i:\s?(\.)(PARAMETER|FORWARDHELPTARGETNAME|FORWARDHELPCATEGORY|REMOTEHELPRUNSPACE|EXTERNALHELP)\s+([a-z0-9-_]+))
+ (?:^|\G)(?i:\s*(\.)(EXTERNALHELP|FORWARDHELP(?:CATEGORY|TARGETNAME)|PARAMETER|REMOTEHELPRUNSPACE))\s+(.+?)\s*$
name
comment.documentation.embedded.powershell