Update CLI reference help, refs #1855

docs/authentication.rst

@@ -192,7 +192,7 @@ There are two ways to configure permissions using ``metadata.json`` (or ``metada
 
 For simple visibility permissions you can use ``"allow"`` blocks in the root, database, table and query sections.
 
-For other permissions you can use a ``"permissions"`` block, described :ref:`in the next section <blah>`.
+For other permissions you can use a ``"permissions"`` block, described :ref:`in the next section <authentication_permissions_other>`.
 
 You can limit who is allowed to view different parts of your Datasette instance using ``"allow"`` keys in your :ref:`metadata` configuration.
 

docs/cli-reference.rst

@@ -617,12 +617,37 @@ Create a signed API token, see :ref:`authentication_cli_create_token`.
 
       Create a signed API token for the specified actor ID
 
+      Example:
+
+          datasette create-token root --secret mysecret
+
+      To only allow create-table:
+
+          datasette create-token root --secret mysecret \
+              --all create-table
+
+      Or to only allow insert-row against a specific table:
+
+          datasette create-token root --secret myscret \
+              --resource mydb mytable insert-row
+
+      Restricted actions can be specified multiple times using multiple --all,
+      --database, and --resource options.
+
+      Add --debug to see a decoded version of the token.
+
     Options:
-      --secret TEXT                Secret used for signing the API tokens
+      --secret TEXT                   Secret used for signing the API tokens
-                                   [required]
+                                      [required]
-      -e, --expires-after INTEGER  Token should expire after this many seconds
+      -e, --expires-after INTEGER     Token should expire after this many seconds
-      --debug                      Show decoded token
+      -a, --all ACTION                Restrict token to this action
-      --help                       Show this message and exit.
+      -d, --database DB ACTION        Restrict token to this action on this database
+      -r, --resource DB RESOURCE ACTION
+                                      Restrict token to this action on this database
+                                      resource (a table, SQL view or named query)
+      --debug                         Show decoded token
+      --plugins-dir DIRECTORY         Path to directory containing custom plugins
+      --help                          Show this message and exit.
 
 
 .. [[[end]]]

docs/plugins.rst

@@ -153,7 +153,6 @@ If you run ``datasette plugins --all`` it will include default plugins that ship
             "hooks": [
                 "actor_from_request",
                 "permission_allowed",
-                "register_commands",
                 "register_permissions",
                 "skip_csrf"
             ]