complete annex.skipunknown transition

annex.skipunknown now defaults to false, so commands like `git annex get foo*`
will not silently skip over files/dirs that are not checked into git.

Sponsored-by: Brock Spratlen on Patreon

CHANGELOG

@@ -1,5 +1,8 @@
 git-annex (10.20220128) UNRELEASED; urgency=medium
 
+  * annex.skipunknown now defaults to false, so commands like
+    `git annex get foo*` will not silently skip over files/dirs that are
+    not checked into git.
   * adb: Avoid find failing with "Argument list too long"
   * Pass --no-textconv when running git diff internally.
   * Fix git-annex forget propagation between repositories.

NEWS

@@ -1,3 +1,12 @@
+git-annex (10.20220218) upstream; urgency=medium
+
+  Transition notice: Commands like `git-annex get foo*` have changed to error
+  out when some of files are not checked into the repository. To get back the
+  previous behavior of silently skipping unknown files, use git config
+  to set annex.skipunknown to true.
+
+ -- Joey Hess <id@joeyh.name>  Fri, 18 Feb 2022 13:12:21 -0400
+
 git-annex (8.20211028) upstream; urgency=medium
 
   This version of git-annex removes support for communicating with git-annex

Types/GitConfig.hs

@@ -233,7 +233,7 @@ extractGitConfig configsource r = GitConfig
 	, annexCommitMode = if getbool (annexConfig "allowsign") False
 		then ManualCommit
 		else AutomaticCommit
-	, annexSkipUnknown = getbool (annexConfig "skipunknown") True
+	, annexSkipUnknown = getbool (annexConfig "skipunknown") False
 	, annexAdjustedBranchRefresh = fromMaybe
 		-- parse as bool if it's not a number
 		(if getbool "adjustedbranchrefresh" False then 1 else 0)

doc/git-annex.mdwn

@@ -836,9 +836,7 @@ repository, using [[git-annex-config]]. See its man page for a list.)
 
   Set to false to make it an error for commands like "git-annex get"
   to be asked to operate on files that are not checked into git.
-
-  The default is currently true, but is planned to change to false in a
-  release in 2022.
+  (This is the default in recent versions of git-annex.)
 
   Note that, when annex.skipunknown is false, a command like "git-annex get ."
   will fail if no files in the current directory are checked into git,

doc/todo/complete_annex.skipunknown_transition_in_2022.mdwn

@@ -2,3 +2,5 @@ annex.skipunknown should be changed to default to false in early 2022.
 This transition was started in mid 2020 and there should have been plenty
 of time for people to learn about it and either set their preferred
 behavior or change workflows for the new behavior.
+
+> [[done]] --[[Joey]]