summaryrefslogtreecommitdiffstats
path: root/gnu/llvm/tools/clang/docs/CommandGuide
diff options
context:
space:
mode:
Diffstat (limited to 'gnu/llvm/tools/clang/docs/CommandGuide')
-rw-r--r--gnu/llvm/tools/clang/docs/CommandGuide/diagtool.rst52
-rw-r--r--gnu/llvm/tools/clang/docs/CommandGuide/index.rst1
2 files changed, 53 insertions, 0 deletions
diff --git a/gnu/llvm/tools/clang/docs/CommandGuide/diagtool.rst b/gnu/llvm/tools/clang/docs/CommandGuide/diagtool.rst
new file mode 100644
index 00000000000..59417f71f69
--- /dev/null
+++ b/gnu/llvm/tools/clang/docs/CommandGuide/diagtool.rst
@@ -0,0 +1,52 @@
+diagtool - clang diagnostics tool
+=================================
+
+SYNOPSIS
+--------
+
+:program:`diagtool` *command* [*args*]
+
+DESCRIPTION
+-----------
+
+:program:`diagtool` is a combination of four tool for dealing with diagnostics in :program:`clang`.
+
+SUBCOMMANDS
+-----------
+
+:program:`diagtool` is separated into several subcommands each tailored to a
+different purpose. A brief summary of each command follows, with more detail in
+the sections that follow.
+
+ * :ref:`find_diagnostic_id` - Print the id of the given diagnostic.
+ * :ref:`list_warnings` - List warnings and their corresponding flags.
+ * :ref:`show_enabled` - Show which warnings are enabled for a given command line.
+ * :ref:`tree` - Show warning flags in a tree view.
+
+.. _find_diagnostic_id:
+
+find-diagnostic-id
+~~~~~~~~~~~~~~~~~~
+
+:program:`diagtool` find-diagnostic-id *diagnostic-name*
+
+.. _list_warnings:
+
+list-warnings
+~~~~~~~~~~~~~
+
+:program:`diagtool` list-warnings
+
+.. _show_enabled:
+
+show-enabled
+~~~~~~~~~~~~
+
+:program:`diagtool` show-enabled [*options*] *filename ...*
+
+.. _tree:
+
+tree
+~~~~
+
+:program:`diagtool` tree [*diagnostic-group*]
diff --git a/gnu/llvm/tools/clang/docs/CommandGuide/index.rst b/gnu/llvm/tools/clang/docs/CommandGuide/index.rst
index 826ed971198..83a91182e9c 100644
--- a/gnu/llvm/tools/clang/docs/CommandGuide/index.rst
+++ b/gnu/llvm/tools/clang/docs/CommandGuide/index.rst
@@ -15,3 +15,4 @@ Basic Commands
:maxdepth: 1
clang
+ diagtool