Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 287101 - dev-util/git: minor misformatting in manpages
Summary: dev-util/git: minor misformatting in manpages
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Development (show other bugs)
Hardware: All All
: High normal (vote)
Assignee: Robin Johnson
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-09-30 14:34 UTC by Jonas Bernoulli
Modified: 2009-10-11 22:28 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
fix manpage glitch (manpage.patch,457 bytes, patch)
2009-09-30 14:35 UTC, Jonas Bernoulli
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Jonas Bernoulli 2009-09-30 14:34:20 UTC
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.
Comment 1 Jonas Bernoulli 2009-09-30 14:35:29 UTC
Created attachment 205681 [details, diff]
fix manpage glitch
Comment 2 Robin Johnson archtester Gentoo Infrastructure gentoo-dev Security 2009-10-11 22:28:08 UTC
InCVS.