docs: Generate CLI docs

Via `go generate ./docs/...`

Author: adombeck

docs/reference/cli/authctl.md

@@ -0,0 +1,23 @@
+## authctl
+
+CLI tool to interact with authd
+
+### Synopsis
+
+authctl is a command-line tool to interact with the authd service for user and group management.
+
+```
+authctl [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for authctl
+```
+
+### SEE ALSO
+
+* [authctl group](authctl_group.md)	 - Commands related to groups
+* [authctl user](authctl_user.md)	 - Commands related to users
+

docs/reference/cli/authctl_group.md

@@ -0,0 +1,19 @@
+## authctl group
+
+Commands related to groups
+
+```
+authctl group [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for group
+```
+
+### SEE ALSO
+
+* [authctl](authctl.md)	 - CLI tool to interact with authd
+* [authctl group set-gid](authctl_group_set-gid.md)	 - Set the GID of a group managed by authd
+

docs/reference/cli/authctl_group_set-gid.md

@@ -0,0 +1,46 @@
+## authctl group set-gid
+
+Set the GID of a group managed by authd
+
+### Synopsis
+
+Set the GID of a group managed by authd to the specified value.
+
+The new GID must be unique and non-negative. The command must be run as root.
+
+When a group's GID is changed, any users whose primary group is set to this
+group will have the GID of their primary group updated. The home directories of
+these users, and any files within these directories that are owned by the group,
+will be updated to the new GID.
+
+Files outside users' home directories are not updated and must be changed
+manually. Note that changing a GID can be unsafe if files on the system are
+still owned by the original GID: those files may become accessible to a
+different group that is later assigned that GID. To change group ownership of
+all files on the system from the old GID to the new GID, run:
+
+    sudo chown -R --from :OLD_GID :NEW_GID /
+
+
+
+```
+authctl group set-gid <name> <gid> [flags]
+```
+
+### Examples
+
+```
+  # Set the GID of group "staff" to 30000
+  authctl group set-gid staff 30000
+```
+
+### Options
+
+```
+  -h, --help   help for set-gid
+```
+
+### SEE ALSO
+
+* [authctl group](authctl_group.md)	 - Commands related to groups
+

docs/reference/cli/authctl_user.md

@@ -0,0 +1,21 @@
+## authctl user
+
+Commands related to users
+
+```
+authctl user [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for user
+```
+
+### SEE ALSO
+
+* [authctl](authctl.md)	 - CLI tool to interact with authd
+* [authctl user lock](authctl_user_lock.md)	 - Lock (disable) a user managed by authd
+* [authctl user set-uid](authctl_user_set-uid.md)	 - Set the UID of a user managed by authd
+* [authctl user unlock](authctl_user_unlock.md)	 - Unlock (enable) a user managed by authd
+

docs/reference/cli/authctl_user_lock.md

@@ -0,0 +1,22 @@
+## authctl user lock
+
+Lock (disable) a user managed by authd
+
+### Synopsis
+
+Lock a user so that they cannot log in.
+
+```
+authctl user lock <user> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for lock
+```
+
+### SEE ALSO
+
+* [authctl user](authctl_user.md)	 - Commands related to users
+

docs/reference/cli/authctl_user_set-uid.md

@@ -0,0 +1,43 @@
+## authctl user set-uid
+
+Set the UID of a user managed by authd
+
+### Synopsis
+
+Set the UID of a user managed by authd to the specified value.
+
+The new UID must be unique and non-negative. The command must be run as root.
+
+The ownership of the user's home directory, and any files within the directory
+that the user owns, will automatically be updated to the new UID.
+
+Files outside the user's home directory are not updated and must be changed
+manually. Note that changing a UID can be unsafe if files on the system are
+still owned by the original UID: those files may become accessible to a different
+account that is later assigned that UID. To change ownership of all files on the
+system from the old UID to the new UID, run:
+
+    sudo chown -R --from OLD_UID NEW_UID /
+
+
+```
+authctl user set-uid <name> <uid> [flags]
+```
+
+### Examples
+
+```
+  # Set the UID of user "alice" to 15000
+  authctl user set-uid alice 15000
+```
+
+### Options
+
+```
+  -h, --help   help for set-uid
+```
+
+### SEE ALSO
+
+* [authctl user](authctl_user.md)	 - Commands related to users
+

docs/reference/cli/authctl_user_unlock.md

@@ -0,0 +1,22 @@
+## authctl user unlock
+
+Unlock (enable) a user managed by authd
+
+### Synopsis
+
+Unlock a locked user so that they can log in again.
+
+```
+authctl user unlock <user> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for unlock
+```
+
+### SEE ALSO
+
+* [authctl user](authctl_user.md)	 - Commands related to users
+