man1/git-sh-i18n.1

   1 '\" t
   2 .\"     Title: git-sh-i18n
   3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 03/06/2023
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.40.0.rc2
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-SH\-I18N" "1" "03/06/2023" "Git 2\&.40\&.0\&.rc2" "Git Manual"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 git-sh-i18n \- Git\(aqs i18n setup code for shell scripts
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 \fI\&. "$(git \-\-exec\-path)/git\-sh\-i18n"\fR
  36 .fi
  37 .sp
  38 .SH "DESCRIPTION"
  39 .sp
  40 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\&.
  41 .sp
  42 The \(aqgit sh\-i18n scriptlet is designed to be sourced (using \fB\&.\fR) by Git\(cqs porcelain programs implemented in shell script\&. It provides wrappers for the GNU \fBgettext\fR and \fBeval_gettext\fR functions accessible through the \fBgettext\&.sh\fR script, and provides pass\-through fallbacks on systems without GNU gettext\&.
  43 .SH "FUNCTIONS"
  44 .PP
  45 gettext
  46 .RS 4
  47 Currently a dummy fall\-through function implemented as a wrapper around
  48 \fBprintf(1)\fR\&. Will be replaced by a real gettext implementation in a later version\&.
  49 .RE
  50 .PP
  51 eval_gettext
  52 .RS 4
  53 Currently a dummy fall\-through function implemented as a wrapper around
  54 \fBprintf(1)\fR
  55 with variables expanded by the
  56 \fBgit-sh-i18n--envsubst\fR(1)
  57 helper\&. Will be replaced by a real gettext implementation in a later version\&.
  58 .RE
  59 .SH "GIT"
  60 .sp
  61 Part of the \fBgit\fR(1) suite