From b8e97d72237202f9de1eb8b66a11d5c817de4df4 Mon Sep 17 00:00:00 2001
From: Gitea Actions Bot <fishconfig-bot@git.rootiest.dev>
Date: Wed, 16 Sep 2026 23:45:42 +0000
Subject: [PATCH] chore(docs): regenerate manual, man page, and component
 registry

---
 docs/fish-config.1  | 12 +++++++++---
 docs/fish-config.md |  9 +++++++--
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/docs/fish-config.1 b/docs/fish-config.1
index 5b6f1c8..9a0008c 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -1696,7 +1696,12 @@ the directory already exists. The two compose: --clean runs first, so
 empty slot because clean just emptied it.
 
 --remote links an already-existing remote (git remote add origin
-<url>) -- it does not create anything. --new-remote creates one first
+<url>) -- it does not create anything. Linking is idempotent: an origin
+already pointing at that URL is reported and accepted, so rerunning
+mkrep against the same target, or pointing it at a checkout that is
+already linked, succeeds instead of failing on \[dq]remote origin already
+exists\[dq]. An origin pointing somewhere else is an error, not a silent
+repoint. --new-remote creates one first
 by running a shell command template in the new repo directory, then
 nothing further is needed since the template itself does the linking
 (e.g. gh repo create {name} --source=. --remote=origin --push).
@@ -1805,8 +1810,9 @@ not, so they are chained with the git commands that do the linking:
 .PP
 \f[B]Dependencies:\f[R] \f[V]_fish_mkdir_p\f[R],
 \f[V]__fish_palette\f[R], \f[V]_mkrep_say\f[R],
-\f[V]_mkrep_verbose\f[R], \f[V]_mkrep_default_remote_cmd\f[R],
-\f[V]_mkrep_remote_url\f[R], \f[V]_mkrep_repo_exists\f[R], \f[V]git\f[R]
+\f[V]_mkrep_verbose\f[R], \f[V]_mkrep_add_origin\f[R],
+\f[V]_mkrep_default_remote_cmd\f[R], \f[V]_mkrep_remote_url\f[R],
+\f[V]_mkrep_repo_exists\f[R], \f[V]git\f[R]
 .SS 5.5 Package Management
 .SS cleanup
 .IP
diff --git a/docs/fish-config.md b/docs/fish-config.md
index 5472ad4..2634177 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -1289,7 +1289,12 @@ functions). They are active in all interactive sessions.
     empty slot because clean just emptied it.
 
     --remote links an already-existing remote (git remote add origin
-    <url>) -- it does not create anything. --new-remote creates one first
+    <url>) -- it does not create anything. Linking is idempotent: an origin
+    already pointing at that URL is reported and accepted, so rerunning
+    mkrep against the same target, or pointing it at a checkout that is
+    already linked, succeeds instead of failing on "remote origin already
+    exists". An origin pointing somewhere else is an error, not a silent
+    repoint. --new-remote creates one first
     by running a shell command template in the new repo directory, then
     nothing further is needed since the template itself does the linking
     (e.g. gh repo create {name} --source=. --remote=origin --push).
@@ -1394,7 +1399,7 @@ functions). They are active in all interactive sessions.
       GitLab (glab): glab repo create {name} --private --skipGitInit && git remote add origin {server}/{user}/{name}.git && if git rev-parse --verify -q HEAD >/dev/null 2>&1; git push -u origin HEAD; end
       Gitea (tea):   tea repos create --name {name} --private && git remote add origin {server}/{user}/{name}.git && if git rev-parse --verify -q HEAD >/dev/null 2>&1; git push -u origin HEAD; end
 
-**Dependencies:** `_fish_mkdir_p`, `__fish_palette`, `_mkrep_say`, `_mkrep_verbose`, `_mkrep_default_remote_cmd`, `_mkrep_remote_url`, `_mkrep_repo_exists`, `git`
+**Dependencies:** `_fish_mkdir_p`, `__fish_palette`, `_mkrep_say`, `_mkrep_verbose`, `_mkrep_add_origin`, `_mkrep_default_remote_cmd`, `_mkrep_remote_url`, `_mkrep_repo_exists`, `git`
 
 ## 5.5 Package Management