diff --git a/docs/TRANSIENT-SETTINGS.md b/docs/TRANSIENT-SETTINGS.md
index d5a8046676..d9b1c20c77 100644
--- a/docs/TRANSIENT-SETTINGS.md
+++ b/docs/TRANSIENT-SETTINGS.md
@@ -332,6 +332,7 @@ All mount unit settings are available to transient units:
✓ SloppyOptions=
✓ LazyUnmount=
✓ ForceUnmount=
+✓ ReadWriteOnly=
```
## Automount Unit Settings
diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml
index d775d74053..d18773663f 100644
--- a/man/systemd.mount.xml
+++ b/man/systemd.mount.xml
@@ -497,6 +497,19 @@
off.
+
+ ReadWriteOnly=
+
+ Takes a boolean argument. If false, a mount
+ point that shall be mounted read-write but cannot be mounted
+ so is retried to be mounted read-only. If true the operation
+ will fail immediately after the read-write mount attempt did
+ not succeed. This corresponds with
+ mount8's
+ -w switch. Defaults to
+ off.
+
+
ForceUnmount=