Updated git_doc to git 1.8
[TortoiseGit.git] / doc / source / en / TortoiseGit / git_doc / git-sh-i18n.xml
blobe4ef18507e138a61d695b0af322b913949a768dd
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">\r
3 \r
4 <sect2 lang="en" id="git-sh-i18n(1)">\r
5     <title>git-sh-i18n(1)</title>\r
6 <indexterm>\r
7 <primary>git-sh-i18n(1)</primary>\r
8 </indexterm>\r
9 <simplesect id="git-sh-i18n(1)__name">\r
10 <title>NAME</title>\r
11 <simpara>git-sh-i18n - Git's i18n setup code for shell scripts</simpara>\r
12 </simplesect>\r
13 <simplesect id="git-sh-i18n(1)__synopsis">\r
14 <title>SYNOPSIS</title>\r
15 <blockquote>\r
16 <literallayout><emphasis>. "$(git --exec-path)/git-sh-i18n"</emphasis></literallayout>\r
17 </blockquote>\r
18 </simplesect>\r
19 <simplesect id="git-sh-i18n(1)__description">\r
20 <title>DESCRIPTION</title>\r
21 <simpara>This is not a command the end user would want to run.  Ever.\r
22 This documentation is meant for people who are studying the\r
23 Porcelain-ish scripts and/or are writing new ones.</simpara>\r
24 <simpara>The 'git sh-i18n scriptlet is designed to be sourced (using\r
25 <emphasis>.</emphasis>) by Git's porcelain programs implemented in shell\r
26 script. It provides wrappers for the GNU <emphasis>gettext</emphasis> and\r
27 <emphasis>eval_gettext</emphasis> functions accessible through the <emphasis>gettext.sh</emphasis>\r
28 script, and provides pass-through fallbacks on systems\r
29 without GNU gettext.</simpara>\r
30 </simplesect>\r
31 <simplesect id="git-sh-i18n(1)__functions">\r
32 <title>FUNCTIONS</title>\r
33 <variablelist>\r
34 <varlistentry>\r
35 <term>\r
36 gettext\r
37 </term>\r
38 <listitem>\r
39 <simpara>\r
40         Currently a dummy fall-through function implemented as a wrapper\r
41         around <emphasis>printf(1)</emphasis>. Will be replaced by a real gettext\r
42         implementation in a later version.\r
43 </simpara>\r
44 </listitem>\r
45 </varlistentry>\r
46 <varlistentry>\r
47 <term>\r
48 eval_gettext\r
49 </term>\r
50 <listitem>\r
51 <simpara>\r
52         Currently a dummy fall-through function implemented as a wrapper\r
53         around <emphasis>printf(1)</emphasis> with variables expanded by the\r
54         <xref linkend="git-sh-i18n&#45;&#45;envsubst(1)" /> helper. Will be replaced by a\r
55         real gettext implementation in a later version.\r
56 </simpara>\r
57 </listitem>\r
58 </varlistentry>\r
59 </variablelist>\r
60 </simplesect>\r
61 <simplesect id="git-sh-i18n(1)__git">\r
62 <title>GIT</title>\r
63 <simpara>Part of the <xref linkend="git(1)" /> suite</simpara>\r
64 </simplesect>\r
65 </sect2>\r