[clang-tidy][docs] Fix formatting and improve clarity in Clang-Tidy documentation

Author: HARSHIL2836R

clang-tools-extra/docs/clang-tidy/index.rst

@@ -339,27 +339,28 @@ An overview of all the command-line options:
 Clang-Tidy Automation
 =====================
 
-:program:`clang-tidy` can analyze multiple source files by specifying them on the
-command line. For larger projects, automation
-scripts provide additional functionality like parallel execution and integration
-with version control systems.
+:program:`clang-tidy` can analyze multiple source files by specifying them on
+the command line. For larger projects, automation scripts provide additional
+functionality like parallel execution and integration with version control
+systems.
 
 Running Clang-Tidy in Parallel
 -------------------------------
 
 :program:`clang-tidy` can process multiple files sequentially, but for projects
-with many source files, the :program:`run-clang-tidy.py` script provides parallel
-execution to significantly reduce analysis time. This script is included with
-clang-tidy and runs :program:`clang-tidy` over all files in a compilation database
-or a specified path concurrently.
+with many source files, the :program:`run-clang-tidy.py` script provides
+parallel execution to significantly reduce analysis time. This script is
+included with clang-tidy and runs :program:`clang-tidy` over all files in a
+compilation database or a specified path concurrently.
 
-The script requires a compilation database (``compile_commands.json``) which can
-be generated by build systems like CMake (using ``-DCMAKE_EXPORT_COMPILE_COMMANDS=ON``)
-or by tools like `Bear`_.
+The script requires a compilation database (``compile_commands.json``) which
+can be generated by build systems like CMake (using
+``-DCMAKE_EXPORT_COMPILE_COMMANDS=ON``) or by tools like `Bear`_.
 
 The script supports most of the same options as :program:`clang-tidy` itself,
-including ``-checks=``, ``-fix``, ``-header-filter=``, and configuration options.
-Run ``run-clang-tidy.py --help`` for a complete list of available options.
+including ``-checks=``, ``-fix``, ``-header-filter=``, and configuration
+options. Run ``run-clang-tidy.py --help`` for a complete list of available
+options.
 
 Example invocations:
 
@@ -380,12 +381,12 @@ Example invocations:
 Running Clang-Tidy on Diff
 ---------------------------
 
-The :program:`clang-tidy-diff.py` script allows you to run :program:`clang-tidy`
-on the lines that have been modified in your working directory or in a
-specific diff. Importantly, clang-tidy-diff only reports diagnostics for changed
-lines; :program:`clang-tidy` still analyzes the entire file and filters out
-unchanged lines after analysis, so this does not improve performance. This is
-particularly useful for code reviews and continuous
+The :program:`clang-tidy-diff.py` script allows you to run
+:program:`clang-tidy` on the lines that have been modified in your working
+directory or in a specific diff. Importantly, clang-tidy-diff only reports
+diagnostics for changed lines; :program:`clang-tidy` still analyzes the entire
+file and filters out unchanged lines after analysis, so this does not improve
+performance. This is particularly useful for code reviews and continuous
 integration, as it focuses analysis on the changed code rather than the entire
 codebase.
 
@@ -404,7 +405,8 @@ Example invocations:
   $ git diff -U0 --no-color HEAD^ | clang-tidy-diff.py -p1
 
   # Run with specific checks and apply fixes
-  $ git diff -U0 --no-color HEAD^ | clang-tidy-diff.py -p1 -fix -checks=-*,readability-*
+  $ git diff -U0 --no-color HEAD^ | clang-tidy-diff.py -p1 -fix \
+    -checks=-*,readability-*
 
   # Run on staged changes
   $ git diff -U0 --no-color --cached | clang-tidy-diff.py -p1
@@ -415,20 +417,21 @@ Example invocations:
   # Run on a patch file
   $ clang-tidy-diff.py -p1 < changes.patch
 
-The ``-p1`` option tells the script to strip one level of path prefix from the
-diff, which is typically needed for Git diffs. The script supports most of the
-same options as :program:`clang-tidy` itself, including ``-checks=``, ``-fix``,
-``-header-filter=``, and configuration options.
+The ``-p1`` option tells the script to strip one level of path prefix from
+the diff, which is typically needed for Git diffs. The script supports most of
+the same options as :program:`clang-tidy` itself, including ``-checks=``,
+``-fix``, ``-header-filter=``, and configuration options.
 
 While :program:`clang-tidy-diff.py` is useful for focusing on recent changes,
 relying solely on it may lead to incomplete analysis. Since the script only
 reports warnings from the modified lines, it may miss issues that are caused
 by the changes but manifest elsewhere in the code. For example, changes that
 only add lines to a function may cause it to violate size limits (e.g.,
-`readability-function-size <checks/readability/function-size.html>`_), but the diagnostic will be reported at the
-function declaration, which may not be in the diff and thus filtered out.
-Modifications to header files may also affect many implementation files, but
-only warnings in the modified header lines will be reported.
+`readability-function-size <checks/readability/function-size.html>`_), but the
+diagnostic will be reported at the function declaration, which may not be in
+the diff and thus filtered out. Modifications to header files may also affect
+many implementation files, but only warnings in the modified header lines will
+be reported.
 
 For comprehensive analysis, especially before merging significant changes,
 consider running :program:`clang-tidy` on the entire affected files or the