summaryrefslogtreecommitdiff
path: root/wiki/git/config.md
diff options
context:
space:
mode:
authorOwen Jacobson <owen@grimoire.ca>2020-01-28 20:49:17 -0500
committerOwen Jacobson <owen@grimoire.ca>2020-01-28 23:23:18 -0500
commit0d6f58c54a7af6c8b4e6cd98663eb36ec4e3accc (patch)
treea2af4dc93f09a920b0ca375c1adde6d8f64eb6be /wiki/git/config.md
parentacf6f5d3bfa748e2f8810ab0fe807f82efcf3eb6 (diff)
Editorial pass & migration to mkdocs.
There's a lot in grimoire.ca that I either no longer stand behind or feel pretty weird about having out there.
Diffstat (limited to 'wiki/git/config.md')
-rw-r--r--wiki/git/config.md58
1 files changed, 0 insertions, 58 deletions
diff --git a/wiki/git/config.md b/wiki/git/config.md
deleted file mode 100644
index 9ee058b..0000000
--- a/wiki/git/config.md
+++ /dev/null
@@ -1,58 +0,0 @@
-# git-config Settings You Want
-
-Git comes with some fairly [lkml](http://www.tux.org/lkml/)-specific
-configuration defaults. You should fix this. All of the items below can be set
-either for your entire login account (`git config --global`) or for a specific
-repository (`git config`).
-
-Full documentation is under `git help config`, unless otherwise stated.
-
-* `git config user.name 'Your Full Name'` and `git config user.email
- 'your-email@example.com'`, obviously.
-
-* `git config push.default simple` - the default behaviour (called `matching`)
- of an unqualified `git push` is to identify pairs of branches by name and
- push all matches from your local repository to the remote. Given that
- branches have explicit “upstream” configuration identifying which, if any,
- branch in which, if any, remote they're associated with, this is dumb. The
- `simple` mode pushes the current branch to its upstream remote, if and only
- if the local branch name and the remote branch name match _and_ the local
- branch tracks the remote branch. Requires Git 1.8 or later; will be the
- default in Git 2.0. (For older versions of Git, use `upstream` instead,
- which does not require that branch names match.)
-
-* `git config merge.defaultToUpstream true` - causes an unqualified `git
- merge` to merge the current branch's configured upstream branch, rather than
- being an error. (`git rebase` always has this behaviour. Consistent!) You
- should still merge thoughtfully.
-
-* `git config rebase.autosquash true` - causes `git rebase -i` to parse magic
- comments created by `git commit --squash=some-hash` and `git commit
- --fixup=some-hash` and reorder the commit list before presenting it for
- further editing. See the descriptions of “squash” and “fixup” in `git help
- rebase` for details; autosquash makes amending commits other than the most
- recent easier and less error-prone.
-
-* `git config branch.autosetupmerge always` - newly-created branches whose
- start point is a branch (`git checkout master -b some-feature`, `git branch
- some-feature origin/develop`, and so on) will be configured to have the
- start point branch as their upstream. By default (with `true` rather than
- `always`) this only happens when the start point is a remote-tracking
- branch.
-
-* `git config rerere.enabled true` - enable “reuse recorded resolution.” The
- `git help rerere` docs explain it pretty well, but the short version is that
- git can record how you resolve conflicts during a “test” merge and reuse the
- same approach when resolving the same conflict later, in a “real” merge.
-
-## For advanced users
-
-A few things are nice when you're getting started, but become annoying when
-you no longer need them.
-
-* `git config advice.detachedHead` - if you already understand the difference
- between having a branch checked out and having a commit checked out, and
- already understand what “detatched head” means, the warning on every `git
- checkout ...some detatched thing...` isn't helping anyone. This is also
- useful repositories used for deployment, where specific commits (from tags,
- for example) are regularly checked out.