semop.2, proc.5, cgroup_namespaces.7, cgroups.7: Fix scrambled scopes #10
Conversation
This file contains 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
The manpages commonly use .in +4/.EX....EE/.in pairs for iindented examples. Clean up four exceptional instances out of hundreds in which the .in was the inner operation rather than the outer. No difference in rendering, but the uniformity makes it possible to parse these mechanically with one rule. Really all these ought to be replaced with .RS/.EX....EE/.RE but doclifter can cope given this less intrusive change.
Scoped macros make parsing this markup less painful.
|
Added to pull request: In inode,7, replace some .in uses with .RS/.RE. I'd have made this a separate pull request, but I don't use github often enough to know how to beat it into doing this. |
If this was supposed to have a matching .RE somewhere, it should be added.
|
Added: In seccomp.2: Remove unbalanced .RS tag. |
As the markup is now written (with low-level tab operations) it is hopeless to try translating it structurally to HTML or XML. Moving these examples to be table displays fixes the problem while keeping the visual changes relatively minor.
|
Added: in zic.8, fix up examples so they can translate to clean HTML/XML. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
The manpages commonly use .in +4/.EX....EE/.in pairs for iindented examples.
Clean up four exceptional instances out of hundreds in which the .in
was the inner operation rather than the outer. No difference in
rendering, but the uniformity makes it possible to parse these
mechanically with one rule.
Really all these ought to be replaced with .RS/.EX....EE/.RE but
doclifter can cope given this less intrusive change.