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

[PATCH] builtin: unmark git-switch and git-restore as experimental

From
Justin Tobler <jltobler@gmail.com>
Date
Jul 28, 2025, 19:42 UTC
Message-ID
<20250728194218.2379432-1-jltobler@gmail.com>
In-Reply-To
<20250722180818.1043014-1-jltobler@gmail.com>

In 4e43b7ff (Declare both git-switch and git-restore experimental, 2019-04-25), the newly introduced git-switch(1) and git-restore(1) commands were marked as experimental. This was done to provide time to make breaking changes to the interface. It has now been over six years since these commands were implemented and there hasn't been much change. Consequently, users have grown to rely on how these commands work and it is no longer feasible to make any breaking changes.

Let's remove the experimental label for git-switch(1) and git-restore(1).

Signed-off-by: Justin Tobler <jltobler@gmail.com>
---
 Documentation/git-restore.adoc | 2 --
 Documentation/git-switch.adoc  | 2 --
 2 files changed, 4 deletions(-)
diff --git a/Documentation/git-restore.adoc b/Documentation/git-restore.adoc
index 877b7772e66..3763a7f4f43 100644
--- a/Documentation/git-restore.adoc
+++ b/Documentation/git-restore.adoc
@@ -28,8 +28,6 @@ otherwise from the index. Use `--source` to restore from a different commit.
 See "Reset, restore and revert" in linkgit:git[1] for the differences
 between the three commands.
 
-THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE.
-
 OPTIONS
 -------
 `-s <tree>`::
diff --git a/Documentation/git-switch.adoc b/Documentation/git-switch.adoc
index 9f62abf9e2b..87707e92652 100644
--- a/Documentation/git-switch.adoc
+++ b/Documentation/git-switch.adoc
@@ -29,8 +29,6 @@ Switching branches does not require a clean index and working tree
 however if the operation leads to loss of local changes, unless told
 otherwise with `--discard-changes` or `--merge`.
 
-THIS COMMAND IS EXPERIMENTAL. THE BEHAVIOR MAY CHANGE.
-
 OPTIONS
 -------
 _<branch>_::
-- 
2.50.1.214.ga30f80fde9
Previous: Justin ToblerNext: Junio C Hamano
Message 10 of 11 in “builtin: unmark git-switch and git-restore as experimental”
  1. 0/2 builtin: unmark git-switch and git-restore as experimentalJustin Tobler, Jul 22, 2025
  2. 1/2 builtin: remove merge short flag for switch and restoreJustin Tobler, Jul 22, 2025
  3. Junio C HamanoJul 22, 2025
  4. Justin ToblerJul 22, 2025
  5. 2/2 builtin: unmark git-switch and git-restore as experimentalJustin Tobler, Jul 22, 2025
  6. Junio C HamanoJul 22, 2025
  7. Justin ToblerJul 22, 2025
  8. Junio C HamanoJul 22, 2025
  9. Justin ToblerJul 22, 2025
  10. builtin: unmark git-switch and git-restore as experimentalJustin Tobler, Jul 28, 2025
  11. Junio C HamanoJul 28, 2025

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.