Fix #175

Author: ShaunLawrie

HelpOut.types.ps1xml

@@ -61,8 +61,13 @@ $FilePath,
 $View = 'PowerShell.Markdown.Help'
 )
 
-if ($filePath -match '[\<\>\|\?\*\:]') {
-    Write-Warning "Will not .Save to $filePath, because that path will not be readable on all operating systems."
+$illegalCharacters = @('<', '>', '|', '?', '*', ':')
+$illegalCharacterRegex = '[' + ($illegalCharacters | Foreach-Object { [regex]::Escape($_) }) + ']'
+$illegalCharacterReadable = ($illegalCharacters | Foreach-Object { "`"$_`"" }) -join ', '
+
+$filePathWithoutQualifier = Split-Path $filePath -NoQualifier
+if ($filePathWithoutQualifier -match $illegalCharacterRegex) {
+    Write-Warning "Will not .Save to $filePath, because that path will not be readable on all operating systems. It cannot contain any of the characters $illegalCharacterReadable."
     return
 }
 

Types/PowerShell.Markdown.Help/Save.ps1

@@ -22,8 +22,13 @@ $FilePath,
 $View = 'PowerShell.Markdown.Help'
 )
 
-if ($filePath -match '[\<\>\|\?\*\:]') {
-    Write-Warning "Will not .Save to $filePath, because that path will not be readable on all operating systems."
+$illegalCharacters = @('<', '>', '|', '?', '*', ':')
+$illegalCharacterRegex = '[' + ($illegalCharacters | Foreach-Object { [regex]::Escape($_) }) + ']'
+$illegalCharacterReadable = ($illegalCharacters | Foreach-Object { "`"$_`"" }) -join ', '
+
+$filePathWithoutQualifier = Split-Path $filePath -NoQualifier
+if ($filePathWithoutQualifier -match $illegalCharacterRegex) {
+    Write-Warning "Will not .Save to $filePath, because that path will not be readable on all operating systems. It cannot contain any of the characters $illegalCharacterReadable."
     return
 }