Git Shell I18n Setup Code

1st chunk of `Documentation/git-sh-i18n.adoc`

0f8b8f5b3afe5e71f77737a452e68a5d78e0b736ce2676e8000000010000047b

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

Title: Git Shell I18n Setup Code

Summary

The git-sh-i18n script provides internationalization setup for Git's shell scripts, offering wrappers for GNU gettext functions and fallbacks for systems without GNU gettext, allowing developers to implement localization in their scripts, with functions like gettext and eval_gettext currently serving as dummy fall-throughs.