git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 01/59] config.txt: move advice.* to a separate file

From
Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
Date
Oct 20, 2018, 12:37 UTC
Message-ID
<20181020123848.2785-2-pclouds@gmail.com>
In-Reply-To
<20181020123848.2785-1-pclouds@gmail.com>
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
---
 Documentation/advice-config.txt | 82 ++++++++++++++++++++++++++++++++
 Documentation/config.txt        | 84 +--------------------------------
 2 files changed, 83 insertions(+), 83 deletions(-)
 create mode 100644 Documentation/advice-config.txt
diff --git a/Documentation/advice-config.txt b/Documentation/advice-config.txt
new file mode 100644
index 0000000000..7f80cddcd4
--- /dev/null
+++ b/Documentation/advice-config.txt
@@ -0,0 +1,82 @@
+advice.*::
+	These variables control various optional help messages designed to
+	aid new users. All 'advice.*' variables default to 'true', and you
+	can tell Git that you do not need help by setting these to 'false':
++
+--
+	pushUpdateRejected::
+		Set this variable to 'false' if you want to disable
+		'pushNonFFCurrent',
+		'pushNonFFMatching', 'pushAlreadyExists',
+		'pushFetchFirst', and 'pushNeedsForce'
+		simultaneously.
+	pushNonFFCurrent::
+		Advice shown when linkgit:git-push[1] fails due to a
+		non-fast-forward update to the current branch.
+	pushNonFFMatching::
+		Advice shown when you ran linkgit:git-push[1] and pushed
+		'matching refs' explicitly (i.e. you used ':', or
+		specified a refspec that isn't your current branch) and
+		it resulted in a non-fast-forward error.
+	pushAlreadyExists::
+		Shown when linkgit:git-push[1] rejects an update that
+		does not qualify for fast-forwarding (e.g., a tag.)
+	pushFetchFirst::
+		Shown when linkgit:git-push[1] rejects an update that
+		tries to overwrite a remote ref that points at an
+		object we do not have.
+	pushNeedsForce::
+		Shown when linkgit:git-push[1] rejects an update that
+		tries to overwrite a remote ref that points at an
+		object that is not a commit-ish, or make the remote
+		ref point at an object that is not a commit-ish.
+	statusHints::
+		Show directions on how to proceed from the current
+		state in the output of linkgit:git-status[1], in
+		the template shown when writing commit messages in
+		linkgit:git-commit[1], and in the help message shown
+		by linkgit:git-checkout[1] when switching branch.
+	statusUoption::
+		Advise to consider using the `-u` option to linkgit:git-status[1]
+		when the command takes more than 2 seconds to enumerate untracked
+		files.
+	commitBeforeMerge::
+		Advice shown when linkgit:git-merge[1] refuses to
+		merge to avoid overwriting local changes.
+	resolveConflict::
+		Advice shown by various commands when conflicts
+		prevent the operation from being performed.
+	implicitIdentity::
+		Advice on how to set your identity configuration when
+		your information is guessed from the system username and
+		domain name.
+	detachedHead::
+		Advice shown when you used linkgit:git-checkout[1] to
+		move to the detach HEAD state, to instruct how to create
+		a local branch after the fact.
+	checkoutAmbiguousRemoteBranchName::
+		Advice shown when the argument to
+		linkgit:git-checkout[1] ambiguously resolves to a
+		remote tracking branch on more than one remote in
+		situations where an unambiguous argument would have
+		otherwise caused a remote-tracking branch to be
+		checked out. See the `checkout.defaultRemote`
+		configuration variable for how to set a given remote
+		to used by default in some situations where this
+		advice would be printed.
+	amWorkDir::
+		Advice that shows the location of the patch file when
+		linkgit:git-am[1] fails to apply it.
+	rmHints::
+		In case of failure in the output of linkgit:git-rm[1],
+		show directions on how to proceed from the current state.
+	addEmbeddedRepo::
+		Advice on what to do when you've accidentally added one
+		git repo inside of another.
+	ignoredHook::
+		Advice shown if a hook is ignored because the hook is not
+		set as executable.
+	waitingForEditor::
+		Print a message to the terminal whenever Git is waiting for
+		editor input from the user.
+--
diff --git a/Documentation/config.txt b/Documentation/config.txt
index 552827935a..a0b0ef582f 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -287,89 +287,7 @@ inventing new variables for use in your own tool, make sure their
 names do not conflict with those that are used by Git itself and
 other popular tools, and describe them in your documentation.
 
-
-advice.*::
-	These variables control various optional help messages designed to
-	aid new users. All 'advice.*' variables default to 'true', and you
-	can tell Git that you do not need help by setting these to 'false':
-+
---
-	pushUpdateRejected::
-		Set this variable to 'false' if you want to disable
-		'pushNonFFCurrent',
-		'pushNonFFMatching', 'pushAlreadyExists',
-		'pushFetchFirst', and 'pushNeedsForce'
-		simultaneously.
-	pushNonFFCurrent::
-		Advice shown when linkgit:git-push[1] fails due to a
-		non-fast-forward update to the current branch.
-	pushNonFFMatching::
-		Advice shown when you ran linkgit:git-push[1] and pushed
-		'matching refs' explicitly (i.e. you used ':', or
-		specified a refspec that isn't your current branch) and
-		it resulted in a non-fast-forward error.
-	pushAlreadyExists::
-		Shown when linkgit:git-push[1] rejects an update that
-		does not qualify for fast-forwarding (e.g., a tag.)
-	pushFetchFirst::
-		Shown when linkgit:git-push[1] rejects an update that
-		tries to overwrite a remote ref that points at an
-		object we do not have.
-	pushNeedsForce::
-		Shown when linkgit:git-push[1] rejects an update that
-		tries to overwrite a remote ref that points at an
-		object that is not a commit-ish, or make the remote
-		ref point at an object that is not a commit-ish.
-	statusHints::
-		Show directions on how to proceed from the current
-		state in the output of linkgit:git-status[1], in
-		the template shown when writing commit messages in
-		linkgit:git-commit[1], and in the help message shown
-		by linkgit:git-checkout[1] when switching branch.
-	statusUoption::
-		Advise to consider using the `-u` option to linkgit:git-status[1]
-		when the command takes more than 2 seconds to enumerate untracked
-		files.
-	commitBeforeMerge::
-		Advice shown when linkgit:git-merge[1] refuses to
-		merge to avoid overwriting local changes.
-	resolveConflict::
-		Advice shown by various commands when conflicts
-		prevent the operation from being performed.
-	implicitIdentity::
-		Advice on how to set your identity configuration when
-		your information is guessed from the system username and
-		domain name.
-	detachedHead::
-		Advice shown when you used linkgit:git-checkout[1] to
-		move to the detach HEAD state, to instruct how to create
-		a local branch after the fact.
-	checkoutAmbiguousRemoteBranchName::
-		Advice shown when the argument to
-		linkgit:git-checkout[1] ambiguously resolves to a
-		remote tracking branch on more than one remote in
-		situations where an unambiguous argument would have
-		otherwise caused a remote-tracking branch to be
-		checked out. See the `checkout.defaultRemote`
-		configuration variable for how to set a given remote
-		to used by default in some situations where this
-		advice would be printed.
-	amWorkDir::
-		Advice that shows the location of the patch file when
-		linkgit:git-am[1] fails to apply it.
-	rmHints::
-		In case of failure in the output of linkgit:git-rm[1],
-		show directions on how to proceed from the current state.
-	addEmbeddedRepo::
-		Advice on what to do when you've accidentally added one
-		git repo inside of another.
-	ignoredHook::
-		Advice shown if a hook is ignored because the hook is not
-		set as executable.
-	waitingForEditor::
-		Print a message to the terminal whenever Git is waiting for
-		editor input from the user.
---
+include::advice-config.txt[]
 
 core.fileMode::
 	Tells Git if the executable bit of files in the working tree
-- 
2.19.1.647.g708186aaf9
Previous: Nguyễn Thái Ngọc DuyNext: Nguyễn Thái Ngọc Duy
Message 2 of 67 in “Split config.txt”
  1. 00/59 Split config.txtNguyễn Thái Ngọc Duy, Oct 20, 2018
  2. 01/59 config.txt: move advice.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  3. 03/59 config.txt: move add.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  4. 04/59 config.txt: move alias.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  5. 05/59 config.txt: move am.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  6. 06/59 config.txt: move apply.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  7. 07/59 config.txt: move blame.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  8. 02/59 config.txt: move core.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  9. 08/59 config.txt: move branch.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  10. 10/59 config.txt: move checkout.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  11. 11/59 config.txt: move clean.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  12. 09/59 config.txt: move browser.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  13. 13/59 config.txt: move column.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  14. 14/59 config.txt: move commit.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  15. 12/59 config.txt: move color.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  16. 15/59 config.txt: move credential.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  17. 16/59 config.txt: move completion.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  18. 17/59 config.txt: move difftool.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  19. 18/59 config.txt: move fastimport.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  20. 19/59 config.txt: move filter.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  21. 20/59 config.txt: move fsck.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  22. 21/59 config.txt: move gc.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  23. 22/59 config.txt: move gitweb.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  24. 23/59 config.txt: move grep.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  25. 24/59 config.txt: move gpg.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  26. 25/59 config.txt: move guitool.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  27. 26/59 config.txt: move help.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  28. 27/59 config.txt: move ssh.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  29. 28/59 config.txt: move i18n.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  30. 29/59 config.txt: move i18n.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  31. Andrei RybakOct 21, 2018
  32. 30/59 config.txt: move init.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  33. 31/59 config.txt: move instaweb.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  34. 32/59 config.txt: move interactive.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  35. 33/59 config.txt: move log.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  36. 34/59 config.txt: move mailinfo.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  37. 36/59 config.txt: move man.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  38. 35/59 config.txt: move mailmap.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  39. 37/59 config.txt: move mergetool.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  40. 38/59 config.txt: move notes.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  41. 40/59 config.txt: move pager.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  42. 41/59 config.txt: move pretty.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  43. 39/59 config.txt: move pack.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  44. 42/59 config.txt: move protocol.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  45. 43/59 config.txt: move remote.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  46. 44/59 config.txt: move remotes.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  47. 45/59 config.txt: move repack.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  48. 46/59 config.txt: move rerere.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  49. 48/59 config.txt: move showBranch.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  50. 49/59 config.txt: move splitIndex.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  51. 47/59 config.txt: move sequencer.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  52. 51/59 config.txt: move tag.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  53. 50/59 config.txt: move status.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  54. 52/59 config.txt: move transfer.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  55. 53/59 config.txt: move uploadarchive.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  56. 55/59 config.txt: move url.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  57. 54/59 config.txt: move uploadpack.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  58. 56/59 config.txt: move user.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  59. 57/59 config.txt: move versionsort.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  60. 58/59 config.txt: move web.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  61. 59/59 config.txt: move worktree.* to a separate fileNguyễn Thái Ngọc Duy, Oct 20, 2018
  62. Ævar Arnfjörð BjarmasonOct 20, 2018
  63. Duy NguyenOct 20, 2018
  64. Ævar Arnfjörð BjarmasonOct 20, 2018
  65. Junio C HamanoOct 20, 2018
  66. Duy NguyenOct 22, 2018
  67. Stefan BellerOct 22, 2018

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.