diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml
index e2814b7e42..5f1a5988a0 100644
--- a/man/org.freedesktop.systemd1.xml
+++ b/man/org.freedesktop.systemd1.xml
@@ -1291,7 +1291,13 @@ node /org/freedesktop/systemd1 {
and terminate all units that aren't dependencies of it. If ignore-dependencies, it
will start a unit but ignore all its dependencies. If ignore-requirements, it will
start a unit but only ignore the requirement dependencies. It is not recommended to make use of the
- latter two options. On completion, this method returns the newly created job object.
+ latter two options. On reply, if successful, this method returns the newly created job object
+ which has been enqueued for asynchronous activation. Callers that want to track the outcome of the
+ actual start operation need to monitor the result of this job. This can be achieved in a race-free
+ manner by first subscribing to the JobRemoved() signal, then calling
+ StartUnit() and using the returned job object to filter out unrelated
+ JobRemoved() signals, until the desired one is received, which will then carry
+ the result of the start operation.
StartUnitReplace() is similar to StartUnit() but
replaces a job that is queued for one unit by a job for another unit.