chore(docs): regenerate manual, man page, and component registry
This commit is contained in:
+18
-4
@@ -1742,10 +1742,11 @@ hist
|
|||||||
.nf
|
.nf
|
||||||
\f[C]
|
\f[C]
|
||||||
Synopsis: mkrep [--cd | --no-cd] [--mkdir | --no-mkdir] [--git | --no-git]
|
Synopsis: mkrep [--cd | --no-cd] [--mkdir | --no-mkdir] [--git | --no-git]
|
||||||
[-c | --clean | --no-clean] [--strict] [-v | --verbose]
|
[-c | --clean | --no-clean] [--strict] [-l | --local]
|
||||||
[-s | --silent] [--template <path>] [--branch <name>]
|
[-v | --verbose] [-s | --silent] [--template <path>]
|
||||||
[--remote <url>] [--new-remote [<cmd>]] [--server <type>]
|
[--branch <name>] [--remote <url>] [--new-remote [<cmd>]]
|
||||||
[--check-existing] [-y | --yes] [--name <name>] [-h | --help] <dir>
|
[--server <type>] [--check-existing] [-y | --yes]
|
||||||
|
[--name <name>] [-h | --help] <dir>
|
||||||
|
|
||||||
Creates a directory, cds into it, and git-inits it -- mkcd plus a git
|
Creates a directory, cds into it, and git-inits it -- mkcd plus a git
|
||||||
repo in one step. All three actions are on by default and each has a
|
repo in one step. All three actions are on by default and each has a
|
||||||
@@ -1758,6 +1759,15 @@ the directory already exists. The two compose: --clean runs first, so
|
|||||||
--clean --strict together is not a contradiction -- strict sees an
|
--clean --strict together is not a contradiction -- strict sees an
|
||||||
empty slot because clean just emptied it.
|
empty slot because clean just emptied it.
|
||||||
|
|
||||||
|
-l/--local forces strictly local action: any flag or environment
|
||||||
|
variable that would link to, create, or check a remote (--remote,
|
||||||
|
--new-remote, --server, --check-existing, $GIT_SERVER, $GITEA_URL,
|
||||||
|
$GITEA_HOST, $GITLAB_URL, $GITLAB_HOST, $MKREP_REMOTE_CMD) is
|
||||||
|
overridden and ignored. Even when passed alongside conflicting remote
|
||||||
|
flags like --server or --remote, -l/--local takes precedence and
|
||||||
|
proceeds with local directory creation and git initialization without
|
||||||
|
erroring or contacting any forge.
|
||||||
|
|
||||||
--remote links an already-existing remote (git remote add origin
|
--remote links an already-existing remote (git remote add origin
|
||||||
<url>) -- it does not create anything. Linking is idempotent: an origin
|
<url>) -- it does not create anything. Linking is idempotent: an origin
|
||||||
already pointing at that URL is reported and accepted, so rerunning
|
already pointing at that URL is reported and accepted, so rerunning
|
||||||
@@ -1820,6 +1830,9 @@ Arguments:
|
|||||||
-c, --clean Remove <dir> first if it already exists
|
-c, --clean Remove <dir> first if it already exists
|
||||||
--no-clean Leave an existing <dir> alone (default)
|
--no-clean Leave an existing <dir> alone (default)
|
||||||
--strict Fail if <dir> already exists (checked after --clean)
|
--strict Fail if <dir> already exists (checked after --clean)
|
||||||
|
-l, --local Force local-only operation; overrides and ignores any
|
||||||
|
remote flags (--remote, --new-remote, --server,
|
||||||
|
--check-existing) and remote environment variables
|
||||||
-v, --verbose Print each step as it runs
|
-v, --verbose Print each step as it runs
|
||||||
-s, --silent Suppress all output; overrides --verbose
|
-s, --silent Suppress all output; overrides --verbose
|
||||||
--template <path>
|
--template <path>
|
||||||
@@ -1846,6 +1859,7 @@ Exit Status:
|
|||||||
Example:
|
Example:
|
||||||
mkrep \[ti]/projects/my-new-repo
|
mkrep \[ti]/projects/my-new-repo
|
||||||
mkrep --clean --strict \[ti]/projects/scratch
|
mkrep --clean --strict \[ti]/projects/scratch
|
||||||
|
mkrep -l \[ti]/projects/my-local-repo
|
||||||
mkrep --remote git\[at]git.example.com:me/foo.git \[ti]/projects/foo
|
mkrep --remote git\[at]git.example.com:me/foo.git \[ti]/projects/foo
|
||||||
set -Ux MKREP_REMOTE_CMD \[aq]gh repo create {name} --private --source=. --remote=origin --push\[aq]
|
set -Ux MKREP_REMOTE_CMD \[aq]gh repo create {name} --private --source=. --remote=origin --push\[aq]
|
||||||
mkrep --new-remote \[ti]/projects/foo
|
mkrep --new-remote \[ti]/projects/foo
|
||||||
|
|||||||
Reference in New Issue
Block a user