From f20cc30a6af045c0fe1c0b9499d4501678d0f306 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petr=20Men=C5=A1=C3=ADk?= <pemensik@redhat.com>
Date: Mon, 18 Nov 2019 22:19:21 +0100
Subject: [PATCH] Document return codes of dig

The dig tool reports some states as exit status. Document them briefly
in the manual page.
---
 bin/dig/dig.rst | 20 ++++++++++++++++++++
 doc/man/dig.1in | 20 ++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/bin/dig/dig.rst b/bin/dig/dig.rst
index b54d22ef5c..93c0b26c43 100644
--- a/bin/dig/dig.rst
+++ b/bin/dig/dig.rst
@@ -647,6 +647,26 @@ To turn off IDN support, use the parameters
 ``+noidnin`` and ``+noidnout``, or define the ``IDN_DISABLE`` environment
 variable.
 
+Return Codes
+~~~~~~~~~~~~
+
+``dig`` return codes are:
+
+``0``
+   DNS response received, including NXDOMAIN status
+
+``1``
+   Usage error
+
+``8``
+   Couldn't open batch file
+
+``9``
+   No reply from server
+
+``10``
+   Internal error
+
 Files
 ~~~~~
 
diff --git a/doc/man/dig.1in b/doc/man/dig.1in
index bc42c4d543..10d7a44911 100644
--- a/doc/man/dig.1in
+++ b/doc/man/dig.1in
@@ -661,6 +661,26 @@ a request to a DNS server or displaying a reply from the server.
 To turn off IDN support, use the parameters
 \fB+noidnin\fP and \fB+noidnout\fP, or define the \fBIDN_DISABLE\fP environment
 variable.
+.SH RETURN CODES
+.sp
+\fBdig\fP return codes are:
+.INDENT 0.0
+.TP
+.B \fB0\fP
+DNS response received, including NXDOMAIN status
+.TP
+.B \fB1\fP
+Usage error
+.TP
+.B \fB8\fP
+Couldn\(aqt open batch file
+.TP
+.B \fB9\fP
+No reply from server
+.TP
+.B \fB10\fP
+Internal error
+.UNINDENT
 .SH FILES
 .sp
 \fB/etc/resolv.conf\fP