| Summary: | dev-util/git: minor misformatting in manpages | ||
|---|---|---|---|
| Product: | Gentoo Linux | Reporter: | Jonas Bernoulli <jonas> |
| Component: | [OLD] Development | Assignee: | Robin Johnson <robbat2> |
| Status: | RESOLVED FIXED | ||
| Severity: | normal | CC: | ricmm |
| Priority: | High | ||
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | All | ||
| Whiteboard: | |||
| Package list: | Runtime testing required: | --- | |
| Attachments: | fix manpage glitch | ||
Created attachment 205681 [details, diff]
fix manpage glitch
InCVS. |
Many git manpages contain minor glitches like this: .ft C $ git add Documentation/\\*.txt .ft At least when using >=app-text/asciidoc-8.1.0 this can be fixed by setting ASCIIDOC_NO_ROFF and ASCIIDOC8. Reproducible: Always Steps to Reproduce: Actual Results: glitches in manpages Expected Results: no glitches in manpages This is what 'Documentation/Makefile' has to say about it. # # For asciidoc ... # -7.1.2, no extra settings are needed. # 8.0-, set ASCIIDOC8. # # # For docbook-xsl ... # -1.68.1, set ASCIIDOC_NO_ROFF? (based on changelog from 1.73.0) # 1.69.0, no extra settings are needed? # 1.69.1-1.71.0, set DOCBOOK_SUPPRESS_SP? # 1.71.1, no extra settings are needed? # 1.72.0, set DOCBOOK_XSL_172. # 1.73.0-, set ASCIIDOC_NO_ROFF # # # If you had been using DOCBOOK_XSL_172 in an attempt to get rid # of 'the ".ft C" problem' in your generated manpages, and you # instead ended up with weird characters around callouts, try # using ASCIIDOC_NO_ROFF instead (it works fine with ASCIIDOC8). # The attached patch follows these recommendations.