diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 8cd4c15f28..9f368f903d 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -228,22 +228,25 @@
emergency.target
A special target unit that starts an emergency shell on the main console. This
- target does not pull in any services or mounts. It is the most minimal version of
+ target does not pull in other services or mounts. It is the most minimal version of
starting the system in order to acquire an interactive shell; the only processes running
- are usually just the system manager (PID 1) and the shell process. This unit is supposed
- to be used with the kernel command line option systemd.unit=; it is
- also used when a file system check on a required file system fails, and boot-up cannot
+ are usually just the system manager (PID 1) and the shell process. This unit may be used
+ by specifying emergency on the kernel command line; it is
+ also used when a file system check on a required file system fails and boot-up cannot
continue. Compare with rescue.target, which serves a similar
purpose, but also starts the most basic services and mounts all file systems.
- Use the systemd.unit=emergency.target kernel command line
- option to boot into this mode. A short alias for this kernel command line option is
- emergency, for compatibility with SysV.
-
In many ways booting into emergency.target is similar to the
effect of booting with init=/bin/sh on the kernel command line,
except that emergency mode provides you with the full system and service manager, and
allows starting individual units in order to continue the boot process in steps.
+
+ Note that depending on how emergency.target is reached, the root file
+ system might be mounted read-only or read-write (no remounting is done specially for this
+ target). For example, the system may boot with root mounted read-only when ro
+ is used on the kernel command line and remain this way for emergency.target,
+ or the system may transition to emergency.target after the system has been
+ partially booted and disks have already been remounted read-write.