diff --git a/man/systemctl.xml b/man/systemctl.xml
index 991e9bafaf..2288f65d16 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -150,11 +150,11 @@
- When listing units, show all loaded units, regardless
- of their state, including inactive units. When showing
- unit/job/manager properties, show all properties regardless
- whether they are set or not.
- To list all units installed on the system, use the
+ When listing units with list-units, also show inactive units and
+ units which are following other units. When showing unit/job/manager properties, show all
+ properties regardless whether they are set or not.
+
+ To list all units installed in the file system, use the
list-unit-files command instead.
@@ -638,10 +638,13 @@
list-units PATTERN...
- List known units (subject to limitations specified
- with ). If one or more
- PATTERNs are specified, only
- units matching one of them are shown.
+ List units that systemd has loaded. This includes units that
+ are either referenced directly or through a dependency, or units that were active in the
+ past and have failed. By default only units which are active, have pending jobs, or have
+ failed are shown; this can be changed with option . If one or more
+ PATTERNs are specified, only units matching one of them are
+ shown. The units that are shown are additionally filtered by
+ and if those options are specified.This is the default command.
@@ -970,11 +973,10 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
list-unit-files PATTERN...
- List installed unit files and their enablement state
- (as reported by is-enabled). If one or
- more PATTERNs are specified,
- only units whose filename (just the last component of the
- path) matches one of them are shown.
+ List unit files installed in the file system and their enablement state
+ (as reported by is-enabled). If one or more
+ PATTERNs are specified, only units whose filename
+ (just the last component of the path) matches one of them are shown.