diff --git a/man/resolvectl.xml b/man/resolvectl.xml
index b9c4d1d768..16c6b0c5b7 100644
--- a/man/resolvectl.xml
+++ b/man/resolvectl.xml
@@ -19,6 +19,7 @@
resolvectl
resolvconf
+ systemd-resolve
Resolve domain names, IPV4 and IPv6 addresses, DNS resource records, and services; introspect and reconfigure the DNS resolver
@@ -472,6 +473,18 @@
for details on those command line options.
+
+ Backwards compatibility with systemd-resolve
+
+ resolvectl is a multi-call binary, which previously was named systemd-resolve
+ and used slightly different parameters. When it is invoked as systemd-resolve
+ (generally achieved by means of a symbolic link of this name to the resolvectl binary),
+ it runs in compatibility mode. For details on the specific parameters and calling syntax, see the output from
+ systemd-resolve --help. Calling the binary as systemd-resolve is
+ deprecated and should only be done for backwards compatibility. All current and new use should call the binary
+ as resolvectl.
+
+
Examples
diff --git a/man/rules/meson.build b/man/rules/meson.build
index 0f6519106a..a62d568861 100644
--- a/man/rules/meson.build
+++ b/man/rules/meson.build
@@ -67,7 +67,7 @@ manpages = [
['portablectl', '1', [], 'ENABLE_PORTABLED'],
['pstore.conf', '5', ['pstore.conf.d'], 'ENABLE_PSTORE'],
['repart.d', '5', [], 'ENABLE_REPART'],
- ['resolvectl', '1', ['resolvconf'], 'ENABLE_RESOLVE'],
+ ['resolvectl', '1', ['resolvconf', 'systemd-resolve'], 'ENABLE_RESOLVE'],
['resolved.conf', '5', ['resolved.conf.d'], 'ENABLE_RESOLVE'],
['runlevel', '8', [], 'HAVE_SYSV_COMPAT'],
['sd-bus-errors',