Manpage formatting tweaks#132338
Open
stefanor wants to merge 2 commits into
Open
Conversation
stefanor
force-pushed
the
manpage-lint
branch
from
1afe878 to
3620666
Compare
|
This PR is stale because it has been open for 30 days with no activity. |
Following on from pythonGH-132291 this is the second part of the patch from https://bugs.debian.org/1101406 This tweaks the formatting of a few bits of the manpage.
github-actions
Bot
removed
the
stale
encukou
reviewed
May 20, 2026
Comment on lines
+258
to
+266
| .nf | ||
| \-Wdefault # Warn once per call location | ||
| \-Werror # Convert to exceptions | ||
| \-Walways # Warn every time | ||
| \-Wall # Same as \-Walways | ||
| \-Wmodule # Warn once per calling module | ||
| \-Wonce # Warn once per Python process | ||
| \-Wignore # Never warn | ||
| .fi |
Member
There was a problem hiding this comment.
This doesn't show up in the render diffs; what does it do?
Contributor
Author
There was a problem hiding this comment.
Temporarily turns off "line filling", for a code block.
The practical effect here is that if it wraps a long line, it wraps all the way to the left margin rather than being indented to the same level. I'm not 100% sold on this being an improvement, but I have seen it described as being useful for code blocks.
Comment on lines
+588
to
+589
| The integer must be a decimal number in the range [0,4\|294\|967\|295]. | ||
| Specifying the value 0 will disable hash randomization. |
Member
There was a problem hiding this comment.
This also doesn't show up in the diffs.
Contributor
Author
There was a problem hiding this comment.
These are "thin-spaces". Only visible in renderings like PDF:
Contributor
Author
|
Updated the gist with render diffs. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Following on from GH-132291 this is the second part of the patch from https://bugs.debian.org/1101406
This tweaks the formatting of a few bits of the manpage.
For those who don't speak roff, here are some rendering diffs: https://gist.github.com/stefanor/da32324f80e36f27819ba22ae0ab2098