@matheusbsbs / matheus-bagliano / commits / 27269fc5f2

Documentation/i18n: quote double-dash for AsciiDoc

As explained in v1.7.3-rc0~13^2 (Work around em-dash handling in newer AsciiDoc, 2010-08-23), if double dashes in names of commands are not escaped, AsciiDoc renders them as em dashes. While fixing that, spell the command name as "git sh-i18n--envsubst" (2 words) instead of emphasizing the name of the binary (one hyphenated name) and format it in italics. The double-dash in the title should be escaped, too, to avoid spurious em dashes in the header: .TH "GIT\-SH\-I18N\(emENVSUB" "1" "06/26/2011" "Git 1\&.7\&.6" "Git Manual" AsciiDoc 8.6.4 with DocBook XSL 1.76.0-RC1 copes fine and writes "GIT\-SH\-I18N\-\-ENVSUB" even without this change, which is why it was missed before. Signed-off-by: Jonathan Nieder <jrnieder@gmail.com> Acked-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Jonathan Nieder committed Jun 29, 2011 at 00:36 UTC 27269fc5f2781cd8f6e832043f9abf7305aa3d49

2 files changed +6 -6

Documentation/git-sh-i18n--envsubst.txt

+5 -5

@@ -1,5 +1,5 @@

1 -git-sh-i18n--envsubst(1)

2 -========================

1 +git-sh-i18n{litdd}envsubst(1)

2 +=============================

4 NAME

5 ----

@@ -10,8 +10,8 @@ SYNOPSIS

10 [verse]

11 eval_gettext () {

12 printf "%s" "$1" | (

13 - export PATH $('git sh-i18n--envsubst' --variables "$1");

14 - 'git sh-i18n--envsubst' "$1"

13 + export PATH $('git sh-i18n{litdd}envsubst' --variables "$1");

14 + 'git sh-i18n{litdd}envsubst' "$1"

15 )

16 }

@@ -22,7 +22,7 @@ This is not a command the end user would want to run. Ever.

22 This documentation is meant for people who are studying the

23 plumbing scripts and/or are writing new ones.

25 -git-sh-i18n--envsubst is Git's stripped-down copy of the GNU

25 +'git sh-i18n{litdd}envsubst' is Git's stripped-down copy of the GNU

26 `envsubst(1)` program that comes with the GNU gettext package. It's

27 used internally by linkgit:git-sh-i18n[1] to interpolate the variables

28 passed to the the `eval_gettext` function.

Documentation/git-sh-i18n.txt

+1 -1

@@ -34,7 +34,7 @@ gettext::

34 eval_gettext::

35 Currently a dummy fall-through function implemented as a wrapper

36 around `printf(1)` with variables expanded by the

37 - linkgit:git-sh-i18n--envsubst[1] helper. Will be replaced by a

37 + linkgit:git-sh-i18n{litdd}envsubst[1] helper. Will be replaced by a

38 real gettext implementation in a later version.

40 GIT