GIT-SH-SETUP(1) Git Manual GIT-SH-SETUP(1)

NAME
       git-sh-setup - Common Git shell script setup code

SYNOPSIS
       . "$(git exec-path)/git-sh-setup"


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-setup scriptlet is designed to be sourced (using .) by other
       shell scripts to set up some variables pointing at the normal Git
       directories and a few helper shell functions.

       Before sourcing it, your script should set up a few variables; USAGE
       (and LONGUSAGE, if any) is used to define message given by usage()
       shell function. SUBDIRECTORYOK can be set if the script can run from a
       subdirectory of the working tree (some commands do not).

       The scriptlet sets GITDIR and GITOBJECTDIRECTORY shell variables,
       but does not export them to the environment.

FUNCTIONS
       die
           exit after emitting the supplied error message to the standard
           error stream.

       usage
           die with the usage message.

       setreflogaction
           set the message that will be recorded to describe the end-user
           action in the reflog, when the script updates a ref.

       giteditor
           runs an editor of user’s choice (GITEDITOR, core.editor, VISUAL or
           EDITOR) on a given file, but error out if no editor is specified
           and the terminal is dumb.

       isbarerepository
           outputs true or false to the standard output stream to indicate if
           the repository is a bare repository (i.e. without an associated
           working tree).

       cdtotoplevel
           runs chdir to the toplevel of the working tree.

       requireworktree
           checks if the current directory is within the working tree of the
           repository, and otherwise dies.

       requireworktreeexists
           checks if the working tree associated with the repository exists,
           and otherwise dies. Often done before calling cdtotoplevel, which
           is impossible to do if there is no working tree.

       requirecleanworktree  []
           checks that the working tree and index associated with the
           repository have no uncommitted changes to tracked files. Otherwise
           it emits an error message of the form Cannot : .
           , and dies. Example:

               requirecleanworktree rebase "Please commit or stash them."


       getauthoridentfromcommit
           outputs code for use with eval to set the GITAUTHORNAME,
           GITAUTHOREMAIL and GITAUTHORDATE variables for a given commit.

       createvirtualbase
           modifies the first file so only lines in common with the second
           file remain. If there is insufficient common material, then the
           first file is left empty. The result is suitable as a virtual base
           input for a 3-way merge.

GIT
       Part of the git(1) suite



Git 1.8.3.1                       11/02/2018                   GIT-SH-SETUP(1)