docs:man: document samba-tool dns add --allow-existing

BUG: https://bugzilla.samba.org/show_bug.cgi?id=13613

Signed-off-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
Reviewed-by: Jennifer Sutton <jennifersutton@catalyst.net.nz>
Reviewed-by: Rowland Penny <rpenny@samba.org>
Autobuild-User(master): Douglas Bagnall <dbagnall@samba.org>
Autobuild-Date(master): Fri Jun  6 00:07:43 UTC 2025 on atb-devel-224

diff --git a/docs-xml/manpages/samba-tool.8.xml b/docs-xml/manpages/samba-tool.8.xml
index 28bd8c00124ee91a9c862c883221848877705449..d0bbc30c9e641ec7927d430099bb3a707552cd5f 100644 (file)
--- a/docs-xml/manpages/samba-tool.8.xml
+++ b/docs-xml/manpages/samba-tool.8.xml
@@ -612,6 +612,16 @@
 <refsect3>
        <title>dns add <replaceable>server</replaceable> <replaceable>zone</replaceable> <replaceable>name</replaceable> <replaceable>A|AAAA|PTR|CNAME|NS|MX|SRV|TXT</replaceable> <replaceable>data</replaceable></title>
        <para>Add a DNS record.</para>
+       <variablelist>
+       <varlistentry>
+       <term>--allow-existing</term>
+       <listitem><para> Do not treat an existing record of this name
+       and type as an error. This has no functional change (the new
+       DNS record is not added) but the message and samba-tool
+       return code will not indicate error. </para></listitem>
+       </varlistentry>
+       </variablelist>
+       
 </refsect3>