diff --git a/book/src/command/db.md b/book/src/command/db.md
index 93fcf33a8..8d545d4ca 100644
--- a/book/src/command/db.md
+++ b/book/src/command/db.md
@@ -241,13 +241,15 @@ super db -f db -c "from logs:objects"
 ### super db attach
 
 ```
-super db attach <endpoint>
+super db attach [options] [endpoint]
 ```
 * [Global](options.md#global)
 * [Database](options.md#database)
 
-The `attach` command binds the local CLI to a database.
-The `<endpoint>` argument specifies a local file system path,
+The `attach` command binds the local CLI to a database, or, if the `endpoint`
+argument is not provided, shows the currently attached database.
+
+The `endpoint` argument specifies a local file system path,
 an `s3` URL, or the URL of a service endpoint.
 When connecting to a service that requires authentication,
 attach initiates a login to obtain credentials.
diff --git a/book/src/command/options.md b/book/src/command/options.md
index 6769ea8ea..ed4b4c2cd 100644
--- a/book/src/command/options.md
+++ b/book/src/command/options.md
@@ -73,7 +73,7 @@ in which they occurred.
 Database options available to the `super db` command and
 to all `db` [sub-commands](db.md#sub-commands) include:
 * `-configdir` configuration and credentials directory
-* `-attach URI` database location for this command only (defaults to the [attached database](../database/intro.md#locating-the-database))
+* `-attach URI` database location for this command only (defaults to the [attached database](db.md#super-db-attach))
 * `-q` quiet mode to disable displaying status messages for many `super db` subcommands
 
 ## Commit