SM0 She11

Path: / / usr / share / doc / git-1.8.3.1

Full Path (server): /usr/share/doc/git-1.8.3.1

📄 COPYING [E] [D]
📄 README [E] [D]
📁 RelNotes Open [D]
📄 blame-options.txt [E] [D]
📄 cmds-ancillaryinterrogators.txt [E] [D]
📄 cmds-ancillarymanipulators.txt [E] [D]
📄 cmds-foreignscminterface.txt [E] [D]
📄 cmds-mainporcelain.txt [E] [D]
📄 cmds-plumbinginterrogators.txt [E] [D]
📄 cmds-plumbingmanipulators.txt [E] [D]
📄 cmds-purehelpers.txt [E] [D]
📄 cmds-synchelpers.txt [E] [D]
📄 cmds-synchingrepositories.txt [E] [D]
📄 config.txt [E] [D]
📁 contrib Open [D]
📄 date-formats.txt [E] [D]
📄 diff-config.txt [E] [D]
📄 diff-format.txt [E] [D]
📄 diff-generate-patch.txt [E] [D]
📄 diff-options.txt [E] [D]
📄 docbook-xsl.css [E] [D]
📄 everyday.html [E] [D]
📄 everyday.txt [E] [D]
📄 fetch-options.txt [E] [D]
📄 git-add.html [E] [D]
📄 git-add.txt [E] [D]
📄 git-am.html [E] [D]
📄 git-am.txt [E] [D]
📄 git-annotate.html [E] [D]
📄 git-annotate.txt [E] [D]
📄 git-apply.html [E] [D]
📄 git-apply.txt [E] [D]
📄 git-archive.html [E] [D]
📄 git-archive.txt [E] [D]
📄 git-bisect-lk2009.html [E] [D]
📄 git-bisect-lk2009.txt [E] [D]
📄 git-bisect.html [E] [D]
📄 git-bisect.txt [E] [D]
📄 git-blame.html [E] [D]
📄 git-blame.txt [E] [D]
📄 git-branch.html [E] [D]
📄 git-branch.txt [E] [D]
📄 git-bundle.html [E] [D]
📄 git-bundle.txt [E] [D]
📄 git-cat-file.html [E] [D]
📄 git-cat-file.txt [E] [D]
📄 git-check-attr.html [E] [D]
📄 git-check-attr.txt [E] [D]
📄 git-check-ignore.html [E] [D]
📄 git-check-ignore.txt [E] [D]
📄 git-check-ref-format.html [E] [D]
📄 git-check-ref-format.txt [E] [D]
📄 git-checkout-index.html [E] [D]
📄 git-checkout-index.txt [E] [D]
📄 git-checkout.html [E] [D]
📄 git-checkout.txt [E] [D]
📄 git-cherry-pick.html [E] [D]
📄 git-cherry-pick.txt [E] [D]
📄 git-cherry.html [E] [D]
📄 git-cherry.txt [E] [D]
📄 git-citool.html [E] [D]
📄 git-citool.txt [E] [D]
📄 git-clean.html [E] [D]
📄 git-clean.txt [E] [D]
📄 git-clone.html [E] [D]
📄 git-clone.txt [E] [D]
📄 git-column.html [E] [D]
📄 git-column.txt [E] [D]
📄 git-commit-tree.html [E] [D]
📄 git-commit-tree.txt [E] [D]
📄 git-commit.html [E] [D]
📄 git-commit.txt [E] [D]
📄 git-config.html [E] [D]
📄 git-config.txt [E] [D]
📄 git-count-objects.html [E] [D]
📄 git-count-objects.txt [E] [D]
📄 git-credential-cache--daemon.html [E] [D]
📄 git-credential-cache--daemon.txt [E] [D]
📄 git-credential-cache.html [E] [D]
📄 git-credential-cache.txt [E] [D]
📄 git-credential-store.html [E] [D]
📄 git-credential-store.txt [E] [D]
📄 git-credential.html [E] [D]
📄 git-credential.txt [E] [D]
📄 git-cvsexportcommit.html [E] [D]
📄 git-cvsexportcommit.txt [E] [D]
📄 git-cvsimport.html [E] [D]
📄 git-cvsimport.txt [E] [D]
📄 git-cvsserver.html [E] [D]
📄 git-cvsserver.txt [E] [D]
📄 git-daemon.html [E] [D]
📄 git-daemon.txt [E] [D]
📄 git-describe.html [E] [D]
📄 git-describe.txt [E] [D]
📄 git-diff-files.html [E] [D]
📄 git-diff-files.txt [E] [D]
📄 git-diff-index.html [E] [D]
📄 git-diff-index.txt [E] [D]
📄 git-diff-tree.html [E] [D]
📄 git-diff-tree.txt [E] [D]
📄 git-diff.html [E] [D]
📄 git-diff.txt [E] [D]
📄 git-difftool.html [E] [D]
📄 git-difftool.txt [E] [D]
📄 git-fast-export.html [E] [D]
📄 git-fast-export.txt [E] [D]
📄 git-fast-import.html [E] [D]
📄 git-fast-import.txt [E] [D]
📄 git-fetch-pack.html [E] [D]
📄 git-fetch-pack.txt [E] [D]
📄 git-fetch.html [E] [D]
📄 git-fetch.txt [E] [D]
📄 git-filter-branch.html [E] [D]
📄 git-filter-branch.txt [E] [D]
📄 git-fmt-merge-msg.html [E] [D]
📄 git-fmt-merge-msg.txt [E] [D]
📄 git-for-each-ref.html [E] [D]
📄 git-for-each-ref.txt [E] [D]
📄 git-format-patch.html [E] [D]
📄 git-format-patch.txt [E] [D]
📄 git-fsck-objects.html [E] [D]
📄 git-fsck-objects.txt [E] [D]
📄 git-fsck.html [E] [D]
📄 git-fsck.txt [E] [D]
📄 git-gc.html [E] [D]
📄 git-gc.txt [E] [D]
📄 git-get-tar-commit-id.html [E] [D]
📄 git-get-tar-commit-id.txt [E] [D]
📄 git-grep.html [E] [D]
📄 git-grep.txt [E] [D]
📄 git-gui.html [E] [D]
📄 git-gui.txt [E] [D]
📄 git-hash-object.html [E] [D]
📄 git-hash-object.txt [E] [D]
📄 git-help.html [E] [D]
📄 git-help.txt [E] [D]
📄 git-http-backend.html [E] [D]
📄 git-http-backend.txt [E] [D]
📄 git-http-fetch.html [E] [D]
📄 git-http-fetch.txt [E] [D]
📄 git-http-push.html [E] [D]
📄 git-http-push.txt [E] [D]
📄 git-imap-send.html [E] [D]
📄 git-imap-send.txt [E] [D]
📄 git-index-pack.html [E] [D]
📄 git-index-pack.txt [E] [D]
📄 git-init-db.html [E] [D]
📄 git-init-db.txt [E] [D]
📄 git-init.html [E] [D]
📄 git-init.txt [E] [D]
📄 git-instaweb.html [E] [D]
📄 git-instaweb.txt [E] [D]
📄 git-log.html [E] [D]
📄 git-log.txt [E] [D]
📄 git-lost-found.html [E] [D]
📄 git-lost-found.txt [E] [D]
📄 git-ls-files.html [E] [D]
📄 git-ls-files.txt [E] [D]
📄 git-ls-remote.html [E] [D]
📄 git-ls-remote.txt [E] [D]
📄 git-ls-tree.html [E] [D]
📄 git-ls-tree.txt [E] [D]
📄 git-mailinfo.html [E] [D]
📄 git-mailinfo.txt [E] [D]
📄 git-mailsplit.html [E] [D]
📄 git-mailsplit.txt [E] [D]
📄 git-merge-base.html [E] [D]
📄 git-merge-base.txt [E] [D]
📄 git-merge-file.html [E] [D]
📄 git-merge-file.txt [E] [D]
📄 git-merge-index.html [E] [D]
📄 git-merge-index.txt [E] [D]
📄 git-merge-one-file.html [E] [D]
📄 git-merge-one-file.txt [E] [D]
📄 git-merge-tree.html [E] [D]
📄 git-merge-tree.txt [E] [D]
📄 git-merge.html [E] [D]
📄 git-merge.txt [E] [D]
📄 git-mergetool--lib.html [E] [D]
📄 git-mergetool--lib.txt [E] [D]
📄 git-mergetool.html [E] [D]
📄 git-mergetool.txt [E] [D]
📄 git-mktag.html [E] [D]
📄 git-mktag.txt [E] [D]
📄 git-mktree.html [E] [D]
📄 git-mktree.txt [E] [D]
📄 git-mv.html [E] [D]
📄 git-mv.txt [E] [D]
📄 git-name-rev.html [E] [D]
📄 git-name-rev.txt [E] [D]
📄 git-notes.html [E] [D]
📄 git-notes.txt [E] [D]
📄 git-p4.html [E] [D]
📄 git-p4.txt [E] [D]
📄 git-pack-objects.html [E] [D]
📄 git-pack-objects.txt [E] [D]
📄 git-pack-redundant.html [E] [D]
📄 git-pack-redundant.txt [E] [D]
📄 git-pack-refs.html [E] [D]
📄 git-pack-refs.txt [E] [D]
📄 git-parse-remote.html [E] [D]
📄 git-parse-remote.txt [E] [D]
📄 git-patch-id.html [E] [D]
📄 git-patch-id.txt [E] [D]
📄 git-peek-remote.html [E] [D]
📄 git-peek-remote.txt [E] [D]
📄 git-prune-packed.html [E] [D]
📄 git-prune-packed.txt [E] [D]
📄 git-prune.html [E] [D]
📄 git-prune.txt [E] [D]
📄 git-pull.html [E] [D]
📄 git-pull.txt [E] [D]
📄 git-push.html [E] [D]
📄 git-push.txt [E] [D]
📄 git-quiltimport.html [E] [D]
📄 git-quiltimport.txt [E] [D]
📄 git-read-tree.html [E] [D]
📄 git-read-tree.txt [E] [D]
📄 git-rebase.html [E] [D]
📄 git-rebase.txt [E] [D]
📄 git-receive-pack.html [E] [D]
📄 git-receive-pack.txt [E] [D]
📄 git-reflog.html [E] [D]
📄 git-reflog.txt [E] [D]
📄 git-relink.html [E] [D]
📄 git-relink.txt [E] [D]
📄 git-remote-ext.html [E] [D]
📄 git-remote-ext.txt [E] [D]
📄 git-remote-fd.html [E] [D]
📄 git-remote-fd.txt [E] [D]
📄 git-remote-helpers.html [E] [D]
📄 git-remote-testgit.html [E] [D]
📄 git-remote-testgit.txt [E] [D]
📄 git-remote.html [E] [D]
📄 git-remote.txt [E] [D]
📄 git-repack.html [E] [D]
📄 git-repack.txt [E] [D]
📄 git-replace.html [E] [D]
📄 git-replace.txt [E] [D]
📄 git-repo-config.html [E] [D]
📄 git-repo-config.txt [E] [D]
📄 git-request-pull.html [E] [D]
📄 git-request-pull.txt [E] [D]
📄 git-rerere.html [E] [D]
📄 git-rerere.txt [E] [D]
📄 git-reset.html [E] [D]
📄 git-reset.txt [E] [D]
📄 git-rev-list.html [E] [D]
📄 git-rev-list.txt [E] [D]
📄 git-rev-parse.html [E] [D]
📄 git-rev-parse.txt [E] [D]
📄 git-revert.html [E] [D]
📄 git-revert.txt [E] [D]
📄 git-rm.html [E] [D]
📄 git-rm.txt [E] [D]
📄 git-send-email.html [E] [D]
📄 git-send-email.txt [E] [D]
📄 git-send-pack.html [E] [D]
📄 git-send-pack.txt [E] [D]
📄 git-sh-i18n--envsubst.html [E] [D]
📄 git-sh-i18n--envsubst.txt [E] [D]
📄 git-sh-i18n.html [E] [D]
📄 git-sh-i18n.txt [E] [D]
📄 git-sh-setup.html [E] [D]
📄 git-sh-setup.txt [E] [D]
📄 git-shell.html [E] [D]
📄 git-shell.txt [E] [D]
📄 git-shortlog.html [E] [D]
📄 git-shortlog.txt [E] [D]
📄 git-show-branch.html [E] [D]
📄 git-show-branch.txt [E] [D]
📄 git-show-index.html [E] [D]
📄 git-show-index.txt [E] [D]
📄 git-show-ref.html [E] [D]
📄 git-show-ref.txt [E] [D]
📄 git-show.html [E] [D]
📄 git-show.txt [E] [D]
📄 git-stage.html [E] [D]
📄 git-stage.txt [E] [D]
📄 git-stash.html [E] [D]
📄 git-stash.txt [E] [D]
📄 git-status.html [E] [D]
📄 git-status.txt [E] [D]
📄 git-stripspace.html [E] [D]
📄 git-stripspace.txt [E] [D]
📄 git-submodule.html [E] [D]
📄 git-submodule.txt [E] [D]
📄 git-svn.html [E] [D]
📄 git-svn.txt [E] [D]
📄 git-symbolic-ref.html [E] [D]
📄 git-symbolic-ref.txt [E] [D]
📄 git-tag.html [E] [D]
📄 git-tag.txt [E] [D]
📄 git-tar-tree.html [E] [D]
📄 git-tar-tree.txt [E] [D]
📄 git-tools.html [E] [D]
📄 git-tools.txt [E] [D]
📄 git-unpack-file.html [E] [D]
📄 git-unpack-file.txt [E] [D]
📄 git-unpack-objects.html [E] [D]
📄 git-unpack-objects.txt [E] [D]
📄 git-update-index.html [E] [D]
📄 git-update-index.txt [E] [D]
📄 git-update-ref.html [E] [D]
📄 git-update-ref.txt [E] [D]
📄 git-update-server-info.html [E] [D]
📄 git-update-server-info.txt [E] [D]
📄 git-upload-archive.html [E] [D]
📄 git-upload-archive.txt [E] [D]
📄 git-upload-pack.html [E] [D]
📄 git-upload-pack.txt [E] [D]
📄 git-var.html [E] [D]
📄 git-var.txt [E] [D]
📄 git-verify-pack.html [E] [D]
📄 git-verify-pack.txt [E] [D]
📄 git-verify-tag.html [E] [D]
📄 git-verify-tag.txt [E] [D]
📄 git-web--browse.html [E] [D]
📄 git-web--browse.txt [E] [D]
📄 git-whatchanged.html [E] [D]
📄 git-whatchanged.txt [E] [D]
📄 git-write-tree.html [E] [D]
📄 git-write-tree.txt [E] [D]
📄 git.html [E] [D]
📄 git.txt [E] [D]
📄 gitattributes.html [E] [D]
📄 gitattributes.txt [E] [D]
📄 gitcli.html [E] [D]
📄 gitcli.txt [E] [D]
📄 gitcore-tutorial.html [E] [D]
📄 gitcore-tutorial.txt [E] [D]
📄 gitcredentials.html [E] [D]
📄 gitcredentials.txt [E] [D]
📄 gitcvs-migration.html [E] [D]
📄 gitcvs-migration.txt [E] [D]
📄 gitdiffcore.html [E] [D]
📄 gitdiffcore.txt [E] [D]
📄 gitglossary.html [E] [D]
📄 gitglossary.txt [E] [D]
📄 githooks.html [E] [D]
📄 githooks.txt [E] [D]
📄 gitignore.html [E] [D]
📄 gitignore.txt [E] [D]
📄 gitk.html [E] [D]
📄 gitk.txt [E] [D]
📄 gitmodules.html [E] [D]
📄 gitmodules.txt [E] [D]
📄 gitnamespaces.html [E] [D]
📄 gitnamespaces.txt [E] [D]
📄 gitremote-helpers.html [E] [D]
📄 gitremote-helpers.txt [E] [D]
📄 gitrepository-layout.html [E] [D]
📄 gitrepository-layout.txt [E] [D]
📄 gitrevisions.html [E] [D]
📄 gitrevisions.txt [E] [D]
📄 gittutorial-2.html [E] [D]
📄 gittutorial-2.txt [E] [D]
📄 gittutorial.html [E] [D]
📄 gittutorial.txt [E] [D]
📄 gitweb.conf.html [E] [D]
📄 gitweb.conf.txt [E] [D]
📄 gitweb.html [E] [D]
📄 gitweb.txt [E] [D]
📄 gitworkflows.html [E] [D]
📄 gitworkflows.txt [E] [D]
📄 glossary-content.txt [E] [D]
📁 howto Open [D]
📄 howto-index.html [E] [D]
📄 howto-index.txt [E] [D]
📄 i18n.txt [E] [D]
📄 mailmap.txt [E] [D]
📄 merge-config.txt [E] [D]
📄 merge-options.txt [E] [D]
📄 merge-strategies.txt [E] [D]
📄 mergetools-diff.txt [E] [D]
📄 mergetools-merge.txt [E] [D]
📄 pretty-formats.txt [E] [D]
📄 pretty-options.txt [E] [D]
📄 pull-fetch-param.txt [E] [D]
📄 rev-list-options.txt [E] [D]
📄 revisions.txt [E] [D]
📄 sequencer.txt [E] [D]
📁 technical Open [D]
📄 urls-remotes.txt [E] [D]
📄 urls.txt [E] [D]
📄 user-manual.html [E] [D]
📄 user-manual.txt [E] [D]

Editing: git-update-ref.txt

git-update-ref(1)
=================

NAME
----
git-update-ref - Update the object name stored in a ref safely

SYNOPSIS
--------
[verse]
'git update-ref' [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] <ref> <newvalue> [<oldvalue>])

DESCRIPTION
-----------
Given two arguments, stores the <newvalue> in the <ref>, possibly
dereferencing the symbolic refs.  E.g. `git update-ref HEAD
<newvalue>` updates the current branch head to the new object.

Given three arguments, stores the <newvalue> in the <ref>,
possibly dereferencing the symbolic refs, after verifying that
the current value of the <ref> matches <oldvalue>.
E.g. `git update-ref refs/heads/master <newvalue> <oldvalue>`
updates the master branch head to <newvalue> only if its current
value is <oldvalue>.  You can specify 40 "0" or an empty string
as <oldvalue> to make sure that the ref you are creating does
not exist.

It also allows a "ref" file to be a symbolic pointer to another
ref file by starting with the four-byte header sequence of
"ref:".

More importantly, it allows the update of a ref file to follow
these symbolic pointers, whether they are symlinks or these
"regular file symbolic refs".  It follows *real* symlinks only
if they start with "refs/": otherwise it will just try to read
them and update them as a regular file (i.e. it will allow the
filesystem to follow them, but will overwrite such a symlink to
somewhere else with a regular filename).

If --no-deref is given, <ref> itself is overwritten, rather than
the result of following the symbolic pointers.

In general, using

git update-ref HEAD "$head"

should be a _lot_ safer than doing

echo "$head" > "$GIT_DIR/HEAD"

both from a symlink following standpoint *and* an error checking
standpoint.  The "refs/" rule for symlinks means that symlinks
that point to "outside" the tree are safe: they'll be followed
for reading but not for writing (so we'll never write through a
ref symlink to some other tree, if you have copied a whole
archive by creating a symlink tree).

With `-d` flag, it deletes the named <ref> after verifying it
still contains <oldvalue>.

Logging Updates
---------------
If config parameter "core.logAllRefUpdates" is true and the ref is one under
"refs/heads/", "refs/remotes/", "refs/notes/", or the symbolic ref HEAD; or
the file "$GIT_DIR/logs/<ref>" exists then `git update-ref` will append
a line to the log file "$GIT_DIR/logs/<ref>" (dereferencing all
symbolic refs before creating the log name) describing the change
in ref value.  Log lines are formatted as:

. oldsha1 SP newsha1 SP committer LF
+
Where "oldsha1" is the 40 character hexadecimal value previously
stored in <ref>, "newsha1" is the 40 character hexadecimal value of
<newvalue> and "committer" is the committer's name, email address
and date in the standard Git committer ident format.

Optionally with -m:

. oldsha1 SP newsha1 SP committer TAB message LF
+
Where all fields are as described above and "message" is the
value supplied to the -m option.

An update will fail (without changing <ref>) if the current user is
unable to create a new log file, append to the existing log file
or does not have committer information available.

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