From 9fcfc0470df856c870dcfc6df78bfbc714da6bd2 Mon Sep 17 00:00:00 2001
From: Dan Streetman <ddstreet@canonical.com>
Date: Tue, 29 Jun 2021 06:29:53 -0400
Subject: Add systemd-resolve backwards compatibility section to resolvectl
 docs

---
 man/resolvectl.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'man/resolvectl.xml')

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 @@
   <refnamediv>
     <refname>resolvectl</refname>
     <refname>resolvconf</refname>
+    <refname>systemd-resolve</refname>
     <refpurpose>Resolve domain names, IPV4 and IPv6 addresses, DNS resource records, and services; introspect and reconfigure the DNS resolver</refpurpose>
   </refnamediv>
 
@@ -472,6 +473,18 @@
     for details on those command line options.</para>
   </refsect1>
 
+  <refsect1>
+    <title>Backwards compatibility with <command>systemd-resolve</command></title>
+
+    <para><command>resolvectl</command> is a multi-call binary, which previously was named <literal>systemd-resolve</literal>
+    and used slightly different parameters. When it is invoked as <literal>systemd-resolve</literal>
+    (generally achieved by means of a symbolic link of this name to the <command>resolvectl</command> binary),
+    it runs in compatibility mode. For details on the specific parameters and calling syntax, see the output from
+    <command>systemd-resolve --help</command>. Calling the binary as <literal>systemd-resolve</literal> is
+    deprecated and should only be done for backwards compatibility. All current and new use should call the binary
+    as <literal>resolvectl</literal>.</para>
+  </refsect1>
+
   <refsect1>
     <title>Examples</title>
 
-- 
cgit v1.2.1