Duplicate help files in PSWorkflow module break Get-Help
At some point in the 5.0 time period, Update-Help installed About topic files in the en-US directory for the PSWorkflow module with .txt (not .help.txt) file name extensions.
Later, this was fixed and Update-Help installed the same help files in the same directory with the (correct) ".help.txt" file name extension.
Now, the PSWorkflow\en-US directory has 9 pairs of files that are identical except for the file name extension.
Get-Help should ignore the .txt files (must have changed in 4.0), but it does not. Instead, it finds both .txt and .help.txt. So, when you run Get-Help, instead of displaying help for the topic, it lists the duplicate base names.
PS C:\ps-test> Get-Help about_Foreach-Parallel
Name Category Module Synopsis
aboutForEach-Parallel HelpFile Describes the ForEach
aboutForeach-Parallel HelpFile Describes the ForEach
I'm not sure why Get-Help is recognizing About.txt files.
But, we had a similar problem in a module when we shipped a file with corrected capitalization in the base name.
We might want to tweak Get-Help so that when it detects an exact duplicate base name, it displays the content in the newest file.
Also, in modules, Get-Help should display the help only for the version of the module that it's processing. That would allow module authors to update help topic names without causing unintended duplicates.
On Windows 2019 Datacenter:
Help files (all with Date Modified 2015-08-09) are in
which confuses PowerShell when getting the help for about_Workflows for example.
They are also in
Deleting those from Modules\PSWorkflow!
Heinz Repp commented
ls ..\Modules\PSWorkflow\en-US\about_*.help.txt | foreach Name | rm
Jim Vierra commented
This seems to have been fixed on 51/W10 but a new issue ahs surfaced:
The help files now exist in two places:
Which also causes the duplicate refrences and blocks access to the help files duplicated. Renaming the files in "C:\Windows\System32\WindowsPowerShell\v1.0\en-US" fixes the issue. The issue happens for more than the WF module..