Skip to content

ShowCommandHelp (F1), with fuzzy input, doesn't consistently find all relevant topics, sometimes display single match in a list instead of opening the topic #3571

Open
@mklement0

Description

@mklement0

Prerequisites

  • Write a descriptive title.
  • Make sure you are able to repro it on the latest released version
  • Search the existing issues, especially the pinned issues.

Exception report

N/A

Screenshot

N/A

Environment data

PS Version: 7.4.0-preview.1
PS HostName: ConsoleHost
PSReadLine Version: 2.2.6
PSReadLine EditMode: Emacs
OS: Darwin JDoes-MacBook-Pro.local 22.2.0 Darwin Kernel Version 22.2.0: Fri Nov 11 02:03:51 PST 2022; root:xnu-8792.61.2~4/RELEASE_ARM64_T6000 arm64
BufferWidth: 180
BufferHeight: 60

Steps to reproduce

Even though it isn't currently documented, ShowCommandHelp also recognizes parts of conceptual about_* topic titles and partial command names.

However,

  • this recognition is inconsistent
  • sometimes, instead of displaying what is seemingly a single matching topic directly, it is presented in a list as if multiple topics had matched.
# OK: Shows list of matching command help topics: Add-Content, Clear-Content, ...
PS> content # <- press F1 here

# !! about_* topic seemingly SHADOWS command lookup: only about_PSItem is shown, not also Get-Item, ...
PS> item # <- press F1 here

# !! Even though *two* matching about_* topics exist - about_Automatic_Variables and about_Variables - 
# !! only *one* is shown (about_Automatic_Variables), and unexpectedly in a *list* instead of directly.
PS> variables # <- press F1 here

Related issue, specific to language keywords:

Also, with respect to the inability to select a topic of interest when multiple ones match:

Expected behavior

See above.

Actual behavior

See above.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Area-CommandHelpLabel for issues related to ShowCommandHelp and the pagerIssue-EnhancementIt's a feature request.

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions