howto-index.txt

   1 Git Howto Index
   2 ===============
   3
   4 Here is a collection of mailing list postings made by various
   5 people describing how they use Git in their workflow.
   6
   7 * link:howto/coordinate-embargoed-releases.html[coordinate-embargoed-releases]
   8
   9 When a vulnerability is reported, we follow these guidelines to
  10 assess the vulnerability, create and review a fix, and coordinate embargoed
  11 security releases.
  12
  13
  14 * link:howto/keep-canonical-history-correct.html[keep-canonical-history-correct] by Junio C Hamano <gitster@pobox.com>
  15
  16 This how-to explains a method for keeping a
  17 project's history correct when using git pull.
  18
  19
  20 * link:howto/maintain-git.html[maintain-git] by Junio C Hamano <gitster@pobox.com>
  21
  22 Imagine that Git development is racing along as usual, when our friendly
  23 neighborhood maintainer is struck down by a wayward bus. Out of the
  24 hordes of suckers (loyal developers), you have been tricked (chosen) to
  25 step up as the new maintainer. This howto will show you "how to" do it.
  26
  27
  28 * link:howto/new-command.html[new-command] by Eric S. Raymond <esr@thyrsus.com>
  29
  30 This is how-to documentation for people who want to add extension
  31 commands to Git.  It should be read alongside builtin.h.
  32
  33
  34 * link:howto/rebase-from-internal-branch.html[rebase-from-internal-branch] by Junio C Hamano <gitster@pobox.com>
  35
  36 In this article, JC talks about how he rebases the
  37 public "seen" branch using the core Git tools when he updates
  38 the "master" branch, and how "rebase" works.  Also discussed
  39 is how this applies to individual developers who sends patches
  40 upstream.
  41
  42
  43 * link:howto/rebuild-from-update-hook.html[rebuild-from-update-hook] by Junio C Hamano <gitster@pobox.com>
  44
  45 In this how-to article, JC talks about how he
  46 uses the post-update hook to automate Git documentation page
  47 shown at https://www.kernel.org/pub/software/scm/git/docs/.
  48
  49
  50 * link:howto/recover-corrupted-blob-object.html[recover-corrupted-blob-object] by Linus Torvalds <torvalds@linux-foundation.org>
  51
  52 Some tricks to reconstruct blob objects in order to fix
  53 a corrupted repository.
  54
  55
  56 * link:howto/recover-corrupted-object-harder.html[recover-corrupted-object-harder] by Jeff King <peff@peff.net>
  57
  58 Recovering a corrupted object when no good copy is available.
  59
  60
  61 * link:howto/revert-a-faulty-merge.html[revert-a-faulty-merge] by Linus Torvalds <torvalds@linux-foundation.org>, Junio C Hamano <gitster@pobox.com>
  62
  63 Sometimes a branch that was already merged to the mainline
  64 is later found to be faulty.  Linus and Junio give guidance on
  65 recovering from such a premature merge and continuing development
  66 after the offending branch is fixed.
  67
  68
  69 * link:howto/revert-branch-rebase.html[revert-branch-rebase] by Junio C Hamano <gitster@pobox.com>
  70
  71 In this article, JC gives a small real-life example of using
  72 'git revert' command, and using a temporary branch and tag for safety
  73 and easier sanity checking.
  74
  75
  76 * link:howto/separating-topic-branches.html[separating-topic-branches] by Junio C Hamano <gitster@pobox.com>
  77
  78 In this article, JC describes how to separate topic branches.
  79
  80
  81 * link:howto/setup-git-server-over-http.html[setup-git-server-over-http] by Rutger Nijlunsing <rutger@nospam.com>
  82
  83
  84
  85 * link:howto/update-hook-example.html[update-hook-example] by Junio C Hamano <gitster@pobox.com> and Carl Baldwin <cnb@fc.hp.com>
  86
  87 An example hooks/update script is presented to
  88 implement repository maintenance policies, such as who can push
  89 into which branch and who can make a tag.
  90
  91
  92 * link:howto/use-git-daemon.html[use-git-daemon]
  93
  94
  95
  96 * link:howto/using-merge-subtree.html[using-merge-subtree] by Sean <seanlkml@sympatico.ca>
  97
  98 In this article, Sean demonstrates how one can use the subtree merge
  99 strategy.
 100
 101
 102 * link:howto/using-signed-tag-in-pull-request.html[using-signed-tag-in-pull-request] by Junio C Hamano <gitster@pobox.com>
 103
 104 Beginning v1.7.9, a contributor can push a signed tag to her
 105 publishing repository and ask her integrator to pull it. This assures the
 106 integrator that the pulled history is authentic and allows others to
 107 later validate it.
 108
 109