docs: Generate CLI docs

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

Author: adombeck

docs/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/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/cli/authctl_group_set-gid.md

@@ -0,0 +1,45 @@
+## 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 value must be unique and non-negative.
+
+When a group's GID is changed, any users whose primary group is set to this group
+will have their primary group GID updated. The home directories of these users and
+files within them 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 /
+
+This command requires root privileges.
+
+```
+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/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/cli/authctl_user_lock.md

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

docs/cli/authctl_user_set-uid.md

@@ -0,0 +1,44 @@
+## 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 value must be unique and non-negative.
+
+The user's home directory and any files within it owned by the user will
+automatically have their ownership 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 /
+
+This command requires root privileges.
+
+```
+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/cli/authctl_user_unlock.md

@@ -0,0 +1,18 @@
+## authctl user unlock
+
+Unlock (enable) a user managed by authd
+
+```
+authctl user unlock <user> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for unlock
+```
+
+### SEE ALSO
+
+* [authctl user](authctl_user.md)	 - Commands related to users
+