diff --git a/man/systemctl.xml b/man/systemctl.xml
index 4b25a286da..134b1a9f44 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -941,13 +941,24 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
mask UNIT…
- Mask one or more units, as specified on the command line. This will link these unit files to
- /dev/null, making it impossible to start them. This is a stronger version of
- disable, since it prohibits all kinds of activation of the unit, including enablement
- and manual activation. Use this option with care. This honors the option to only
- mask temporarily until the next reboot of the system. The option may be used to
- ensure that the units are also stopped. This command expects valid unit names only, it does not accept unit
- file paths.
+ Mask one or more units, as specified on the command line. This will link these unit files
+ to /dev/null, making it impossible to start them. This is a stronger version
+ of disable, since it prohibits all kinds of activation of the unit, including
+ enablement and manual activation. Use this option with care. This honors the
+ option to only mask temporarily until the next reboot of the
+ system. The option may be used to ensure that the units are also
+ stopped. This command expects valid unit names only, it does not accept unit file paths.
+
+ Note that this will create a symlink under the unit's name in
+ /etc/systemd/system/ (in case is not specified)
+ or /run/systemd/system/ (in case is
+ specified). If a matching unit file already exists under these directories this operation will
+ hence fail. This means that the operation is primarily useful to mask units shipped by the vendor
+ (as those are shipped in /usr/lib/systemd/system/ and not the aforementioned
+ two directories), but typically doesn't work for units created locally (as those are typically
+ placed precisely in the two aforementioned directories). Similar restrictions apply for
+ mode, in which case the directories are below the user's home directory
+ however.