gitea admin user delete --help gives misleading documentation #6524

New Issue

GiteaMirror · 2025-11-02T06:58:31-06:00

GiteaMirror commented

2025-11-02 06:58:31 -06:00

Originally created by @strk on GitHub (Dec 15, 2020).

This is the current --help output for gitea admin user delete:

NAME:
   Gitea admin user delete - Delete specific user

USAGE:
   Gitea admin user delete [command options] [arguments...]

OPTIONS:
   --id value                     ID of authentication source (default: 0)
   --custom-path value, -C value  Custom path file path (default: "/home/git/custom")
   --config value, -c value       Custom configuration file path (default: "/home/git/custom/conf/app.ini")
   --version, -v                  print the version
   --work-path value, -w value    Set the gitea working path (default: "/home/git")

BUT the --id switch does NOT specify an authentication source. Instead it is used as the user identifier (not easy to figure out, btw). I'd think it's a bug in implementation rather than documentation, and that the implmeentation is missing a --username switch to reference users by username instead of id

Originally created by @strk on GitHub (Dec 15, 2020). This is the current --help output for `gitea admin user delete`: ``` NAME: Gitea admin user delete - Delete specific user USAGE: Gitea admin user delete [command options] [arguments...] OPTIONS: --id value ID of authentication source (default: 0) --custom-path value, -C value Custom path file path (default: "/home/git/custom") --config value, -c value Custom configuration file path (default: "/home/git/custom/conf/app.ini") --version, -v print the version --work-path value, -w value Set the gitea working path (default: "/home/git") ``` BUT the `--id` switch does NOT specify an authentication source. Instead it is used as the _user_ identifier (not easy to figure out, btw). I'd think it's a bug in implementation rather than documentation, and that the implmeentation is missing a `--username` switch to reference users by username instead of id

GiteaMirror closed this issue

2025-11-02 06:58:31 -06:00

GiteaMirror commented

2025-11-02 06:58:32 -06:00

@strk commented on GitHub (Dec 15, 2020):

Note this is as of current master (980b0df829)

@strk commented on GitHub (Dec 15, 2020): Note this is as of current master (980b0df8296cdec3692482c3efdbfa68036a1114)

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/gitea#6524