Repository navigation
Installed manpage on Linux does not look like pwsh.1.ronn #21086
Description
Prerequisites
- Write a descriptive title.
- Make sure you are able to repro it on the latest released version
- Search the existing issues.
- Refer to the FAQ.
- Refer to Differences between Windows PowerShell 5.1 and PowerShell.
Steps to reproduce
The man page from the 7.4.1 deb package is rather terse/truncated
Expected behavior
I would like the man page contents to look like pwsh.1.ronn
Actual behavior
PWSH(1) PWSH(1)
NAME
pwsh - PowerShell command-line shell and .NET REPL
SYNOPSIS
pwsh [-Login] [ [-File] filePath [args] ] [-Command { - | script-block [-args arg-array] | string [CommandPa‐
rameters] } ] [-ConfigurationFile filePath] [-ConfigurationName string] [-CustomPipeName string] [-EncodedAr‐
guments Base64EncodedArguments] [-EncodedCommand Base64EncodedCommand] [-ExecutionPolicy ExecutionPolicy]
[-Help] [-InputFormat {Text | XML}] [-Interactive] [-MTA] [-NoExit] [-NoLogo] [-NonInteractive] [-NoProfile]
[-NoProfileLoadTime] [-OutputFormat {Text | XML}] [-SettingsFile filePath] [-SSHServerMode] [-STA] [-Version]
[-WindowStyle
January 2024 PWSH(1)Error details
noneEnvironment data
Name Value
---- -----
PSVersion 7.4.1
PSEdition Core
GitCommitId 7.4.1
OS Ubuntu 22.04.3 LTS
Platform Unix
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
WSManStackVersion 3.0Visuals
No response
Activity
237dmitry commentedon Jan 17, 2024
Converted to
man(troff) format,ronnrequires a long list of dependencies (ruby etc). As formanitself:amcmannis commentedon Apr 17, 2024
Can confirm with the RHEL packages as well.
EDIT: Was able to generate a more decent man using pandoc:
pandoc -s -f gfm -t man -o pwsh.man pwsh.mdChrisTX commentedon Jun 29, 2026
ronnbreaking is due to the unescaped< >brackets. Specifically,-WindowStyle <style>in the header causesronnto assume the rest of the document is the content of a style tag and thus not rendered.Adding backslashes to escape them will make
ronnproduce the page as expected. It will look slightly better than usingpandocsince its headers are properly understood.powershell: check the generated man page