diff options
author | Ævar Arnfjörð Bjarmason <avarab@gmail.com> | 2020-12-09 10:16:37 +0300 |
---|---|---|
committer | Ævar Arnfjörð Bjarmason <avarab@gmail.com> | 2020-12-09 18:33:45 +0300 |
commit | 75bef2886edd4e3b1e622058584a70a3f7752b41 (patch) | |
tree | c89456830614226aa2a05e5656e8b13cabbd4e5d | |
parent | ea6022becb7e04a14cefeca1117730c7b5827eb3 (diff) |
doc: re-flow server-side git usage paragraph & add sections
This is mainly done in preparation for a follow-up change, to make the
diff easier to read.
-rw-r--r-- | doc/serverside_git_usage.md | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/doc/serverside_git_usage.md b/doc/serverside_git_usage.md index 3152311da..9a4d464da 100644 --- a/doc/serverside_git_usage.md +++ b/doc/serverside_git_usage.md @@ -8,13 +8,20 @@ Gitaly uses three implementations to read and write to Git repositories: ### Using Git +#### Plumbing v.s. porcelain + `git(1)` is the default choice to access repositories for Gitaly. Not all -commands that are available should be used in the Gitaly code base. Git makes -a distinction between porcelain and plumbing commands. Porcelain commands are -intended for the end-user and are the user-interface of the default `git` -client, where plumbing commands are intended for scripted use or to build -another porcelain. Gitaly should only use plumbing commands. `man 1 git` -contains a section on the low level plumbing. +commands that are available should be used in the Gitaly code base. + +Git makes a distinction between porcelain and plumbing +commands. Porcelain commands are intended for the end-user and are the +user-interface of the default `git` client, where plumbing commands +are intended for scripted use or to build another porcelain. + +Gitaly should only use plumbing commands. `man 1 git` contains a +section on the low level plumbing. + +#### Executing Git commands When executing Git, developers should always use the `git.SafeCmd()` and sibling interfaces. These make sure Gitaly is protected against command injection, the |