about summary refs log tree commit diff
path: root/third_party/git/Documentation/git-sh-i18n.txt
blob: 60cf49cb2a38df99d4526698576acd5cb6c979c4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
git-sh-i18n(1)
==============

NAME
----
git-sh-i18n - Git's i18n setup code for shell scripts

SYNOPSIS
--------
[verse]
'. "$(git --exec-path)/git-sh-i18n"'

DESCRIPTION
-----------

This is not a command the end user would want to run.  Ever.
This documentation is meant for people who are studying the
Porcelain-ish scripts and/or are writing new ones.

The 'git sh-i18n scriptlet is designed to be sourced (using
`.`) by Git's porcelain programs implemented in shell
script. It provides wrappers for the GNU `gettext` and
`eval_gettext` functions accessible through the `gettext.sh`
script, and provides pass-through fallbacks on systems
without GNU gettext.

FUNCTIONS
---------

gettext::
	Currently a dummy fall-through function implemented as a wrapper
	around `printf(1)`. Will be replaced by a real gettext
	implementation in a later version.

eval_gettext::
	Currently a dummy fall-through function implemented as a wrapper
	around `printf(1)` with variables expanded by the
	linkgit:git-sh-i18n{litdd}envsubst[1] helper. Will be replaced by a
	real gettext implementation in a later version.

GIT
---
Part of the linkgit:git[1] suite