From 3d57a072ec6073988b4c775a9cffd431ef63ab5f Mon Sep 17 00:00:00 2001
From: Ned Batchelder <ned@nedbatchelder.com>
Date: Sun, 10 Mar 2024 08:20:04 -0400
Subject: [PATCH] docs: document the report:format setting

---
 CHANGES.rst      |  6 ++++++
 CONTRIBUTORS.txt |  1 +
 doc/config.rst   | 13 +++++++++++++
 3 files changed, 20 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index eebfcc38f..1ae94d2a4 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -29,6 +29,12 @@ Unreleased
 
 - Fix: clicking a line number in the HTML report now positions more accurately.
 
+- Fix: the ``report:format`` setting was defined as a boolean, but should be a
+  string.  Thanks, `Tanaydin Sirin <pull 1754_>`_.  It is also now documented
+  on the :ref:`configuration page <config_report_format>`.
+
+.. _pull 1754: https://github.com/nedbat/coveragepy/pull/1754
+
 
 .. scriv-start-here
 
diff --git a/CONTRIBUTORS.txt b/CONTRIBUTORS.txt
index ddf76e714..0c36cc46b 100644
--- a/CONTRIBUTORS.txt
+++ b/CONTRIBUTORS.txt
@@ -209,6 +209,7 @@ Steve Leonard
 Steve Oswald
 Steve Peak
 Sviatoslav Sydorenko
+Tanaydin Sirin
 Teake Nutma
 Ted Wexler
 Thijs Triemstra
diff --git a/doc/config.rst b/doc/config.rst
index 540ec780a..4485145c0 100644
--- a/doc/config.rst
+++ b/doc/config.rst
@@ -627,6 +627,19 @@ use of the decimal places.  A setting of 100 will fail any value under 100,
 regardless of the number of decimal places of precision.
 
 
+.. _config_report_format:
+
+[report] format
+...............
+
+(string, default "text") The format to use for the textual report.  The default
+is "text" which produces a simple textual table. You can use "markdown" to
+produce a Markdown table, or "total" to output only the total coverage
+percentage.
+
+.. versionadded:: 7.0
+
+
 .. _config_report_ignore_errors:
 
 [report] ignore_errors