[llvm-branch-commits] [clang-tools-extra] [clang-tidy][docs] Rewrite short check docs to Markdown (PR #210467)
Reid Kleckner via llvm-branch-commits
llvm-branch-commits at lists.llvm.org
Fri Jul 17 17:06:51 PDT 2026
https://github.com/rnk created https://github.com/llvm/llvm-project/pull/210467
Tracking issue: #201242
See the [migration guide] for more information.
[migration guide]: https://llvm.org/docs/SphinxQuickstartTemplate.html#markdown-migration-guidelines
This is a stacked PR based on #210466 , which will be a standalone commit that
renames *.rst -> *.md before this PR lands for history preservation purposes.
I chose to migrate these files because they were all short, i.e. less than 30 lines, so they all have very uncomplicated reST, which doesn't require much review, or fancy rewriting.
This was prepared with rst2myst plus LLM-assisted cleanup, and the changes are broken into two commits, mechanical, and LLM cleanup.
Please spot check my work and approve if it looks good. You can view the rendered HTML using the links in [this gist](https://gist.github.com/rnk/d5af78243f915fe0809cb878d95916d3) to confirm it renders properly.
>From b0151797297a31a5cb63a9c80c25f75a0b870a5f Mon Sep 17 00:00:00 2001
From: Reid Kleckner <rkleckner at nvidia.com>
Date: Fri, 17 Jul 2026 18:57:17 +0000
Subject: [PATCH 1/2] [docs] Convert selected rst docs with rst2myst
---
.../clang-tidy/checks/abseil/cleanup-ctad.md | 23 +++++------
.../checks/abseil/duration-addition.md | 27 ++++++-------
.../checks/abseil/duration-factory-float.md | 27 ++++++-------
.../checks/abseil/no-internal-dependencies.md | 27 ++++++-------
.../clang-tidy/checks/abseil/no-namespace.md | 24 ++++++------
.../checks/abseil/redundant-strcat-calls.md | 29 +++++++-------
.../checks/abseil/str-cat-append.md | 19 +++++-----
.../checks/abseil/time-comparison.md | 27 ++++++-------
.../altera/id-dependent-backward-branch.md | 38 +++++++++----------
.../checks/altera/kernel-name-restriction.md | 10 ++---
.../checks/android/cloexec-accept.md | 17 +++++----
.../checks/android/cloexec-accept4.md | 17 +++++----
.../checks/android/cloexec-creat.md | 17 +++++----
.../clang-tidy/checks/android/cloexec-dup.md | 17 +++++----
.../checks/android/cloexec-epoll-create.md | 19 +++++-----
.../checks/android/cloexec-epoll-create1.md | 17 +++++----
.../checks/android/cloexec-fopen.md | 20 +++++-----
.../checks/android/cloexec-inotify-init.md | 19 +++++-----
.../checks/android/cloexec-inotify-init1.md | 17 +++++----
.../checks/android/cloexec-memfd-create.md | 17 +++++----
.../clang-tidy/checks/android/cloexec-open.md | 29 +++++++-------
.../clang-tidy/checks/android/cloexec-pipe.md | 21 +++++-----
.../checks/android/cloexec-pipe2.md | 21 +++++-----
.../checks/android/cloexec-socket.md | 17 +++++----
.../clang-tidy/checks/boost/use-to-string.md | 29 +++++++-------
.../bugprone/assignment-in-if-condition.md | 27 ++++++-------
.../bugprone/bad-signal-to-kill-thread.md | 22 +++++------
.../bool-pointer-implicit-conversion.md | 21 +++++-----
.../checks/bugprone/command-processor.md | 17 ++++-----
.../copy-constructor-mutates-argument.md | 10 ++---
...efault-operator-new-on-overaligned-type.md | 19 +++++-----
.../bugprone/dynamic-static-initializers.md | 21 +++++-----
.../checks/bugprone/float-loop-counter.md | 15 ++++----
.../bugprone/forward-declaration-namespace.md | 21 +++++-----
.../checks/bugprone/inaccurate-erase.md | 34 ++++++++---------
.../checks/bugprone/incorrect-roundings.md | 13 ++++---
.../checks/bugprone/macro-parentheses.md | 11 +++---
.../bugprone/macro-repeated-side-effects.md | 8 ++--
.../misplaced-pointer-arithmetic-in-alloc.md | 28 +++++++-------
.../bugprone/multiple-statement-macro.md | 15 ++++----
.../clang-tidy/checks/bugprone/no-escape.md | 29 +++++++-------
.../checks/bugprone/parent-virtual-call.md | 31 +++++++--------
.../checks/bugprone/posix-return.md | 23 +++++------
.../checks/bugprone/signed-bitwise.md | 24 ++++++------
.../checks/bugprone/sizeof-container.md | 33 ++++++++--------
.../bugprone/spuriously-wake-up-functions.md | 37 +++++++++---------
.../checks/bugprone/suspicious-include.md | 24 ++++++------
.../checks/bugprone/terminating-continue.md | 25 ++++++------
.../checks/bugprone/throw-keyword-missing.md | 23 ++++++-----
.../throwing-static-initialization.md | 20 +++++-----
.../bugprone/undelegated-constructor.md | 7 ++--
.../checks/bugprone/virtual-near-miss.md | 23 +++++------
.../docs/clang-tidy/checks/cert/arr39-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/con36-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/con54-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/ctr56-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/dcl03-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/dcl16-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/dcl37-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/dcl50-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/dcl51-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/dcl54-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/dcl58-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/dcl59-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/env33-c.md | 12 +++---
.../docs/clang-tidy/checks/cert/err09-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/err34-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/err52-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/err58-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/err60-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/err61-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/exp42-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/exp45-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/fio38-c.md | 12 +++---
.../docs/clang-tidy/checks/cert/flp30-c.md | 12 +++---
.../docs/clang-tidy/checks/cert/flp37-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/int09-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/mem57-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/msc24-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/msc30-c.md | 12 +++---
.../docs/clang-tidy/checks/cert/msc32-c.md | 12 +++---
.../docs/clang-tidy/checks/cert/msc33-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/msc50-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/msc51-cpp.md | 12 +++---
.../docs/clang-tidy/checks/cert/msc54-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/oop11-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/oop54-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/oop57-cpp.md | 14 +++----
.../docs/clang-tidy/checks/cert/oop58-cpp.md | 9 +++--
.../docs/clang-tidy/checks/cert/pos44-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/pos47-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/sig30-c.md | 9 +++--
.../docs/clang-tidy/checks/cert/str34-c.md | 9 +++--
.../clang-analyzer/core.BitwiseShift.md | 13 ++++---
.../clang-analyzer/core.CallAndMessage.md | 13 ++++---
.../checks/clang-analyzer/core.DivideZero.md | 13 ++++---
.../core.NonNullParamChecker.md | 13 ++++---
.../clang-analyzer/core.NullDereference.md | 13 ++++---
.../clang-analyzer/core.StackAddressEscape.md | 13 ++++---
.../core.UndefinedBinaryOperatorResult.md | 13 ++++---
.../checks/clang-analyzer/core.VLASize.md | 13 ++++---
.../core.uninitialized.ArraySubscript.md | 13 ++++---
.../core.uninitialized.Assign.md | 13 ++++---
.../core.uninitialized.Branch.md | 13 ++++---
...ore.uninitialized.CapturedBlockVariable.md | 13 ++++---
.../core.uninitialized.NewArraySize.md | 13 ++++---
.../core.uninitialized.UndefReturn.md | 13 ++++---
.../clang-analyzer/cplusplus.ArrayDelete.md | 13 ++++---
.../clang-analyzer/cplusplus.InnerPointer.md | 13 ++++---
.../checks/clang-analyzer/cplusplus.Move.md | 13 ++++---
.../clang-analyzer/cplusplus.NewDelete.md | 13 ++++---
.../cplusplus.NewDeleteLeaks.md | 13 ++++---
.../clang-analyzer/cplusplus.PlacementNew.md | 13 ++++---
.../cplusplus.SelfAssignment.md | 13 ++++---
.../clang-analyzer/cplusplus.StringChecker.md | 13 ++++---
.../clang-analyzer/deadcode.DeadStores.md | 13 ++++---
.../clang-analyzer/fuchsia.HandleChecker.md | 13 ++++---
.../nullability.NullPassedToNonnull.md | 15 +++++---
.../nullability.NullReturnedFromNonnull.md | 15 +++++---
.../nullability.NullableDereferenced.md | 13 ++++---
.../nullability.NullablePassedToNonnull.md | 15 +++++---
...nullability.NullableReturnedFromNonnull.md | 15 +++++---
.../optin.core.EnumCastOutOfRange.md | 13 ++++---
.../optin.cplusplus.UninitializedObject.md | 13 ++++---
.../optin.cplusplus.VirtualCall.md | 13 ++++---
.../clang-analyzer/optin.mpi.MPI-Checker.md | 13 ++++---
...ability.EmptyLocalizationContextChecker.md | 13 ++++---
...ocalizability.NonLocalizedStringChecker.md | 13 ++++---
.../optin.performance.GCDAntipattern.md | 13 ++++---
.../optin.performance.Padding.md | 13 ++++---
.../optin.portability.UnixAPI.md | 13 ++++---
.../optin.taint.TaintedAlloc.md | 13 ++++---
.../checks/clang-analyzer/osx.API.md | 13 ++++---
.../osx.NumberObjectConversion.md | 13 ++++---
.../checks/clang-analyzer/osx.ObjCProperty.md | 13 ++++---
.../clang-analyzer/osx.SecKeychainAPI.md | 13 ++++---
.../checks/clang-analyzer/osx.cocoa.AtSync.md | 13 ++++---
.../osx.cocoa.AutoreleaseWrite.md | 13 ++++---
.../clang-analyzer/osx.cocoa.ClassRelease.md | 13 ++++---
.../clang-analyzer/osx.cocoa.Dealloc.md | 13 ++++---
.../osx.cocoa.IncompatibleMethodTypes.md | 13 ++++---
.../checks/clang-analyzer/osx.cocoa.Loops.md | 13 ++++---
.../osx.cocoa.MissingSuperCall.md | 13 ++++---
.../osx.cocoa.NSAutoreleasePool.md | 13 ++++---
.../clang-analyzer/osx.cocoa.NSError.md | 15 +++++---
.../checks/clang-analyzer/osx.cocoa.NilArg.md | 13 ++++---
.../osx.cocoa.NonNilReturnValue.md | 13 ++++---
.../clang-analyzer/osx.cocoa.ObjCGenerics.md | 13 ++++---
.../clang-analyzer/osx.cocoa.RetainCount.md | 13 ++++---
.../osx.cocoa.RunLoopAutoreleaseLeak.md | 13 ++++---
.../clang-analyzer/osx.cocoa.SelfInit.md | 13 ++++---
.../clang-analyzer/osx.cocoa.SuperDealloc.md | 13 ++++---
.../clang-analyzer/osx.cocoa.UnusedIvars.md | 13 ++++---
.../osx.cocoa.VariadicMethodTypes.md | 13 ++++---
.../osx.coreFoundation.CFError.md | 15 +++++---
.../osx.coreFoundation.CFNumber.md | 13 ++++---
.../osx.coreFoundation.CFRetainRelease.md | 13 ++++---
...x.coreFoundation.containers.OutOfBounds.md | 13 ++++---
...oundation.containers.PointerSizedValues.md | 13 ++++---
.../security.FloatLoopCounter.md | 13 ++++---
.../security.PutenvStackArray.md | 13 ++++---
.../security.SetgidSetuidOrder.md | 25 ++++++------
.../security.cert.env.InvalidPtr.md | 13 ++++---
...ureAPI.DeprecatedOrUnsafeBufferHandling.md | 13 ++++---
.../security.insecureAPI.UncheckedReturn.md | 13 ++++---
.../security.insecureAPI.bcmp.md | 13 ++++---
.../security.insecureAPI.bcopy.md | 13 ++++---
.../security.insecureAPI.bzero.md | 13 ++++---
...urity.insecureAPI.decodeValueOfObjCType.md | 13 ++++---
.../security.insecureAPI.getpw.md | 13 ++++---
.../security.insecureAPI.gets.md | 13 ++++---
.../security.insecureAPI.mkstemp.md | 13 ++++---
.../security.insecureAPI.mktemp.md | 13 ++++---
.../security.insecureAPI.rand.md | 13 ++++---
.../security.insecureAPI.strcpy.md | 13 ++++---
.../security.insecureAPI.vfork.md | 13 ++++---
.../checks/clang-analyzer/unix.API.md | 13 ++++---
.../unix.BlockInCriticalSection.md | 13 ++++---
.../checks/clang-analyzer/unix.Errno.md | 13 ++++---
.../checks/clang-analyzer/unix.Malloc.md | 13 ++++---
.../clang-analyzer/unix.MallocSizeof.md | 13 ++++---
.../unix.MismatchedDeallocator.md | 13 ++++---
.../unix.StdCLibraryFunctions.md | 13 ++++---
.../checks/clang-analyzer/unix.Stream.md | 13 ++++---
.../checks/clang-analyzer/unix.Vfork.md | 13 ++++---
.../clang-analyzer/unix.cstring.BadSizeArg.md | 13 ++++---
.../clang-analyzer/unix.cstring.NullArg.md | 13 ++++---
.../webkit.NoUncountedMemberChecker.md | 13 ++++---
.../webkit.RefCntblBaseVirtualDtor.md | 13 ++++---
.../webkit.UncountedLambdaCapturesChecker.md | 13 ++++---
.../thread-canceltype-asynchronous.md | 22 +++++------
.../cppcoreguidelines/avoid-c-arrays.md | 9 +++--
.../cppcoreguidelines/avoid-magic-numbers.md | 9 +++--
.../avoid-reference-coroutine-parameters.md | 24 ++++++------
.../c-copy-assignment-signature.md | 9 +++--
.../cppcoreguidelines/explicit-constructor.md | 9 +++--
.../explicit-virtual-functions.md | 9 +++--
.../interfaces-global-init.md | 9 ++---
.../checks/cppcoreguidelines/macro-to-enum.md | 9 +++--
.../narrowing-conversions.md | 12 +++---
.../cppcoreguidelines/noexcept-destructor.md | 11 +++---
.../noexcept-move-operations.md | 11 +++---
.../checks/cppcoreguidelines/noexcept-swap.md | 15 ++++----
...non-private-member-variables-in-classes.md | 9 +++--
.../pro-bounds-array-to-pointer-decay.md | 12 +++---
.../pro-bounds-constant-array-index.md | 23 ++++++-----
.../pro-bounds-pointer-arithmetic.md | 17 +++++----
.../cppcoreguidelines/pro-type-cstyle-cast.md | 24 ++++++------
.../pro-type-reinterpret-cast.md | 16 ++++----
.../pro-type-static-cast-downcast.md | 23 +++++------
.../pro-type-union-access.md | 10 ++---
.../cppcoreguidelines/pro-type-vararg.md | 12 +++---
.../checks/cppcoreguidelines/slicing.md | 31 ++++++++-------
.../use-default-member-init.md | 11 +++---
.../checks/darwin/avoid-spinlock.md | 17 +++++----
.../checks/darwin/dispatch-once-nonstatic.md | 17 +++++----
.../checks/fuchsia/default-arguments-calls.md | 21 +++++-----
.../fuchsia/default-arguments-declarations.md | 15 ++++----
.../checks/fuchsia/header-anon-namespaces.md | 9 +++--
.../checks/fuchsia/multiple-inheritance.md | 11 +++---
.../checks/fuchsia/overloaded-operator.md | 17 +++++----
.../checks/fuchsia/virtual-inheritance.md | 13 ++++---
.../checks/google/build-explicit-make-pair.md | 11 +++---
.../checks/google/build-namespaces.md | 11 +++---
.../checks/google/build-using-namespace.md | 23 +++++------
.../checks/google/default-arguments.md | 9 +++--
.../checks/google/explicit-constructor.md | 11 +++---
.../checks/google/global-names-in-headers.md | 11 +++---
.../checks/google/objc-avoid-nsobject-new.md | 34 ++++++++---------
.../checks/google/objc-function-naming.md | 23 +++++------
.../readability-braces-around-statements.md | 9 +++--
.../checks/google/readability-casting.md | 11 +++---
.../google/readability-function-size.md | 9 +++--
.../google/readability-namespace-comments.md | 9 +++--
.../checks/google/readability-todo.md | 14 ++++---
.../clang-tidy/checks/google/runtime-float.md | 11 +++---
.../clang-tidy/checks/google/runtime-int.md | 22 +++++++----
.../checks/google/runtime-operator.md | 11 +++---
.../checks/linuxkernel/must-check-errs.md | 29 +++++++-------
.../checks/llvm/else-after-return.md | 8 ++--
.../clang-tidy/checks/llvm/header-guard.md | 7 ++--
.../clang-tidy/checks/llvm/include-order.md | 10 ++---
.../llvm/prefer-register-over-unsigned.md | 36 +++++++++---------
.../clang-tidy/checks/llvm/qualified-auto.md | 9 +++--
.../checks/llvm/use-new-mlir-op-builder.md | 25 ++++++------
.../checks/llvmlibc/callee-namespace.md | 37 +++++++++---------
.../checks/llvmlibc/inline-function-decl.md | 11 +++---
.../misc/anonymous-namespace-in-header.md | 13 +++----
.../checks/misc/confusable-identifiers.md | 15 ++++----
.../checks/misc/misleading-bidirectional.md | 27 ++++++-------
.../checks/misc/misleading-identifier.md | 27 ++++++-------
.../clang-tidy/checks/misc/misplaced-const.md | 37 +++++++++---------
.../checks/misc/new-delete-overloads.md | 16 ++++----
.../clang-tidy/checks/misc/no-recursion.md | 19 +++++-----
.../checks/misc/non-copyable-objects.md | 15 ++++----
...non-private-member-variables-in-classes.md | 18 +++++----
.../checks/misc/predictable-rand.md | 20 +++++-----
.../clang-tidy/checks/misc/static-assert.md | 11 +++---
.../misc/unconventional-assign-operator.md | 24 ++++++------
.../checks/misc/uniqueptr-reset-release.md | 26 +++++++------
.../checks/misc/unused-alias-decls.md | 18 ++++-----
.../checks/misc/unused-using-decls.md | 19 +++++-----
.../checks/modernize/avoid-setjmp-longjmp.md | 19 +++++-----
.../modernize/avoid-variadic-functions.md | 14 +++----
.../modernize/deprecated-ios-base-aliases.md | 25 ++++++------
.../checks/modernize/redundant-void-arg.md | 27 +++++++------
.../modernize/return-braced-init-list.md | 27 ++++++-------
.../checks/modernize/shrink-to-fit.md | 14 +++----
.../checks/modernize/unary-static-assert.md | 29 +++++++-------
.../checks/modernize/use-bool-literals.md | 36 +++++++++---------
.../checks/modernize/use-default.md | 13 ++++---
.../checks/modernize/use-starts-ends-with.md | 13 ++++---
.../clang-tidy/checks/mpi/buffer-deref.md | 29 +++++++-------
.../clang-tidy/checks/mpi/type-mismatch.md | 21 +++++-----
.../clang-tidy/checks/objc/assert-equals.md | 9 +++--
.../checks/objc/avoid-nserror-init.md | 15 ++++----
.../checks/objc/dealloc-in-category.md | 15 ++++----
.../checks/objc/forbidden-subclassing.md | 26 +++++++------
.../clang-tidy/checks/objc/missing-hash.md | 17 +++++----
.../docs/clang-tidy/checks/objc/super-self.md | 12 +++---
.../checks/openmp/exception-escape.md | 16 ++++----
.../checks/performance/faster-string-find.md | 9 +++--
.../performance/implicit-cast-in-loop.md | 12 +++---
.../implicit-conversion-in-loop.md | 21 +++++-----
.../performance/inefficient-algorithm.md | 30 +++++++--------
.../performance/move-constructor-init.md | 7 ++--
.../checks/performance/noexcept-destructor.md | 13 ++++---
.../performance/noexcept-move-constructor.md | 14 +++----
.../checks/performance/noexcept-swap.md | 13 ++++---
.../performance/trivially-destructible.md | 19 +++++-----
.../performance/type-promotion-in-math-fn.md | 27 ++++++-------
.../checks/performance/use-std-move.md | 33 ++++++++--------
.../checks/portability/no-assembler.md | 11 +++---
.../avoid-const-params-in-decls.md | 24 ++++++------
.../avoid-nested-conditional-operator.md | 15 ++++----
.../readability/container-data-pointer.md | 18 +++++----
.../convert-member-functions-to-static.md | 19 +++++-----
.../checks/readability/delete-null-pointer.md | 17 +++++----
.../checks/readability/implicit-bool-cast.md | 13 ++++---
.../readability/math-missing-parentheses.md | 18 ++++-----
.../readability/misplaced-array-index.md | 30 +++++++--------
.../redundant-function-ptr-dereference.md | 25 ++++++------
.../readability/redundant-smartptr-get.md | 26 +++++++------
.../readability/redundant-string-cstr.md | 17 +++++----
.../readability/simplify-subscript-expr.md | 24 ++++++------
...tatic-definition-in-anonymous-namespace.md | 27 ++++++-------
.../checks/readability/use-std-min-max.md | 34 ++++++++---------
.../checks/zircon/temporary-objects.md | 15 ++++----
308 files changed, 2676 insertions(+), 2228 deletions(-)
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md
index b8afc8b8a8481..091cc32cb2e62 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md
@@ -1,22 +1,23 @@
-.. title:: clang-tidy - abseil-cleanup-ctad
+```{title} clang-tidy - abseil-cleanup-ctad
+```
-abseil-cleanup-ctad
-===================
+# abseil-cleanup-ctad
-Suggests switching the initialization pattern of ``absl::Cleanup``
+Suggests switching the initialization pattern of `absl::Cleanup`
instances from the factory function to class template argument
deduction (CTAD), in C++17 and higher.
-.. code-block:: c++
+```c++
+auto c1 = absl::MakeCleanup([] {});
- auto c1 = absl::MakeCleanup([] {});
-
- const auto c2 = absl::MakeCleanup(std::function<void()>([] {}));
+const auto c2 = absl::MakeCleanup(std::function<void()>([] {}));
+```
becomes
-.. code-block:: c++
+```c++
+absl::Cleanup c1 = [] {};
- absl::Cleanup c1 = [] {};
+const absl::Cleanup c2 = std::function<void()>([] {});
+```
- const absl::Cleanup c2 = std::function<void()>([] {});
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md
index e8e3da00212aa..33f38e3d5944b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md
@@ -1,21 +1,22 @@
-.. title:: clang-tidy - abseil-duration-addition
+```{title} clang-tidy - abseil-duration-addition
+```
-abseil-duration-addition
-========================
+# abseil-duration-addition
-Checks for cases where addition should be performed in the ``absl::Time``
-domain. When adding two values, and one is known to be an ``absl::Time``,
-we can infer that the other should be interpreted as an ``absl::Duration``
+Checks for cases where addition should be performed in the `absl::Time`
+domain. When adding two values, and one is known to be an `absl::Time`,
+we can infer that the other should be interpreted as an `absl::Duration`
of a similar scale, and make that inference explicit.
Examples:
-.. code-block:: c++
+```c++
+// Original - Addition in the integer domain
+int x;
+absl::Time t;
+int result = absl::ToUnixSeconds(t) + x;
- // Original - Addition in the integer domain
- int x;
- absl::Time t;
- int result = absl::ToUnixSeconds(t) + x;
+// Suggestion - Addition in the absl::Time domain
+int result = absl::ToUnixSeconds(t + absl::Seconds(x));
+```
- // Suggestion - Addition in the absl::Time domain
- int result = absl::ToUnixSeconds(t + absl::Seconds(x));
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md
index a4fc6d4291d3b..2dbd7abab663f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md
@@ -1,10 +1,10 @@
-.. title:: clang-tidy - abseil-duration-factory-float
+```{title} clang-tidy - abseil-duration-factory-float
+```
-abseil-duration-factory-float
-=============================
+# abseil-duration-factory-float
Checks for cases where the floating-point overloads of various
-``absl::Duration`` factory functions are called when the more-efficient
+`absl::Duration` factory functions are called when the more-efficient
integer versions could be used instead.
This check will not suggest fixes for literals which contain fractional
@@ -13,17 +13,18 @@ superfluous casts.
Examples:
-.. code-block:: c++
+```c++
+// Original - Providing a floating-point literal.
+absl::Duration d = absl::Seconds(10.0);
- // Original - Providing a floating-point literal.
- absl::Duration d = absl::Seconds(10.0);
+// Suggested - Use an integer instead.
+absl::Duration d = absl::Seconds(10);
- // Suggested - Use an integer instead.
- absl::Duration d = absl::Seconds(10);
+// Original - Explicitly casting to a floating-point type.
+absl::Duration d = absl::Seconds(static_cast<double>(10));
- // Original - Explicitly casting to a floating-point type.
- absl::Duration d = absl::Seconds(static_cast<double>(10));
+// Suggested - Remove the explicit cast
+absl::Duration d = absl::Seconds(10);
+```
- // Suggested - Remove the explicit cast
- absl::Duration d = absl::Seconds(10);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md
index c06057b313da5..aec3f19dcbef8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md
@@ -1,24 +1,25 @@
-.. title:: clang-tidy - abseil-no-internal-dependencies
+```{title} clang-tidy - abseil-no-internal-dependencies
+```
-abseil-no-internal-dependencies
-===============================
+# abseil-no-internal-dependencies
Warns if code using Abseil depends on internal details. If something is in a
namespace that includes the word "internal", code is not allowed to depend upon
it because it's an implementation detail. They cannot friend it, include it,
you mention it or refer to it in any way. Doing so violates Abseil's
compatibility guidelines and may result in breakage. See
-https://abseil.io/about/compatibility for more information.
+<https://abseil.io/about/compatibility> for more information.
The following cases will result in warnings:
-.. code-block:: c++
-
- absl::strings_internal::foo();
- // warning triggered on this line
- class foo {
- friend struct absl::container_internal::faa;
- // warning triggered on this line
- };
- absl::memory_internal::MakeUniqueResult();
+```c++
+absl::strings_internal::foo();
+// warning triggered on this line
+class foo {
+ friend struct absl::container_internal::faa;
// warning triggered on this line
+};
+absl::memory_internal::MakeUniqueResult();
+// warning triggered on this line
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md
index 46e79cfc11223..36bf87c67b897 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md
@@ -1,21 +1,21 @@
-.. title:: clang-tidy - abseil-no-namespace
+```{title} clang-tidy - abseil-no-namespace
+```
-abseil-no-namespace
-===================
+# abseil-no-namespace
-Ensures code does not open ``namespace absl`` as that violates Abseil's
-compatibility guidelines. Code should not open ``namespace absl`` as that
+Ensures code does not open `namespace absl` as that violates Abseil's
+compatibility guidelines. Code should not open `namespace absl` as that
conflicts with Abseil's compatibility guidelines and may result in breakage.
Any code that uses:
-.. code-block:: c++
-
- namespace absl {
- ...
- }
+```c++
+namespace absl {
+ ...
+}
+```
will be prompted with a warning.
-See `the full Abseil compatibility guidelines <https://
-abseil.io/about/compatibility>`_ for more information.
+See [the full Abseil compatibility guidelines](https://abseil.io/about/compatibility) for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md
index 6db321a06243f..feed2b31963e7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md
@@ -1,26 +1,27 @@
-.. title:: clang-tidy - abseil-redundant-strcat-calls
+```{title} clang-tidy - abseil-redundant-strcat-calls
+```
-abseil-redundant-strcat-calls
-=============================
+# abseil-redundant-strcat-calls
-Suggests removal of unnecessary calls to ``absl::StrCat`` when the result is
-being passed to another call to ``absl::StrCat`` or ``absl::StrAppend``.
+Suggests removal of unnecessary calls to `absl::StrCat` when the result is
+being passed to another call to `absl::StrCat` or `absl::StrAppend`.
The extra calls cause unnecessary temporary strings to be constructed. Removing
them makes the code smaller and faster.
Examples:
-.. code-block:: c++
+```c++
+std::string s = absl::StrCat("A", absl::StrCat("B", absl::StrCat("C", "D")));
+//before
- std::string s = absl::StrCat("A", absl::StrCat("B", absl::StrCat("C", "D")));
- //before
+std::string s = absl::StrCat("A", "B", "C", "D");
+//after
- std::string s = absl::StrCat("A", "B", "C", "D");
- //after
+absl::StrAppend(&s, absl::StrCat("E", "F", "G"));
+//before
- absl::StrAppend(&s, absl::StrCat("E", "F", "G"));
- //before
+absl::StrAppend(&s, "E", "F", "G");
+//after
+```
- absl::StrAppend(&s, "E", "F", "G");
- //after
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md
index e989f7cc45fcf..96ea3e6aa840c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md
@@ -1,17 +1,18 @@
-.. title:: clang-tidy - abseil-str-cat-append
+```{title} clang-tidy - abseil-str-cat-append
+```
-abseil-str-cat-append
-=====================
+# abseil-str-cat-append
-Flags uses of ``absl::StrCat()`` to append to a ``std::string``. Suggests
-``absl::StrAppend()`` should be used instead.
+Flags uses of `absl::StrCat()` to append to a `std::string`. Suggests
+`absl::StrAppend()` should be used instead.
The extra calls cause unnecessary temporary strings to be constructed. Removing
them makes the code smaller and faster.
-.. code-block:: c++
+```c++
+a = absl::StrCat(a, b); // Use absl::StrAppend(&a, b) instead.
+```
- a = absl::StrCat(a, b); // Use absl::StrAppend(&a, b) instead.
-
-Does not diagnose cases where ``absl::StrCat()`` is used as a template
+Does not diagnose cases where `absl::StrCat()` is used as a template
argument for a functor.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md
index 9342e4cf96ccc..8db85430700f9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md
@@ -1,23 +1,24 @@
-.. title:: clang-tidy - abseil-time-comparison
+```{title} clang-tidy - abseil-time-comparison
+```
-abseil-time-comparison
-======================
+# abseil-time-comparison
-Prefer comparisons in the ``absl::Time`` domain instead of the integer domain.
+Prefer comparisons in the `absl::Time` domain instead of the integer domain.
-N.B.: In cases where an ``absl::Time`` is being converted to an integer,
+N.B.: In cases where an `absl::Time` is being converted to an integer,
alignment may occur. If the comparison depends on this alignment, doing the
-comparison in the ``absl::Time`` domain may yield a different result. In
+comparison in the `absl::Time` domain may yield a different result. In
practice this is very rare, and still indicates a bug which should be fixed.
Examples:
-.. code-block:: c++
+```c++
+// Original - Comparison in the integer domain
+int x;
+absl::Time t;
+if (x < absl::ToUnixSeconds(t)) ...
- // Original - Comparison in the integer domain
- int x;
- absl::Time t;
- if (x < absl::ToUnixSeconds(t)) ...
+// Suggested - Compare in the absl::Time domain instead
+if (absl::FromUnixSeconds(x) < t) ...
+```
- // Suggested - Compare in the absl::Time domain instead
- if (absl::FromUnixSeconds(x) < t) ...
diff --git a/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md b/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md
index 26dd1fb90925b..fc7589c7930d1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md
@@ -1,28 +1,28 @@
-.. title:: clang-tidy - altera-id-dependent-backward-branch
+```{title} clang-tidy - altera-id-dependent-backward-branch
+```
-altera-id-dependent-backward-branch
-===================================
+# altera-id-dependent-backward-branch
Finds ID-dependent variables and fields that are used within loops. This causes
branches to occur inside the loops, and thus leads to performance degradation.
-.. code-block:: c++
+```c++
+// The following code will produce a warning because this ID-dependent
+// variable is used in a loop condition statement.
+int ThreadID = get_local_id(0);
- // The following code will produce a warning because this ID-dependent
- // variable is used in a loop condition statement.
- int ThreadID = get_local_id(0);
+// The following loop will produce a warning because the loop condition
+// statement depends on an ID-dependent variable.
+for (int i = 0; i < ThreadID; ++i) {
+ std::cout << i << std::endl;
+}
- // The following loop will produce a warning because the loop condition
- // statement depends on an ID-dependent variable.
- for (int i = 0; i < ThreadID; ++i) {
- std::cout << i << std::endl;
- }
+// The following loop will not produce a warning, because the ID-dependent
+// variable is not used in the loop condition statement.
+for (int i = 0; i < 100; ++i) {
+ std::cout << ThreadID << std::endl;
+}
+```
- // The following loop will not produce a warning, because the ID-dependent
- // variable is not used in the loop condition statement.
- for (int i = 0; i < 100; ++i) {
- std::cout << ThreadID << std::endl;
- }
+Based on the [Altera SDK for OpenCL: Best Practices Guide](https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_optimization_guide.pdf).
-Based on the `Altera SDK for OpenCL: Best Practices Guide
-<https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_optimization_guide.pdf>`_.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md b/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md
index 86cc10bef9573..283a3521d015d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - altera-kernel-name-restriction
+```{title} clang-tidy - altera-kernel-name-restriction
+```
-altera-kernel-name-restriction
-==============================
+# altera-kernel-name-restriction
Finds kernel files and include directives whose filename is `kernel.cl`,
`Verilog.cl`, or `VHDL.cl`. The check is case insensitive.
@@ -11,5 +11,5 @@ design files that have the same names as certain internal files, which
leads to a compilation error.
Based on the `Guidelines for Naming the Kernel` section in the
-`Intel FPGA SDK for OpenCL Pro Edition: Programming Guide
-<https://www.intel.com/content/www/us/en/programmable/documentation/mwh1391807965224.html#ewa1412973930963>`_.
+[Intel FPGA SDK for OpenCL Pro Edition: Programming Guide](https://www.intel.com/content/www/us/en/programmable/documentation/mwh1391807965224.html#ewa1412973930963).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md
index 58ce05f3e18b5..18c5d76dcfb18 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - android-cloexec-accept
+```{title} clang-tidy - android-cloexec-accept
+```
-android-cloexec-accept
-======================
+# android-cloexec-accept
-The usage of ``accept()`` is not recommended, it's better to use ``accept4()``.
+The usage of `accept()` is not recommended, it's better to use `accept4()`.
Without this flag, an opened sensitive file descriptor would remain open across
a fork+exec to a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+accept(sockfd, addr, addrlen);
- accept(sockfd, addr, addrlen);
+// becomes
- // becomes
+accept4(sockfd, addr, addrlen, SOCK_CLOEXEC);
+```
- accept4(sockfd, addr, addrlen, SOCK_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md
index 1633395d8f6a8..714a25375a131 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - android-cloexec-accept4
+```{title} clang-tidy - android-cloexec-accept4
+```
-android-cloexec-accept4
-=======================
+# android-cloexec-accept4
-``accept4()`` should include ``SOCK_CLOEXEC`` in its type argument to avoid the
+`accept4()` should include `SOCK_CLOEXEC` in its type argument to avoid the
file descriptor leakage. Without this flag, an opened sensitive file would
remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+accept4(sockfd, addr, addrlen, SOCK_NONBLOCK);
- accept4(sockfd, addr, addrlen, SOCK_NONBLOCK);
+// becomes
- // becomes
+accept4(sockfd, addr, addrlen, SOCK_NONBLOCK | SOCK_CLOEXEC);
+```
- accept4(sockfd, addr, addrlen, SOCK_NONBLOCK | SOCK_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md
index d2892a0fdc560..91ec1d671dfa8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md
@@ -1,16 +1,17 @@
-.. title:: clang-tidy - android-cloexec-creat
+```{title} clang-tidy - android-cloexec-creat
+```
-android-cloexec-creat
-=====================
+# android-cloexec-creat
-The usage of ``creat()`` is not recommended, it's better to use ``open()``.
+The usage of `creat()` is not recommended, it's better to use `open()`.
Examples:
-.. code-block:: c++
+```c++
+int fd = creat(path, mode);
- int fd = creat(path, mode);
+// becomes
- // becomes
+int fd = open(path, O_WRONLY | O_CREAT | O_TRUNC | O_CLOEXEC, mode);
+```
- int fd = open(path, O_WRONLY | O_CREAT | O_TRUNC | O_CLOEXEC, mode);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md
index d287a657d1c0b..654d058f03f2b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - android-cloexec-dup
+```{title} clang-tidy - android-cloexec-dup
+```
-android-cloexec-dup
-===================
+# android-cloexec-dup
-The usage of ``dup()`` is not recommended, it's better to use ``fcntl()``,
+The usage of `dup()` is not recommended, it's better to use `fcntl()`,
which can set the close-on-exec flag. Otherwise, an opened sensitive file would
remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+int fd = dup(oldfd);
- int fd = dup(oldfd);
+// becomes
- // becomes
+int fd = fcntl(oldfd, F_DUPFD_CLOEXEC);
+```
- int fd = fcntl(oldfd, F_DUPFD_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md
index 98f0f6c901d6b..affdda6ae3d97 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md
@@ -1,17 +1,18 @@
-.. title:: clang-tidy - android-cloexec-epoll-create
+```{title} clang-tidy - android-cloexec-epoll-create
+```
-android-cloexec-epoll-create
-============================
+# android-cloexec-epoll-create
-The usage of ``epoll_create()`` is not recommended, it's better to use
-``epoll_create1()``, which allows close-on-exec.
+The usage of `epoll_create()` is not recommended, it's better to use
+`epoll_create1()`, which allows close-on-exec.
Examples:
-.. code-block:: c++
+```c++
+epoll_create(size);
- epoll_create(size);
+// becomes
- // becomes
+epoll_create1(EPOLL_CLOEXEC);
+```
- epoll_create1(EPOLL_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md
index 7e7c4adb0795d..9733f7346c756 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - android-cloexec-epoll-create1
+```{title} clang-tidy - android-cloexec-epoll-create1
+```
-android-cloexec-epoll-create1
-=============================
+# android-cloexec-epoll-create1
-``epoll_create1()`` should include ``EPOLL_CLOEXEC`` in its type argument to
+`epoll_create1()` should include `EPOLL_CLOEXEC` in its type argument to
avoid the file descriptor leakage. Without this flag, an opened sensitive file
would remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+epoll_create1(0);
- epoll_create1(0);
+// becomes
- // becomes
+epoll_create1(EPOLL_CLOEXEC);
+```
- epoll_create1(EPOLL_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md
index 0552969848960..f80dc16b72197 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md
@@ -1,18 +1,18 @@
-.. title:: clang-tidy - android-cloexec-fopen
+```{title} clang-tidy - android-cloexec-fopen
+```
-android-cloexec-fopen
-=====================
+# android-cloexec-fopen
-``fopen()`` should include ``e`` in their mode string; so ``re`` would be
-valid. This is equivalent to having set ``FD_CLOEXEC on`` that descriptor.
+`fopen()` should include `e` in their mode string; so `re` would be
+valid. This is equivalent to having set `FD_CLOEXEC on` that descriptor.
Examples:
-.. code-block:: c++
+```c++
+fopen("fn", "r");
- fopen("fn", "r");
+// becomes
- // becomes
-
- fopen("fn", "re");
+fopen("fn", "re");
+```
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md
index cee4c7bf4fed5..301080a7b62fe 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md
@@ -1,17 +1,18 @@
-.. title:: clang-tidy - android-cloexec-inotify-init
+```{title} clang-tidy - android-cloexec-inotify-init
+```
-android-cloexec-inotify-init
-============================
+# android-cloexec-inotify-init
-The usage of ``inotify_init()`` is not recommended, it's better to use
-``inotify_init1()``.
+The usage of `inotify_init()` is not recommended, it's better to use
+`inotify_init1()`.
Examples:
-.. code-block:: c++
+```c++
+inotify_init();
- inotify_init();
+// becomes
- // becomes
+inotify_init1(IN_CLOEXEC);
+```
- inotify_init1(IN_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md
index 741158964ec10..695b6e1c0f53a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md
@@ -1,19 +1,20 @@
-.. title:: clang-tidy - android-cloexec-inotify-init1
+```{title} clang-tidy - android-cloexec-inotify-init1
+```
-android-cloexec-inotify-init1
-=============================
+# android-cloexec-inotify-init1
-``inotify_init1()`` should include ``IN_CLOEXEC`` in its type argument
+`inotify_init1()` should include `IN_CLOEXEC` in its type argument
to avoid the file descriptor leakage. Without this flag, an opened
sensitive file would remain open across a fork+exec to a
lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+inotify_init1(IN_NONBLOCK);
- inotify_init1(IN_NONBLOCK);
+// becomes
- // becomes
+inotify_init1(IN_NONBLOCK | IN_CLOEXEC);
+```
- inotify_init1(IN_NONBLOCK | IN_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md
index a45321d64b30d..75be610d78dc3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - android-cloexec-memfd-create
+```{title} clang-tidy - android-cloexec-memfd-create
+```
-android-cloexec-memfd-create
-============================
+# android-cloexec-memfd-create
-``memfd_create()`` should include ``MFD_CLOEXEC`` in its type argument to avoid
+`memfd_create()` should include `MFD_CLOEXEC` in its type argument to avoid
the file descriptor leakage. Without this flag, an opened sensitive file would
remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+memfd_create(name, MFD_ALLOW_SEALING);
- memfd_create(name, MFD_ALLOW_SEALING);
+// becomes
- // becomes
+memfd_create(name, MFD_ALLOW_SEALING | MFD_CLOEXEC);
+```
- memfd_create(name, MFD_ALLOW_SEALING | MFD_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md
index 850eae7023c64..967eb9d837b75 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md
@@ -1,24 +1,25 @@
-.. title:: clang-tidy - android-cloexec-open
+```{title} clang-tidy - android-cloexec-open
+```
-android-cloexec-open
-====================
+# android-cloexec-open
A common source of security bugs is code that opens a file without using the
-``O_CLOEXEC`` flag. Without that flag, an opened sensitive file would remain
+`O_CLOEXEC` flag. Without that flag, an opened sensitive file would remain
open across a fork+exec to a lower-privileged SELinux domain, leaking that
-sensitive data. Open-like functions including ``open()``, ``openat()``, and
-``open64()`` should include ``O_CLOEXEC`` in their flags argument.
+sensitive data. Open-like functions including `open()`, `openat()`, and
+`open64()` should include `O_CLOEXEC` in their flags argument.
Examples:
-.. code-block:: c++
+```c++
+open("filename", O_RDWR);
+open64("filename", O_RDWR);
+openat(0, "filename", O_RDWR);
- open("filename", O_RDWR);
- open64("filename", O_RDWR);
- openat(0, "filename", O_RDWR);
+// becomes
- // becomes
+open("filename", O_RDWR | O_CLOEXEC);
+open64("filename", O_RDWR | O_CLOEXEC);
+openat(0, "filename", O_RDWR | O_CLOEXEC);
+```
- open("filename", O_RDWR | O_CLOEXEC);
- open64("filename", O_RDWR | O_CLOEXEC);
- openat(0, "filename", O_RDWR | O_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md
index c19e07f6c5dfe..267c2889272e2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md
@@ -1,22 +1,23 @@
-.. title:: clang-tidy - android-cloexec-pipe
+```{title} clang-tidy - android-cloexec-pipe
+```
-android-cloexec-pipe
-====================
+# android-cloexec-pipe
-This check detects usage of ``pipe()``. Using ``pipe()`` is not recommended,
-``pipe2()`` is the suggested replacement. The check also adds the ``O_CLOEXEC``
+This check detects usage of `pipe()`. Using `pipe()` is not recommended,
+`pipe2()` is the suggested replacement. The check also adds the `O_CLOEXEC`
flag that marks the file descriptor to be closed in child processes.
Without this flag a sensitive file descriptor can be leaked to a
child process, potentially into a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
-
- pipe(pipefd);
+```c++
+pipe(pipefd);
+```
Suggested replacement:
-.. code-block:: c++
+```c++
+pipe2(pipefd, O_CLOEXEC);
+```
- pipe2(pipefd, O_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md
index dc9c6fc411177..1f15991693ad1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md
@@ -1,22 +1,23 @@
-.. title:: clang-tidy - android-cloexec-pipe2
+```{title} clang-tidy - android-cloexec-pipe2
+```
-android-cloexec-pipe2
-=====================
+# android-cloexec-pipe2
-This check ensures that ``pipe2()`` is called with the ``O_CLOEXEC`` flag.
-The check also adds the ``O_CLOEXEC`` flag that marks the file descriptor
+This check ensures that `pipe2()` is called with the `O_CLOEXEC` flag.
+The check also adds the `O_CLOEXEC` flag that marks the file descriptor
to be closed in child processes.
Without this flag a sensitive file descriptor can be leaked to a child process,
potentially into a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
-
- pipe2(pipefd, O_NONBLOCK);
+```c++
+pipe2(pipefd, O_NONBLOCK);
+```
Suggested replacement:
-.. code-block:: c++
+```c++
+pipe2(pipefd, O_NONBLOCK | O_CLOEXEC);
+```
- pipe2(pipefd, O_NONBLOCK | O_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md
index 10b1976101e17..c12bdf045781a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - android-cloexec-socket
+```{title} clang-tidy - android-cloexec-socket
+```
-android-cloexec-socket
-======================
+# android-cloexec-socket
-``socket()`` should include ``SOCK_CLOEXEC`` in its type argument to avoid the
+`socket()` should include `SOCK_CLOEXEC` in its type argument to avoid the
file descriptor leakage. Without this flag, an opened sensitive file would
remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-.. code-block:: c++
+```c++
+socket(domain, type, SOCK_STREAM);
- socket(domain, type, SOCK_STREAM);
+// becomes
- // becomes
+socket(domain, type, SOCK_STREAM | SOCK_CLOEXEC);
+```
- socket(domain, type, SOCK_STREAM | SOCK_CLOEXEC);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md b/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md
index 9a5bb888ba861..d142af0e68ce5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md
@@ -1,22 +1,21 @@
-.. title:: clang-tidy - boost-use-to-string
+```{title} clang-tidy - boost-use-to-string
+```
-boost-use-to-string
-===================
+# boost-use-to-string
-This check finds conversion from integer type like ``int`` to
-``std::string`` or ``std::wstring`` using ``boost::lexical_cast``,
-and replace it with calls to ``std::to_string`` and ``std::to_wstring``.
+This check finds conversion from integer type like `int` to
+`std::string` or `std::wstring` using `boost::lexical_cast`,
+and replace it with calls to `std::to_string` and `std::to_wstring`.
-It doesn't replace conversion from floating points despite the ``to_string``
+It doesn't replace conversion from floating points despite the `to_string`
overloads, because it would change the behavior.
+```c++
+auto str = boost::lexical_cast<std::string>(42);
+auto wstr = boost::lexical_cast<std::wstring>(2137LL);
-.. code-block:: c++
-
- auto str = boost::lexical_cast<std::string>(42);
- auto wstr = boost::lexical_cast<std::wstring>(2137LL);
-
- // Will be changed to
- auto str = std::to_string(42);
- auto wstr = std::to_wstring(2137LL);
+// Will be changed to
+auto str = std::to_string(42);
+auto wstr = std::to_wstring(2137LL);
+```
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md
index 980e8146d0d64..6f2a10452712f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - bugprone-assignment-in-if-condition
+```{title} clang-tidy - bugprone-assignment-in-if-condition
+```
-bugprone-assignment-in-if-condition
-===================================
+# bugprone-assignment-in-if-condition
Finds assignments within conditions of `if` statements.
Such assignments are bug-prone because they may have been intended as
@@ -9,17 +9,18 @@ equality tests.
This check finds all assignments within `if` conditions, including ones that
are not flagged by `-Wparentheses` due to an extra set of parentheses, and
-including assignments that call an overloaded ``operator=()``. The identified
+including assignments that call an overloaded `operator=()`. The identified
assignments violate
-`BARR group "Rule 8.2.c" <https://barrgroup.com/embedded-systems/books/embedded-c-coding-standard/statement-rules/if-else-statements>`_.
+[BARR group "Rule 8.2.c"](https://barrgroup.com/embedded-systems/books/embedded-c-coding-standard/statement-rules/if-else-statements).
-.. code-block:: c++
+```c++
+int f = 3;
+if(f = 4) { // This is identified by both `Wparentheses` and this check - should it have been: `if (f == 4)` ?
+ f = f + 1;
+}
- int f = 3;
- if(f = 4) { // This is identified by both `Wparentheses` and this check - should it have been: `if (f == 4)` ?
- f = f + 1;
- }
+if((f == 5) || (f = 6)) { // the assignment here `(f = 6)` is identified by this check, but not by `-Wparentheses`. Should it have been `(f == 6)` ?
+ f = f + 2;
+}
+```
- if((f == 5) || (f = 6)) { // the assignment here `(f = 6)` is identified by this check, but not by `-Wparentheses`. Should it have been `(f == 6)` ?
- f = f + 2;
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md
index 2a09a804630a0..002d80634ceb3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md
@@ -1,18 +1,18 @@
-.. title:: clang-tidy - bugprone-bad-signal-to-kill-thread
+```{title} clang-tidy - bugprone-bad-signal-to-kill-thread
+```
-bugprone-bad-signal-to-kill-thread
-==================================
+# bugprone-bad-signal-to-kill-thread
-Finds ``pthread_kill`` function calls when a thread is terminated by
-raising ``SIGTERM`` signal and the signal kills the entire process, not
-just the individual thread. Use any signal except ``SIGTERM``.
+Finds `pthread_kill` function calls when a thread is terminated by
+raising `SIGTERM` signal and the signal kills the entire process, not
+just the individual thread. Use any signal except `SIGTERM`.
-.. code-block:: c++
-
- pthread_kill(thread, SIGTERM);
+```c++
+pthread_kill(thread, SIGTERM);
+```
This check corresponds to the CERT C Coding Standard rule
-`POS44-C. Do not use signals to terminate threads
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/posix-pos/pos44-c/>`_.
+[POS44-C. Do not use signals to terminate threads](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/posix-pos/pos44-c/).
`cert-pos44-c` redirects here as an alias of this check.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md
index e42ee5f609540..df4702f9cc4bd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md
@@ -1,16 +1,17 @@
-.. title:: clang-tidy - bugprone-bool-pointer-implicit-conversion
+```{title} clang-tidy - bugprone-bool-pointer-implicit-conversion
+```
-bugprone-bool-pointer-implicit-conversion
-=========================================
+# bugprone-bool-pointer-implicit-conversion
-Checks for conditions based on implicit conversion from a ``bool`` pointer to
-``bool``.
+Checks for conditions based on implicit conversion from a `bool` pointer to
+`bool`.
Example:
-.. code-block:: c++
+```c++
+bool *p;
+if (p) {
+ // Never used in a pointer-specific way.
+}
+```
- bool *p;
- if (p) {
- // Never used in a pointer-specific way.
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md
index ff832af1e1ad1..9ba630dbe639f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md
@@ -1,16 +1,15 @@
-.. title:: clang-tidy - bugprone-command-processor
+```{title} clang-tidy - bugprone-command-processor
+```
-bugprone-command-processor
-==========================
+# bugprone-command-processor
-Flags calls to ``system()``, ``popen()``, and ``_popen()``, which
-execute a command processor. It does not flag calls to ``system()`` with a null
+Flags calls to `system()`, `popen()`, and `_popen()`, which
+execute a command processor. It does not flag calls to `system()` with a null
pointer argument, as such a call checks for the presence of a command processor
but does not actually attempt to execute a command.
-References
-----------
+## References
This check corresponds to the CERT C Coding Standard rule
-`ENV33-C. Do not call system()
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/environment-env/env33-c/>`_.
+[ENV33-C. Do not call system()](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/environment-env/env33-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md
index b27045488eebf..6c62844091456 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md
@@ -1,11 +1,11 @@
-.. title:: clang-tidy - bugprone-copy-constructor-mutates-argument
+```{title} clang-tidy - bugprone-copy-constructor-mutates-argument
+```
-bugprone-copy-constructor-mutates-argument
-==========================================
+# bugprone-copy-constructor-mutates-argument
Finds assignments to the copied object and its direct or indirect members
in copy constructors and copy assignment operators.
This check corresponds to the CERT C Coding Standard rule
-`OOP58-CPP. Copy operations must not mutate the source object
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop58-cpp/>`_.
+[OOP58-CPP. Copy operations must not mutate the source object](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop58-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md
index 3fdef811e9d5b..0b2204f50c05d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md
@@ -1,20 +1,19 @@
-.. title:: clang-tidy - bugprone-default-operator-new-on-overaligned-type
+```{title} clang-tidy - bugprone-default-operator-new-on-overaligned-type
+```
-bugprone-default-operator-new-on-overaligned-type
-=================================================
+# bugprone-default-operator-new-on-overaligned-type
-Flags uses of default ``operator new`` where the type has extended
+Flags uses of default `operator new` where the type has extended
alignment (an alignment greater than the fundamental alignment).
-The default ``operator new`` is guaranteed to provide the correct alignment
+The default `operator new` is guaranteed to provide the correct alignment
if the requested alignment is less or equal to the fundamental alignment.
-Only cases are detected (by design) where the ``operator new`` is not
+Only cases are detected (by design) where the `operator new` is not
user-defined and is not a placement new (the reason is that in these cases we
assume that the user provided the correct memory allocation).
-References
-----------
+## References
This check corresponds to the CERT C++ Coding Standard rule
-`MEM57-CPP. Avoid using default operator new for over-aligned types
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/>`_.
+[MEM57-CPP. Avoid using default operator new for over-aligned types](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md
index 93d403cd112d4..a430ec5d6b403 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md
@@ -1,14 +1,14 @@
-.. title:: clang-tidy - bugprone-dynamic-static-initializers
+```{title} clang-tidy - bugprone-dynamic-static-initializers
+```
-bugprone-dynamic-static-initializers
-====================================
+# bugprone-dynamic-static-initializers
Finds instances of static variables that are dynamically initialized
in header files.
This can pose problems in certain multithreaded contexts. For example,
when disabling compiler generated synchronization instructions for
-static variables initialized at runtime (e.g. by ``-fno-threadsafe-statics``),
+static variables initialized at runtime (e.g. by `-fno-threadsafe-statics`),
even if a particular project takes the necessary precautions to prevent race
conditions during initialization by providing their own synchronization, header
files included from other projects may not. Therefore, such a check is helpful
@@ -17,13 +17,14 @@ variable initialization will not cause problems.
Consider the following code:
-.. code-block:: c
-
- int foo() {
- static int k = bar();
- return k;
- }
+```c
+int foo() {
+ static int k = bar();
+ return k;
+}
+```
When synchronization of static initialization is disabled, if two threads both
call `foo` for the first time, there is the possibility that `k` will be double
initialized, creating a race condition.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/float-loop-counter.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/float-loop-counter.md
index 86d7d2ccebc9b..027d60cc3f7f0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/float-loop-counter.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/float-loop-counter.md
@@ -1,13 +1,12 @@
-.. title:: clang-tidy - bugprone-float-loop-counter
+```{title} clang-tidy - bugprone-float-loop-counter
+```
-bugprone-float-loop-counter
-===========================
+# bugprone-float-loop-counter
-Flags ``for`` loops where the induction expression has a floating-point type.
+Flags `for` loops where the induction expression has a floating-point type.
-References
-----------
+## References
This check corresponds to the CERT C Coding Standard rule
-`FLP30-C. Do not use floating-point variables as loop counters
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/floating-point-flp/flp30-c/>`_.
+[FLP30-C. Do not use floating-point variables as loop counters](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/floating-point-flp/flp30-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md
index 5e04f660330d9..23515489fcd12 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - bugprone-forward-declaration-namespace
+```{title} clang-tidy - bugprone-forward-declaration-namespace
+```
-bugprone-forward-declaration-namespace
-======================================
+# bugprone-forward-declaration-namespace
Checks if an unused forward declaration is in a wrong namespace.
@@ -9,13 +9,14 @@ The check inspects all unused forward declarations and checks if there is any
declaration/definition with the same name existing, which could indicate that
the forward declaration is in a potentially wrong namespace.
-.. code-block:: c++
-
- namespace na { struct A; }
- namespace nb { struct A {}; }
- nb::A a;
- // warning : no definition found for 'A', but a definition with the same name
- // 'A' found in another namespace 'nb::'
+```c++
+namespace na { struct A; }
+namespace nb { struct A {}; }
+nb::A a;
+// warning : no definition found for 'A', but a definition with the same name
+// 'A' found in another namespace 'nb::'
+```
This check can only generate warnings, but it can't suggest a fix at this
point.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md
index b2dcdd59a600c..38135ba58e3bb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md
@@ -1,29 +1,29 @@
-.. title:: clang-tidy - bugprone-inaccurate-erase
+```{title} clang-tidy - bugprone-inaccurate-erase
+```
-bugprone-inaccurate-erase
-=========================
+# bugprone-inaccurate-erase
+Checks for inaccurate use of the `erase()` method.
-Checks for inaccurate use of the ``erase()`` method.
-
-Algorithms like ``remove()`` do not actually remove any element from the
+Algorithms like `remove()` do not actually remove any element from the
container but return an iterator to the first redundant element at the end
of the container. These redundant elements must be removed using the
-``erase()`` method. This check warns when not all of the elements will be
+`erase()` method. This check warns when not all of the elements will be
removed due to using an inappropriate overload.
For example, the following code erases only one element:
-.. code-block:: c++
-
- std::vector<int> xs;
- ...
- xs.erase(std::remove(xs.begin(), xs.end(), 10));
+```c++
+std::vector<int> xs;
+...
+xs.erase(std::remove(xs.begin(), xs.end(), 10));
+```
-Call the two-argument overload of ``erase()`` to remove the subrange:
+Call the two-argument overload of `erase()` to remove the subrange:
-.. code-block:: c++
+```c++
+std::vector<int> xs;
+...
+xs.erase(std::remove(xs.begin(), xs.end(), 10), xs.end());
+```
- std::vector<int> xs;
- ...
- xs.erase(std::remove(xs.begin(), xs.end(), 10), xs.end());
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md
index 0a5047a9f0f51..6141f5a58bd61 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md
@@ -1,12 +1,14 @@
-.. title:: clang-tidy - bugprone-incorrect-roundings
+```{title} clang-tidy - bugprone-incorrect-roundings
+```
-bugprone-incorrect-roundings
-============================
+# bugprone-incorrect-roundings
Checks the usage of patterns known to produce incorrect rounding.
-Programmers often use::
+Programmers often use:
- (int)(double_expression + 0.5)
+```
+(int)(double_expression + 0.5)
+```
to round the double expression to an integer. The problem with this:
@@ -14,3 +16,4 @@ to round the double expression to an integer. The problem with this:
2. It is incorrect. The number 0.499999975 (smallest representable float
number below 0.5) rounds to 1.0. Even worse behavior for negative
numbers where both -0.5f and -1.4f both round to 0.0.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-parentheses.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-parentheses.md
index e70a3fd20865b..8a55119d50b50 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-parentheses.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-parentheses.md
@@ -1,8 +1,7 @@
-.. title:: clang-tidy - bugprone-macro-parentheses
-
-bugprone-macro-parentheses
-==========================
+```{title} clang-tidy - bugprone-macro-parentheses
+```
+# bugprone-macro-parentheses
Finds macros that can have unexpected behavior due to missing parentheses.
@@ -19,5 +18,5 @@ with parentheses. This ensures that the argument value is calculated
properly.
This check corresponds to the CERT C Coding Standard rule
-`PRE02-C. Macro replacement lists should be parenthesized.
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/recommendations/preprocessor-pre/pre02-c/>`_
+[PRE02-C. Macro replacement lists should be parenthesized.](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/recommendations/preprocessor-pre/pre02-c/)
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-repeated-side-effects.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-repeated-side-effects.md
index 15dfdcaf6c095..fab70443d3e59 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-repeated-side-effects.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/macro-repeated-side-effects.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - bugprone-macro-repeated-side-effects
-
-bugprone-macro-repeated-side-effects
-====================================
+```{title} clang-tidy - bugprone-macro-repeated-side-effects
+```
+# bugprone-macro-repeated-side-effects
Checks for repeated argument with side effects in macros.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/misplaced-pointer-arithmetic-in-alloc.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/misplaced-pointer-arithmetic-in-alloc.md
index 8e0191a57aaf1..c9c8b5085cad9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/misplaced-pointer-arithmetic-in-alloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/misplaced-pointer-arithmetic-in-alloc.md
@@ -1,25 +1,25 @@
-.. title:: clang-tidy - bugprone-misplaced-pointer-arithmetic-in-alloc
+```{title} clang-tidy - bugprone-misplaced-pointer-arithmetic-in-alloc
+```
-bugprone-misplaced-pointer-arithmetic-in-alloc
-===============================================
+# bugprone-misplaced-pointer-arithmetic-in-alloc
Finds cases where an integer expression is added to or subtracted from the
-result of a memory allocation function (``malloc()``, ``calloc()``,
-``realloc()``, ``alloca()``) instead of its argument. The check detects error
+result of a memory allocation function (`malloc()`, `calloc()`,
+`realloc()`, `alloca()`) instead of its argument. The check detects error
cases even if one of these functions is called by a constant function pointer.
Example code:
-.. code-block:: c
-
- void bad_malloc(int n) {
- char *p = (char*) malloc(n) + 10;
- }
-
+```c
+void bad_malloc(int n) {
+ char *p = (char*) malloc(n) + 10;
+}
+```
The suggested fix is to add the integer expression to the argument of
-``malloc`` and not to its result. In the example above the fix would be
+`malloc` and not to its result. In the example above the fix would be
-.. code-block:: c
+```c
+char *p = (char*) malloc(n + 10);
+```
- char *p = (char*) malloc(n + 10);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md
index 708dc9506f765..c2c66b53ac121 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - bugprone-multiple-statement-macro
+```{title} clang-tidy - bugprone-multiple-statement-macro
+```
-bugprone-multiple-statement-macro
-=================================
+# bugprone-multiple-statement-macro
Detect multiple statement macros that are used in unbraced conditionals. Only
the first statement of the macro will be inside the conditional and the other
@@ -9,8 +9,9 @@ ones will be executed unconditionally.
Example:
-.. code-block:: c++
+```c++
+#define INCREMENT_TWO(x, y) (x)++; (y)++
+if (do_increment)
+ INCREMENT_TWO(a, b); // (b)++ will be executed unconditionally.
+```
- #define INCREMENT_TWO(x, y) (x)++; (y)++
- if (do_increment)
- INCREMENT_TWO(a, b); // (b)++ will be executed unconditionally.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md
index 850b01c4d76f6..557fe208b7445 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md
@@ -1,19 +1,20 @@
-.. title:: clang-tidy - bugprone-no-escape
+```{title} clang-tidy - bugprone-no-escape
+```
-bugprone-no-escape
-==================
+# bugprone-no-escape
-Finds pointers with the ``noescape`` attribute that are captured by an
-asynchronously-executed block. The block arguments in ``dispatch_async()`` and
-``dispatch_after()`` are guaranteed to escape, so it is an error if a pointer
-with the ``noescape`` attribute is captured by one of these blocks.
+Finds pointers with the `noescape` attribute that are captured by an
+asynchronously-executed block. The block arguments in `dispatch_async()` and
+`dispatch_after()` are guaranteed to escape, so it is an error if a pointer
+with the `noescape` attribute is captured by one of these blocks.
-The following is an example of an invalid use of the ``noescape`` attribute.
+The following is an example of an invalid use of the `noescape` attribute.
- .. code-block:: objc
+> ```objc
+> void foo(__attribute__((noescape)) int *p) {
+> dispatch_async(queue, ^{
+> *p = 123;
+> });
+> });
+> ```
- void foo(__attribute__((noescape)) int *p) {
- dispatch_async(queue, ^{
- *p = 123;
- });
- });
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md
index c3521272035bc..77061ce992893 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md
@@ -1,23 +1,24 @@
-.. title:: clang-tidy - bugprone-parent-virtual-call
+```{title} clang-tidy - bugprone-parent-virtual-call
+```
-bugprone-parent-virtual-call
-============================
+# bugprone-parent-virtual-call
Detects and fixes calls to grand-...parent virtual methods instead of calls
to overridden parent's virtual methods.
-.. code-block:: c++
+```c++
+struct A {
+ int virtual foo() {...}
+};
- struct A {
- int virtual foo() {...}
- };
+struct B: public A {
+ int foo() override {...}
+};
- struct B: public A {
- int foo() override {...}
- };
+struct C: public B {
+ int foo() override { A::foo(); }
+// ^^^^^^^^
+// warning: qualified name A::foo refers to a member overridden in subclass; did you mean 'B'? [bugprone-parent-virtual-call]
+};
+```
- struct C: public B {
- int foo() override { A::foo(); }
- // ^^^^^^^^
- // warning: qualified name A::foo refers to a member overridden in subclass; did you mean 'B'? [bugprone-parent-virtual-call]
- };
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/posix-return.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/posix-return.md
index 1a4a3ed3b9a37..fdf32d49070c3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/posix-return.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/posix-return.md
@@ -1,21 +1,22 @@
-.. title:: clang-tidy - bugprone-posix-return
+```{title} clang-tidy - bugprone-posix-return
+```
-bugprone-posix-return
-=====================
+# bugprone-posix-return
-Checks if any calls to ``pthread_*`` or ``posix_*`` functions
-(except ``posix_openpt``) expect negative return values. These functions return
-either ``0`` on success or an ``errno`` on failure, which is positive only.
+Checks if any calls to `pthread_*` or `posix_*` functions
+(except `posix_openpt`) expect negative return values. These functions return
+either `0` on success or an `errno` on failure, which is positive only.
Example buggy usage looks like:
-.. code-block:: c
-
- if (posix_fadvise(...) < 0) {
+```c
+if (posix_fadvise(...) < 0) {
+```
This will never happen as the return value is always non-negative.
A simple fix could be:
-.. code-block:: c
+```c
+if (posix_fadvise(...) > 0) {
+```
- if (posix_fadvise(...) > 0) {
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md
index 0646a977867f8..612e1bcd0ea1a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - bugprone-signed-bitwise
+```{title} clang-tidy - bugprone-signed-bitwise
+```
-bugprone-signed-bitwise
-=======================
+# bugprone-signed-bitwise
Finds uses of bitwise operations on signed integer types, which may lead to
undefined or implementation defined behavior.
@@ -11,18 +11,20 @@ lead to undefined or implementation dependent behavior. In particular, right
shift a signed integer is implementation dependent, while left shift a signed
integer may result in undefined behavior.
-.. code-block:: c++
+```c++
+int main(){
+ int x = -4;
+ int y = x >> 1; // y can be -2 or 2147483646
+}
+```
- int main(){
- int x = -4;
- int y = x >> 1; // y can be -2 or 2147483646
- }
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnorePositiveIntegerLiterals
If this option is set to `true`, the check will not warn on bitwise
operations with positive integer literals, e.g. ``~0``, ``2 << 1``, etc.
Default value is `false`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md
index 5d70d45a91357..4d7075fb33b3f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md
@@ -1,26 +1,27 @@
-.. title:: clang-tidy - bugprone-sizeof-container
+```{title} clang-tidy - bugprone-sizeof-container
+```
-bugprone-sizeof-container
-=========================
+# bugprone-sizeof-container
-The check finds usages of ``sizeof`` on expressions of STL container types.
-Most likely the user wanted to use ``.size()`` instead.
+The check finds usages of `sizeof` on expressions of STL container types.
+Most likely the user wanted to use `.size()` instead.
-All class/struct types declared in namespace ``std::`` having a const
-``size()`` method are considered containers, with the exception of
-``std::bitset`` and ``std::array``.
+All class/struct types declared in namespace `std::` having a const
+`size()` method are considered containers, with the exception of
+`std::bitset` and `std::array`.
Examples:
-.. code-block:: c++
+```c++
+std::string s;
+int a = 47 + sizeof(s); // warning: sizeof() doesn't return the size of the container. Did you mean .size()?
- std::string s;
- int a = 47 + sizeof(s); // warning: sizeof() doesn't return the size of the container. Did you mean .size()?
+int b = sizeof(std::string); // no warning, probably intended.
- int b = sizeof(std::string); // no warning, probably intended.
+std::string array_of_strings[10];
+int c = sizeof(array_of_strings) / sizeof(array_of_strings[0]); // no warning, definitely intended.
- std::string array_of_strings[10];
- int c = sizeof(array_of_strings) / sizeof(array_of_strings[0]); // no warning, definitely intended.
+std::array<int, 3> std_array;
+int d = sizeof(std_array); // no warning, probably intended.
+```
- std::array<int, 3> std_array;
- int d = sizeof(std_array); // no warning, probably intended.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md
index 961d468d89c22..de3b8bf2ff567 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md
@@ -1,29 +1,28 @@
-.. title:: clang-tidy - bugprone-spuriously-wake-up-functions
+```{title} clang-tidy - bugprone-spuriously-wake-up-functions
+```
-bugprone-spuriously-wake-up-functions
-=====================================
+# bugprone-spuriously-wake-up-functions
-Finds ``cnd_wait``, ``cnd_timedwait``, ``wait``, ``wait_for``, or
-``wait_until`` function calls when the function is not invoked from a loop
+Finds `cnd_wait`, `cnd_timedwait`, `wait`, `wait_for`, or
+`wait_until` function calls when the function is not invoked from a loop
that checks whether a condition predicate holds or the function has a
condition parameter.
-.. code-block:: c++
+```c++
+if (condition_predicate) {
+ condition.wait(lk);
+}
+```
- if (condition_predicate) {
- condition.wait(lk);
- }
-
-.. code-block:: c
-
- if (condition_predicate) {
- if (thrd_success != cnd_wait(&condition, &lock)) {
- }
+```c
+if (condition_predicate) {
+ if (thrd_success != cnd_wait(&condition, &lock)) {
}
+}
+```
This check corresponds to the CERT C++ Coding Standard rule
-`CON54-CPP. Wrap functions that can spuriously wake up in a loop
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/concurrency-con/con54-cpp/>`_.
+[CON54-CPP. Wrap functions that can spuriously wake up in a loop](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/concurrency-con/con54-cpp/).
and CERT C Coding Standard rule
-`CON36-C. Wrap functions that can spuriously wake up in a loop
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/concurrency-con/con36-c/>`_.
+[CON36-C. Wrap functions that can spuriously wake up in a loop](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/concurrency-con/con36-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md
index 4fbfa259f3d09..a0093f36c81ef 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md
@@ -1,24 +1,26 @@
-.. title:: clang-tidy - bugprone-suspicious-include
+```{title} clang-tidy - bugprone-suspicious-include
+```
-bugprone-suspicious-include
-===========================
+# bugprone-suspicious-include
The check detects various cases when an include refers to what appears to be an
implementation file, which often leads to hard-to-track-down ODR violations.
Examples:
-.. code-block:: c++
+```c++
+#include "Dinosaur.hpp" // OK, .hpp files tend not to have definitions.
+#include "Pterodactyl.h" // OK, .h files tend not to have definitions.
+#include "Velociraptor.cpp" // Warning, filename is suspicious.
+#include_next <stdio.c> // Warning, filename is suspicious.
+```
- #include "Dinosaur.hpp" // OK, .hpp files tend not to have definitions.
- #include "Pterodactyl.h" // OK, .h files tend not to have definitions.
- #include "Velociraptor.cpp" // Warning, filename is suspicious.
- #include_next <stdio.c> // Warning, filename is suspicious.
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoredRegex
A regular expression for the file name to be ignored by the check. Default
is empty string.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md
index 222de90037336..2bff03b12a8ae 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md
@@ -1,17 +1,18 @@
-.. title:: clang-tidy - bugprone-terminating-continue
+```{title} clang-tidy - bugprone-terminating-continue
+```
-bugprone-terminating-continue
-=============================
+# bugprone-terminating-continue
-Detects ``do while`` loops with a condition always evaluating to false that
-have a ``continue`` statement, as this ``continue`` terminates the loop
+Detects `do while` loops with a condition always evaluating to false that
+have a `continue` statement, as this `continue` terminates the loop
effectively.
-.. code-block:: c++
+```c++
+void f() {
+do {
+ // some code
+ continue; // terminating continue
+ // some other code
+} while(false);
+```
- void f() {
- do {
- // some code
- continue; // terminating continue
- // some other code
- } while(false);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md
index be80fc8a84832..3ff01a88dcbc5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md
@@ -1,22 +1,21 @@
-.. title:: clang-tidy - bugprone-throw-keyword-missing
+```{title} clang-tidy - bugprone-throw-keyword-missing
+```
-bugprone-throw-keyword-missing
-==============================
+# bugprone-throw-keyword-missing
-Warns about a potentially missing ``throw`` keyword. If a temporary object
+Warns about a potentially missing `throw` keyword. If a temporary object
is created, but the object's type derives from (or is the same as) a class
that has 'EXCEPTION', 'Exception' or 'exception' in its name, we can assume
that the programmer's intention was to throw that object.
Example:
-.. code-block:: c++
-
- void f(int i) {
- if (i < 0) {
- // Exception is created but is not thrown.
- std::runtime_error("Unexpected argument");
- }
+```c++
+void f(int i) {
+ if (i < 0) {
+ // Exception is created but is not thrown.
+ std::runtime_error("Unexpected argument");
}
-
+}
+```
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md
index 23ffc29b4dc4f..8015cddcbc1f8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md
@@ -1,14 +1,14 @@
-.. title:: clang-tidy - bugprone-throwing-static-initialization
+```{title} clang-tidy - bugprone-throwing-static-initialization
+```
-bugprone-throwing-static-initialization
-=======================================
+# bugprone-throwing-static-initialization
-Finds all ``static`` or ``thread_local`` variable declarations where the
+Finds all `static` or `thread_local` variable declarations where the
initializer for the object may throw an exception.
-Options
--------
+## Options
+```{eval-rst}
.. option:: AllowedTypes
A semicolon-separated list of names of types that will be excluded from
@@ -18,10 +18,10 @@ Options
list contains the sequence `::`, it is matched against the qualified type
name (i.e. ``namespace::Type``), otherwise it is matched against only the
type name (i.e. ``Type``). Default is an empty string.
+```
-References
-----------
+## References
This check corresponds to the CERT C++ Coding Standard rule
-`ERR58-CPP. Handle all exceptions thrown before main() begins executing
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err58-cpp/>`_.
+[ERR58-CPP. Handle all exceptions thrown before main() begins executing](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err58-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/undelegated-constructor.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/undelegated-constructor.md
index b32ed386f69cb..58bccfe704f38 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/undelegated-constructor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/undelegated-constructor.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - bugprone-undelegated-constructor
+```{title} clang-tidy - bugprone-undelegated-constructor
+```
-bugprone-undelegated-constructor
-================================
+# bugprone-undelegated-constructor
Finds creation of temporary objects in constructors that look like a
function call to another constructor of the same class.
The user most likely meant to use a delegating constructor or base class
initializer.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md
index d42268455b0c2..c6c3ca30d993a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - bugprone-virtual-near-miss
+```{title} clang-tidy - bugprone-virtual-near-miss
+```
-bugprone-virtual-near-miss
-==========================
+# bugprone-virtual-near-miss
Warn if a function is a near miss (i.e. the name is very similar and
the function signature is the same) to a virtual function from a base
@@ -9,13 +9,14 @@ class.
Example:
-.. code-block:: c++
+```c++
+struct Base {
+ virtual void func();
+};
- struct Base {
- virtual void func();
- };
+struct Derived : Base {
+ virtual void funk();
+ // warning: 'Derived::funk' has a similar name and the same signature as virtual method 'Base::func'; did you mean to override it?
+};
+```
- struct Derived : Base {
- virtual void funk();
- // warning: 'Derived::funk' has a similar name and the same signature as virtual method 'Base::func'; did you mean to override it?
- };
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/arr39-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/arr39-c.md
index c41b2632d9d0f..f6476a056e6d5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/arr39-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/arr39-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-arr39-c
+```{title} clang-tidy - cert-arr39-c
+```
-cert-arr39-c
-============
+# cert-arr39-c
The `cert-arr39-c` check is an alias, please see
-:doc:`bugprone-sizeof-expression <../bugprone/sizeof-expression>`
+{doc}`bugprone-sizeof-expression <../bugprone/sizeof-expression>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md
index e3b2794510b5f..1bc5bee151cf2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-con36-c
+```{title} clang-tidy - cert-con36-c
+```
-cert-con36-c
-============
+# cert-con36-c
The `cert-con36-c` check is an alias, please see
-:doc:`bugprone-spuriously-wake-up-functions
+{doc}`bugprone-spuriously-wake-up-functions
<../bugprone/spuriously-wake-up-functions>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md
index c8fb7ad31e31e..c25173ec3d55e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-con54-cpp
+```{title} clang-tidy - cert-con54-cpp
+```
-cert-con54-cpp
-==============
+# cert-con54-cpp
The `cert-con54-cpp` check is an alias, please see
-:doc:`bugprone-spuriously-wake-up-functions
+{doc}`bugprone-spuriously-wake-up-functions
<../bugprone/spuriously-wake-up-functions>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md
index e65eeb3d2b4c9..d7ba4cb7e65c1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-ctr56-cpp
+```{title} clang-tidy - cert-ctr56-cpp
+```
-cert-ctr56-cpp
-==============
+# cert-ctr56-cpp
The `cert-ctr56-cpp` check is an alias, please see
-:doc:`bugprone-pointer-arithmetic-on-polymorphic-object
+{doc}`bugprone-pointer-arithmetic-on-polymorphic-object
<../bugprone/pointer-arithmetic-on-polymorphic-object>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md
index c2bf0983566b5..7506be25c88cf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md
@@ -1,7 +1,8 @@
-.. title:: clang-tidy - cert-dcl03-c
+```{title} clang-tidy - cert-dcl03-c
+```
-cert-dcl03-c
-============
+# cert-dcl03-c
The `cert-dcl03-c` check is an alias, please see
-:doc:`misc-static-assert <../misc/static-assert>` for more information.
+{doc}`misc-static-assert <../misc/static-assert>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md
index 387e6d45853cc..355338dce681e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-dcl16-c
+```{title} clang-tidy - cert-dcl16-c
+```
-cert-dcl16-c
-============
+# cert-dcl16-c
The `cert-dcl16-c` check is an alias, please see
-:doc:`readability-uppercase-literal-suffix
+{doc}`readability-uppercase-literal-suffix
<../readability/uppercase-literal-suffix>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl37-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl37-c.md
index f29eaa2bc3a55..6a2edba4334d9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl37-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl37-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-dcl37-c
+```{title} clang-tidy - cert-dcl37-c
+```
-cert-dcl37-c
-============
+# cert-dcl37-c
The `cert-dcl37-c` check is an alias, please see
-:doc:`bugprone-reserved-identifier <../bugprone/reserved-identifier>` for more
+{doc}`bugprone-reserved-identifier <../bugprone/reserved-identifier>` for more
information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md
index 12def084cfecb..d8885ac12a04e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cert-dcl50-cpp
+```{title} clang-tidy - cert-dcl50-cpp
+```
-cert-dcl50-cpp
-==============
+# cert-dcl50-cpp
The `cert-dcl50-cpp` check is an alias, please see
-:doc:`modernize-avoid-variadic-functions
+{doc}`modernize-avoid-variadic-functions
<../modernize/avoid-variadic-functions>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`DCL50-CPP. Do not define a C-style variadic function
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl50-cpp/>`_.
+[DCL50-CPP. Do not define a C-style variadic function](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl50-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md
index 5bad65cda5298..09c3bc60a653a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-dcl51-cpp
+```{title} clang-tidy - cert-dcl51-cpp
+```
-cert-dcl51-cpp
-==============
+# cert-dcl51-cpp
The `cert-dcl51-cpp` check is an alias, please see
-:doc:`bugprone-reserved-identifier <../bugprone/reserved-identifier>` for more
+{doc}`bugprone-reserved-identifier <../bugprone/reserved-identifier>` for more
information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md
index 062dcfc364197..0d8decf05c10c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-dcl54-cpp
+```{title} clang-tidy - cert-dcl54-cpp
+```
-cert-dcl54-cpp
-==============
+# cert-dcl54-cpp
The `cert-dcl54-cpp` check is an alias, please see
-:doc:`misc-new-delete-overloads <../misc/new-delete-overloads>` for more
+{doc}`misc-new-delete-overloads <../misc/new-delete-overloads>` for more
information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md
index e89f4ea21b007..373c4d6dd8519 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cert-dcl58-cpp
+```{title} clang-tidy - cert-dcl58-cpp
+```
-cert-dcl58-cpp
-==============
+# cert-dcl58-cpp
The `cert-dcl58-cpp` is an alias, please see
-:doc:`bugprone-std-namespace-modification
+{doc}`bugprone-std-namespace-modification
<../bugprone/std-namespace-modification>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`DCL58-CPP. Do not modify the standard namespaces
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl58-cpp/>`_.
+[DCL58-CPP. Do not modify the standard namespaces](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl58-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md
index 58bc54664d565..ec77f5763ca73 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-dcl59-cpp
+```{title} clang-tidy - cert-dcl59-cpp
+```
-cert-dcl59-cpp
-==============
+# cert-dcl59-cpp
The `cert-dcl59-cpp` check is an alias, please see
-:doc:`misc-anonymous-namespace-in-header
+{doc}`misc-anonymous-namespace-in-header
<../misc/anonymous-namespace-in-header>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/env33-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/env33-c.md
index c07b5761b570b..3d3755fb93dfa 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/env33-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/env33-c.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - cert-env33-c
+```{title} clang-tidy - cert-env33-c
+```
-cert-env33-c
-============
+# cert-env33-c
The `cert-env33-c` check is an alias, please see
-:doc:`bugprone-command-processor <../bugprone/command-processor>`
+{doc}`bugprone-command-processor <../bugprone/command-processor>`
for more information.
This check corresponds to the CERT C Coding Standard rule
-`ENV33-C. Do not call system()
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/environment-env/env33-c/>`_.
+[ENV33-C. Do not call system()](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/environment-env/env33-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md
index 299609d257261..9543349d4103d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md
@@ -1,10 +1,10 @@
-.. title:: clang-tidy - cert-err09-cpp
+```{title} clang-tidy - cert-err09-cpp
+```
-cert-err09-cpp
-==============
+# cert-err09-cpp
The `cert-err09-cpp` check is an alias, please see
-:doc:`misc-throw-by-value-catch-by-reference
+{doc}`misc-throw-by-value-catch-by-reference
<../misc/throw-by-value-catch-by-reference>`
for more information.
@@ -13,3 +13,4 @@ ERR09-CPP. Throw anonymous temporaries. However, all of the CERT
recommendations have been removed from public view, and so their
justification for the behavior of this check requires an account on
their wiki to view.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md
index d5a63ec5f3acf..1b2caa78efd3d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-err34-c
+```{title} clang-tidy - cert-err34-c
+```
-cert-err34-c
-============
+# cert-err34-c
The cert-err34-c check is an alias, please see
-:doc:`bugprone-unchecked-string-to-number-conversion
+{doc}`bugprone-unchecked-string-to-number-conversion
<../bugprone/unchecked-string-to-number-conversion>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err52-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err52-cpp.md
index eeb05b42c3f38..ffa7962fbaf03 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err52-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err52-cpp.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - cert-err52-cpp
+```{title} clang-tidy - cert-err52-cpp
+```
-cert-err52-cpp
-==============
+# cert-err52-cpp
The `cert-err52-cpp` check is an alias, please see
-:doc:`modernize-avoid-setjmp-longjmp <../modernize/avoid-setjmp-longjmp>`
+{doc}`modernize-avoid-setjmp-longjmp <../modernize/avoid-setjmp-longjmp>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`ERR52-CPP. Do not use setjmp() or longjmp()
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err52-cpp/>`_.
+[ERR52-CPP. Do not use setjmp() or longjmp()](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err52-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md
index befc156ba9a33..2a9c9007cec98 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cert-err58-cpp
+```{title} clang-tidy - cert-err58-cpp
+```
-cert-err58-cpp
-==============
+# cert-err58-cpp
The `cert-err58-cpp` check is an alias, please see
-:doc:`bugprone-throwing-static-initialization
+{doc}`bugprone-throwing-static-initialization
<../bugprone/throwing-static-initialization>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`ERR58-CPP. Handle all exceptions thrown before main() begins executing
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err58-cpp/>`_.
+[ERR58-CPP. Handle all exceptions thrown before main() begins executing](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err58-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md
index 2d96d3b43758a..b792e70dd4571 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cert-err60-cpp
+```{title} clang-tidy - cert-err60-cpp
+```
-cert-err60-cpp
-==============
+# cert-err60-cpp
The `cert-err60-cpp` check is an alias, please see
-:doc:`bugprone-exception-copy-constructor-throws
+{doc}`bugprone-exception-copy-constructor-throws
<../bugprone/exception-copy-constructor-throws>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`ERR60-CPP. Exception objects must be nothrow copy constructible
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err60-cpp/>`_.
+[ERR60-CPP. Exception objects must be nothrow copy constructible](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err60-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md
index 4f070647d23f0..1b0c11011850f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-err61-cpp
+```{title} clang-tidy - cert-err61-cpp
+```
-cert-err61-cpp
-==============
+# cert-err61-cpp
The `cert-err61-cpp` check is an alias, please see
-:doc:`misc-throw-by-value-catch-by-reference
+{doc}`misc-throw-by-value-catch-by-reference
<../misc/throw-by-value-catch-by-reference>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md
index 9d7cbbbf5e3e2..0ca23a6e8dbb4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-exp42-c
+```{title} clang-tidy - cert-exp42-c
+```
-cert-exp42-c
-============
+# cert-exp42-c
The `cert-exp42-c` check is an alias, please see
-:doc:`bugprone-suspicious-memory-comparison
+{doc}`bugprone-suspicious-memory-comparison
<../bugprone/suspicious-memory-comparison>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md
index 72e01b3c7777f..1298cb4ebfc75 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-exp45-c
+```{title} clang-tidy - cert-exp45-c
+```
-cert-exp45-c
-============
+# cert-exp45-c
The `cert-exp45-c` check is an alias, please see
-:doc:`bugprone-assignment-in-selection-statement
+{doc}`bugprone-assignment-in-selection-statement
<../bugprone/assignment-in-selection-statement>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md
index fd2f409e7928d..c824a12c25617 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md
@@ -1,11 +1,11 @@
-.. title:: clang-tidy - cert-fio38-c
+```{title} clang-tidy - cert-fio38-c
+```
-cert-fio38-c
-============
+# cert-fio38-c
The `cert-fio38-c` check is an alias, please see
-:doc:`misc-non-copyable-objects <../misc/non-copyable-objects>` for more
+{doc}`misc-non-copyable-objects <../misc/non-copyable-objects>` for more
information.
-This check corresponds to CERT C++ Coding Standard rule `FIO38-C. Do not copy a FILE object
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/input-output-fio/fio38-c/>`_.
+This check corresponds to CERT C++ Coding Standard rule [FIO38-C. Do not copy a FILE object](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/input-output-fio/fio38-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/flp30-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/flp30-c.md
index 36ad4eee53230..117971fb2fac7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/flp30-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/flp30-c.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - cert-flp30-c
+```{title} clang-tidy - cert-flp30-c
+```
-cert-flp30-c
-============
+# cert-flp30-c
The `cert-flp30-c` check is an alias, please see
-:doc:`bugprone-float-loop-counter <../bugprone/float-loop-counter>`
+{doc}`bugprone-float-loop-counter <../bugprone/float-loop-counter>`
for more information
This check corresponds to the CERT C Coding Standard rule
-`FLP30-C. Do not use floating-point variables as loop counters
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/floating-point-flp/flp30-c/>`_.
+[FLP30-C. Do not use floating-point variables as loop counters](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/floating-point-flp/flp30-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md
index f41d97bf464fc..97c744286eded 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-flp37-c
+```{title} clang-tidy - cert-flp37-c
+```
-cert-flp37-c
-============
+# cert-flp37-c
The `cert-flp37-c` check is an alias, please see
-:doc:`bugprone-suspicious-memory-comparison
+{doc}`bugprone-suspicious-memory-comparison
<../bugprone/suspicious-memory-comparison>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md
index 77cbae5664e36..9cca7d8c82940 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-int09-c
+```{title} clang-tidy - cert-int09-c
+```
-cert-int09-c
-============
+# cert-int09-c
The `cert-int09-c` check is an alias, please see
-:doc:`readability-enum-initial-value <../readability/enum-initial-value>` for
+{doc}`readability-enum-initial-value <../readability/enum-initial-value>` for
more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md
index 8cd27a724ad58..82e9bff105733 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cert-mem57-cpp
+```{title} clang-tidy - cert-mem57-cpp
+```
-cert-mem57-cpp
-==============
+# cert-mem57-cpp
The `cert-mem57-cpp` is an alias, please see
-:doc:`bugprone-default-operator-new-on-overaligned-type
+{doc}`bugprone-default-operator-new-on-overaligned-type
<../bugprone/default-operator-new-on-overaligned-type>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`MEM57-CPP. Avoid using default operator new for over-aligned types
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/>`_.
+[MEM57-CPP. Avoid using default operator new for over-aligned types](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md
index 0287dd5f193b5..01fab7b6843d0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-msc24-c
+```{title} clang-tidy - cert-msc24-c
+```
-cert-msc24-c
-============
+# cert-msc24-c
The `cert-msc24-c` check is an alias, please see
-:doc:`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more
+{doc}`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more
information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc30-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc30-c.md
index f5045c3539a28..142396b26fde6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc30-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc30-c.md
@@ -1,11 +1,11 @@
-.. title:: clang-tidy - cert-msc30-c
+```{title} clang-tidy - cert-msc30-c
+```
-cert-msc30-c
-============
+# cert-msc30-c
The `cert-msc30-c` check is an alias, please see
-:doc:`misc-predictable-rand <../misc/predictable-rand>` for more information.
+{doc}`misc-predictable-rand <../misc/predictable-rand>` for more information.
This check corresponds to the CERT C Coding Standard rule
-`MSC30-C. Do not use the rand() function for generating pseudorandom numbers
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/miscellaneous-msc/msc30-c/>`_.
+[MSC30-C. Do not use the rand() function for generating pseudorandom numbers](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/miscellaneous-msc/msc30-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc32-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc32-c.md
index 5239a7940c54f..f7319f501c9ce 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc32-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc32-c.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - cert-msc32-c
+```{title} clang-tidy - cert-msc32-c
+```
-cert-msc32-c
-============
+# cert-msc32-c
The `cert-msc32-c` check is an alias, please see
-:doc:`bugprone-random-generator-seed <../bugprone/random-generator-seed>`
+{doc}`bugprone-random-generator-seed <../bugprone/random-generator-seed>`
for more information.
This check corresponds to the CERT C Coding Standard rule
-`MSC32-C. Properly seed pseudorandom number generators
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/miscellaneous-msc/msc32-c/>`_.
+[MSC32-C. Properly seed pseudorandom number generators](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/miscellaneous-msc/msc32-c/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md
index a0bd0f3d05e77..1824a44b3265e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-msc33-c
+```{title} clang-tidy - cert-msc33-c
+```
-cert-msc33-c
-============
+# cert-msc33-c
The `cert-msc33-c` check is an alias, please see
-:doc:`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more
+{doc}`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more
information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc50-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc50-cpp.md
index 639f2d72908e5..0d49b17b6ab44 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc50-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc50-cpp.md
@@ -1,11 +1,11 @@
-.. title:: clang-tidy - cert-msc50-cpp
+```{title} clang-tidy - cert-msc50-cpp
+```
-cert-msc50-cpp
-==============
+# cert-msc50-cpp
The `cert-msc50-cpp` check is an alias, please see
-:doc:`misc-predictable-rand <../misc/predictable-rand>` for more information.
+{doc}`misc-predictable-rand <../misc/predictable-rand>` for more information.
This check corresponds to the CERT C Coding Standard rule
-`MSC50-CPP. Do not use std::rand() for generating pseudorandom numbers
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc50-cpp>`_.
+[MSC50-CPP. Do not use std::rand() for generating pseudorandom numbers](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc50-cpp).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md
index 57cb0646c5e22..ad708754b242a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cert-msc51-cpp
+```{title} clang-tidy - cert-msc51-cpp
+```
-cert-msc51-cpp
-==============
+# cert-msc51-cpp
The `cert-msc51-cpp` check is an alias, please see
-:doc:`bugprone-random-generator-seed
+{doc}`bugprone-random-generator-seed
<../bugprone/random-generator-seed>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`MSC51-CPP. Ensure your random number generator is properly seeded
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc51-cpp/>`_.
+[MSC51-CPP. Ensure your random number generator is properly seeded](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc51-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc54-cpp.md
index a50a83a76d1ba..404ca51635ea4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc54-cpp.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-msc54-cpp
+```{title} clang-tidy - cert-msc54-cpp
+```
-cert-msc54-cpp
-==============
+# cert-msc54-cpp
The `cert-msc54-cpp` check is an alias, please see
-:doc:`bugprone-signal-handler <../bugprone/signal-handler>`
+{doc}`bugprone-signal-handler <../bugprone/signal-handler>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md
index b79aa8707156e..6c320a7d7f787 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md
@@ -1,10 +1,10 @@
-.. title:: clang-tidy - cert-oop11-cpp
+```{title} clang-tidy - cert-oop11-cpp
+```
-cert-oop11-cpp
-==============
+# cert-oop11-cpp
The `cert-oop11-cpp check` is an alias, please see
-:doc:`performance-move-constructor-init <../performance/move-constructor-init>`
+{doc}`performance-move-constructor-init <../performance/move-constructor-init>`
for more information.
This check corresponds to the CERT C++ Coding Standard recommendation
@@ -12,3 +12,4 @@ OOP11-CPP. Do not copy-initialize members or base classes from a move
constructor. However, all of the CERT recommendations have been removed from
public view, and so their justification for the behavior of this check requires
an account on their wiki to view.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md
index e45427d1d4da3..49e464e9a3424 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-oop54-cpp
+```{title} clang-tidy - cert-oop54-cpp
+```
-cert-oop54-cpp
-==============
+# cert-oop54-cpp
The `cert-oop54-cpp` check is an alias, please see
-:doc:`bugprone-unhandled-self-assignment
+{doc}`bugprone-unhandled-self-assignment
<../bugprone/unhandled-self-assignment>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md
index dc599c3254441..713bc9d498ef3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md
@@ -1,14 +1,14 @@
-.. title:: clang-tidy - cert-oop57-cpp
+```{title} clang-tidy - cert-oop57-cpp
+```
-cert-oop57-cpp
-==============
+# cert-oop57-cpp
The `cert-oop57-cpp` check is an alias, please see
-:doc:`bugprone-raw-memory-call-on-non-trivial-type
+{doc}`bugprone-raw-memory-call-on-non-trivial-type
<../bugprone/raw-memory-call-on-non-trivial-type>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
-`OOP57-CPP. Prefer special member functions and overloaded operators to C
-Standard Library functions
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop57-cpp/>`_.
+[OOP57-CPP. Prefer special member functions and overloaded operators to C
+Standard Library functions](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop57-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md
index 90bca50798e9d..b9a6d58a09077 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - cert-oop58-cpp
+```{title} clang-tidy - cert-oop58-cpp
+```
-cert-oop58-cpp
-==============
+# cert-oop58-cpp
The `cert-oop58-cpp` check is an alias, please see
-:doc:`bugprone-copy-constructor-mutates-argument
+{doc}`bugprone-copy-constructor-mutates-argument
<../bugprone/copy-constructor-mutates-argument>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md
index 7b893f4fd60f6..69ecbf5646310 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-pos44-c
+```{title} clang-tidy - cert-pos44-c
+```
-cert-pos44-c
-============
+# cert-pos44-c
The `cert-pos44-c` check is an alias, please see
-:doc:`bugprone-bad-signal-to-kill-thread
+{doc}`bugprone-bad-signal-to-kill-thread
<../bugprone/bad-signal-to-kill-thread>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md
index 11e868fbb7a54..3a48ce8413a90 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-pos47-c
+```{title} clang-tidy - cert-pos47-c
+```
-cert-pos47-c
-============
+# cert-pos47-c
The `cert-pos47-c` check is an alias, please see
-:doc:`concurrency-thread-canceltype-asynchronous
+{doc}`concurrency-thread-canceltype-asynchronous
<../concurrency/thread-canceltype-asynchronous>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md
index 72609a35b4d83..ae2fd5f15c2e7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-sig30-c
+```{title} clang-tidy - cert-sig30-c
+```
-cert-sig30-c
-============
+# cert-sig30-c
The `cert-sig30-c` check is an alias, please see
-:doc:`bugprone-signal-handler <../bugprone/signal-handler>`
+{doc}`bugprone-signal-handler <../bugprone/signal-handler>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/str34-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/str34-c.md
index 245b3b4f613c7..3329f0ae68eb5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/str34-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/str34-c.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cert-str34-c
+```{title} clang-tidy - cert-str34-c
+```
-cert-str34-c
-============
+# cert-str34-c
The `cert-str34-c` check is an alias, please see
-:doc:`bugprone-signed-char-misuse <../bugprone/signed-char-misuse>`
+{doc}`bugprone-signed-char-misuse <../bugprone/signed-char-misuse>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md
index d8d6314d43922..6dffeb511fc97 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.BitwiseShift
+```{title} clang-tidy - clang-analyzer-core.BitwiseShift
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-bitwiseshift
+```
-clang-analyzer-core.BitwiseShift
-================================
+# clang-analyzer-core.BitwiseShift
Finds cases where bitwise shift operation causes undefined behaviour.
The `clang-analyzer-core.BitwiseShift` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-bitwiseshift>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-bitwiseshift)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md
index df0dccced7c81..3fa4a206caf64 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-core.CallAndMessage
+```{title} clang-tidy - clang-analyzer-core.CallAndMessage
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-callandmessage
+```
-clang-analyzer-core.CallAndMessage
-==================================
+# clang-analyzer-core.CallAndMessage
Check for logical errors for function calls and Objective-C message expressions
(e.g., uninitialized arguments, null function pointers).
The `clang-analyzer-core.CallAndMessage` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-callandmessage>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-callandmessage)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md
index b88a761850f65..36a9bd800a1d0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.DivideZero
+```{title} clang-tidy - clang-analyzer-core.DivideZero
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-dividezero
+```
-clang-analyzer-core.DivideZero
-==============================
+# clang-analyzer-core.DivideZero
Check for division by zero.
The `clang-analyzer-core.DivideZero` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-dividezero>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-dividezero)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md
index 439cb98978847..57f556141f520 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-core.NonNullParamChecker
+```{title} clang-tidy - clang-analyzer-core.NonNullParamChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-nonnullparamchecker
+```
-clang-analyzer-core.NonNullParamChecker
-=======================================
+# clang-analyzer-core.NonNullParamChecker
Check for null pointers passed as arguments to a function whose arguments are
references or marked with the 'nonnull' attribute.
The `clang-analyzer-core.NonNullParamChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-nonnullparamchecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-nonnullparamchecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md
index 6bb4c1b79cefe..03aa80b8d3fac 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.NullDereference
+```{title} clang-tidy - clang-analyzer-core.NullDereference
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-nulldereference
+```
-clang-analyzer-core.NullDereference
-===================================
+# clang-analyzer-core.NullDereference
Check for dereferences of null pointers.
The `clang-analyzer-core.NullDereference` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-nulldereference>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-nulldereference)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md
index c4769e16ffbfa..b958e393f28d7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.StackAddressEscape
+```{title} clang-tidy - clang-analyzer-core.StackAddressEscape
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-stackaddressescape
+```
-clang-analyzer-core.StackAddressEscape
-======================================
+# clang-analyzer-core.StackAddressEscape
Check that addresses to stack memory do not escape the function.
The `clang-analyzer-core.StackAddressEscape` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-stackaddressescape>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-stackaddressescape)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md
index 5242232415245..a609f7f2bb0da 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.UndefinedBinaryOperatorResult
+```{title} clang-tidy - clang-analyzer-core.UndefinedBinaryOperatorResult
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-undefinedbinaryoperatorresult
+```
-clang-analyzer-core.UndefinedBinaryOperatorResult
-=================================================
+# clang-analyzer-core.UndefinedBinaryOperatorResult
Check for undefined results of binary operators.
The `clang-analyzer-core.UndefinedBinaryOperatorResult` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-undefinedbinaryoperatorresult>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-undefinedbinaryoperatorresult)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md
index f9af836cf6607..da1964436a346 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.VLASize
+```{title} clang-tidy - clang-analyzer-core.VLASize
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-vlasize
+```
-clang-analyzer-core.VLASize
-===========================
+# clang-analyzer-core.VLASize
Check for declarations of VLA of undefined or zero size.
The `clang-analyzer-core.VLASize` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-vlasize>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-vlasize)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md
index 7f0c6b18147f6..a448ef18bde32 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.uninitialized.ArraySubscript
+```{title} clang-tidy - clang-analyzer-core.uninitialized.ArraySubscript
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-arraysubscript
+```
-clang-analyzer-core.uninitialized.ArraySubscript
-================================================
+# clang-analyzer-core.uninitialized.ArraySubscript
Check for uninitialized values used as array subscripts.
The `clang-analyzer-core.uninitialized.ArraySubscript` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-arraysubscript>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-arraysubscript)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md
index 79618e59e8f09..705a64ea36ad6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.uninitialized.Assign
+```{title} clang-tidy - clang-analyzer-core.uninitialized.Assign
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-assign
+```
-clang-analyzer-core.uninitialized.Assign
-========================================
+# clang-analyzer-core.uninitialized.Assign
Check for assigning uninitialized values.
The `clang-analyzer-core.uninitialized.Assign` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-assign>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-assign)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md
index fe5763823d52e..54738668691ad 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.uninitialized.Branch
+```{title} clang-tidy - clang-analyzer-core.uninitialized.Branch
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-branch
+```
-clang-analyzer-core.uninitialized.Branch
-========================================
+# clang-analyzer-core.uninitialized.Branch
Check for uninitialized values used as branch conditions.
The `clang-analyzer-core.uninitialized.Branch` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-branch>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-branch)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md
index b052c9de4302b..9e0695775e794 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.uninitialized.CapturedBlockVariable
+```{title} clang-tidy - clang-analyzer-core.uninitialized.CapturedBlockVariable
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-capturedblockvariable
+```
-clang-analyzer-core.uninitialized.CapturedBlockVariable
-=======================================================
+# clang-analyzer-core.uninitialized.CapturedBlockVariable
Check for blocks that capture uninitialized values.
The `clang-analyzer-core.uninitialized.CapturedBlockVariable` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-capturedblockvariable>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-capturedblockvariable)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md
index 03aeb3e185407..526200dba4633 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.uninitialized.NewArraySize
+```{title} clang-tidy - clang-analyzer-core.uninitialized.NewArraySize
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-newarraysize
+```
-clang-analyzer-core.uninitialized.NewArraySize
-==============================================
+# clang-analyzer-core.uninitialized.NewArraySize
Check if the size of the array in a new[] expression is undefined.
The `clang-analyzer-core.uninitialized.NewArraySize` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-newarraysize>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-newarraysize)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md
index 25d52fc8baca7..20cd7e0f4957b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-core.uninitialized.UndefReturn
+```{title} clang-tidy - clang-analyzer-core.uninitialized.UndefReturn
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-undefreturn
+```
-clang-analyzer-core.uninitialized.UndefReturn
-=============================================
+# clang-analyzer-core.uninitialized.UndefReturn
Check for uninitialized values being returned to the caller.
The `clang-analyzer-core.uninitialized.UndefReturn` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-undefreturn>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-undefreturn)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md
index 98147aaaa6883..1b4a103c926e5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.ArrayDelete
+```{title} clang-tidy - clang-analyzer-cplusplus.ArrayDelete
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-arraydelete
+```
-clang-analyzer-cplusplus.ArrayDelete
-====================================
+# clang-analyzer-cplusplus.ArrayDelete
Reports destructions of arrays of polymorphic objects that are destructed as
their base class.
The `clang-analyzer-cplusplus.ArrayDelete` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-arraydelete>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-arraydelete)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md
index 91937c1adf8cb..fa7b79b719a03 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.InnerPointer
+```{title} clang-tidy - clang-analyzer-cplusplus.InnerPointer
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-innerpointer
+```
-clang-analyzer-cplusplus.InnerPointer
-=====================================
+# clang-analyzer-cplusplus.InnerPointer
Check for inner pointers of C++ containers used after re/deallocation.
The `clang-analyzer-cplusplus.InnerPointer` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-innerpointer>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-innerpointer)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md
index f478598bb4e6c..224cf6f398dab 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.Move
+```{title} clang-tidy - clang-analyzer-cplusplus.Move
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-move
+```
-clang-analyzer-cplusplus.Move
-=============================
+# clang-analyzer-cplusplus.Move
Find use-after-move bugs in C++.
The `clang-analyzer-cplusplus.Move` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-move>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-move)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md
index 1a7174b0fea45..9aeff02b3cd51 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.NewDelete
+```{title} clang-tidy - clang-analyzer-cplusplus.NewDelete
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdelete
+```
-clang-analyzer-cplusplus.NewDelete
-==================================
+# clang-analyzer-cplusplus.NewDelete
Check for double-free and use-after-free problems. Traces memory managed by
new/delete.
The `clang-analyzer-cplusplus.NewDelete` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdelete>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdelete)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md
index dcd58cd100238..2179cff75f1e2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.NewDeleteLeaks
+```{title} clang-tidy - clang-analyzer-cplusplus.NewDeleteLeaks
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdeleteleaks
+```
-clang-analyzer-cplusplus.NewDeleteLeaks
-=======================================
+# clang-analyzer-cplusplus.NewDeleteLeaks
Check for memory leaks. Traces memory managed by new/delete.
The `clang-analyzer-cplusplus.NewDeleteLeaks` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdeleteleaks>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdeleteleaks)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md
index 75a1653587452..9b727086417cb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.PlacementNew
+```{title} clang-tidy - clang-analyzer-cplusplus.PlacementNew
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-placementnew
+```
-clang-analyzer-cplusplus.PlacementNew
-=====================================
+# clang-analyzer-cplusplus.PlacementNew
Check if default placement new is provided with pointers to sufficient storage
capacity.
The `clang-analyzer-cplusplus.PlacementNew` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-placementnew>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-placementnew)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md
index 62e300660828b..666e7a4f0a072 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.SelfAssignment
+```{title} clang-tidy - clang-analyzer-cplusplus.SelfAssignment
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-selfassignment
+```
-clang-analyzer-cplusplus.SelfAssignment
-=======================================
+# clang-analyzer-cplusplus.SelfAssignment
Checks C++ copy and move assignment operators for self assignment.
The `clang-analyzer-cplusplus.SelfAssignment` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md
index 5ffbae9c2660c..845e0aae0b0f7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-cplusplus.StringChecker
+```{title} clang-tidy - clang-analyzer-cplusplus.StringChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker
+```
-clang-analyzer-cplusplus.StringChecker
-======================================
+# clang-analyzer-cplusplus.StringChecker
Checks C++ std::string bugs.
The `clang-analyzer-cplusplus.StringChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md
index faab8cd4c5e96..e320575ea087d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-deadcode.DeadStores
+```{title} clang-tidy - clang-analyzer-deadcode.DeadStores
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#deadcode-deadstores
+```
-clang-analyzer-deadcode.DeadStores
-==================================
+# clang-analyzer-deadcode.DeadStores
Check for values stored to variables that are never read afterwards.
The `clang-analyzer-deadcode.DeadStores` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#deadcode-deadstores>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#deadcode-deadstores)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md
index 974aa491e1183..8a3b59a9b6f91 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-fuchsia.HandleChecker
+```{title} clang-tidy - clang-analyzer-fuchsia.HandleChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#fuchsia-handlechecker
+```
-clang-analyzer-fuchsia.HandleChecker
-====================================
+# clang-analyzer-fuchsia.HandleChecker
A Checker that detect leaks related to Fuchsia handles.
The `clang-analyzer-fuchsia.HandleChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#fuchsia-handlechecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#fuchsia-handlechecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md
index 0cba3bea831ee..02ca0e14aa41f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-nullability.NullPassedToNonnull
+```{title} clang-tidy - clang-analyzer-nullability.NullPassedToNonnull
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullpassedtononnull
+```
-clang-analyzer-nullability.NullPassedToNonnull
-==============================================
+# clang-analyzer-nullability.NullPassedToNonnull
-Warns when a null pointer is passed to a pointer which has a _Nonnull type.
+Warns when a null pointer is passed to a pointer which has a \_Nonnull type.
The `clang-analyzer-nullability.NullPassedToNonnull` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullpassedtononnull>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullpassedtononnull)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md
index d7f8f7ef3119e..4943cf8697759 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-nullability.NullReturnedFromNonnull
+```{title} clang-tidy - clang-analyzer-nullability.NullReturnedFromNonnull
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullreturnedfromnonnull
+```
-clang-analyzer-nullability.NullReturnedFromNonnull
-==================================================
+# clang-analyzer-nullability.NullReturnedFromNonnull
-Warns when a null pointer is returned from a function that has _Nonnull return
+Warns when a null pointer is returned from a function that has \_Nonnull return
type.
The `clang-analyzer-nullability.NullReturnedFromNonnull` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullreturnedfromnonnull>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullreturnedfromnonnull)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md
index c86960c877cea..2eaf77a9af733 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-nullability.NullableDereferenced
+```{title} clang-tidy - clang-analyzer-nullability.NullableDereferenced
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullabledereferenced
+```
-clang-analyzer-nullability.NullableDereferenced
-===============================================
+# clang-analyzer-nullability.NullableDereferenced
Warns when a nullable pointer is dereferenced.
The `clang-analyzer-nullability.NullableDereferenced` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullabledereferenced>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullabledereferenced)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md
index f2830669d5c75..302a0ad63779c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-nullability.NullablePassedToNonnull
+```{title} clang-tidy - clang-analyzer-nullability.NullablePassedToNonnull
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablepassedtononnull
+```
-clang-analyzer-nullability.NullablePassedToNonnull
-==================================================
+# clang-analyzer-nullability.NullablePassedToNonnull
-Warns when a nullable pointer is passed to a pointer which has a _Nonnull type.
+Warns when a nullable pointer is passed to a pointer which has a \_Nonnull type.
The `clang-analyzer-nullability.NullablePassedToNonnull` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablepassedtononnull>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablepassedtononnull)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md
index 220c839cb240b..cb7654416fbcc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-nullability.NullableReturnedFromNonnull
+```{title} clang-tidy - clang-analyzer-nullability.NullableReturnedFromNonnull
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablereturnedfromnonnull
+```
-clang-analyzer-nullability.NullableReturnedFromNonnull
-======================================================
+# clang-analyzer-nullability.NullableReturnedFromNonnull
-Warns when a nullable pointer is returned from a function that has _Nonnull
+Warns when a nullable pointer is returned from a function that has \_Nonnull
return type.
The `clang-analyzer-nullability.NullableReturnedFromNonnull` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablereturnedfromnonnull>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablereturnedfromnonnull)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md
index 99dd1adf38f6b..d28b91477966d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.core.EnumCastOutOfRange
+```{title} clang-tidy - clang-analyzer-optin.core.EnumCastOutOfRange
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-core-enumcastoutofrange
+```
-clang-analyzer-optin.core.EnumCastOutOfRange
-============================================
+# clang-analyzer-optin.core.EnumCastOutOfRange
Check integer to enumeration casts for out of range values.
The `clang-analyzer-optin.core.EnumCastOutOfRange` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-core-enumcastoutofrange>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-core-enumcastoutofrange)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md
index ed66cfc6efd9f..fb5441d595fb4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.cplusplus.UninitializedObject
+```{title} clang-tidy - clang-analyzer-optin.cplusplus.UninitializedObject
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-uninitializedobject
+```
-clang-analyzer-optin.cplusplus.UninitializedObject
-==================================================
+# clang-analyzer-optin.cplusplus.UninitializedObject
Reports uninitialized fields after object construction.
The `clang-analyzer-optin.cplusplus.UninitializedObject` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-uninitializedobject>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-uninitializedobject)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md
index 4b7a25441f9f8..64c1a1043cf26 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.cplusplus.VirtualCall
+```{title} clang-tidy - clang-analyzer-optin.cplusplus.VirtualCall
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-virtualcall
+```
-clang-analyzer-optin.cplusplus.VirtualCall
-==========================================
+# clang-analyzer-optin.cplusplus.VirtualCall
Check virtual function calls during construction/destruction.
The `clang-analyzer-optin.cplusplus.VirtualCall` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-virtualcall>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-virtualcall)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md
index 005d904ec3e02..5d9f0f0f6f1be 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.mpi.MPI-Checker
+```{title} clang-tidy - clang-analyzer-optin.mpi.MPI-Checker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-mpi-mpi-checker
+```
-clang-analyzer-optin.mpi.MPI-Checker
-====================================
+# clang-analyzer-optin.mpi.MPI-Checker
Checks MPI code.
The `clang-analyzer-optin.mpi.MPI-Checker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-mpi-mpi-checker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-mpi-mpi-checker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md
index 81d4fc39cd561..a6451823f9985 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
+```{title} clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-emptylocalizationcontextchecker
+```
-clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
-=============================================================================
+# clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
Check that NSLocalizedString macros include a comment for context.
The `clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-emptylocalizationcontextchecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-emptylocalizationcontextchecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md
index 3faef615eaaad..94f1642c4e5f7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
+```{title} clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-nonlocalizedstringchecker
+```
-clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
-=======================================================================
+# clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
Warns about uses of non-localized NSStrings passed to UI methods expecting
localized NSStrings.
The `clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-nonlocalizedstringchecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-nonlocalizedstringchecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md
index 95f435acd7c9c..27f03abe68b10 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.performance.GCDAntipattern
+```{title} clang-tidy - clang-analyzer-optin.performance.GCDAntipattern
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-gcdantipattern
+```
-clang-analyzer-optin.performance.GCDAntipattern
-===============================================
+# clang-analyzer-optin.performance.GCDAntipattern
Check for performance anti-patterns when using Grand Central Dispatch.
The `clang-analyzer-optin.performance.GCDAntipattern` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-gcdantipattern>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-gcdantipattern)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md
index 77acf0a6ed115..890605955ef39 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.performance.Padding
+```{title} clang-tidy - clang-analyzer-optin.performance.Padding
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-padding
+```
-clang-analyzer-optin.performance.Padding
-========================================
+# clang-analyzer-optin.performance.Padding
Check for excessively padded structs.
The `clang-analyzer-optin.performance.Padding` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-padding>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-padding)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md
index f133494718a87..3a840d9e62a9e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-optin.portability.UnixAPI
+```{title} clang-tidy - clang-analyzer-optin.portability.UnixAPI
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-portability-unixapi
+```
-clang-analyzer-optin.portability.UnixAPI
-========================================
+# clang-analyzer-optin.portability.UnixAPI
Finds implementation-defined behavior in UNIX/Posix functions.
The `clang-analyzer-optin.portability.UnixAPI` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-portability-unixapi>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-portability-unixapi)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md
index 9732333c61aa7..1b1b95c4c487e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-optin.taint.TaintedAlloc
+```{title} clang-tidy - clang-analyzer-optin.taint.TaintedAlloc
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-taint-taintedalloc
+```
-clang-analyzer-optin.taint.TaintedAlloc
-=======================================
+# clang-analyzer-optin.taint.TaintedAlloc
Check for memory allocations, where the size parameter might be a tainted
(attacker controlled) value.
The `clang-analyzer-optin.taint.TaintedAlloc` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#optin-taint-taintedalloc>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-taint-taintedalloc)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md
index 7bb178d1072f5..81dc66073f481 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.API
+```{title} clang-tidy - clang-analyzer-osx.API
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-api
+```
-clang-analyzer-osx.API
-======================
+# clang-analyzer-osx.API
Check for proper uses of various Apple APIs.
The `clang-analyzer-osx.API` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-api>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-api)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md
index 89ddfeb9ecd45..43a92542c008e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.NumberObjectConversion
+```{title} clang-tidy - clang-analyzer-osx.NumberObjectConversion
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-numberobjectconversion
+```
-clang-analyzer-osx.NumberObjectConversion
-=========================================
+# clang-analyzer-osx.NumberObjectConversion
Check for erroneous conversions of objects representing numbers into numbers.
The `clang-analyzer-osx.NumberObjectConversion` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-numberobjectconversion>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-numberobjectconversion)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md
index a3c2aca52a550..322ba1aff5bc3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.ObjCProperty
+```{title} clang-tidy - clang-analyzer-osx.ObjCProperty
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-objcproperty
+```
-clang-analyzer-osx.ObjCProperty
-===============================
+# clang-analyzer-osx.ObjCProperty
Check for proper uses of Objective-C properties.
The `clang-analyzer-osx.ObjCProperty` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-objcproperty>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-objcproperty)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md
index 21dc34e73e1f6..cfa928ca167f4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.SecKeychainAPI
+```{title} clang-tidy - clang-analyzer-osx.SecKeychainAPI
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-seckeychainapi
+```
-clang-analyzer-osx.SecKeychainAPI
-=================================
+# clang-analyzer-osx.SecKeychainAPI
Check for proper uses of Secure Keychain APIs.
The `clang-analyzer-osx.SecKeychainAPI` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-seckeychainapi>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-seckeychainapi)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md
index 341dcf51fc614..85c7c45f727e8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.AtSync
+```{title} clang-tidy - clang-analyzer-osx.cocoa.AtSync
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-atsync
+```
-clang-analyzer-osx.cocoa.AtSync
-===============================
+# clang-analyzer-osx.cocoa.AtSync
Check for nil pointers used as mutexes for @synchronized.
The `clang-analyzer-osx.cocoa.AtSync` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-atsync>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-atsync)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md
index f2516c36e08a7..5b2dd1c1c94d9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.AutoreleaseWrite
+```{title} clang-tidy - clang-analyzer-osx.cocoa.AutoreleaseWrite
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-autoreleasewrite
+```
-clang-analyzer-osx.cocoa.AutoreleaseWrite
-=========================================
+# clang-analyzer-osx.cocoa.AutoreleaseWrite
Warn about potentially crashing writes to autoreleasing objects from different
autoreleasing pools in Objective-C.
The `clang-analyzer-osx.cocoa.AutoreleaseWrite` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-autoreleasewrite>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-autoreleasewrite)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md
index ae197294b97a4..5a6c685a35b47 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.ClassRelease
+```{title} clang-tidy - clang-analyzer-osx.cocoa.ClassRelease
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-classrelease
+```
-clang-analyzer-osx.cocoa.ClassRelease
-=====================================
+# clang-analyzer-osx.cocoa.ClassRelease
Check for sending 'retain', 'release', or 'autorelease' directly to a Class.
The `clang-analyzer-osx.cocoa.ClassRelease` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-classrelease>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-classrelease)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md
index 4176e8279f64e..65c12a21a9e86 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.Dealloc
+```{title} clang-tidy - clang-analyzer-osx.cocoa.Dealloc
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-dealloc
+```
-clang-analyzer-osx.cocoa.Dealloc
-================================
+# clang-analyzer-osx.cocoa.Dealloc
Warn about Objective-C classes that lack a correct implementation of -dealloc.
The `clang-analyzer-osx.cocoa.Dealloc` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-dealloc>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-dealloc)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md
index a3b47405b631f..2a39cf7005730 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.IncompatibleMethodTypes
+```{title} clang-tidy - clang-analyzer-osx.cocoa.IncompatibleMethodTypes
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-incompatiblemethodtypes
+```
-clang-analyzer-osx.cocoa.IncompatibleMethodTypes
-================================================
+# clang-analyzer-osx.cocoa.IncompatibleMethodTypes
Warn about Objective-C method signatures with type incompatibilities.
The `clang-analyzer-osx.cocoa.IncompatibleMethodTypes` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-incompatiblemethodtypes>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-incompatiblemethodtypes)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md
index 03af29665b426..e20bccb258de3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.Loops
+```{title} clang-tidy - clang-analyzer-osx.cocoa.Loops
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-loops
+```
-clang-analyzer-osx.cocoa.Loops
-==============================
+# clang-analyzer-osx.cocoa.Loops
Improved modeling of loops using Cocoa collection types.
The `clang-analyzer-osx.cocoa.Loops` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-loops>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-loops)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md
index 53d96f6c6298f..09c62c3b36684 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.MissingSuperCall
+```{title} clang-tidy - clang-analyzer-osx.cocoa.MissingSuperCall
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-missingsupercall
+```
-clang-analyzer-osx.cocoa.MissingSuperCall
-=========================================
+# clang-analyzer-osx.cocoa.MissingSuperCall
Warn about Objective-C methods that lack a necessary call to super.
The `clang-analyzer-osx.cocoa.MissingSuperCall` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-missingsupercall>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-missingsupercall)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md
index 22f5bc21d8a33..004988fa79e3d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.NSAutoreleasePool
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NSAutoreleasePool
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nsautoreleasepool
+```
-clang-analyzer-osx.cocoa.NSAutoreleasePool
-==========================================
+# clang-analyzer-osx.cocoa.NSAutoreleasePool
Warn for suboptimal uses of NSAutoreleasePool in Objective-C GC mode.
The `clang-analyzer-osx.cocoa.NSAutoreleasePool` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nsautoreleasepool>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nsautoreleasepool)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md
index fdb93230e530b..0e5f68d7a40ed 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.NSError
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NSError
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nserror
+```
-clang-analyzer-osx.cocoa.NSError
-================================
+# clang-analyzer-osx.cocoa.NSError
-Check usage of NSError** parameters.
+Check usage of NSError\*\* parameters.
The `clang-analyzer-osx.cocoa.NSError` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nserror>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nserror)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md
index 116dfd0dfc765..03c78d462b25d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.NilArg
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NilArg
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nilarg
+```
-clang-analyzer-osx.cocoa.NilArg
-===============================
+# clang-analyzer-osx.cocoa.NilArg
Check for prohibited nil arguments to ObjC method calls.
The `clang-analyzer-osx.cocoa.NilArg` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nilarg>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nilarg)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md
index e4ae9f817fc58..8eb3d8227f583 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.NonNilReturnValue
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NonNilReturnValue
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nonnilreturnvalue
+```
-clang-analyzer-osx.cocoa.NonNilReturnValue
-==========================================
+# clang-analyzer-osx.cocoa.NonNilReturnValue
Model the APIs that are guaranteed to return a non-nil value.
The `clang-analyzer-osx.cocoa.NonNilReturnValue` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nonnilreturnvalue>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nonnilreturnvalue)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md
index dc80bd2b9125c..df3fe1be5207e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.ObjCGenerics
+```{title} clang-tidy - clang-analyzer-osx.cocoa.ObjCGenerics
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-objcgenerics
+```
-clang-analyzer-osx.cocoa.ObjCGenerics
-=====================================
+# clang-analyzer-osx.cocoa.ObjCGenerics
Check for type errors when using Objective-C generics.
The `clang-analyzer-osx.cocoa.ObjCGenerics` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-objcgenerics>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-objcgenerics)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md
index d932bf5079456..e2b041f4e7ab4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.RetainCount
+```{title} clang-tidy - clang-analyzer-osx.cocoa.RetainCount
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-retaincount
+```
-clang-analyzer-osx.cocoa.RetainCount
-====================================
+# clang-analyzer-osx.cocoa.RetainCount
Check for leaks and improper reference count management.
The `clang-analyzer-osx.cocoa.RetainCount` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-retaincount>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-retaincount)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md
index 2388d96673b6b..f9d6e230aae34 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
+```{title} clang-tidy - clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-runloopautoreleaseleak
+```
-clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
-===============================================
+# clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
Check for leaked memory in autorelease pools that will never be drained.
The `clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-runloopautoreleaseleak>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-runloopautoreleaseleak)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md
index ec218b6d92ca5..2a4f3392f3966 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.SelfInit
+```{title} clang-tidy - clang-analyzer-osx.cocoa.SelfInit
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-selfinit
+```
-clang-analyzer-osx.cocoa.SelfInit
-=================================
+# clang-analyzer-osx.cocoa.SelfInit
Check that 'self' is properly initialized inside an initializer method.
The `clang-analyzer-osx.cocoa.SelfInit` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-selfinit>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-selfinit)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md
index f0e52e7ad2f02..da8fc4f188159 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.SuperDealloc
+```{title} clang-tidy - clang-analyzer-osx.cocoa.SuperDealloc
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-superdealloc
+```
-clang-analyzer-osx.cocoa.SuperDealloc
-=====================================
+# clang-analyzer-osx.cocoa.SuperDealloc
Warn about improper use of '[super dealloc]' in Objective-C.
The `clang-analyzer-osx.cocoa.SuperDealloc` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-superdealloc>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-superdealloc)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md
index ed92cf583680b..3226ac073acb9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.UnusedIvars
+```{title} clang-tidy - clang-analyzer-osx.cocoa.UnusedIvars
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-unusedivars
+```
-clang-analyzer-osx.cocoa.UnusedIvars
-====================================
+# clang-analyzer-osx.cocoa.UnusedIvars
Warn about private ivars that are never used.
The `clang-analyzer-osx.cocoa.UnusedIvars` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-unusedivars>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-unusedivars)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md
index b18ca4338d140..9f65e5efdfbd5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-osx.cocoa.VariadicMethodTypes
+```{title} clang-tidy - clang-analyzer-osx.cocoa.VariadicMethodTypes
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-variadicmethodtypes
+```
-clang-analyzer-osx.cocoa.VariadicMethodTypes
-============================================
+# clang-analyzer-osx.cocoa.VariadicMethodTypes
Check for passing non-Objective-C types to variadic collection initialization
methods that expect only Objective-C types.
The `clang-analyzer-osx.cocoa.VariadicMethodTypes` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-variadicmethodtypes>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-variadicmethodtypes)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md
index 54547aded1ddc..27afcb8081342 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.coreFoundation.CFError
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFError
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cferror
+```
-clang-analyzer-osx.coreFoundation.CFError
-=========================================
+# clang-analyzer-osx.coreFoundation.CFError
-Check usage of CFErrorRef* parameters.
+Check usage of CFErrorRef\* parameters.
The `clang-analyzer-osx.coreFoundation.CFError` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cferror>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cferror)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md
index ce8ebadcac3bf..cc77356508e5a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.coreFoundation.CFNumber
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFNumber
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfnumber
+```
-clang-analyzer-osx.coreFoundation.CFNumber
-==========================================
+# clang-analyzer-osx.coreFoundation.CFNumber
Check for proper uses of CFNumber APIs.
The `clang-analyzer-osx.coreFoundation.CFNumber` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfnumber>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfnumber)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md
index 4cc5a6c8e95a5..a74c36bba82e5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.coreFoundation.CFRetainRelease
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFRetainRelease
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfretainrelease
+```
-clang-analyzer-osx.coreFoundation.CFRetainRelease
-=================================================
+# clang-analyzer-osx.coreFoundation.CFRetainRelease
Check for null arguments to CFRetain/CFRelease/CFMakeCollectable.
The `clang-analyzer-osx.coreFoundation.CFRetainRelease` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfretainrelease>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfretainrelease)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md
index 2c6f30c4fbcf9..3c92207b598ad 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-osx.coreFoundation.containers.OutOfBounds
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.containers.OutOfBounds
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-outofbounds
+```
-clang-analyzer-osx.coreFoundation.containers.OutOfBounds
-========================================================
+# clang-analyzer-osx.coreFoundation.containers.OutOfBounds
Checks for index out-of-bounds when using 'CFArray' API.
The `clang-analyzer-osx.coreFoundation.containers.OutOfBounds` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-outofbounds>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-outofbounds)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md
index 6862f6f187279..648900cb83e9c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-pointersizedvalues
+```
-clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
-===============================================================
+# clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
Warns if 'CFArray', 'CFDictionary', 'CFSet' are created with non-pointer-size
values.
The `clang-analyzer-osx.coreFoundation.containers.PointerSizedValues` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-pointersizedvalues>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-pointersizedvalues)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md
index c6c6719805f30..5ee97a863e8d9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-security.FloatLoopCounter
+```{title} clang-tidy - clang-analyzer-security.FloatLoopCounter
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-floatloopcounter
+```
-clang-analyzer-security.FloatLoopCounter
-========================================
+# clang-analyzer-security.FloatLoopCounter
Warn on using a floating point value as a loop counter (CERT: FLP30-C,
FLP30-CPP).
The `clang-analyzer-security.FloatLoopCounter` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-floatloopcounter>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-floatloopcounter)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md
index 5858078246d9b..a0021039a6627 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md
@@ -1,9 +1,12 @@
-.. title:: clang-tidy - clang-analyzer-security.PutenvStackArray
+```{title} clang-tidy - clang-analyzer-security.PutenvStackArray
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-putenvstackarray-c
+```
-clang-analyzer-security.PutenvStackArray
-========================================
+# clang-analyzer-security.PutenvStackArray
Finds calls to the putenv function which pass a pointer to a stack-allocated
(automatic) array as the argument. Function putenv does not copy the passed
@@ -12,6 +15,6 @@ other threads. Content of a stack-allocated array is likely to be overwritten
after exiting from the function.
The `clang-analyzer-security.PutenvStackArray` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-putenvstackarray-c>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-putenvstackarray-c)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md
index bb1f5d7e2bdfd..7cc71f790fc2b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md
@@ -1,19 +1,22 @@
-.. title:: clang-tidy - clang-analyzer-security.SetgidSetuidOrder
+```{title} clang-tidy - clang-analyzer-security.SetgidSetuidOrder
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-setgidsetuidorder-c
+```
-clang-analyzer-security.SetgidSetuidOrder
-=========================================
+# clang-analyzer-security.SetgidSetuidOrder
-The checker checks for sequences of ``setuid(getuid())`` and
-``setgid(getgid())`` calls (in this order). If such a sequence is found and
-there is no other privilege-changing function call (``seteuid``, ``setreuid``,
-``setresuid`` and the GID versions of these) in between, a warning is
-generated. The checker finds only exactly ``setuid(getuid())`` calls (and the
-GID versions), not for example if the result of ``getuid()`` is stored in
+The checker checks for sequences of `setuid(getuid())` and
+`setgid(getgid())` calls (in this order). If such a sequence is found and
+there is no other privilege-changing function call (`seteuid`, `setreuid`,
+`setresuid` and the GID versions of these) in between, a warning is
+generated. The checker finds only exactly `setuid(getuid())` calls (and the
+GID versions), not for example if the result of `getuid()` is stored in
a variable.
The `clang-analyzer-security.SetgidSetuidOrder` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-setgidsetuidorder-c>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-setgidsetuidorder-c)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md
index 8986fa0e684f5..f7e935d8f3a83 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.cert.env.InvalidPtr
+```{title} clang-tidy - clang-analyzer-security.cert.env.InvalidPtr
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-cert-env-invalidptr
+```
-clang-analyzer-security.cert.env.InvalidPtr
-===========================================
+# clang-analyzer-security.cert.env.InvalidPtr
Finds usages of possibly invalidated pointers.
The `clang-analyzer-security.cert.env.InvalidPtr` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-cert-env-invalidptr>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-cert-env-invalidptr)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md
index 8a8880805af70..39046f2c3a384 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-deprecatedorunsafebufferhandling
+```
-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
-====================================================================
+# clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
Warn on uses of unsecure or deprecated buffer manipulating functions.
The `clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-deprecatedorunsafebufferhandling>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-deprecatedorunsafebufferhandling)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md
index b4489c649633d..7f8ef7f62d1c0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.UncheckedReturn
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.UncheckedReturn
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-uncheckedreturn
+```
-clang-analyzer-security.insecureAPI.UncheckedReturn
-===================================================
+# clang-analyzer-security.insecureAPI.UncheckedReturn
Warn on uses of functions whose return values must be always checked.
The `clang-analyzer-security.insecureAPI.UncheckedReturn` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-uncheckedreturn>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-uncheckedreturn)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md
index e0c66a7083f37..4adc2683a13ae 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.bcmp
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.bcmp
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcmp
+```
-clang-analyzer-security.insecureAPI.bcmp
-========================================
+# clang-analyzer-security.insecureAPI.bcmp
Warn on uses of the 'bcmp' function.
The `clang-analyzer-security.insecureAPI.bcmp` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcmp>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcmp)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md
index 2d6869b6ebcab..67665bbc979cc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.bcopy
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.bcopy
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcopy
+```
-clang-analyzer-security.insecureAPI.bcopy
-=========================================
+# clang-analyzer-security.insecureAPI.bcopy
Warn on uses of the 'bcopy' function.
The `clang-analyzer-security.insecureAPI.bcopy` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcopy>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcopy)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md
index e9ed1f7d1e28a..4927986d2634f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.bzero
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.bzero
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bzero
+```
-clang-analyzer-security.insecureAPI.bzero
-=========================================
+# clang-analyzer-security.insecureAPI.bzero
Warn on uses of the 'bzero' function.
The `clang-analyzer-security.insecureAPI.bzero` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bzero>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bzero)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md
index 6b926f3638ee5..d3d8efed90045 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.decodeValueOfObjCType
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.decodeValueOfObjCType
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-decodevalueofobjctype
+```
-clang-analyzer-security.insecureAPI.decodeValueOfObjCType
-=========================================================
+# clang-analyzer-security.insecureAPI.decodeValueOfObjCType
Warn on uses of the '-decodeValueOfObjCType:at:' method.
The `clang-analyzer-security.insecureAPI.decodeValueOfObjCType` check is an alias, please see
-`Clang Static Analyzer security.insecureAPI.decodeValueOfObjCType
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-decodevalueofobjctype>`_
+[Clang Static Analyzer security.insecureAPI.decodeValueOfObjCType](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-decodevalueofobjctype)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md
index ed661a2fa3590..14942b8513a90 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.getpw
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.getpw
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-getpw
+```
-clang-analyzer-security.insecureAPI.getpw
-=========================================
+# clang-analyzer-security.insecureAPI.getpw
Warn on uses of the 'getpw' function.
The `clang-analyzer-security.insecureAPI.getpw` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-getpw>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-getpw)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md
index 5b579d825381d..cd5873022108d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.gets
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.gets
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-gets
+```
-clang-analyzer-security.insecureAPI.gets
-========================================
+# clang-analyzer-security.insecureAPI.gets
Warn on uses of the 'gets' function.
The `clang-analyzer-security.insecureAPI.gets` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-gets>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-gets)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md
index d84251db35142..92609acdb3a6d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.mkstemp
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.mkstemp
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mkstemp
+```
-clang-analyzer-security.insecureAPI.mkstemp
-===========================================
+# clang-analyzer-security.insecureAPI.mkstemp
Warn when 'mkstemp' is passed fewer than 6 X's in the format string.
The `clang-analyzer-security.insecureAPI.mkstemp` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mkstemp>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mkstemp)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md
index e5778cbfb6c2f..ad4b01918e219 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.mktemp
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.mktemp
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mktemp
+```
-clang-analyzer-security.insecureAPI.mktemp
-==========================================
+# clang-analyzer-security.insecureAPI.mktemp
Warn on uses of the 'mktemp' function.
The `clang-analyzer-security.insecureAPI.mktemp` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mktemp>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mktemp)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md
index 25acabe7f8a16..9f41836183cea 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.rand
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.rand
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-rand
+```
-clang-analyzer-security.insecureAPI.rand
-========================================
+# clang-analyzer-security.insecureAPI.rand
Warn on uses of the 'rand', 'random', and related functions.
The `clang-analyzer-security.insecureAPI.rand` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-rand>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-rand)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md
index 4177950d686b3..b2f7e24e3cc64 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.strcpy
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.strcpy
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-strcpy
+```
-clang-analyzer-security.insecureAPI.strcpy
-==========================================
+# clang-analyzer-security.insecureAPI.strcpy
Warn on uses of the 'strcpy' and 'strcat' functions.
The `clang-analyzer-security.insecureAPI.strcpy` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-strcpy>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-strcpy)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md
index 0a24fb960b520..3b9486fa75f86 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-security.insecureAPI.vfork
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.vfork
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-vfork
+```
-clang-analyzer-security.insecureAPI.vfork
-=========================================
+# clang-analyzer-security.insecureAPI.vfork
Warn on uses of the 'vfork' function.
The `clang-analyzer-security.insecureAPI.vfork` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-vfork>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-vfork)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md
index b561b9037d2a4..ffd6485a81964 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.API
+```{title} clang-tidy - clang-analyzer-unix.API
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-api
+```
-clang-analyzer-unix.API
-=======================
+# clang-analyzer-unix.API
Check calls to various UNIX/Posix functions.
The `clang-analyzer-unix.API` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-api>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-api)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md
index 40d2d3d8b8aac..0998aaa766323 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.BlockInCriticalSection
+```{title} clang-tidy - clang-analyzer-unix.BlockInCriticalSection
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-blockincriticalsection
+```
-clang-analyzer-unix.BlockInCriticalSection
-==========================================
+# clang-analyzer-unix.BlockInCriticalSection
Check for calls to blocking functions inside a critical section.
The `clang-analyzer-unix.BlockInCriticalSection` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-blockincriticalsection>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-blockincriticalsection)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md
index 67a2d05811dc1..a0e96a6134184 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.Errno
+```{title} clang-tidy - clang-analyzer-unix.Errno
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-errno
+```
-clang-analyzer-unix.Errno
-=========================
+# clang-analyzer-unix.Errno
Check for improper use of 'errno'.
The `clang-analyzer-unix.Errno` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-errno>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-errno)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md
index 78c0ef193623a..d89551e9f2713 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-unix.Malloc
+```{title} clang-tidy - clang-analyzer-unix.Malloc
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-malloc
+```
-clang-analyzer-unix.Malloc
-==========================
+# clang-analyzer-unix.Malloc
Check for memory leaks, double free, and use-after-free problems. Traces memory
managed by malloc()/free().
The `clang-analyzer-unix.Malloc` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-malloc>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-malloc)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md
index 6cb193dd5fab7..a71e38eb61773 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.MallocSizeof
+```{title} clang-tidy - clang-analyzer-unix.MallocSizeof
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-mallocsizeof
+```
-clang-analyzer-unix.MallocSizeof
-================================
+# clang-analyzer-unix.MallocSizeof
Check for dubious malloc arguments involving sizeof.
The `clang-analyzer-unix.MallocSizeof` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-mallocsizeof>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-mallocsizeof)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md
index 924dd41a1b6d2..1643399d2793e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.MismatchedDeallocator
+```{title} clang-tidy - clang-analyzer-unix.MismatchedDeallocator
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-mismatcheddeallocator
+```
-clang-analyzer-unix.MismatchedDeallocator
-=========================================
+# clang-analyzer-unix.MismatchedDeallocator
Check for mismatched deallocators.
The `clang-analyzer-unix.MismatchedDeallocator` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-mismatcheddeallocator>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-mismatcheddeallocator)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md
index 0415dab9927db..8399b0ff6d50b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-unix.StdCLibraryFunctions
+```{title} clang-tidy - clang-analyzer-unix.StdCLibraryFunctions
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-stdclibraryfunctions
+```
-clang-analyzer-unix.StdCLibraryFunctions
-========================================
+# clang-analyzer-unix.StdCLibraryFunctions
Check for invalid arguments of C standard library functions, and apply
relations between arguments and return value.
The `clang-analyzer-unix.StdCLibraryFunctions` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-stdclibraryfunctions>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-stdclibraryfunctions)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md
index 82a8bdcaefce7..79a469dc9b2bc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.Stream
+```{title} clang-tidy - clang-analyzer-unix.Stream
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-stream
+```
-clang-analyzer-unix.Stream
-==========================
+# clang-analyzer-unix.Stream
Check stream handling functions.
The `clang-analyzer-unix.Stream` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-stream>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-stream)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md
index 5b1e5bf89563e..6ba5bac2a20e0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.Vfork
+```{title} clang-tidy - clang-analyzer-unix.Vfork
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-vfork
+```
-clang-analyzer-unix.Vfork
-=========================
+# clang-analyzer-unix.Vfork
Check for proper usage of vfork.
The `clang-analyzer-unix.Vfork` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-vfork>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-vfork)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md
index 3aa1ec9cc0a62..e157bdcda26bf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md
@@ -1,14 +1,17 @@
-.. title:: clang-tidy - clang-analyzer-unix.cstring.BadSizeArg
+```{title} clang-tidy - clang-analyzer-unix.cstring.BadSizeArg
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-badsizearg
+```
-clang-analyzer-unix.cstring.BadSizeArg
-======================================
+# clang-analyzer-unix.cstring.BadSizeArg
Check the size argument passed into C string functions for common erroneous
patterns.
The `clang-analyzer-unix.cstring.BadSizeArg` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-badsizearg>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-badsizearg)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md
index 8957735dc6d99..bda662aa7b60a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-unix.cstring.NullArg
+```{title} clang-tidy - clang-analyzer-unix.cstring.NullArg
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-nullarg
+```
-clang-analyzer-unix.cstring.NullArg
-===================================
+# clang-analyzer-unix.cstring.NullArg
Check for null pointers being passed as arguments to C string functions.
The `clang-analyzer-unix.cstring.NullArg` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-nullarg>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-nullarg)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md
index bd7dcff489c2e..6629bdcfbe1e0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-webkit.NoUncountedMemberChecker
+```{title} clang-tidy - clang-analyzer-webkit.NoUncountedMemberChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-nouncountedmemberchecker
+```
-clang-analyzer-webkit.NoUncountedMemberChecker
-==============================================
+# clang-analyzer-webkit.NoUncountedMemberChecker
Check for no uncounted member variables.
The `clang-analyzer-webkit.NoUncountedMemberChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#webkit-nouncountedmemberchecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#webkit-nouncountedmemberchecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md
index e0f2036ec1c09..7a11b350921cb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-webkit.RefCntblBaseVirtualDtor
+```{title} clang-tidy - clang-analyzer-webkit.RefCntblBaseVirtualDtor
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-refcntblbasevirtualdtor
+```
-clang-analyzer-webkit.RefCntblBaseVirtualDtor
-=============================================
+# clang-analyzer-webkit.RefCntblBaseVirtualDtor
Check for any ref-countable base class having virtual destructor.
The `clang-analyzer-webkit.RefCntblBaseVirtualDtor` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#webkit-refcntblbasevirtualdtor>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#webkit-refcntblbasevirtualdtor)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md
index 8b4a21bfaf707..0f69f94d7ff79 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md
@@ -1,13 +1,16 @@
-.. title:: clang-tidy - clang-analyzer-webkit.UncountedLambdaCapturesChecker
+```{title} clang-tidy - clang-analyzer-webkit.UncountedLambdaCapturesChecker
+```
+
+```{eval-rst}
.. meta::
:http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-uncountedlambdacaptureschecker
+```
-clang-analyzer-webkit.UncountedLambdaCapturesChecker
-====================================================
+# clang-analyzer-webkit.UncountedLambdaCapturesChecker
Check uncounted lambda captures.
The `clang-analyzer-webkit.UncountedLambdaCapturesChecker` check is an alias, please see
-`Clang Static Analyzer Available Checkers
-<https://clang.llvm.org/docs/analyzer/checkers.html#webkit-uncountedlambdacaptureschecker>`_
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#webkit-uncountedlambdacaptureschecker)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md b/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md
index 8085fdb728a89..521e78ce4d2ff 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md
@@ -1,21 +1,21 @@
-.. title:: clang-tidy - concurrency-thread-canceltype-asynchronous
+```{title} clang-tidy - concurrency-thread-canceltype-asynchronous
+```
-concurrency-thread-canceltype-asynchronous
-==========================================
+# concurrency-thread-canceltype-asynchronous
-Finds ``pthread_setcanceltype`` function calls where a thread's cancellation
+Finds `pthread_setcanceltype` function calls where a thread's cancellation
type is set to asynchronous. Asynchronous cancellation type
-(``PTHREAD_CANCEL_ASYNCHRONOUS``) is generally unsafe, use type
-``PTHREAD_CANCEL_DEFERRED`` instead which is the default. Even with deferred
+(`PTHREAD_CANCEL_ASYNCHRONOUS`) is generally unsafe, use type
+`PTHREAD_CANCEL_DEFERRED` instead which is the default. Even with deferred
cancellation, a cancellation point in an asynchronous signal handler may still
be acted upon and the effect is as if it was an asynchronous cancellation.
-.. code-block:: c++
-
- pthread_setcanceltype(PTHREAD_CANCEL_ASYNCHRONOUS, &oldtype);
+```c++
+pthread_setcanceltype(PTHREAD_CANCEL_ASYNCHRONOUS, &oldtype);
+```
This check corresponds to the CERT C Coding Standard rule
-`POS47-C. Do not use threads that can be canceled asynchronously
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/posix-pos/pos47-c/>`_.
+[POS47-C. Do not use threads that can be canceled asynchronously](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/posix-pos/pos47-c/).
`cert-pos47-c` redirects here as an alias of this check.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-c-arrays.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-c-arrays.md
index d5a2c655cf288..11ea4751c859e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-c-arrays.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-c-arrays.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cppcoreguidelines-avoid-c-arrays
+```{title} clang-tidy - cppcoreguidelines-avoid-c-arrays
+```
-cppcoreguidelines-avoid-c-arrays
-================================
+# cppcoreguidelines-avoid-c-arrays
The `cppcoreguidelines-avoid-c-arrays` check is an alias, please see
-:doc:`modernize-avoid-c-arrays <../modernize/avoid-c-arrays>`
+{doc}`modernize-avoid-c-arrays <../modernize/avoid-c-arrays>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-magic-numbers.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-magic-numbers.md
index 987cf82137b13..ee46df861bd41 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-magic-numbers.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-magic-numbers.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cppcoreguidelines-avoid-magic-numbers
+```{title} clang-tidy - cppcoreguidelines-avoid-magic-numbers
+```
-cppcoreguidelines-avoid-magic-numbers
-=====================================
+# cppcoreguidelines-avoid-magic-numbers
The `cppcoreguidelines-avoid-magic-numbers` check is an alias, please see
-:doc:`readability-magic-numbers <../readability/magic-numbers>`
+{doc}`readability-magic-numbers <../readability/magic-numbers>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md
index 887bdc66d938a..4904021dfdcb2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - cppcoreguidelines-avoid-reference-coroutine-parameters
+```{title} clang-tidy - cppcoreguidelines-avoid-reference-coroutine-parameters
+```
-cppcoreguidelines-avoid-reference-coroutine-parameters
-======================================================
+# cppcoreguidelines-avoid-reference-coroutine-parameters
Warns when a coroutine accepts reference parameters. After a coroutine suspend
point, references could be dangling and no longer valid. Instead, pass
@@ -9,14 +9,14 @@ parameters as values.
Examples:
-.. code-block:: c++
+```c++
+std::future<int> someCoroutine(int& val) {
+ co_await ...;
+ // When the coroutine is resumed, 'val' might no longer be valid.
+ if (val) ...
+}
+```
- std::future<int> someCoroutine(int& val) {
- co_await ...;
- // When the coroutine is resumed, 'val' might no longer be valid.
- if (val) ...
- }
-
-This check implements `CP.53
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#rcoro-reference-parameters>`_
+This check implements [CP.53](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#rcoro-reference-parameters)
from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md
index ec1b6e7d1e6aa..ce4764e047edf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cppcoreguidelines-c-copy-assignment-signature
+```{title} clang-tidy - cppcoreguidelines-c-copy-assignment-signature
+```
-cppcoreguidelines-c-copy-assignment-signature
-=============================================
+# cppcoreguidelines-c-copy-assignment-signature
The `cppcoreguidelines-c-copy-assignment-signature` check is an alias,
-please see :doc:`misc-unconventional-assign-operator
+please see {doc}`misc-unconventional-assign-operator
<../misc/unconventional-assign-operator>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-constructor.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-constructor.md
index a83c86f8a468a..5e4e02d829219 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-constructor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-constructor.md
@@ -1,7 +1,8 @@
-.. title:: clang-tidy - cppcoreguidelines-explicit-constructor
+```{title} clang-tidy - cppcoreguidelines-explicit-constructor
+```
-cppcoreguidelines-explicit-constructor
-======================================
+# cppcoreguidelines-explicit-constructor
This check is an alias for
-:doc:`misc-explicit-constructor <../misc/explicit-constructor>`.
+{doc}`misc-explicit-constructor <../misc/explicit-constructor>`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-virtual-functions.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-virtual-functions.md
index 1d6c879e8aff1..495216502073f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-virtual-functions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/explicit-virtual-functions.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cppcoreguidelines-explicit-virtual-functions
+```{title} clang-tidy - cppcoreguidelines-explicit-virtual-functions
+```
-cppcoreguidelines-explicit-virtual-functions
-============================================
+# cppcoreguidelines-explicit-virtual-functions
The `cppcoreguidelines-explicit-virtual-functions` check is an alias,
-please see :doc:`modernize-use-override <../modernize/use-override>`
+please see {doc}`modernize-use-override <../modernize/use-override>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/interfaces-global-init.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/interfaces-global-init.md
index 65ff1db9e4907..304b602a5d5f0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/interfaces-global-init.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/interfaces-global-init.md
@@ -1,13 +1,12 @@
-.. title:: clang-tidy - cppcoreguidelines-interfaces-global-init
+```{title} clang-tidy - cppcoreguidelines-interfaces-global-init
+```
-cppcoreguidelines-interfaces-global-init
-========================================
+# cppcoreguidelines-interfaces-global-init
This check flags initializers of globals that access extern objects,
and therefore can lead to order-of-initialization problems.
-This check implements `I.22
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#ri-global-init>`_
+This check implements [I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#ri-global-init)
from the C++ Core Guidelines.
Note that currently this does not flag calls to non-constexpr functions, and
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/macro-to-enum.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/macro-to-enum.md
index 5e90fdd42a2e3..f9f44c42ea81c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/macro-to-enum.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/macro-to-enum.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cppcoreguidelines-macro-to-enum
+```{title} clang-tidy - cppcoreguidelines-macro-to-enum
+```
-cppcoreguidelines-macro-to-enum
-===============================
+# cppcoreguidelines-macro-to-enum
The `cppcoreguidelines-macro-to-enum` check is an alias, please see
-:doc:`modernize-macro-to-enum <../modernize/macro-to-enum>`
+{doc}`modernize-macro-to-enum <../modernize/macro-to-enum>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/narrowing-conversions.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/narrowing-conversions.md
index 135b3b23ee6d1..3ef797e28d808 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/narrowing-conversions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/narrowing-conversions.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - cppcoreguidelines-narrowing-conversions
+```{title} clang-tidy - cppcoreguidelines-narrowing-conversions
+```
-cppcoreguidelines-narrowing-conversions
-=======================================
+# cppcoreguidelines-narrowing-conversions
-This check implements part of `ES.46
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es46-avoid-lossy-narrowing-truncating-arithmetic-conversions>`_
+This check implements part of [ES.46](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es46-avoid-lossy-narrowing-truncating-arithmetic-conversions)
from the C++ Core Guidelines.
The `cppcoreguidelines-narrowing-conversions` check is an alias, please see
-:doc:`bugprone-narrowing-conversions <../bugprone/narrowing-conversions>`
+{doc}`bugprone-narrowing-conversions <../bugprone/narrowing-conversions>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-destructor.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-destructor.md
index d7c861de365c5..580b4168feaf1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-destructor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-destructor.md
@@ -1,11 +1,12 @@
-.. title:: clang-tidy - cppcoreguidelines-noexcept-destructor
+```{title} clang-tidy - cppcoreguidelines-noexcept-destructor
+```
-cppcoreguidelines-noexcept-destructor
-=====================================
+# cppcoreguidelines-noexcept-destructor
-This check implements `C.37 <https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c37-make-destructors-noexcept>`_
+This check implements [C.37](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c37-make-destructors-noexcept)
from the C++ Core Guidelines.
The `cppcoreguidelines-noexcept-destructor` check is an alias, please see
-:doc:`performance-noexcept-destructor <../performance/noexcept-destructor>`
+{doc}`performance-noexcept-destructor <../performance/noexcept-destructor>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md
index e34a5cdcba3a5..86a45039164e7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md
@@ -1,11 +1,12 @@
-.. title:: clang-tidy - cppcoreguidelines-noexcept-move-operations
+```{title} clang-tidy - cppcoreguidelines-noexcept-move-operations
+```
-cppcoreguidelines-noexcept-move-operations
-==========================================
+# cppcoreguidelines-noexcept-move-operations
-This check implements `C.66 <https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c66-make-move-operations-noexcept>`_
+This check implements [C.66](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c66-make-move-operations-noexcept)
from the C++ Core Guidelines.
The `cppcoreguidelines-noexcept-move-operations` check is an alias, please see
-:doc:`performance-noexcept-move-constructor
+{doc}`performance-noexcept-move-constructor
<../performance/noexcept-move-constructor>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md
index e9e95ce527f7f..fb8a9a6d7868b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md
@@ -1,13 +1,14 @@
-.. title:: clang-tidy - cppcoreguidelines-noexcept-swap
+```{title} clang-tidy - cppcoreguidelines-noexcept-swap
+```
-cppcoreguidelines-noexcept-swap
-===============================
+# cppcoreguidelines-noexcept-swap
-This check implements `C.83 <https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c83-for-value-like-types-consider-providing-a-noexcept-swap-function>`_
-, `C.84 <https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c84-a-swap-function-must-not-fail>`_
-and `C.85 <https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c85-make-swap-noexcept>`_
+This check implements [C.83](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c83-for-value-like-types-consider-providing-a-noexcept-swap-function)
+, [C.84](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c84-a-swap-function-must-not-fail)
+and [C.85](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c85-make-swap-noexcept)
from the C++ Core Guidelines.
The `cppcoreguidelines-noexcept-swap check` is an alias, please see
-:doc:`performance-noexcept-swap <../performance/noexcept-swap>`
+{doc}`performance-noexcept-swap <../performance/noexcept-swap>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md
index 5455af4b42ea1..876b2c0d62725 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - cppcoreguidelines-non-private-member-variables-in-classes
+```{title} clang-tidy - cppcoreguidelines-non-private-member-variables-in-classes
+```
-cppcoreguidelines-non-private-member-variables-in-classes
-=========================================================
+# cppcoreguidelines-non-private-member-variables-in-classes
The `cppcoreguidelines-non-private-member-variables-in-classes` check is
-an alias, please see :doc:`misc-non-private-member-variables-in-classes
+an alias, please see {doc}`misc-non-private-member-variables-in-classes
<../misc/non-private-member-variables-in-classes>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-array-to-pointer-decay.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-array-to-pointer-decay.md
index 06de6fcb2c44b..684130fae0bc3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-array-to-pointer-decay.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-array-to-pointer-decay.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-bounds-array-to-pointer-decay
+```{title} clang-tidy - cppcoreguidelines-pro-bounds-array-to-pointer-decay
+```
-cppcoreguidelines-pro-bounds-array-to-pointer-decay
-===================================================
+# cppcoreguidelines-pro-bounds-array-to-pointer-decay
This check flags all array to pointer decays.
-Pointers should not be used as arrays. ``span<T>`` is a bounds-checked, safe
+Pointers should not be used as arrays. `span<T>` is a bounds-checked, safe
alternative to using pointers to access arrays.
-This rule is part of the `Bounds safety (Bounds 3)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-bounds-decay>`_
+This rule is part of the [Bounds safety (Bounds 3)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-bounds-decay)
profile from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md
index 4eddeb489a1db..c847408d56318 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md
@@ -1,29 +1,32 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-bounds-constant-array-index
+```{title} clang-tidy - cppcoreguidelines-pro-bounds-constant-array-index
+```
-cppcoreguidelines-pro-bounds-constant-array-index
-=================================================
+# cppcoreguidelines-pro-bounds-constant-array-index
This check flags all array subscript expressions on static arrays and
-``std::arrays`` that either do not have a constant integer expression index or
-are out of bounds (for ``std::array``). For out-of-bounds checking of static
+`std::arrays` that either do not have a constant integer expression index or
+are out of bounds (for `std::array`). For out-of-bounds checking of static
arrays, see the `-Warray-bounds` Clang diagnostic.
-This rule is part of the `Bounds safety (Bounds 2)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-bounds-arrayindex>`_
+This rule is part of the [Bounds safety (Bounds 2)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-bounds-arrayindex)
profile from the C++ Core Guidelines.
-Optionally, this check can generate fixes using ``gsl::at`` for indexing.
+Optionally, this check can generate fixes using `gsl::at` for indexing.
-Options
--------
+## Options
+```{eval-rst}
.. option:: GslHeader
The check can generate fixes after this option has been set to the name of
the include file that contains ``gsl::at()``, e.g. `"gsl/gsl.h"`.
Default is an empty string.
+```
+```{eval-rst}
.. option:: IncludeStyle
A string specifying which include-style is used, `llvm` or `google`. Default
is `llvm`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md
index 3f020090f8612..b309c2ea2c4f0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md
@@ -1,23 +1,24 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-bounds-pointer-arithmetic
+```{title} clang-tidy - cppcoreguidelines-pro-bounds-pointer-arithmetic
+```
-cppcoreguidelines-pro-bounds-pointer-arithmetic
-===============================================
+# cppcoreguidelines-pro-bounds-pointer-arithmetic
This check flags all usage of pointer arithmetic, because it could lead to an
invalid pointer. Subtraction of two pointers is not flagged by this check.
Pointers should only refer to single objects, and pointer arithmetic is fragile
-and easy to get wrong. ``span<T>`` is a bounds-checked, safe type for accessing
+and easy to get wrong. `span<T>` is a bounds-checked, safe type for accessing
arrays of data.
-This rule is part of the `Bounds safety (Bounds 1)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-bounds-arithmetic>`_
+This rule is part of the [Bounds safety (Bounds 1)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-bounds-arithmetic)
profile from the C++ Core Guidelines.
-Options
--------
+## Options
+```{eval-rst}
.. option:: AllowIncrementDecrementOperators
When enabled, the check will allow using the prefix/postfix increment or
decrement operators on pointers. Default is ``false``.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-cstyle-cast.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-cstyle-cast.md
index a94115e9d5e1c..95d151f32a174 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-cstyle-cast.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-cstyle-cast.md
@@ -1,19 +1,19 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-type-cstyle-cast
+```{title} clang-tidy - cppcoreguidelines-pro-type-cstyle-cast
+```
-cppcoreguidelines-pro-type-cstyle-cast
-======================================
+# cppcoreguidelines-pro-type-cstyle-cast
-This check flags all use of C-style casts that perform a ``static_cast``
-downcast, ``const_cast``, or ``reinterpret_cast``.
+This check flags all use of C-style casts that perform a `static_cast`
+downcast, `const_cast`, or `reinterpret_cast`.
Use of these casts can violate type safety and cause the program to access a
variable that is actually of type X to be accessed as if it were of an
-unrelated type Z. Note that a C-style ``(T)expression`` cast means to perform
-the first of the following that is possible: a ``const_cast``, a
-``static_cast``, a ``static_cast`` followed by a ``const_cast``, a
-``reinterpret_cast``, or a ``reinterpret_cast`` followed by a ``const_cast``.
-This rule bans ``(T)expression`` only when used to perform an unsafe cast.
+unrelated type Z. Note that a C-style `(T)expression` cast means to perform
+the first of the following that is possible: a `const_cast`, a
+`static_cast`, a `static_cast` followed by a `const_cast`, a
+`reinterpret_cast`, or a `reinterpret_cast` followed by a `const_cast`.
+This rule bans `(T)expression` only when used to perform an unsafe cast.
-This rule is part of the `Type safety (Type.4)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-cstylecast>`_
+This rule is part of the [Type safety (Type.4)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-cstylecast)
profile from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-reinterpret-cast.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-reinterpret-cast.md
index c2e4170ed098d..f252acef6f24f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-reinterpret-cast.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-reinterpret-cast.md
@@ -1,14 +1,14 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-type-reinterpret-cast
+```{title} clang-tidy - cppcoreguidelines-pro-type-reinterpret-cast
+```
-cppcoreguidelines-pro-type-reinterpret-cast
-===========================================
+# cppcoreguidelines-pro-type-reinterpret-cast
-This check flags all uses of ``reinterpret_cast`` in C++ code.
+This check flags all uses of `reinterpret_cast` in C++ code.
Use of these casts can violate type safety and cause the program to access a
-variable that is actually of type ``X`` to be accessed as if it were of an
-unrelated type ``Z``.
+variable that is actually of type `X` to be accessed as if it were of an
+unrelated type `Z`.
-This rule is part of the `Type safety (Type.1.1)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-reinterpretcast>`_
+This rule is part of the [Type safety (Type.1.1)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-reinterpretcast)
profile from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md
index 21c014577a003..714e7c6c85287 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md
@@ -1,24 +1,25 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-type-static-cast-downcast
+```{title} clang-tidy - cppcoreguidelines-pro-type-static-cast-downcast
+```
-cppcoreguidelines-pro-type-static-cast-downcast
-===============================================
+# cppcoreguidelines-pro-type-static-cast-downcast
-This check flags all usages of ``static_cast``, where a base class is casted to
+This check flags all usages of `static_cast`, where a base class is casted to
a derived class. In those cases, a fix-it is provided to convert the cast to a
-``dynamic_cast``.
+`dynamic_cast`.
Use of these casts can violate type safety and cause the program to access a
-variable that is actually of type ``X`` to be accessed as if it were of an
-unrelated type ``Z``.
+variable that is actually of type `X` to be accessed as if it were of an
+unrelated type `Z`.
-This rule is part of the `Type safety (Type.2)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-downcast>`_
+This rule is part of the [Type safety (Type.2)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-downcast)
profile from the C++ Core Guidelines.
-Options
--------
+## Options
+```{eval-rst}
.. option:: StrictMode
When set to `false`, no warnings are emitted for casts on non-polymorphic
types. Default is `true`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-union-access.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-union-access.md
index db726a227af31..6457bb51527f9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-union-access.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-union-access.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-type-union-access
+```{title} clang-tidy - cppcoreguidelines-pro-type-union-access
+```
-cppcoreguidelines-pro-type-union-access
-=======================================
+# cppcoreguidelines-pro-type-union-access
This check flags all access to members of unions. Passing unions as a whole is
not flagged.
@@ -12,6 +12,6 @@ had its destructor called. This is fragile because it cannot generally be
enforced to be safe in the language and so relies on programmer discipline to
get it right.
-This rule is part of the `Type safety (Type.7)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-unions>`_
+This rule is part of the [Type safety (Type.7)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-unions)
profile from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-vararg.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-vararg.md
index 09809c25c1447..122fa843316ee 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-vararg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-vararg.md
@@ -1,10 +1,10 @@
-.. title:: clang-tidy - cppcoreguidelines-pro-type-vararg
+```{title} clang-tidy - cppcoreguidelines-pro-type-vararg
+```
-cppcoreguidelines-pro-type-vararg
-=================================
+# cppcoreguidelines-pro-type-vararg
This check flags all calls to c-style vararg functions and all use of
-``va_arg``.
+`va_arg`.
To allow for SFINAE use of vararg functions, a call is not flagged if a literal
0 is passed as the only vararg argument or function is used in unevaluated
@@ -14,6 +14,6 @@ Passing to varargs assumes the correct type will be read. This is fragile
because it cannot generally be enforced to be safe in the language and so
relies on programmer discipline to get it right.
-This rule is part of the `Type safety (Type.8)
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-varargs>`_
+This rule is part of the [Type safety (Type.8)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#pro-type-varargs)
profile from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md
index dd81365638d09..4b390d22e9ee8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md
@@ -1,27 +1,26 @@
-.. title:: clang-tidy - cppcoreguidelines-slicing
+```{title} clang-tidy - cppcoreguidelines-slicing
+```
-cppcoreguidelines-slicing
-=========================
+# cppcoreguidelines-slicing
Flags slicing of member variables or vtable. Slicing happens when copying a
derived object into a base object: the members of the derived object (both
member variables and virtual member functions) will be discarded. This can be
misleading especially for member function slicing, for example:
-.. code-block:: c++
+```c++
+struct B { int a; virtual int f(); };
+struct D : B { int b; int f() override; };
- struct B { int a; virtual int f(); };
- struct D : B { int b; int f() override; };
+void use(B b) { // Missing reference, intended?
+ b.f(); // Calls B::f.
+}
- void use(B b) { // Missing reference, intended?
- b.f(); // Calls B::f.
- }
+D d;
+use(d); // Slice.
+```
- D d;
- use(d); // Slice.
-
-This check implements `ES.63
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es63-dont-slice>`_
-and `C.145
-<https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c145-access-polymorphic-objects-through-pointers-and-references>`_
+This check implements [ES.63](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es63-dont-slice)
+and [C.145](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c145-access-polymorphic-objects-through-pointers-and-references)
from the C++ Core Guidelines.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/use-default-member-init.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/use-default-member-init.md
index 8a11f737678e6..7c2307ed913e7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/use-default-member-init.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/use-default-member-init.md
@@ -1,11 +1,12 @@
-.. title:: clang-tidy - cppcoreguidelines-use-default-member-init
+```{title} clang-tidy - cppcoreguidelines-use-default-member-init
+```
-cppcoreguidelines-use-default-member-init
-=========================================
+# cppcoreguidelines-use-default-member-init
-This check implements `C.48 <https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#rc-in-class-initializer>`_
+This check implements [C.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#rc-in-class-initializer)
from the C++ Core Guidelines.
The `cppcoreguidelines-use-default-member-init` check is an alias, please see
-:doc:`modernize-use-default-member-init <../modernize/use-default-member-init>`
+{doc}`modernize-use-default-member-init <../modernize/use-default-member-init>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/darwin/avoid-spinlock.md b/clang-tools-extra/docs/clang-tidy/checks/darwin/avoid-spinlock.md
index 96248924cd9af..fdc5d0fa1abc1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/darwin/avoid-spinlock.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/darwin/avoid-spinlock.md
@@ -1,15 +1,16 @@
-.. title:: clang-tidy - darwin-avoid-spinlock
+```{title} clang-tidy - darwin-avoid-spinlock
+```
-darwin-avoid-spinlock
-=====================
+# darwin-avoid-spinlock
-Finds usages of ``OSSpinlock``, which is deprecated due to potential livelock
+Finds usages of `OSSpinlock`, which is deprecated due to potential livelock
problems.
This check will detect following function invocations:
-- ``OSSpinlockLock``
-- ``OSSpinlockTry``
-- ``OSSpinlockUnlock``
+- `OSSpinlockLock`
+- `OSSpinlockTry`
+- `OSSpinlockUnlock`
+
+The corresponding information about the problem of `OSSpinlock`: <https://blog.postmates.com/why-spinlocks-are-bad-on-ios-b69fc5221058>
-The corresponding information about the problem of ``OSSpinlock``: https://blog.postmates.com/why-spinlocks-are-bad-on-ios-b69fc5221058
diff --git a/clang-tools-extra/docs/clang-tidy/checks/darwin/dispatch-once-nonstatic.md b/clang-tools-extra/docs/clang-tidy/checks/darwin/dispatch-once-nonstatic.md
index 4506bfff2cf27..20ca6c99c2a62 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/darwin/dispatch-once-nonstatic.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/darwin/dispatch-once-nonstatic.md
@@ -1,22 +1,23 @@
-.. title:: clang-tidy - darwin-dispatch-once-nonstatic
+```{title} clang-tidy - darwin-dispatch-once-nonstatic
+```
-darwin-dispatch-once-nonstatic
-==============================
+# darwin-dispatch-once-nonstatic
-Finds declarations of ``dispatch_once_t`` variables without static or global
-storage. The behavior of using ``dispatch_once_t`` predicates with automatic or
+Finds declarations of `dispatch_once_t` variables without static or global
+storage. The behavior of using `dispatch_once_t` predicates with automatic or
dynamic storage is undefined by libdispatch, and should be avoided.
It is a common pattern to have functions initialize internal static or global
data once when the function runs, but programmers have been known to miss the
-static on the ``dispatch_once_t`` predicate, leading to an uninitialized flag
+static on the `dispatch_once_t` predicate, leading to an uninitialized flag
value at the mercy of the stack.
-Programmers have also been known to make ``dispatch_once_t`` variables be
+Programmers have also been known to make `dispatch_once_t` variables be
members of structs or classes, with the intent to lazily perform some expensive
struct or class member initialization only once; however, this violates the
libdispatch requirements.
See the discussion section of
-`Apple's dispatch_once documentation <https://developer.apple.com/documentation/dispatch/1447169-dispatch_once>`_
+[Apple's dispatch_once documentation](https://developer.apple.com/documentation/dispatch/1447169-dispatch_once)
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md
index e2b91c2be163a..1c9c0190cd9b7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md
@@ -1,22 +1,23 @@
-.. title:: clang-tidy - fuchsia-default-arguments-calls
+```{title} clang-tidy - fuchsia-default-arguments-calls
+```
-fuchsia-default-arguments-calls
-===============================
+# fuchsia-default-arguments-calls
Warns if a function or method is called with default arguments.
For example, given the declaration:
-.. code-block:: c++
-
- int foo(int value = 5) { return value; }
+```c++
+int foo(int value = 5) { return value; }
+```
A function call expression that uses a default argument will be diagnosed.
Calling it without defaults will not cause a warning:
-.. code-block:: c++
+```c++
+foo(); // warning
+foo(0); // no warning
+```
- foo(); // warning
- foo(0); // no warning
+See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-See the features disallowed in Fuchsia at https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md
index 85e5de2b14bd7..97037510404dc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md
@@ -1,16 +1,17 @@
-.. title:: clang-tidy - fuchsia-default-arguments-declarations
+```{title} clang-tidy - fuchsia-default-arguments-declarations
+```
-fuchsia-default-arguments-declarations
-======================================
+# fuchsia-default-arguments-declarations
Warns if a function or method is declared with default parameters.
For example, the declaration:
-.. code-block:: c++
-
- int foo(int value = 5) { return value; }
+```c++
+int foo(int value = 5) { return value; }
+```
will cause a warning.
-See the features disallowed in Fuchsia at https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en
+See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md
index f2e14c62a2a11..fb0fec670f56a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - fuchsia-header-anon-namespaces
+```{title} clang-tidy - fuchsia-header-anon-namespaces
+```
-fuchsia-header-anon-namespaces
-==============================
+# fuchsia-header-anon-namespaces
The `fuchsia-header-anon-namespaces` check is an alias, please see
-:doc:`misc-anonymous-namespace-in-header
+{doc}`misc-anonymous-namespace-in-header
<../misc/anonymous-namespace-in-header>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/multiple-inheritance.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/multiple-inheritance.md
index c5ae6a2efb2cb..eaafab5b8d392 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/multiple-inheritance.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/multiple-inheritance.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - fuchsia-multiple-inheritance
+```{title} clang-tidy - fuchsia-multiple-inheritance
+```
-fuchsia-multiple-inheritance
-============================
+# fuchsia-multiple-inheritance
The `fuchsia-multiple-inheritance` check is an alias, please See
-:doc:`misc-multiple-inheritance <../misc/multiple-inheritance>` for details.
+{doc}`misc-multiple-inheritance <../misc/multiple-inheritance>` for details.
+
+See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-See the features disallowed in Fuchsia at https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md
index 48d2940b99ef5..aa2f9d1fc254f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md
@@ -1,18 +1,19 @@
-.. title:: clang-tidy - fuchsia-overloaded-operator
+```{title} clang-tidy - fuchsia-overloaded-operator
+```
-fuchsia-overloaded-operator
-===========================
+# fuchsia-overloaded-operator
Warns if an operator is overloaded, except for the assignment (copy and move)
operators.
For example:
-.. code-block:: c++
+```c++
+int operator+(int); // Warning
- int operator+(int); // Warning
+B &operator=(const B &Other); // No warning
+B &operator=(B &&Other) // No warning
+```
- B &operator=(const B &Other); // No warning
- B &operator=(B &&Other) // No warning
+See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-See the features disallowed in Fuchsia at https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md
index 2d01f7a0027da..bb17ab0ab3d28 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md
@@ -1,14 +1,15 @@
-.. title:: clang-tidy - fuchsia-virtual-inheritance
+```{title} clang-tidy - fuchsia-virtual-inheritance
+```
-fuchsia-virtual-inheritance
-===========================
+# fuchsia-virtual-inheritance
Warns if classes are defined with virtual inheritance.
For example, classes should not be defined with virtual inheritance:
-.. code-block:: c++
+```c++
+class B : public virtual A {}; // warning
+```
- class B : public virtual A {}; // warning
+See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-See the features disallowed in Fuchsia at https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/build-explicit-make-pair.md b/clang-tools-extra/docs/clang-tidy/checks/google/build-explicit-make-pair.md
index e3e9eeb0e973e..565dfea44eaae 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/build-explicit-make-pair.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/build-explicit-make-pair.md
@@ -1,11 +1,12 @@
-.. title:: clang-tidy - google-build-explicit-make-pair
+```{title} clang-tidy - google-build-explicit-make-pair
+```
-google-build-explicit-make-pair
-===============================
+# google-build-explicit-make-pair
-Check that ``make_pair``'s template arguments are deduced.
+Check that `make_pair`'s template arguments are deduced.
-G++ 4.6 in C++11 mode fails badly if ``make_pair``'s template arguments are
+G++ 4.6 in C++11 mode fails badly if `make_pair`'s template arguments are
specified explicitly, and such use isn't intended in any case.
Corresponding cpplint.py check name: `build/explicit_make_pair`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md b/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md
index a1a1041b7d57d..f9986e7e30b85 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md
@@ -1,15 +1,16 @@
-.. title:: clang-tidy - google-build-namespaces
+```{title} clang-tidy - google-build-namespaces
+```
-google-build-namespaces
-=======================
+# google-build-namespaces
The `google-build-namespaces` check is an alias, please see
-:doc:`misc-anonymous-namespace-in-header
+{doc}`misc-anonymous-namespace-in-header
<../misc/anonymous-namespace-in-header>`
for more information.
Finds anonymous namespaces in headers.
-https://google.github.io/styleguide/cppguide.html#Namespaces
+<https://google.github.io/styleguide/cppguide.html#Namespaces>
Corresponding cpplint.py check name: `build/namespaces`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md
index 64ad9bda40840..fb4f8046ba98a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md
@@ -1,19 +1,20 @@
-.. title:: clang-tidy - google-build-using-namespace
+```{title} clang-tidy - google-build-using-namespace
+```
-google-build-using-namespace
-============================
+# google-build-using-namespace
-Finds ``using namespace`` directives.
+Finds `using namespace` directives.
The check implements the following rule of the
-`Google C++ Style Guide <https://google.github.io/styleguide/cppguide.html#Namespaces>`_:
+[Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html#Namespaces):
- You may not use a using-directive to make all names from a namespace
- available.
+> You may not use a using-directive to make all names from a namespace
+> available.
-.. code-block:: c++
-
- // Forbidden -- This pollutes the namespace.
- using namespace foo;
+```c++
+// Forbidden -- This pollutes the namespace.
+using namespace foo;
+```
Corresponding cpplint.py check name: `build/namespaces`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/default-arguments.md b/clang-tools-extra/docs/clang-tidy/checks/google/default-arguments.md
index c02099c6ed1ef..a4db990d6ba6a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/default-arguments.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/default-arguments.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - google-default-arguments
+```{title} clang-tidy - google-default-arguments
+```
-google-default-arguments
-========================
+# google-default-arguments
Checks that default arguments are not given for virtual methods.
-See https://google.github.io/styleguide/cppguide.html#Default_Arguments
+See <https://google.github.io/styleguide/cppguide.html#Default_Arguments>
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/explicit-constructor.md b/clang-tools-extra/docs/clang-tidy/checks/google/explicit-constructor.md
index c86fdccd5e6dc..91238073e0c42 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/explicit-constructor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/explicit-constructor.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - google-explicit-constructor
+```{title} clang-tidy - google-explicit-constructor
+```
-google-explicit-constructor
-===========================
+# google-explicit-constructor
This check is an alias for
-:doc:`misc-explicit-constructor <../misc/explicit-constructor>`.
+{doc}`misc-explicit-constructor <../misc/explicit-constructor>`.
+
+See <https://google.github.io/styleguide/cppguide.html#Explicit_Constructors>
-See https://google.github.io/styleguide/cppguide.html#Explicit_Constructors
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/global-names-in-headers.md b/clang-tools-extra/docs/clang-tidy/checks/google/global-names-in-headers.md
index 4a071a9dc163a..34db79d57961b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/global-names-in-headers.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/global-names-in-headers.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - google-global-names-in-headers
+```{title} clang-tidy - google-global-names-in-headers
+```
-google-global-names-in-headers
-==============================
+# google-global-names-in-headers
Flag global namespace pollution in header files. Right now it only triggers on
-``using`` declarations and directives.
+`using` declarations and directives.
The relevant style guide section is
-https://google.github.io/styleguide/cppguide.html#Namespaces.
+<https://google.github.io/styleguide/cppguide.html#Namespaces>.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/objc-avoid-nsobject-new.md b/clang-tools-extra/docs/clang-tidy/checks/google/objc-avoid-nsobject-new.md
index 4eae4470c872b..9cfa91e68860f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/objc-avoid-nsobject-new.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/objc-avoid-nsobject-new.md
@@ -1,29 +1,29 @@
-.. title:: clang-tidy - google-objc-avoid-nsobject-new
+```{title} clang-tidy - google-objc-avoid-nsobject-new
+```
-google-objc-avoid-nsobject-new
-==============================
+# google-objc-avoid-nsobject-new
-Finds calls to ``+new`` or overrides of it, which are prohibited by the
+Finds calls to `+new` or overrides of it, which are prohibited by the
Google Objective-C style guide.
-The Google Objective-C style guide forbids calling ``+new`` or overriding it in
-class implementations, preferring ``+alloc`` and ``-init`` methods to
+The Google Objective-C style guide forbids calling `+new` or overriding it in
+class implementations, preferring `+alloc` and `-init` methods to
instantiate objects.
An example:
-.. code-block:: objc
+```objc
+NSDate *now = [NSDate new];
+Foo *bar = [Foo new];
+```
- NSDate *now = [NSDate new];
- Foo *bar = [Foo new];
+Instead, code should use `+alloc`/`-init` or class factory methods.
-Instead, code should use ``+alloc``/``-init`` or class factory methods.
-
-.. code-block:: objc
-
- NSDate *now = [NSDate date];
- Foo *bar = [[Foo alloc] init];
+```objc
+NSDate *now = [NSDate date];
+Foo *bar = [[Foo alloc] init];
+```
This check corresponds to the Google Objective-C Style Guide rule
-`Do Not Use +new
-<https://google.github.io/styleguide/objcguide.html#do-not-use-new>`_.
+[Do Not Use +new](https://google.github.io/styleguide/objcguide.html#do-not-use-new).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/objc-function-naming.md b/clang-tools-extra/docs/clang-tidy/checks/google/objc-function-naming.md
index 6a4043c0ec1e8..976503fcdb17c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/objc-function-naming.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/objc-function-naming.md
@@ -1,27 +1,28 @@
-.. title:: clang-tidy - google-objc-function-naming
+```{title} clang-tidy - google-objc-function-naming
+```
-google-objc-function-naming
-===========================
+# google-objc-function-naming
Finds function declarations in Objective-C files that do not follow the pattern
described in the Google Objective-C Style Guide.
The corresponding style guide rule can be found here:
-https://google.github.io/styleguide/objcguide.html#function-names
+<https://google.github.io/styleguide/objcguide.html#function-names>
All function names should be in Pascal case. Functions whose storage class is
not static should have an appropriate prefix.
The following code sample does not follow this pattern:
-.. code-block:: objc
-
- static bool is_positive(int i) { return i > 0; }
- bool IsNegative(int i) { return i < 0; }
+```objc
+static bool is_positive(int i) { return i > 0; }
+bool IsNegative(int i) { return i < 0; }
+```
The sample above might be corrected to the following code:
-.. code-block:: objc
+```objc
+static bool IsPositive(int i) { return i > 0; }
+bool *ABCIsNegative(int i) { return i < 0; }
+```
- static bool IsPositive(int i) { return i > 0; }
- bool *ABCIsNegative(int i) { return i < 0; }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md
index 545783e23165a..8c6a14e809048 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md
@@ -1,9 +1,10 @@
-.. title:: clang-tidy - google-readability-braces-around-statements
+```{title} clang-tidy - google-readability-braces-around-statements
+```
-google-readability-braces-around-statements
-===========================================
+# google-readability-braces-around-statements
The `google-readability-braces-around-statements` check is an alias, please see
-:doc:`readability-braces-around-statements
+{doc}`readability-braces-around-statements
<../readability/braces-around-statements>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-casting.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-casting.md
index 77983c400053d..0337e9f5281bd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-casting.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-casting.md
@@ -1,14 +1,15 @@
-.. title:: clang-tidy - google-readability-casting
+```{title} clang-tidy - google-readability-casting
+```
-google-readability-casting
-==========================
+# google-readability-casting
The `google-readability-casting` check is an alias, please see
-:doc:`modernize-avoid-c-style-cast <../modernize/avoid-c-style-cast>`
+{doc}`modernize-avoid-c-style-cast <../modernize/avoid-c-style-cast>`
for more information.
Finds usages of C-style casts.
-https://google.github.io/styleguide/cppguide.html#Casting
+<https://google.github.io/styleguide/cppguide.html#Casting>
Corresponding cpplint.py check name: `readability/casting`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-function-size.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-function-size.md
index eaa650ca4af0b..4310623c17ef8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-function-size.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-function-size.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - google-readability-function-size
+```{title} clang-tidy - google-readability-function-size
+```
-google-readability-function-size
-================================
+# google-readability-function-size
The `google-readability-function-size` check is an alias, please see
-:doc:`readability-function-size <../readability/function-size>` for more
+{doc}`readability-function-size <../readability/function-size>` for more
information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md
index 4a1abdd832f11..3ad55fd0f289c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md
@@ -1,7 +1,8 @@
-.. title:: clang-tidy - google-readability-namespace-comments
+```{title} clang-tidy - google-readability-namespace-comments
+```
-google-readability-namespace-comments
-=====================================
+# google-readability-namespace-comments
The `google-readability-namespace-comments check` is an alias, please see
-:doc:`llvm-namespace-comment <../llvm/namespace-comment>` for more information.
+{doc}`llvm-namespace-comment <../llvm/namespace-comment>` for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md
index fccfa81166436..ed3b1188050fb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md
@@ -1,18 +1,18 @@
-.. title:: clang-tidy - google-readability-todo
+```{title} clang-tidy - google-readability-todo
+```
-google-readability-todo
-=======================
+# google-readability-todo
Finds TODO comments without a username or bug number.
The relevant style guide section is
-https://google.github.io/styleguide/cppguide.html#TODO_Comments.
+<https://google.github.io/styleguide/cppguide.html#TODO_Comments>.
Corresponding cpplint.py check: `readability/todo`
-Options
--------
+## Options
+```{eval-rst}
.. option:: Style
A string specifying the TODO style for fix-it hints. Accepted values are
@@ -20,3 +20,5 @@ Options
* `Hyphen` will format the fix-it as: ``// TODO: username - details``.
* `Parentheses` will format the fix-it as: ``// TODO(username): details``.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-float.md b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-float.md
index 4b853ad56021d..a48376ec0b484 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-float.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-float.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - google-runtime-float
+```{title} clang-tidy - google-runtime-float
+```
-google-runtime-float
-====================
+# google-runtime-float
-Finds uses of ``long double`` and suggests against their use due to lack of
+Finds uses of `long double` and suggests against their use due to lack of
portability.
The corresponding style guide rule:
-https://google.github.io/styleguide/cppguide.html#Floating-Point_Types
+<https://google.github.io/styleguide/cppguide.html#Floating-Point_Types>
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md
index 21a30e620758e..191859d911a1e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md
@@ -1,27 +1,33 @@
-.. title:: clang-tidy - google-runtime-int
+```{title} clang-tidy - google-runtime-int
+```
-google-runtime-int
-==================
+# google-runtime-int
-Finds uses of ``short``, ``long`` and ``long long`` and suggest replacing them
-with ``u?intXX(_t)?``.
+Finds uses of `short`, `long` and `long long` and suggest replacing them
+with `u?intXX(_t)?`.
The corresponding style guide rule:
-https://google.github.io/styleguide/cppguide.html#Integer_Types.
+<https://google.github.io/styleguide/cppguide.html#Integer_Types>.
Corresponding cpplint.py check: `runtime/int`.
-Options
--------
+## Options
+```{eval-rst}
.. option:: UnsignedTypePrefix
A string specifying the unsigned type prefix. Default is `uint`.
+```
+```{eval-rst}
.. option:: SignedTypePrefix
A string specifying the signed type prefix. Default is `int`.
+```
+```{eval-rst}
.. option:: TypeSuffix
A string specifying the type suffix. Default is an empty string.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-operator.md b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-operator.md
index 67f2993005017..6d816df773252 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-operator.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - google-runtime-operator
+```{title} clang-tidy - google-runtime-operator
+```
-google-runtime-operator
-=======================
+# google-runtime-operator
-Finds overloads of unary ``operator &``.
+Finds overloads of unary `operator &`.
-https://google.github.io/styleguide/cppguide.html#Operator_Overloading
+<https://google.github.io/styleguide/cppguide.html#Operator_Overloading>
Corresponding cpplint.py check name: `runtime/operator`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/linuxkernel/must-check-errs.md b/clang-tools-extra/docs/clang-tidy/checks/linuxkernel/must-check-errs.md
index 6a4b743665964..f0e9cfb101e6d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/linuxkernel/must-check-errs.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/linuxkernel/must-check-errs.md
@@ -1,28 +1,29 @@
-.. title:: clang-tidy - linuxkernel-must-check-errs
+```{title} clang-tidy - linuxkernel-must-check-errs
+```
-linuxkernel-must-check-errs
-===========================
+# linuxkernel-must-check-errs
Checks Linux kernel code to see if it uses the results from the functions in
-``linux/err.h``. Also checks to see if code uses the results from functions
+`linux/err.h`. Also checks to see if code uses the results from functions
that directly return a value from one of these error functions.
-This is important in the Linux kernel because ``ERR_PTR``, ``PTR_ERR``,
-``IS_ERR``, ``IS_ERR_OR_NULL``, ``ERR_CAST``, and ``PTR_ERR_OR_ZERO`` return
+This is important in the Linux kernel because `ERR_PTR`, `PTR_ERR`,
+`IS_ERR`, `IS_ERR_OR_NULL`, `ERR_CAST`, and `PTR_ERR_OR_ZERO` return
values must be checked, since positive pointers and negative error codes are
being used in the same context. These functions are marked with
-``__attribute__((warn_unused_result))``, but some kernel versions do not have
+`__attribute__((warn_unused_result))`, but some kernel versions do not have
this warning enabled for clang.
Examples:
-.. code-block:: c
+```c
+/* Trivial unused call to an ERR function */
+PTR_ERR_OR_ZERO(some_function_call());
- /* Trivial unused call to an ERR function */
- PTR_ERR_OR_ZERO(some_function_call());
+/* A function that returns ERR_PTR. */
+void *fn() { ERR_PTR(-EINVAL); }
- /* A function that returns ERR_PTR. */
- void *fn() { ERR_PTR(-EINVAL); }
+/* An invalid use of fn. */
+fn();
+```
- /* An invalid use of fn. */
- fn();
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/else-after-return.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/else-after-return.md
index 95ffa62638ea5..c162fb97ffcc4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/else-after-return.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/else-after-return.md
@@ -1,9 +1,9 @@
-.. title:: clang-tidy - llvm-else-after-return
+```{title} clang-tidy - llvm-else-after-return
+```
-llvm-else-after-return
-======================
+# llvm-else-after-return
The `llvm-else-after-return` check is an alias, please see
-:doc:`readability-else-after-return <../readability/else-after-return>`
+{doc}`readability-else-after-return <../readability/else-after-return>`
for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/header-guard.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/header-guard.md
index 74eb10ba6fcf9..43fbe6a9d2843 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/header-guard.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/header-guard.md
@@ -1,6 +1,7 @@
-.. title:: clang-tidy - llvm-header-guard
+```{title} clang-tidy - llvm-header-guard
+```
-llvm-header-guard
-=================
+# llvm-header-guard
Finds and fixes header guards that do not adhere to LLVM style.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/include-order.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/include-order.md
index 8a215b8e63fa0..22ea984331bae 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/include-order.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/include-order.md
@@ -1,9 +1,9 @@
-.. title:: clang-tidy - llvm-include-order
+```{title} clang-tidy - llvm-include-order
+```
-llvm-include-order
-==================
+# llvm-include-order
+Checks the correct order of `#includes`.
-Checks the correct order of ``#includes``.
+See <https://llvm.org/docs/CodingStandards.html#include-style>
-See https://llvm.org/docs/CodingStandards.html#include-style
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md
index 5d78a188ebc93..1ce5d8316f285 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md
@@ -1,27 +1,27 @@
-.. title:: clang-tidy - llvm-prefer-register-over-unsigned
+```{title} clang-tidy - llvm-prefer-register-over-unsigned
+```
-llvm-prefer-register-over-unsigned
-==================================
+# llvm-prefer-register-over-unsigned
-Finds historical use of ``unsigned`` to hold vregs and physregs and rewrites
-them to use ``Register``.
+Finds historical use of `unsigned` to hold vregs and physregs and rewrites
+them to use `Register`.
Currently this works by finding all variables of unsigned integer type whose
-initializer begins with an implicit cast from ``Register`` to ``unsigned``.
+initializer begins with an implicit cast from `Register` to `unsigned`.
-.. code-block:: c++
-
- void example(MachineOperand &MO) {
- unsigned Reg = MO.getReg();
- ...
- }
+```c++
+void example(MachineOperand &MO) {
+ unsigned Reg = MO.getReg();
+ ...
+}
+```
becomes:
-.. code-block:: c++
-
- void example(MachineOperand &MO) {
- Register Reg = MO.getReg();
- ...
- }
+```c++
+void example(MachineOperand &MO) {
+ Register Reg = MO.getReg();
+ ...
+}
+```
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/qualified-auto.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/qualified-auto.md
index e5dc836b71b86..5751071b905eb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/qualified-auto.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/qualified-auto.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - llvm-qualified-auto
+```{title} clang-tidy - llvm-qualified-auto
+```
-llvm-qualified-auto
-===================
+# llvm-qualified-auto
The `llvm-qualified-auto check` is an alias, please see
-:doc:`readability-qualified-auto <../readability/qualified-auto>`
+{doc}`readability-qualified-auto <../readability/qualified-auto>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md
index dc1989dc61176..80e17a0a23111 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md
@@ -1,21 +1,20 @@
-.. title:: clang-tidy - llvm-use-new-mlir-op-builder
+```{title} clang-tidy - llvm-use-new-mlir-op-builder
+```
-llvm-mlir-op-builder
-====================
+# llvm-mlir-op-builder
-Checks for uses of MLIR's old/to be deprecated ``OpBuilder::create<T>`` form
-and suggests using ``T::create`` instead.
+Checks for uses of MLIR's old/to be deprecated `OpBuilder::create<T>` form
+and suggests using `T::create` instead.
-Example
--------
-
-.. code-block:: c++
-
- builder.create<FooOp>(builder.getUnknownLoc(), "baz");
+## Example
+```c++
+builder.create<FooOp>(builder.getUnknownLoc(), "baz");
+```
Transforms to:
-.. code-block:: c++
+```c++
+FooOp::create(builder, builder.getUnknownLoc(), "baz");
+```
- FooOp::create(builder, builder.getUnknownLoc(), "baz");
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md
index ba742b5e1cab5..cb4530fef4bf7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md
@@ -1,28 +1,29 @@
-.. title:: clang-tidy - llvmlibc-callee-namespace
+```{title} clang-tidy - llvmlibc-callee-namespace
+```
-llvmlibc-callee-namespace
-====================================
+# llvmlibc-callee-namespace
Checks all calls resolve to functions within correct namespace.
-.. code-block:: c++
+```c++
+// Implementation inside the LIBC_NAMESPACE namespace.
+// Correct if:
+// - LIBC_NAMESPACE is a macro
+// - LIBC_NAMESPACE expansion starts with `__llvm_libc`
+namespace LIBC_NAMESPACE {
- // Implementation inside the LIBC_NAMESPACE namespace.
- // Correct if:
- // - LIBC_NAMESPACE is a macro
- // - LIBC_NAMESPACE expansion starts with `__llvm_libc`
- namespace LIBC_NAMESPACE {
+// Allow calls with the fully qualified name.
+LIBC_NAMESPACE::strlen("hello");
- // Allow calls with the fully qualified name.
- LIBC_NAMESPACE::strlen("hello");
+// Allow calls to compiler provided functions.
+(void)__builtin_abs(-1);
- // Allow calls to compiler provided functions.
- (void)__builtin_abs(-1);
+// Bare calls are allowed as long as they resolve to the correct namespace.
+strlen("world");
- // Bare calls are allowed as long as they resolve to the correct namespace.
- strlen("world");
+// Disallow calling into functions in the global namespace.
+::strlen("!");
- // Disallow calling into functions in the global namespace.
- ::strlen("!");
+} // namespace LIBC_NAMESPACE
+```
- } // namespace LIBC_NAMESPACE
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/inline-function-decl.md b/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/inline-function-decl.md
index 71d963969005b..22bf87703af57 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/inline-function-decl.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/inline-function-decl.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - llvmlibc-inline-function-decl
+```{title} clang-tidy - llvmlibc-inline-function-decl
+```
-llvmlibc-inline-function-decl
-=============================
+# llvmlibc-inline-function-decl
Checks that all implicitly and explicitly inline functions in header files are
-tagged with the ``LIBC_INLINE`` macro, except for functions implicit to classes
+tagged with the `LIBC_INLINE` macro, except for functions implicit to classes
or deleted functions.
-See the `libc style guide <https://libc.llvm.org/dev/code_style.html>`_ for more
+See the [libc style guide](https://libc.llvm.org/dev/code_style.html) for more
information about this macro.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/anonymous-namespace-in-header.md b/clang-tools-extra/docs/clang-tidy/checks/misc/anonymous-namespace-in-header.md
index 447a6975157b3..6bd0763e09da6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/anonymous-namespace-in-header.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/anonymous-namespace-in-header.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - misc-anonymous-namespace-in-header
+```{title} clang-tidy - misc-anonymous-namespace-in-header
+```
-misc-anonymous-namespace-in-header
-==================================
+# misc-anonymous-namespace-in-header
Finds anonymous namespaces in headers.
@@ -10,11 +10,10 @@ violations because each translation unit including the header will get its
own unique version of the symbols. This increases binary size and can cause
confusing link-time errors.
-References
-----------
+## References
This check corresponds to the CERT C++ Coding Standard rule
-`DCL59-CPP. Do not define an unnamed namespace in a header file
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl59-cpp/>`_.
+[DCL59-CPP. Do not define an unnamed namespace in a header file](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl59-cpp/).
Corresponding cpplint.py check name: `build/namespaces`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/confusable-identifiers.md b/clang-tools-extra/docs/clang-tidy/checks/misc/confusable-identifiers.md
index 1b2d961278356..7be09af2e5bf4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/confusable-identifiers.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/confusable-identifiers.md
@@ -1,15 +1,16 @@
-.. title:: clang-tidy - misc-confusable-identifiers
+```{title} clang-tidy - misc-confusable-identifiers
+```
-misc-confusable-identifiers
-===========================
+# misc-confusable-identifiers
Warn about confusable identifiers, i.e. identifiers that are visually close to
each other, but use different Unicode characters. This detects a potential
-attack described in `CVE-2021-42574 <https://www.cve.org/CVERecord?id=CVE-2021-42574>`_.
+attack described in [CVE-2021-42574](https://www.cve.org/CVERecord?id=CVE-2021-42574).
Example:
-.. code-block:: text
+```text
+int fo; // Initial character is U+0066 (LATIN SMALL LETTER F).
+int 𝐟o; // Initial character is U+1D41F (MATHEMATICAL BOLD SMALL F) not U+0066 (LATIN SMALL LETTER F).
+```
- int fo; // Initial character is U+0066 (LATIN SMALL LETTER F).
- int 𝐟o; // Initial character is U+1D41F (MATHEMATICAL BOLD SMALL F) not U+0066 (LATIN SMALL LETTER F).
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md b/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md
index e9bc19a4b10e1..29ddfea0a3ef6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md
@@ -1,21 +1,22 @@
-.. title:: clang-tidy - misc-misleading-bidirectional
+```{title} clang-tidy - misc-misleading-bidirectional
+```
-misc-misleading-bidirectional
-=============================
+# misc-misleading-bidirectional
Warns about unterminated bidirectional unicode sequence, detecting potential attack
-as described in the `Trojan Source <https://www.trojansource.codes>`_ attack.
+as described in the [Trojan Source](https://www.trojansource.codes) attack.
Example:
-.. code-block:: c++
+```c++
+#include <iostream>
- #include <iostream>
+int main() {
+ bool isAdmin = false;
+ /* } if (isAdmin) begin admins only */
+ std::cout << "You are an admin.\n";
+ /* end admins only { */
+ return 0;
+}
+```
- int main() {
- bool isAdmin = false;
- /* } if (isAdmin) begin admins only */
- std::cout << "You are an admin.\n";
- /* end admins only { */
- return 0;
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-identifier.md b/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-identifier.md
index 5941d1ca9b9c0..196f9a2b7868a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-identifier.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-identifier.md
@@ -1,23 +1,24 @@
-.. title:: clang-tidy - misc-misleading-identifier
+```{title} clang-tidy - misc-misleading-identifier
+```
-misc-misleading-identifier
-==========================
+# misc-misleading-identifier
Finds identifiers that contain Unicode characters with right-to-left direction,
which can be confusing as they may change the understanding of a whole
-statement line, as described in `Trojan Source <https://trojansource.codes>`_.
+statement line, as described in [Trojan Source](https://trojansource.codes).
An example of such misleading code follows:
-.. code-block:: text
+```text
+#include <stdio.h>
- #include <stdio.h>
+short int א = (short int)0;
+short int ג = (short int)12345;
- short int א = (short int)0;
- short int ג = (short int)12345;
+int main() {
+ int א = ג; // a local variable, set to zero?
+ printf("ג is %d\n", ג);
+ printf("א is %d\n", א);
+}
+```
- int main() {
- int א = ג; // a local variable, set to zero?
- printf("ג is %d\n", ג);
- printf("א is %d\n", א);
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md b/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md
index 3b21a87069863..d9c5e6a001635 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md
@@ -1,25 +1,26 @@
-.. title:: clang-tidy - misc-misplaced-const
+```{title} clang-tidy - misc-misplaced-const
+```
-misc-misplaced-const
-====================
+# misc-misplaced-const
-This check diagnoses when a ``const`` qualifier is applied to a ``typedef``/
-``using`` to a pointer type rather than to the pointee, because such constructs
-are often misleading to developers because the ``const`` applies to the pointer
+This check diagnoses when a `const` qualifier is applied to a `typedef`/
+`using` to a pointer type rather than to the pointee, because such constructs
+are often misleading to developers because the `const` applies to the pointer
rather than the pointee.
-For instance, in the following code, the resulting type is ``int * const``
-rather than ``const int *``:
+For instance, in the following code, the resulting type is `int * const`
+rather than `const int *`:
-.. code-block:: c++
+```c++
+typedef int *int_ptr;
+void f(const int_ptr ptr) {
+ *ptr = 0; // potentially quite unexpectedly the int can be modified here
+ ptr = 0; // does not compile
+}
+```
- typedef int *int_ptr;
- void f(const int_ptr ptr) {
- *ptr = 0; // potentially quite unexpectedly the int can be modified here
- ptr = 0; // does not compile
- }
-
-The check does not diagnose when the underlying ``typedef``/``using`` type is a
-pointer to a ``const`` type or a function pointer type. This is because the
-``const`` qualifier is less likely to be mistaken because it would be redundant
+The check does not diagnose when the underlying `typedef`/`using` type is a
+pointer to a `const` type or a function pointer type. This is because the
+`const` qualifier is less likely to be mistaken because it would be redundant
(or disallowed) on the underlying pointee type.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/new-delete-overloads.md b/clang-tools-extra/docs/clang-tidy/checks/misc/new-delete-overloads.md
index b8555b5a42f26..0b1afe0c5ee24 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/new-delete-overloads.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/new-delete-overloads.md
@@ -1,19 +1,19 @@
-.. title:: clang-tidy - misc-new-delete-overloads
+```{title} clang-tidy - misc-new-delete-overloads
+```
-misc-new-delete-overloads
-=========================
+# misc-new-delete-overloads
`cert-dcl54-cpp` redirects here as an alias for this check.
-The check flags overloaded operator ``new()`` and operator ``delete()``
+The check flags overloaded operator `new()` and operator `delete()`
functions that do not have a corresponding free store function defined within
the same scope.
For instance, the check will flag a class implementation of a non-placement
-operator ``new()`` when the class does not also define a non-placement operator
-``delete()`` function as well.
+operator `new()` when the class does not also define a non-placement operator
+`delete()` function as well.
The check does not flag implicitly-defined operators, deleted or private
operators, or placement operators.
-This check corresponds to CERT C++ Coding Standard rule `DCL54-CPP. Overload allocation and deallocation functions as a pair in the same scope
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl54-cpp/>`_.
+This check corresponds to CERT C++ Coding Standard rule [DCL54-CPP. Overload allocation and deallocation functions as a pair in the same scope](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl54-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/no-recursion.md b/clang-tools-extra/docs/clang-tidy/checks/misc/no-recursion.md
index ff2e851f4d31d..4542a24836250 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/no-recursion.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/no-recursion.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - misc-no-recursion
+```{title} clang-tidy - misc-no-recursion
+```
-misc-no-recursion
-=================
+# misc-no-recursion
Finds strongly connected functions (by analyzing the call graph for
SCC's (Strongly Connected Components) that are loops),
@@ -10,14 +10,13 @@ and displays one example of a possible call graph loop (recursion).
References:
-* CERT C++ Coding Standard rule `DCL56-CPP. Avoid cycles during initialization of static objects <https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl56-cpp/>`_.
-* JPL Institutional Coding Standard for the C Programming Language
+- CERT C++ Coding Standard rule [DCL56-CPP. Avoid cycles during initialization of static objects](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl56-cpp/).
+- JPL Institutional Coding Standard for the C Programming Language
(JPL DOCID D-60411) rule `2.4 Do not use direct or indirect recursion`.
-* OpenCL Specification, Version 1.2 rule `6.9 Restrictions: i. Recursion is not supported. <https://www.khronos.org/registry/OpenCL/specs/opencl-1.2.pdf>`_.
+- OpenCL Specification, Version 1.2 rule [6.9 Restrictions: i. Recursion is not supported.](https://www.khronos.org/registry/OpenCL/specs/opencl-1.2.pdf).
+## Limitations
-Limitations
------------
+- The check does not handle calls done through function pointers
+- The check does not handle C++ destructors
-* The check does not handle calls done through function pointers
-* The check does not handle C++ destructors
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/non-copyable-objects.md b/clang-tools-extra/docs/clang-tidy/checks/misc/non-copyable-objects.md
index 4c95d6d1f6e67..7e794212af42c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/non-copyable-objects.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/non-copyable-objects.md
@@ -1,16 +1,15 @@
-.. title:: clang-tidy - misc-non-copyable-objects
+```{title} clang-tidy - misc-non-copyable-objects
+```
-misc-non-copyable-objects
-=========================
+# misc-non-copyable-objects
`cert-fio38-c` redirects here as an alias for this check.
Flags dereferences and non-pointer declarations of objects that are
not meant to be passed by value, such as C FILE objects or POSIX
-``pthread_mutex_t`` objects.
+`pthread_mutex_t` objects.
-References
-----------
+## References
+
+This check corresponds to CERT C++ Coding Standard rule [FIO38-C. Do not copy a FILE object](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/input-output-fio/fio38-c/).
-This check corresponds to CERT C++ Coding Standard rule `FIO38-C. Do not copy a FILE object
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/input-output-fio/fio38-c/>`_.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md b/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md
index 9d5b7f6673159..9c2e63605faf3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md
@@ -1,27 +1,31 @@
-.. title:: clang-tidy - misc-non-private-member-variables-in-classes
+```{title} clang-tidy - misc-non-private-member-variables-in-classes
+```
-misc-non-private-member-variables-in-classes
-============================================
+# misc-non-private-member-variables-in-classes
`cppcoreguidelines-non-private-member-variables-in-classes` redirects here
as an alias for this check.
Finds classes that contain non-static data members in addition to user-declared
non-static member functions and diagnose all data members declared with a
-non-``public`` access specifier. The data members should be declared as
-``private`` and accessed through member functions instead of exposed to derived
+non-`public` access specifier. The data members should be declared as
+`private` and accessed through member functions instead of exposed to derived
classes or class consumers.
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoreClassesWithAllMemberVariablesBeingPublic
When `true`, allows to completely ignore classes if **all** the member
variables in that class declared with a ``public`` access specifier.
Default is `false`.
+```
+```{eval-rst}
.. option:: IgnorePublicMemberVariables
When `true`, allows to ignore (not diagnose) **all** the member variables
declared with a ``public`` access specifier. Default is `false`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/predictable-rand.md b/clang-tools-extra/docs/clang-tidy/checks/misc/predictable-rand.md
index 303c30927d458..31ddccd4decc4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/predictable-rand.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/predictable-rand.md
@@ -1,20 +1,18 @@
-.. title:: clang-tidy - misc-predictable-rand
+```{title} clang-tidy - misc-predictable-rand
+```
-misc-predictable-rand
-=====================
+# misc-predictable-rand
-Warns for the usage of ``std::rand()``. Pseudorandom number generators use
+Warns for the usage of `std::rand()`. Pseudorandom number generators use
mathematical algorithms to produce a sequence of numbers with good
statistical properties, but the numbers produced are not genuinely random.
-The ``std::rand()`` function takes a seed (number), runs a mathematical
+The `std::rand()` function takes a seed (number), runs a mathematical
operation on it and returns the result. By manipulating the seed the result
can be predictable.
-References
-----------
+## References
This check corresponds to the CERT C Coding Standard rules
-`MSC30-C. Do not use the rand() function for generating pseudorandom numbers
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/miscellaneous-msc/msc30-c/>`_.
-`MSC50-CPP. Do not use std::rand() for generating pseudorandom numbers
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc50-cpp/>`_.
+[MSC30-C. Do not use the rand() function for generating pseudorandom numbers](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/miscellaneous-msc/msc30-c/).
+[MSC50-CPP. Do not use std::rand() for generating pseudorandom numbers](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc50-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/static-assert.md b/clang-tools-extra/docs/clang-tidy/checks/misc/static-assert.md
index 560d43f8d6216..2eeca7a7d466e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/static-assert.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/static-assert.md
@@ -1,12 +1,13 @@
-.. title:: clang-tidy - misc-static-assert
+```{title} clang-tidy - misc-static-assert
+```
-misc-static-assert
-==================
+# misc-static-assert
`cert-dcl03-c` redirects here as an alias for this check.
-Replaces ``assert()`` with ``static_assert()`` if the condition is evaluable
+Replaces `assert()` with `static_assert()` if the condition is evaluable
at compile time.
-The condition of ``static_assert()`` is evaluated at compile time which is
+The condition of `static_assert()` is evaluated at compile time which is
safer and more efficient.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md b/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md
index 49e3fd5b6ee42..5cdb3ad6879cc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md
@@ -1,15 +1,15 @@
-.. title:: clang-tidy - misc-unconventional-assign-operator
-
-misc-unconventional-assign-operator
-===================================
+```{title} clang-tidy - misc-unconventional-assign-operator
+```
+# misc-unconventional-assign-operator
Finds declarations of assign operators with the wrong return and/or argument
-types and definitions with good return type but wrong ``return`` statements.
-
- * The return type must be ``Class&``.
- * The assignment may be from the class type by value, const lvalue
- reference, non-const rvalue reference, or from a completely different
- type (e.g. ``int``).
- * Private and deleted operators are ignored.
- * The operator must always return ``*this``.
+types and definitions with good return type but wrong `return` statements.
+
+> - The return type must be `Class&`.
+> - The assignment may be from the class type by value, const lvalue
+> reference, non-const rvalue reference, or from a completely different
+> type (e.g. `int`).
+> - Private and deleted operators are ignored.
+> - The operator must always return `*this`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md b/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md
index 8d48fa192e69f..7162e6e489c3e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md
@@ -1,24 +1,26 @@
-.. title:: clang-tidy - misc-uniqueptr-reset-release
+```{title} clang-tidy - misc-uniqueptr-reset-release
+```
-misc-uniqueptr-reset-release
-============================
+# misc-uniqueptr-reset-release
-Find and replace ``unique_ptr::reset(release())`` with ``std::move()``.
+Find and replace `unique_ptr::reset(release())` with `std::move()`.
Example:
-.. code-block:: c++
+```c++
+std::unique_ptr<Foo> x, y;
+x.reset(y.release()); -> x = std::move(y);
+```
- std::unique_ptr<Foo> x, y;
- x.reset(y.release()); -> x = std::move(y);
+If `y` is already rvalue, `std::move()` is not added. `x` and `y` can
+also be `std::unique_ptr<Foo>*`.
-If ``y`` is already rvalue, ``std::move()`` is not added. ``x`` and ``y`` can
-also be ``std::unique_ptr<Foo>*``.
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: IncludeStyle
A string specifying which include-style is used, `llvm` or `google`. Default
is `llvm`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md
index 1b0a0cde059b9..18fbcc2cf7a73 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md
@@ -1,14 +1,14 @@
-.. title:: clang-tidy - misc-unused-alias-decls
-
-misc-unused-alias-decls
-=======================
+```{title} clang-tidy - misc-unused-alias-decls
+```
+# misc-unused-alias-decls
Finds unused namespace alias declarations.
-.. code-block:: c++
+```c++
+namespace my_namespace {
+class C {};
+}
+namespace unused_alias = ::my_namespace;
+```
- namespace my_namespace {
- class C {};
- }
- namespace unused_alias = ::my_namespace;
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md
index 17544656a5fe3..1c655da7d29ed 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md
@@ -1,19 +1,20 @@
-.. title:: clang-tidy - misc-unused-using-decls
+```{title} clang-tidy - misc-unused-using-decls
+```
-misc-unused-using-decls
-=======================
+# misc-unused-using-decls
-Finds unused ``using`` declarations.
+Finds unused `using` declarations.
-Unused ``using`` declarations in header files will not be diagnosed
+Unused `using` declarations in header files will not be diagnosed
since these using declarations are part of the header's public API.
Allowed header file extensions can be configured via the global
option `HeaderFileExtensions`.
Example:
-.. code-block:: c++
+```c++
+// main.cpp
+namespace n { class C; }
+using n::C; // Never actually used.
+```
- // main.cpp
- namespace n { class C; }
- using n::C; // Never actually used.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-setjmp-longjmp.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-setjmp-longjmp.md
index 835d94b69f358..9c6d92ce57bf4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-setjmp-longjmp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-setjmp-longjmp.md
@@ -1,16 +1,15 @@
-.. title:: clang-tidy - modernize-avoid-setjmp-longjmp
+```{title} clang-tidy - modernize-avoid-setjmp-longjmp
+```
-modernize-avoid-setjmp-longjmp
-==============================
+# modernize-avoid-setjmp-longjmp
-Flags all call expressions involving ``setjmp()`` and
-``longjmp()`` in C++ code.
+Flags all call expressions involving `setjmp()` and
+`longjmp()` in C++ code.
-Exception handling with ``throw`` and ``catch`` should be used instead.
+Exception handling with `throw` and `catch` should be used instead.
-References
-----------
+## References
This check corresponds to the CERT C++ Coding Standard rule
-`ERR52-CPP. Do not use setjmp() or longjmp()
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err52-cpp/>`_.
+[ERR52-CPP. Do not use setjmp() or longjmp()](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err52-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-variadic-functions.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-variadic-functions.md
index 7604c92c8dbac..2c25ef3ec0f19 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-variadic-functions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/avoid-variadic-functions.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - modernize-avoid-variadic-functions
+```{title} clang-tidy - modernize-avoid-variadic-functions
+```
-modernize-avoid-variadic-functions
-==================================
+# modernize-avoid-variadic-functions
Find all function definitions (but not declarations) of C-style variadic
functions.
@@ -9,10 +9,8 @@ functions.
Instead of C-style variadic functions, C++ function parameter pack should be
used.
-
-References
-----------
+## References
This check corresponds to the CERT C++ Coding Standard rule
-`DCL50-CPP. Do not define a C-style variadic function
-<https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl50-cpp/>`_.
+[DCL50-CPP. Do not define a C-style variadic function](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl50-cpp/).
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/deprecated-ios-base-aliases.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/deprecated-ios-base-aliases.md
index 6a431d4a162c9..b863c0e23b2f5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/deprecated-ios-base-aliases.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/deprecated-ios-base-aliases.md
@@ -1,17 +1,16 @@
-.. title:: clang-tidy - modernize-deprecated-ios-base-aliases
+```{title} clang-tidy - modernize-deprecated-ios-base-aliases
+```
-modernize-deprecated-ios-base-aliases
-=====================================
+# modernize-deprecated-ios-base-aliases
-Detects usage of the deprecated member types of ``std::ios_base`` and replaces
+Detects usage of the deprecated member types of `std::ios_base` and replaces
those that have a non-deprecated equivalent.
-=================================== ===========================
-Deprecated member type Replacement
-=================================== ===========================
-``std::ios_base::io_state`` ``std::ios_base::iostate``
-``std::ios_base::open_mode`` ``std::ios_base::openmode``
-``std::ios_base::seek_dir`` ``std::ios_base::seekdir``
-``std::ios_base::streamoff``
-``std::ios_base::streampos``
-=================================== ===========================
+| Deprecated member type | Replacement |
+| -------------------------- | ------------------------- |
+| `std::ios_base::io_state` | `std::ios_base::iostate` |
+| `std::ios_base::open_mode` | `std::ios_base::openmode` |
+| `std::ios_base::seek_dir` | `std::ios_base::seekdir` |
+| `std::ios_base::streamoff` | |
+| `std::ios_base::streampos` | |
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/redundant-void-arg.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/redundant-void-arg.md
index 209d9ba7fd123..1dd917a55c5ff 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/redundant-void-arg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/redundant-void-arg.md
@@ -1,19 +1,18 @@
-.. title:: clang-tidy - modernize-redundant-void-arg
+```{title} clang-tidy - modernize-redundant-void-arg
+```
-modernize-redundant-void-arg
-============================
+# modernize-redundant-void-arg
-Finds and removes redundant ``void`` argument lists.
+Finds and removes redundant `void` argument lists.
Works in C++ and in C23 and up.
Examples:
- =================================== ===========================
- Initial code Code with applied fixes
- =================================== ===========================
- ``int f(void);`` ``int f();``
- ``int (*f(void))(void);`` ``int (*f())();``
- ``typedef int (*f_t(void))(void);`` ``typedef int (*f_t())();``
- ``void (C::*p)(void);`` ``void (C::*p)();``
- ``C::C(void) {}`` ``C::C() {}``
- ``C::~C(void) {}`` ``C::~C() {}``
- =================================== ===========================
+: | Initial code | Code with applied fixes |
+ | --------------------------------- | ------------------------- |
+ | `int f(void);` | `int f();` |
+ | `int (*f(void))(void);` | `int (*f())();` |
+ | `typedef int (*f_t(void))(void);` | `typedef int (*f_t())();` |
+ | `void (C::*p)(void);` | `void (C::*p)();` |
+ | `C::C(void) {}` | `C::C() {}` |
+ | `C::~C(void) {}` | `C::~C() {}` |
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md
index 2631d9056e851..fa6c50a4f6af8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md
@@ -1,22 +1,23 @@
-.. title:: clang-tidy - modernize-return-braced-init-list
+```{title} clang-tidy - modernize-return-braced-init-list
+```
-modernize-return-braced-init-list
-=================================
+# modernize-return-braced-init-list
Replaces explicit calls to the constructor in a return with a braced
initializer list. This way the return type is not needlessly duplicated in the
function definition and the return statement.
-.. code:: c++
+```c++
+Foo bar() {
+ Baz baz;
+ return Foo(baz);
+}
- Foo bar() {
- Baz baz;
- return Foo(baz);
- }
+// transforms to:
- // transforms to:
+Foo bar() {
+ Baz baz;
+ return {baz};
+}
+```
- Foo bar() {
- Baz baz;
- return {baz};
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/shrink-to-fit.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/shrink-to-fit.md
index 4d7ffafe2a9fa..17271eb181bbe 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/shrink-to-fit.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/shrink-to-fit.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - modernize-shrink-to-fit
-
-modernize-shrink-to-fit
-=======================
+```{title} clang-tidy - modernize-shrink-to-fit
+```
+# modernize-shrink-to-fit
Replace copy and swap tricks on shrinkable containers with the
-``shrink_to_fit()`` method call.
+`shrink_to_fit()` method call.
-The ``shrink_to_fit()`` method is more readable and more effective than
+The `shrink_to_fit()` method is more readable and more effective than
the copy and swap trick to reduce the capacity of a shrinkable container.
-Note that, the ``shrink_to_fit()`` method is only available in C++11 and up.
+Note that, the `shrink_to_fit()` method is only available in C++11 and up.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md
index 9a0de6c981e59..a4e451c6ed507 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md
@@ -1,26 +1,27 @@
-.. title:: clang-tidy - modernize-unary-static-assert
+```{title} clang-tidy - modernize-unary-static-assert
+```
-modernize-unary-static-assert
-=============================
+# modernize-unary-static-assert
-The check diagnoses any ``static_assert`` declaration with an
+The check diagnoses any `static_assert` declaration with an
empty string literal and provides a fix-it note to replace the
-declaration with a single-argument ``static_assert`` declaration.
+declaration with a single-argument `static_assert` declaration.
The check is only applicable for C++17 and later code.
The following code:
-.. code-block:: c++
-
- void f_textless(int a) {
- static_assert(sizeof(a) <= 10, "");
- }
+```c++
+void f_textless(int a) {
+ static_assert(sizeof(a) <= 10, "");
+}
+```
is replaced by:
-.. code-block:: c++
+```c++
+void f_textless(int a) {
+ static_assert(sizeof(a) <= 10);
+}
+```
- void f_textless(int a) {
- static_assert(sizeof(a) <= 10);
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md
index 27cf79b6e3a8c..1c8969b167c84 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md
@@ -1,28 +1,30 @@
-.. title:: clang-tidy - modernize-use-bool-literals
+```{title} clang-tidy - modernize-use-bool-literals
+```
-modernize-use-bool-literals
-===========================
+# modernize-use-bool-literals
-Finds integer literals which are cast to ``bool``.
+Finds integer literals which are cast to `bool`.
-.. code-block:: c++
+```c++
+bool p = 1;
+bool f = static_cast<bool>(1);
+std::ios_base::sync_with_stdio(0);
+bool x = p ? 1 : 0;
- bool p = 1;
- bool f = static_cast<bool>(1);
- std::ios_base::sync_with_stdio(0);
- bool x = p ? 1 : 0;
+// transforms to
- // transforms to
+bool p = true;
+bool f = true;
+std::ios_base::sync_with_stdio(false);
+bool x = p ? true : false;
+```
- bool p = true;
- bool f = true;
- std::ios_base::sync_with_stdio(false);
- bool x = p ? true : false;
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoreMacros
If set to `true`, the check will not give warnings inside macros. Default
is `true`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-default.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-default.md
index 7d2186f37daae..7cd9d80cbb41b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-default.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-default.md
@@ -1,9 +1,12 @@
-:orphan:
+---
+orphan: true
+---
-.. title:: clang-tidy - modernize-use-default
+```{title} clang-tidy - modernize-use-default
+```
-modernize-use-default
-=====================
+# modernize-use-default
This check has been renamed to
-:doc:`modernize-use-equals-default <../modernize/use-equals-default>`.
+{doc}`modernize-use-equals-default <../modernize/use-equals-default>`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md
index fd89b780f7519..8a41c5c27ba41 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md
@@ -1,14 +1,15 @@
-.. title:: clang-tidy - modernize-use-starts-ends-with
+```{title} clang-tidy - modernize-use-starts-ends-with
+```
-modernize-use-starts-ends-with
-==============================
+# modernize-use-starts-ends-with
-Checks for common roundabout ways to express ``starts_with`` and ``ends_with``
+Checks for common roundabout ways to express `starts_with` and `ends_with`
and suggests replacing with the simpler method when it is available. Notably,
-this will work with ``std::string`` and ``std::string_view``.
+this will work with `std::string` and `std::string_view`.
Covered scenarios:
+```{eval-rst}
==================================================== =====================
Expression Replacement
---------------------------------------------------- ---------------------
@@ -23,3 +24,5 @@ Expression Replacement
``u.compare(u.size() - v.size(), v.size(), v) == 0`` ``u.ends_with(v)``
``u.rfind(v) == u.size() - v.size()`` ``u.ends_with(v)``
==================================================== =====================
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md b/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md
index 9658246b21d2a..cfaa1dd800dbd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md
@@ -1,27 +1,28 @@
-.. title:: clang-tidy - mpi-buffer-deref
+```{title} clang-tidy - mpi-buffer-deref
+```
-mpi-buffer-deref
-================
+# mpi-buffer-deref
This check verifies if a buffer passed to an MPI (Message Passing Interface)
function is sufficiently dereferenced. Buffers should be passed as a single
-pointer or array. As MPI function signatures specify ``void *`` for their
+pointer or array. As MPI function signatures specify `void *` for their
buffer types, insufficiently dereferenced buffers can be passed, like for
example as double pointers or multidimensional arrays, without a compiler
warning emitted.
Examples:
-.. code-block:: c++
+```c++
+// A double pointer is passed to the MPI function.
+char *buf;
+MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
- // A double pointer is passed to the MPI function.
- char *buf;
- MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
+// A multidimensional array is passed to the MPI function.
+short buf[1][1];
+MPI_Send(buf, 1, MPI_SHORT, 0, 0, MPI_COMM_WORLD);
- // A multidimensional array is passed to the MPI function.
- short buf[1][1];
- MPI_Send(buf, 1, MPI_SHORT, 0, 0, MPI_COMM_WORLD);
+// A pointer to an array is passed to the MPI function.
+short *buf[1];
+MPI_Send(buf, 1, MPI_SHORT, 0, 0, MPI_COMM_WORLD);
+```
- // A pointer to an array is passed to the MPI function.
- short *buf[1];
- MPI_Send(buf, 1, MPI_SHORT, 0, 0, MPI_COMM_WORLD);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md b/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md
index e5d174c33315d..24864f4de2a3a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - mpi-type-mismatch
+```{title} clang-tidy - mpi-type-mismatch
+```
-mpi-type-mismatch
-=================
+# mpi-type-mismatch
This check verifies if buffer type and MPI (Message Passing Interface)
datatype pairs match for used MPI functions. All MPI datatypes defined
@@ -11,12 +11,13 @@ of verification.
Example:
-.. code-block:: c++
+```c++
+// In this case, the buffer type matches MPI datatype.
+char buf;
+MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
- // In this case, the buffer type matches MPI datatype.
- char buf;
- MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
+// In the following case, the buffer type does not match MPI datatype.
+int buf;
+MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
+```
- // In the following case, the buffer type does not match MPI datatype.
- int buf;
- MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/assert-equals.md b/clang-tools-extra/docs/clang-tidy/checks/objc/assert-equals.md
index 09f5ef01c10c3..6a0aab9a0da07 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/assert-equals.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/assert-equals.md
@@ -1,11 +1,12 @@
-.. title:: clang-tidy - objc-assert-equals
+```{title} clang-tidy - objc-assert-equals
+```
-objc-assert-equals
-==================
+# objc-assert-equals
Finds improper usages of `XCTAssertEqual` and `XCTAssertNotEqual` and replaces
them with `XCTAssertEqualObjects` or `XCTAssertNotEqualObjects`.
This makes tests less fragile, as many improperly rely on pointer equality for
-strings that have equal values. This assumption is not guaranteed by the
+strings that have equal values. This assumption is not guaranteed by the
language.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/avoid-nserror-init.md b/clang-tools-extra/docs/clang-tidy/checks/objc/avoid-nserror-init.md
index 4de389bdd3505..65f7807f3e794 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/avoid-nserror-init.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/avoid-nserror-init.md
@@ -1,13 +1,14 @@
-.. title:: clang-tidy - objc-avoid-nserror-init
+```{title} clang-tidy - objc-avoid-nserror-init
+```
-objc-avoid-nserror-init
-=======================
+# objc-avoid-nserror-init
-Finds improper initialization of ``NSError`` objects.
+Finds improper initialization of `NSError` objects.
According to Apple developer document, we should always use factory method
-``errorWithDomain:code:userInfo:`` to create new NSError objects instead
-of ``[NSError alloc] init]``. Otherwise it will lead to a warning message
+`errorWithDomain:code:userInfo:` to create new NSError objects instead
+of `[NSError alloc] init]`. Otherwise it will lead to a warning message
during runtime.
-The corresponding information about ``NSError`` creation: https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ErrorHandlingCocoa/CreateCustomizeNSError/CreateCustomizeNSError.html
+The corresponding information about `NSError` creation: <https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ErrorHandlingCocoa/CreateCustomizeNSError/CreateCustomizeNSError.html>
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/dealloc-in-category.md b/clang-tools-extra/docs/clang-tidy/checks/objc/dealloc-in-category.md
index 6d889089fe206..4ef1afcbde81a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/dealloc-in-category.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/dealloc-in-category.md
@@ -1,13 +1,14 @@
-.. title:: clang-tidy - objc-dealloc-in-category
+```{title} clang-tidy - objc-dealloc-in-category
+```
-objc-dealloc-in-category
-========================
+# objc-dealloc-in-category
-Finds implementations of ``-dealloc`` in Objective-C categories. The category
-implementation will override any ``-dealloc`` in the class implementation,
+Finds implementations of `-dealloc` in Objective-C categories. The category
+implementation will override any `-dealloc` in the class implementation,
potentially causing issues.
-Classes implement ``-dealloc`` to perform important actions to deallocate
-an object. If a category on the class implements ``-dealloc``, it will
+Classes implement `-dealloc` to perform important actions to deallocate
+an object. If a category on the class implements `-dealloc`, it will
override the class's implementation and unexpected deallocation behavior
may occur.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md b/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md
index 389409412e251..423abb7702188 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - objc-forbidden-subclassing
+```{title} clang-tidy - objc-forbidden-subclassing
+```
-objc-forbidden-subclassing
-==========================
+# objc-forbidden-subclassing
Finds Objective-C classes which are subclasses of classes which are
not designed to be subclassed.
@@ -9,20 +9,22 @@ not designed to be subclassed.
By default, includes a list of Objective-C classes which are publicly
documented as not supporting subclassing.
-.. note::
+:::{note}
+Instead of using this check, for code under your control, you should add
+`__attribute__((objc_subclassing_restricted))` before your `@interface`
+declarations to ensure the compiler prevents others from subclassing your
+Objective-C classes.
+See <https://clang.llvm.org/docs/AttributeReference.html#objc-subclassing-restricted>
+:::
- Instead of using this check, for code under your control, you should add
- ``__attribute__((objc_subclassing_restricted))`` before your ``@interface``
- declarations to ensure the compiler prevents others from subclassing your
- Objective-C classes.
- See https://clang.llvm.org/docs/AttributeReference.html#objc-subclassing-restricted
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: ForbiddenSuperClassNames
Semicolon-separated list of names of Objective-C classes which
do not support subclassing.
Defaults to `ABNewPersonViewController;ABPeoplePickerNavigationController;ABPersonViewController;ABUnknownPersonViewController;NSHashTable;NSMapTable;NSPointerArray;NSPointerFunctions;NSTimer;UIActionSheet;UIAlertView;UIImagePickerController;UITextInputMode;UIWebView`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/missing-hash.md b/clang-tools-extra/docs/clang-tidy/checks/objc/missing-hash.md
index ea8f775897c21..fc16b1c2a6afd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/missing-hash.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/missing-hash.md
@@ -1,16 +1,17 @@
-.. title:: clang-tidy - objc-missing-hash
+```{title} clang-tidy - objc-missing-hash
+```
-objc-missing-hash
-=================
+# objc-missing-hash
-Finds Objective-C implementations that implement ``-isEqual:`` without also
-appropriately implementing ``-hash``.
+Finds Objective-C implementations that implement `-isEqual:` without also
+appropriately implementing `-hash`.
Apple documentation highlights that objects that are equal must have the same
hash value:
-https://developer.apple.com/documentation/objectivec/1418956-nsobject/1418795-isequal?language=objc
+<https://developer.apple.com/documentation/objectivec/1418956-nsobject/1418795-isequal?language=objc>
-Note that the check only verifies the presence of ``-hash`` in scenarios where
+Note that the check only verifies the presence of `-hash` in scenarios where
its omission could result in unexpected behavior. The verification of the
-implementation of ``-hash`` is the responsibility of the developer, e.g.,
+implementation of `-hash` is the responsibility of the developer, e.g.,
through the addition of unit tests to verify the implementation.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/super-self.md b/clang-tools-extra/docs/clang-tidy/checks/objc/super-self.md
index ed0bb2958225c..a6d7124349439 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/super-self.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/super-self.md
@@ -1,12 +1,12 @@
-.. title:: clang-tidy - objc-super-self
+```{title} clang-tidy - objc-super-self
+```
-objc-super-self
-===============
+# objc-super-self
-Finds invocations of ``-self`` on super instances in initializers of subclasses
-of ``NSObject`` and recommends calling a superclass initializer instead.
+Finds invocations of `-self` on super instances in initializers of subclasses
+of `NSObject` and recommends calling a superclass initializer instead.
-Invoking ``-self`` on super instances in initializers is a common programmer
+Invoking `-self` on super instances in initializers is a common programmer
error when the programmer's original intent is to call a superclass
initializer. Failing to call a superclass initializer breaks initializer
chaining and can result in invalid object initialization.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md b/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md
index 07e5c3cbc15ef..45b102e56001d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md
@@ -1,25 +1,27 @@
-.. title:: clang-tidy - openmp-exception-escape
+```{title} clang-tidy - openmp-exception-escape
+```
-openmp-exception-escape
-=======================
+# openmp-exception-escape
Analyzes OpenMP Structured Blocks and checks that no exception escapes
out of the Structured Block it was thrown in.
As per the OpenMP specification, a structured block is an executable statement,
possibly compound, with a single entry at the top and a single exit at the
-bottom. Which means, ``throw`` may not be used to 'exit' out of the
+bottom. Which means, `throw` may not be used to 'exit' out of the
structured block. If an exception is not caught in the same structured block
it was thrown in, the behavior is undefined.
-FIXME: this check does not model SEH, ``setjmp``/``longjmp``.
+FIXME: this check does not model SEH, `setjmp`/`longjmp`.
WARNING! This check may be expensive on large source files.
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoredExceptions
Comma-separated list containing type names which are not counted as thrown
exceptions in the check. Default value is an empty string.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/faster-string-find.md b/clang-tools-extra/docs/clang-tidy/checks/performance/faster-string-find.md
index feac0499c45db..45127ab4a41ec 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/faster-string-find.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/faster-string-find.md
@@ -1,8 +1,9 @@
-.. title:: clang-tidy - performance-faster-string-find
+```{title} clang-tidy - performance-faster-string-find
+```
-performance-faster-string-find
-==============================
+# performance-faster-string-find
The `performance-faster-string-find` check is an alias, please see
-:doc:`performance-prefer-single-char-overloads <prefer-single-char-overloads>`
+{doc}`performance-prefer-single-char-overloads <prefer-single-char-overloads>`
for more information.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md
index 4b097caa121c9..51f7211aae822 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md
@@ -1,10 +1,12 @@
-:orphan:
+---
+orphan: true
+---
-.. title:: clang-tidy - performance-implicit-cast-in-loop
+```{title} clang-tidy - performance-implicit-cast-in-loop
+```
-performance-implicit-cast-in-loop
-=================================
+# performance-implicit-cast-in-loop
-This check has been renamed to :doc:`performance-implicit-conversion-in-loop
+This check has been renamed to {doc}`performance-implicit-conversion-in-loop
<../performance/implicit-conversion-in-loop>`.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md
index 14e4d31f9748d..86ac0415a1367 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - performance-implicit-conversion-in-loop
+```{title} clang-tidy - performance-implicit-conversion-in-loop
+```
-performance-implicit-conversion-in-loop
-=======================================
+# performance-implicit-conversion-in-loop
This warning appears in a range-based loop with a loop variable of const ref
type where the type of the variable does not match the one returned by the
@@ -10,12 +10,13 @@ result in expensive deep copies.
Example:
-.. code-block:: c++
+```c++
+map<int, vector<string>> my_map;
+for (const pair<int, vector<string>>& p : my_map) {}
+// The iterator type is in fact pair<const int, vector<string>>, which means
+// that the compiler added a conversion, resulting in a copy of the vectors.
+```
- map<int, vector<string>> my_map;
- for (const pair<int, vector<string>>& p : my_map) {}
- // The iterator type is in fact pair<const int, vector<string>>, which means
- // that the compiler added a conversion, resulting in a copy of the vectors.
-
-The easiest solution is usually to use ``const auto&`` instead of writing the
+The easiest solution is usually to use `const auto&` instead of writing the
type manually.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md b/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md
index 062c62c3aa24f..7416d94e7b622 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md
@@ -1,8 +1,7 @@
-.. title:: clang-tidy - performance-inefficient-algorithm
-
-performance-inefficient-algorithm
-=================================
+```{title} clang-tidy - performance-inefficient-algorithm
+```
+# performance-inefficient-algorithm
Warns on inefficient use of STL algorithms on associative containers.
@@ -10,20 +9,21 @@ Associative containers implement some of the algorithms as methods which
should be preferred to the algorithms in the algorithm header. The methods
can take advantage of the order of the elements.
-.. code-block:: c++
-
- std::set<int> s;
- auto it = std::find(s.begin(), s.end(), 43);
+```c++
+std::set<int> s;
+auto it = std::find(s.begin(), s.end(), 43);
- // becomes
+// becomes
- auto it = s.find(43);
+auto it = s.find(43);
+```
-.. code-block:: c++
+```c++
+std::set<int> s;
+auto c = std::count(s.begin(), s.end(), 43);
- std::set<int> s;
- auto c = std::count(s.begin(), s.end(), 43);
+// becomes
- // becomes
+auto c = s.count(43);
+```
- auto c = s.count(43);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/move-constructor-init.md b/clang-tools-extra/docs/clang-tidy/checks/performance/move-constructor-init.md
index 9dc0761d2c34f..45411734372ad 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/move-constructor-init.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/move-constructor-init.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - performance-move-constructor-init
+```{title} clang-tidy - performance-move-constructor-init
+```
-performance-move-constructor-init
-=================================
+# performance-move-constructor-init
"cert-oop11-cpp" redirects here as an alias for this check.
The check flags user-defined move constructors that have a ctor-initializer
initializing a member or base class through a copy constructor instead of a
move constructor.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-destructor.md b/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-destructor.md
index 88f55fab619af..58a8346fc4ffc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-destructor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-destructor.md
@@ -1,12 +1,13 @@
-.. title:: clang-tidy - performance-noexcept-destructor
+```{title} clang-tidy - performance-noexcept-destructor
+```
-performance-noexcept-destructor
-===============================
+# performance-noexcept-destructor
-The check flags user-defined destructors marked with ``noexcept(expr)``
-where ``expr`` evaluates to ``false`` (but is not a ``false`` literal itself).
+The check flags user-defined destructors marked with `noexcept(expr)`
+where `expr` evaluates to `false` (but is not a `false` literal itself).
-When a destructor is marked as ``noexcept``, it assures the compiler that
+When a destructor is marked as `noexcept`, it assures the compiler that
no exceptions will be thrown during the destruction of an object, which
allows the compiler to perform certain optimizations such as omitting
exception handling code.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-move-constructor.md b/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-move-constructor.md
index eb605c5b0a53b..865b5c066c583 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-move-constructor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-move-constructor.md
@@ -1,13 +1,13 @@
-.. title:: clang-tidy - performance-noexcept-move-constructor
-
-performance-noexcept-move-constructor
-=====================================
+```{title} clang-tidy - performance-noexcept-move-constructor
+```
+# performance-noexcept-move-constructor
The check flags user-defined move constructors and assignment operators not
-marked with ``noexcept`` or marked with ``noexcept(expr)`` where ``expr``
-evaluates to ``false`` (but is not a ``false`` literal itself).
+marked with `noexcept` or marked with `noexcept(expr)` where `expr`
+evaluates to `false` (but is not a `false` literal itself).
Move constructors of all the types used with STL containers, for example,
-should be declared ``noexcept``. Otherwise STL may choose copy constructors
+should be declared `noexcept`. Otherwise STL may choose copy constructors
instead. The same is valid for move assignment operations.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-swap.md b/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-swap.md
index e6d25d9dabf09..808be6f8e8c37 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-swap.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/noexcept-swap.md
@@ -1,13 +1,14 @@
-.. title:: clang-tidy - performance-noexcept-swap
+```{title} clang-tidy - performance-noexcept-swap
+```
-performance-noexcept-swap
-=========================
+# performance-noexcept-swap
The check flags user-defined swap and iter_swap functions not marked with
-``noexcept`` or marked with ``noexcept(expr)`` where ``expr`` evaluates to
-``false`` (but is not a ``false`` literal itself).
+`noexcept` or marked with `noexcept(expr)` where `expr` evaluates to
+`false` (but is not a `false` literal itself).
-When a swap or iter_swap function is marked as ``noexcept``, it assures the
+When a swap or iter_swap function is marked as `noexcept`, it assures the
compiler that no exceptions will be thrown during the swapping of two objects,
which allows the compiler to perform certain optimizations such as omitting
exception handling code.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md b/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md
index 00e4e470739c2..032c8bab3afd6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md
@@ -1,15 +1,16 @@
-.. title:: clang-tidy - performance-trivially-destructible
+```{title} clang-tidy - performance-trivially-destructible
+```
-performance-trivially-destructible
-==================================
+# performance-trivially-destructible
Finds types that could be made trivially-destructible by removing out-of-line
defaulted destructor declarations.
-.. code-block:: c++
+```c++
+struct A: TrivialType {
+ ~A(); // Makes A non-trivially-destructible.
+ TrivialType trivial_fields;
+};
+A::~A() = default;
+```
- struct A: TrivialType {
- ~A(); // Makes A non-trivially-destructible.
- TrivialType trivial_fields;
- };
- A::~A() = default;
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md b/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md
index e315a42324719..b30dcdd003c2f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md
@@ -1,21 +1,22 @@
-.. title:: clang-tidy - performance-type-promotion-in-math-fn
+```{title} clang-tidy - performance-type-promotion-in-math-fn
+```
-performance-type-promotion-in-math-fn
-=====================================
+# performance-type-promotion-in-math-fn
-Finds calls to C math library functions (from ``math.h`` or, in C++, ``cmath``)
-with implicit ``float`` to ``double`` promotions.
+Finds calls to C math library functions (from `math.h` or, in C++, `cmath`)
+with implicit `float` to `double` promotions.
-For example, warns on ``::sin(0.f)``, because this function's parameter is a
-double. You probably meant to call ``std::sin(0.f)`` (in C++), or ``sinf(0.f)``
+For example, warns on `::sin(0.f)`, because this function's parameter is a
+double. You probably meant to call `std::sin(0.f)` (in C++), or `sinf(0.f)`
(in C).
-.. code-block:: c++
+```c++
+float a;
+asin(a);
- float a;
- asin(a);
+// becomes
- // becomes
+float a;
+std::asin(a);
+```
- float a;
- std::asin(a);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md b/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md
index 659126b19c504..2cc0e5daa62cf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md
@@ -1,23 +1,24 @@
-.. title:: clang-tidy - performance-use-std-move
+```{title} clang-tidy - performance-use-std-move
+```
-performance-use-std-move
-========================
+# performance-use-std-move
-Suggests insertion of ``std::move(...)`` to turn copy assignment operator calls
+Suggests insertion of `std::move(...)` to turn copy assignment operator calls
into move assignment ones, when deemed valid and profitable.
-.. code-block:: c++
+```c++
+void assign(std::vector<int>& out) {
+ std::vector<int> some = make_vector();
+ use_vector(some);
+ out = some;
+}
- void assign(std::vector<int>& out) {
- std::vector<int> some = make_vector();
- use_vector(some);
- out = some;
- }
+// becomes
- // becomes
+void assign(std::vector<int>& out) {
+ std::vector<int> some = make_vector();
+ use_vector(some);
+ out = std::move(some);
+}
+```
- void assign(std::vector<int>& out) {
- std::vector<int> some = make_vector();
- use_vector(some);
- out = std::move(some);
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md b/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md
index ddc24683d76db..10b79deb1a9b0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md
@@ -1,12 +1,13 @@
-.. title:: clang-tidy - portability-no-assembler
+```{title} clang-tidy - portability-no-assembler
+```
-portability-no-assembler
-========================
+# portability-no-assembler
Checks for assembler statements. Use of inline assembly should be avoided
since it ties to a specific CPU architecture and syntax making code that
uses it non-portable across platforms.
-.. code-block:: c++
+```c++
+asm("mov al, 2"); // warning: do not use assembler statements
+```
- asm("mov al, 2"); // warning: do not use assembler statements
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md
index b1146e9da79ba..db982afa6353a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md
@@ -1,25 +1,27 @@
-.. title:: clang-tidy - readability-avoid-const-params-in-decls
+```{title} clang-tidy - readability-avoid-const-params-in-decls
+```
-readability-avoid-const-params-in-decls
-=======================================
+# readability-avoid-const-params-in-decls
Checks whether a function declaration has parameters that are top level
-``const``.
+`const`.
-``const`` values in declarations do not affect the signature of a function, so
+`const` values in declarations do not affect the signature of a function, so
they should not be put there.
Examples:
-.. code-block:: c++
+```c++
+void f(const string); // Bad: const is top level.
+void f(const string&); // Good: const is not top level.
+```
- void f(const string); // Bad: const is top level.
- void f(const string&); // Good: const is not top level.
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoreMacros
If set to `true`, the check will not give warnings inside macros. Default
is `true`.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md
index cd3906855d497..e2123b8ddc7ef 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - readability-avoid-nested-conditional-operator
+```{title} clang-tidy - readability-avoid-nested-conditional-operator
+```
-readability-avoid-nested-conditional-operator
-=============================================
+# readability-avoid-nested-conditional-operator
Identifies instances of nested conditional operators in the code.
@@ -11,8 +11,9 @@ several statements and stored the intermediate results in temporary variable.
Examples:
-.. code-block:: c++
+```c++
+int NestInConditional = (condition1 ? true1 : false1) ? true2 : false2;
+int NestInTrue = condition1 ? (condition2 ? true1 : false1) : false2;
+int NestInFalse = condition1 ? true1 : condition2 ? true2 : false1;
+```
- int NestInConditional = (condition1 ? true1 : false1) ? true2 : false2;
- int NestInTrue = condition1 ? (condition2 ? true1 : false1) : false2;
- int NestInFalse = condition1 ? true1 : condition2 ? true2 : false1;
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md b/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md
index 4b2ef6ef1fbea..020d903d816cc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md
@@ -1,21 +1,23 @@
-.. title:: clang-tidy - readability-container-data-pointer
+```{title} clang-tidy - readability-container-data-pointer
+```
-readability-container-data-pointer
-==================================
+# readability-container-data-pointer
-Finds cases where code could use ``data()`` rather than the address of the
+Finds cases where code could use `data()` rather than the address of the
element at index 0 in a container. This pattern is commonly used to materialize
-a pointer to the backing data of a container. ``std::vector`` and
-``std::string`` provide a ``data()`` accessor to retrieve the data pointer
+a pointer to the backing data of a container. `std::vector` and
+`std::string` provide a `data()` accessor to retrieve the data pointer
which should be preferred.
This also ensures that in the case that the container is empty, the data
pointer access does not perform an errant memory access.
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoredContainers
Semicolon-separated list of containers regexp for which this check won't be
enforced. Default is an empty string.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md b/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md
index 59f4632109c92..52c8cc0f03666 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md
@@ -1,15 +1,16 @@
-.. title:: clang-tidy - readability-convert-member-functions-to-static
+```{title} clang-tidy - readability-convert-member-functions-to-static
+```
-readability-convert-member-functions-to-static
-==============================================
+# readability-convert-member-functions-to-static
-Finds non-static member functions that can be made ``static``
-because the functions don't use ``this``.
+Finds non-static member functions that can be made `static`
+because the functions don't use `this`.
After applying modifications as suggested by the check, running the check again
-might find more opportunities to mark member functions ``static``.
+might find more opportunities to mark member functions `static`.
-After making a member function ``static``, you might want to run the check
-:doc:`readability-static-accessed-through-instance
+After making a member function `static`, you might want to run the check
+{doc}`readability-static-accessed-through-instance
<../readability/static-accessed-through-instance>` to replace calls like
-``Instance.method()`` by ``Class::method()``.
+`Instance.method()` by `Class::method()`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md b/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md
index 08779151de02b..51b54f1da5b45 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md
@@ -1,14 +1,15 @@
-.. title:: clang-tidy - readability-delete-null-pointer
+```{title} clang-tidy - readability-delete-null-pointer
+```
-readability-delete-null-pointer
-===============================
+# readability-delete-null-pointer
-Checks the ``if`` statements where a pointer's existence is checked and
+Checks the `if` statements where a pointer's existence is checked and
then deletes the pointer.
The check is unnecessary as deleting a null pointer has no effect.
-.. code:: c++
+```c++
+int *p;
+if (p)
+ delete p;
+```
- int *p;
- if (p)
- delete p;
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md b/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md
index cb764ba5e7276..5ccaa85e0c4c2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md
@@ -1,9 +1,12 @@
-:orphan:
+---
+orphan: true
+---
-.. title:: clang-tidy - readability-implicit-bool-cast
+```{title} clang-tidy - readability-implicit-bool-cast
+```
-readability-implicit-bool-cast
-==============================
+# readability-implicit-bool-cast
-This check has been renamed to :doc:`readability-implicit-bool-conversion
+This check has been renamed to {doc}`readability-implicit-bool-conversion
<../readability/implicit-bool-conversion>`.
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md b/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md
index 9bc98d5ccc6c9..8821b31413c8e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md
@@ -1,7 +1,7 @@
-.. title:: clang-tidy - readability-math-missing-parentheses
+```{title} clang-tidy - readability-math-missing-parentheses
+```
-readability-math-missing-parentheses
-====================================
+# readability-math-missing-parentheses
Check for missing parentheses in mathematical expressions that involve
operators of different priorities.
@@ -16,13 +16,13 @@ more maintainable code.
Before:
-.. code-block:: c++
-
- int x = 1 + 2 * 3 - 4 / 5;
-
+```c++
+int x = 1 + 2 * 3 - 4 / 5;
+```
After:
-.. code-block:: c++
+```c++
+int x = 1 + (2 * 3) - (4 / 5);
+```
- int x = 1 + (2 * 3) - (4 / 5);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md b/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md
index 26a5af779d7a7..f0dae62df1009 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md
@@ -1,27 +1,27 @@
-.. title:: clang-tidy - readability-misplaced-array-index
+```{title} clang-tidy - readability-misplaced-array-index
+```
-readability-misplaced-array-index
-=================================
+# readability-misplaced-array-index
This check warns for unusual array index syntax.
The following code has unusual array index syntax:
-.. code-block:: c++
-
- void f(int *X, int Y) {
- Y[X] = 0;
- }
+```c++
+void f(int *X, int Y) {
+ Y[X] = 0;
+}
+```
becomes
-.. code-block:: c++
-
- void f(int *X, int Y) {
- X[Y] = 0;
- }
+```c++
+void f(int *X, int Y) {
+ X[Y] = 0;
+}
+```
The check warns about such unusual syntax for readability reasons:
- * There are programmers that are not familiar with this unusual syntax.
- * It is possible that variables are mixed up.
+: - There are programmers that are not familiar with this unusual syntax.
+ - It is possible that variables are mixed up.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md
index d8c7ec7884c83..87d7e7b07a736 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md
@@ -1,24 +1,25 @@
-.. title:: clang-tidy - readability-redundant-function-ptr-dereference
+```{title} clang-tidy - readability-redundant-function-ptr-dereference
+```
-readability-redundant-function-ptr-dereference
-==============================================
+# readability-redundant-function-ptr-dereference
Finds redundant dereferences of a function pointer.
Before:
-.. code-block:: c++
+```c++
+int f(int,int);
+int (*p)(int, int) = &f;
- int f(int,int);
- int (*p)(int, int) = &f;
-
- int i = (**p)(10, 50);
+int i = (**p)(10, 50);
+```
After:
-.. code-block:: c++
+```c++
+int f(int,int);
+int (*p)(int, int) = &f;
- int f(int,int);
- int (*p)(int, int) = &f;
+int i = (*p)(10, 50);
+```
- int i = (*p)(10, 50);
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md
index ab8a3681907e3..a5261ad7fbdba 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md
@@ -1,23 +1,25 @@
-.. title:: clang-tidy - readability-redundant-smartptr-get
+```{title} clang-tidy - readability-redundant-smartptr-get
+```
-readability-redundant-smartptr-get
-==================================
+# readability-redundant-smartptr-get
-Find and remove redundant calls to smart pointer's ``.get()`` method.
+Find and remove redundant calls to smart pointer's `.get()` method.
Examples:
-.. code-block:: c++
+```c++
+ptr.get()->Foo() ==> ptr->Foo()
+*ptr.get() ==> *ptr
+*ptr->get() ==> **ptr
+if (ptr.get() == nullptr) ... => if (ptr == nullptr) ...
+```
- ptr.get()->Foo() ==> ptr->Foo()
- *ptr.get() ==> *ptr
- *ptr->get() ==> **ptr
- if (ptr.get() == nullptr) ... => if (ptr == nullptr) ...
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: IgnoreMacros
If this option is set to `true` (default is `true`), the check will not warn
about calls inside macros.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md
index 84495a5605bec..cb5baa2935c07 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md
@@ -1,15 +1,14 @@
-.. title:: clang-tidy - readability-redundant-string-cstr
+```{title} clang-tidy - readability-redundant-string-cstr
+```
-readability-redundant-string-cstr
-=================================
+# readability-redundant-string-cstr
+Finds unnecessary calls to `std::string::c_str()` and
+`std::string::data()`.
-Finds unnecessary calls to ``std::string::c_str()`` and
-``std::string::data()``.
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: StringParameterFunctions
A semicolon-separated list of regular expressions matching the
@@ -19,3 +18,5 @@ Options
can do so should exist. This can be used to configure functions such as
``fmt::format``, ``spdlog::logger::info``, or wrappers around these and
similar functions. The default value is the empty string.
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md b/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md
index 4b7d7f2ddcf41..fc18ad1381430 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md
@@ -1,23 +1,25 @@
-.. title:: clang-tidy - readability-simplify-subscript-expr
+```{title} clang-tidy - readability-simplify-subscript-expr
+```
-readability-simplify-subscript-expr
-===================================
+# readability-simplify-subscript-expr
This check simplifies subscript expressions. Currently this covers calling
-``.data()`` and immediately doing an array subscript operation to obtain a
-single element, in which case simply calling ``operator[]`` suffice.
+`.data()` and immediately doing an array subscript operation to obtain a
+single element, in which case simply calling `operator[]` suffice.
Examples:
-.. code-block:: c++
+```c++
+std::string s = ...;
+char c = s.data()[i]; // char c = s[i];
+```
- std::string s = ...;
- char c = s.data()[i]; // char c = s[i];
-
-Options
--------
+## Options
+```{eval-rst}
.. option:: Types
The list of type(s) that triggers this check. Default is
`::std::basic_string;::std::basic_string_view;::std::vector;::std::array;::std::span`
+```
+
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md
index 91d40bd713ee2..330f1d53d48a3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md
@@ -1,21 +1,22 @@
-.. title:: clang-tidy - readability-static-definition-in-anonymous-namespace
+```{title} clang-tidy - readability-static-definition-in-anonymous-namespace
+```
-readability-static-definition-in-anonymous-namespace
-====================================================
+# readability-static-definition-in-anonymous-namespace
Finds static function and variable definitions in anonymous namespace.
-In this case, ``static`` is redundant, because anonymous namespace limits the
+In this case, `static` is redundant, because anonymous namespace limits the
visibility of definitions to a single translation unit.
-.. code-block:: c++
-
- namespace {
- static int a = 1; // Warning.
- static const int b = 1; // Warning.
- namespace inner {
- static int c = 1; // Warning.
- }
+```c++
+namespace {
+ static int a = 1; // Warning.
+ static const int b = 1; // Warning.
+ namespace inner {
+ static int c = 1; // Warning.
}
+}
+```
+
+The check will apply a fix by removing the redundant `static` qualifier.
-The check will apply a fix by removing the redundant ``static`` qualifier.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md b/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md
index 73712bdba83b7..5b6b2cd624f56 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md
@@ -1,29 +1,29 @@
-.. title:: clang-tidy - readability-use-std-min-max
+```{title} clang-tidy - readability-use-std-min-max
+```
-readability-use-std-min-max
-===========================
+# readability-use-std-min-max
Replaces certain conditional statements with equivalent calls to
-``std::min`` or ``std::max``.
+`std::min` or `std::max`.
Note: This may impact performance in critical code due to potential
additional stores compared to the original if statement.
Before:
-.. code-block:: c++
-
- void foo() {
- int a = 2, b = 3;
- if (a < b)
- a = b;
- }
-
+```c++
+void foo() {
+ int a = 2, b = 3;
+ if (a < b)
+ a = b;
+}
+```
After:
-.. code-block:: c++
+```c++
+void foo() {
+ int a = 2, b = 3;
+ a = std::max(a, b);
+}
+```
- void foo() {
- int a = 2, b = 3;
- a = std::max(a, b);
- }
diff --git a/clang-tools-extra/docs/clang-tidy/checks/zircon/temporary-objects.md b/clang-tools-extra/docs/clang-tidy/checks/zircon/temporary-objects.md
index a27822e14c1f6..edb96ed979206 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/zircon/temporary-objects.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/zircon/temporary-objects.md
@@ -1,10 +1,11 @@
-.. title:: clang-tidy - zircon-temporary-objects
+```{title} clang-tidy - zircon-temporary-objects
+```
-zircon-temporary-objects
-========================
+# zircon-temporary-objects
-.. note::
+:::{note}
+The `zircon-temporary-objects` check has been deprecated and will be removed
+in 24th release of LLVM. Please use
+{doc}`fuchsia-temporary-objects <../fuchsia/temporary-objects>` instead.
+:::
- The `zircon-temporary-objects` check has been deprecated and will be removed
- in 24th release of LLVM. Please use
- :doc:`fuchsia-temporary-objects <../fuchsia/temporary-objects>` instead.
>From 5236a81f6937dff6719f63674e9aab9dd5ed4385 Mon Sep 17 00:00:00 2001
From: Reid Kleckner <rkleckner at nvidia.com>
Date: Fri, 17 Jul 2026 19:04:23 +0000
Subject: [PATCH 2/2] [clang-tidy][docs] Finish MyST cleanup for short check
docs
---
.../clang-tidy/checks/abseil/cleanup-ctad.md | 5 ++--
.../checks/abseil/duration-addition.md | 3 +-
.../checks/abseil/duration-factory-float.md | 3 +-
.../checks/abseil/no-internal-dependencies.md | 3 +-
.../clang-tidy/checks/abseil/no-namespace.md | 3 +-
.../checks/abseil/redundant-strcat-calls.md | 3 +-
.../checks/abseil/str-cat-append.md | 3 +-
.../checks/abseil/time-comparison.md | 3 +-
.../altera/id-dependent-backward-branch.md | 5 ++--
.../checks/altera/kernel-name-restriction.md | 3 +-
.../checks/android/cloexec-accept.md | 3 +-
.../checks/android/cloexec-accept4.md | 3 +-
.../checks/android/cloexec-creat.md | 3 +-
.../clang-tidy/checks/android/cloexec-dup.md | 3 +-
.../checks/android/cloexec-epoll-create.md | 3 +-
.../checks/android/cloexec-epoll-create1.md | 3 +-
.../checks/android/cloexec-fopen.md | 5 ++--
.../checks/android/cloexec-inotify-init.md | 3 +-
.../checks/android/cloexec-inotify-init1.md | 2 +-
.../checks/android/cloexec-memfd-create.md | 3 +-
.../clang-tidy/checks/android/cloexec-open.md | 3 +-
.../clang-tidy/checks/android/cloexec-pipe.md | 4 +--
.../checks/android/cloexec-pipe2.md | 5 ++--
.../checks/android/cloexec-socket.md | 3 +-
.../clang-tidy/checks/boost/use-to-string.md | 3 +-
.../bugprone/assignment-in-if-condition.md | 3 +-
.../bugprone/bad-signal-to-kill-thread.md | 3 +-
.../bool-pointer-implicit-conversion.md | 3 +-
.../checks/bugprone/command-processor.md | 3 +-
.../copy-constructor-mutates-argument.md | 3 +-
...efault-operator-new-on-overaligned-type.md | 3 +-
.../bugprone/dynamic-static-initializers.md | 3 +-
.../bugprone/forward-declaration-namespace.md | 3 +-
.../checks/bugprone/inaccurate-erase.md | 5 ++--
.../checks/bugprone/incorrect-roundings.md | 3 +-
.../bugprone/multiple-statement-macro.md | 3 +-
.../clang-tidy/checks/bugprone/no-escape.md | 15 +++++-----
.../checks/bugprone/parent-virtual-call.md | 3 +-
.../checks/bugprone/signed-bitwise.md | 12 ++++----
.../checks/bugprone/sizeof-container.md | 3 +-
.../bugprone/spuriously-wake-up-functions.md | 3 +-
.../checks/bugprone/suspicious-include.md | 11 +++----
.../checks/bugprone/terminating-continue.md | 3 +-
.../checks/bugprone/throw-keyword-missing.md | 3 +-
.../throwing-static-initialization.md | 12 ++++----
.../checks/bugprone/virtual-near-miss.md | 3 +-
.../docs/clang-tidy/checks/cert/con36-c.md | 4 +--
.../docs/clang-tidy/checks/cert/con54-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/ctr56-cpp.md | 5 ++--
.../docs/clang-tidy/checks/cert/dcl03-c.md | 4 +--
.../docs/clang-tidy/checks/cert/dcl16-c.md | 4 +--
.../docs/clang-tidy/checks/cert/dcl50-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/dcl51-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/dcl54-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/dcl58-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/dcl59-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/err09-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/err34-c.md | 4 +--
.../docs/clang-tidy/checks/cert/err58-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/err60-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/err61-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/exp42-c.md | 4 +--
.../docs/clang-tidy/checks/cert/exp45-c.md | 4 +--
.../docs/clang-tidy/checks/cert/fio38-c.md | 4 +--
.../docs/clang-tidy/checks/cert/flp37-c.md | 4 +--
.../docs/clang-tidy/checks/cert/int09-c.md | 4 +--
.../docs/clang-tidy/checks/cert/mem57-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/msc24-c.md | 4 +--
.../docs/clang-tidy/checks/cert/msc33-c.md | 4 +--
.../docs/clang-tidy/checks/cert/msc51-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/oop11-cpp.md | 3 +-
.../docs/clang-tidy/checks/cert/oop54-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/oop57-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/oop58-cpp.md | 4 +--
.../docs/clang-tidy/checks/cert/pos44-c.md | 4 +--
.../docs/clang-tidy/checks/cert/pos47-c.md | 4 +--
.../docs/clang-tidy/checks/cert/sig30-c.md | 5 +---
.../clang-analyzer/core.BitwiseShift.md | 12 ++++----
.../clang-analyzer/core.CallAndMessage.md | 12 ++++----
.../checks/clang-analyzer/core.DivideZero.md | 12 ++++----
.../core.NonNullParamChecker.md | 12 ++++----
.../clang-analyzer/core.NullDereference.md | 12 ++++----
.../clang-analyzer/core.StackAddressEscape.md | 12 ++++----
.../core.UndefinedBinaryOperatorResult.md | 12 ++++----
.../checks/clang-analyzer/core.VLASize.md | 12 ++++----
.../core.uninitialized.ArraySubscript.md | 12 ++++----
.../core.uninitialized.Assign.md | 12 ++++----
.../core.uninitialized.Branch.md | 12 ++++----
...ore.uninitialized.CapturedBlockVariable.md | 12 ++++----
.../core.uninitialized.NewArraySize.md | 12 ++++----
.../core.uninitialized.UndefReturn.md | 12 ++++----
.../clang-analyzer/cplusplus.ArrayDelete.md | 12 ++++----
.../clang-analyzer/cplusplus.InnerPointer.md | 12 ++++----
.../checks/clang-analyzer/cplusplus.Move.md | 12 ++++----
.../clang-analyzer/cplusplus.NewDelete.md | 12 ++++----
.../cplusplus.NewDeleteLeaks.md | 12 ++++----
.../clang-analyzer/cplusplus.PlacementNew.md | 12 ++++----
.../cplusplus.SelfAssignment.md | 14 ++++-----
.../clang-analyzer/cplusplus.StringChecker.md | 12 ++++----
.../clang-analyzer/deadcode.DeadStores.md | 12 ++++----
.../clang-analyzer/fuchsia.HandleChecker.md | 12 ++++----
.../nullability.NullPassedToNonnull.md | 12 ++++----
.../nullability.NullReturnedFromNonnull.md | 12 ++++----
.../nullability.NullableDereferenced.md | 12 ++++----
.../nullability.NullablePassedToNonnull.md | 12 ++++----
...nullability.NullableReturnedFromNonnull.md | 12 ++++----
.../optin.core.EnumCastOutOfRange.md | 12 ++++----
.../optin.cplusplus.UninitializedObject.md | 12 ++++----
.../optin.cplusplus.VirtualCall.md | 12 ++++----
.../clang-analyzer/optin.mpi.MPI-Checker.md | 12 ++++----
...ability.EmptyLocalizationContextChecker.md | 12 ++++----
...ocalizability.NonLocalizedStringChecker.md | 12 ++++----
.../optin.performance.GCDAntipattern.md | 12 ++++----
.../optin.performance.Padding.md | 12 ++++----
.../optin.portability.UnixAPI.md | 12 ++++----
.../optin.taint.TaintedAlloc.md | 12 ++++----
.../checks/clang-analyzer/osx.API.md | 12 ++++----
.../osx.NumberObjectConversion.md | 12 ++++----
.../checks/clang-analyzer/osx.ObjCProperty.md | 12 ++++----
.../clang-analyzer/osx.SecKeychainAPI.md | 12 ++++----
.../checks/clang-analyzer/osx.cocoa.AtSync.md | 12 ++++----
.../osx.cocoa.AutoreleaseWrite.md | 12 ++++----
.../clang-analyzer/osx.cocoa.ClassRelease.md | 12 ++++----
.../clang-analyzer/osx.cocoa.Dealloc.md | 12 ++++----
.../osx.cocoa.IncompatibleMethodTypes.md | 12 ++++----
.../checks/clang-analyzer/osx.cocoa.Loops.md | 12 ++++----
.../osx.cocoa.MissingSuperCall.md | 12 ++++----
.../osx.cocoa.NSAutoreleasePool.md | 12 ++++----
.../clang-analyzer/osx.cocoa.NSError.md | 12 ++++----
.../checks/clang-analyzer/osx.cocoa.NilArg.md | 12 ++++----
.../osx.cocoa.NonNilReturnValue.md | 12 ++++----
.../clang-analyzer/osx.cocoa.ObjCGenerics.md | 12 ++++----
.../clang-analyzer/osx.cocoa.RetainCount.md | 12 ++++----
.../osx.cocoa.RunLoopAutoreleaseLeak.md | 12 ++++----
.../clang-analyzer/osx.cocoa.SelfInit.md | 12 ++++----
.../clang-analyzer/osx.cocoa.SuperDealloc.md | 12 ++++----
.../clang-analyzer/osx.cocoa.UnusedIvars.md | 12 ++++----
.../osx.cocoa.VariadicMethodTypes.md | 12 ++++----
.../osx.coreFoundation.CFError.md | 14 ++++-----
.../osx.coreFoundation.CFNumber.md | 12 ++++----
.../osx.coreFoundation.CFRetainRelease.md | 12 ++++----
...x.coreFoundation.containers.OutOfBounds.md | 12 ++++----
...oundation.containers.PointerSizedValues.md | 12 ++++----
.../security.FloatLoopCounter.md | 12 ++++----
.../security.PutenvStackArray.md | 12 ++++----
.../security.SetgidSetuidOrder.md | 12 ++++----
.../security.cert.env.InvalidPtr.md | 12 ++++----
...ureAPI.DeprecatedOrUnsafeBufferHandling.md | 12 ++++----
.../security.insecureAPI.UncheckedReturn.md | 12 ++++----
.../security.insecureAPI.bcmp.md | 14 ++++-----
.../security.insecureAPI.bcopy.md | 14 ++++-----
.../security.insecureAPI.bzero.md | 14 ++++-----
...urity.insecureAPI.decodeValueOfObjCType.md | 14 ++++-----
.../security.insecureAPI.getpw.md | 14 ++++-----
.../security.insecureAPI.gets.md | 12 ++++----
.../security.insecureAPI.mkstemp.md | 12 ++++----
.../security.insecureAPI.mktemp.md | 12 ++++----
.../security.insecureAPI.rand.md | 12 ++++----
.../security.insecureAPI.strcpy.md | 12 ++++----
.../security.insecureAPI.vfork.md | 12 ++++----
.../checks/clang-analyzer/unix.API.md | 12 ++++----
.../unix.BlockInCriticalSection.md | 12 ++++----
.../checks/clang-analyzer/unix.Errno.md | 12 ++++----
.../checks/clang-analyzer/unix.Malloc.md | 12 ++++----
.../clang-analyzer/unix.MallocSizeof.md | 12 ++++----
.../unix.MismatchedDeallocator.md | 12 ++++----
.../unix.StdCLibraryFunctions.md | 12 ++++----
.../checks/clang-analyzer/unix.Stream.md | 12 ++++----
.../checks/clang-analyzer/unix.Vfork.md | 12 ++++----
.../clang-analyzer/unix.cstring.BadSizeArg.md | 12 ++++----
.../clang-analyzer/unix.cstring.NullArg.md | 12 ++++----
.../webkit.NoUncountedMemberChecker.md | 12 ++++----
.../webkit.RefCntblBaseVirtualDtor.md | 12 ++++----
.../webkit.UncountedLambdaCapturesChecker.md | 12 ++++----
.../thread-canceltype-asynchronous.md | 3 +-
.../avoid-reference-coroutine-parameters.md | 3 +-
.../c-copy-assignment-signature.md | 4 +--
.../noexcept-move-operations.md | 5 ++--
.../checks/cppcoreguidelines/noexcept-swap.md | 7 ++---
...non-private-member-variables-in-classes.md | 5 ++--
.../pro-bounds-constant-array-index.md | 17 +++++------
.../pro-bounds-pointer-arithmetic.md | 8 ++---
.../pro-type-static-cast-downcast.md | 8 ++---
.../checks/cppcoreguidelines/slicing.md | 3 +-
.../checks/fuchsia/default-arguments-calls.md | 5 ++--
.../fuchsia/default-arguments-declarations.md | 3 +-
.../checks/fuchsia/header-anon-namespaces.md | 4 +--
.../checks/fuchsia/overloaded-operator.md | 3 +-
.../checks/fuchsia/virtual-inheritance.md | 3 +-
.../checks/google/build-namespaces.md | 4 +--
.../checks/google/build-using-namespace.md | 3 +-
.../readability-braces-around-statements.md | 4 +--
.../google/readability-namespace-comments.md | 3 +-
.../checks/google/readability-todo.md | 12 ++++----
.../clang-tidy/checks/google/runtime-int.md | 19 ++++--------
.../llvm/prefer-register-over-unsigned.md | 5 ++--
.../checks/llvm/use-new-mlir-op-builder.md | 5 ++--
.../checks/llvmlibc/callee-namespace.md | 3 +-
.../checks/misc/misleading-bidirectional.md | 3 +-
.../clang-tidy/checks/misc/misplaced-const.md | 3 +-
...non-private-member-variables-in-classes.md | 17 +++++------
.../misc/unconventional-assign-operator.md | 13 ++++-----
.../checks/misc/uniqueptr-reset-release.md | 10 +++----
.../checks/misc/unused-alias-decls.md | 3 +-
.../checks/misc/unused-using-decls.md | 3 +-
.../modernize/return-braced-init-list.md | 3 +-
.../checks/modernize/unary-static-assert.md | 5 ++--
.../checks/modernize/use-bool-literals.md | 10 +++----
.../checks/modernize/use-starts-ends-with.md | 29 ++++++++-----------
.../clang-tidy/checks/mpi/buffer-deref.md | 3 +-
.../clang-tidy/checks/mpi/type-mismatch.md | 3 +-
.../checks/objc/forbidden-subclassing.md | 10 +++----
.../checks/openmp/exception-escape.md | 8 ++---
.../performance/implicit-cast-in-loop.md | 4 +--
.../implicit-conversion-in-loop.md | 3 +-
.../performance/inefficient-algorithm.md | 5 ++--
.../performance/trivially-destructible.md | 3 +-
.../performance/type-promotion-in-math-fn.md | 3 +-
.../checks/performance/use-std-move.md | 3 +-
.../checks/portability/no-assembler.md | 3 +-
.../avoid-const-params-in-decls.md | 10 +++----
.../avoid-nested-conditional-operator.md | 3 +-
.../readability/container-data-pointer.md | 8 ++---
.../convert-member-functions-to-static.md | 4 +--
.../checks/readability/delete-null-pointer.md | 3 +-
.../checks/readability/implicit-bool-cast.md | 4 +--
.../readability/math-missing-parentheses.md | 5 ++--
.../readability/misplaced-array-index.md | 9 +++---
.../redundant-function-ptr-dereference.md | 5 ++--
.../readability/redundant-smartptr-get.md | 10 +++----
.../readability/redundant-string-cstr.md | 18 +++++-------
.../readability/simplify-subscript-expr.md | 10 +++----
...tatic-definition-in-anonymous-namespace.md | 3 +-
.../checks/readability/use-std-min-max.md | 5 ++--
234 files changed, 840 insertions(+), 1032 deletions(-)
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md
index 091cc32cb2e62..74d58367dcf60 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/cleanup-ctad.md
@@ -7,7 +7,7 @@ Suggests switching the initialization pattern of `absl::Cleanup`
instances from the factory function to class template argument
deduction (CTAD), in C++17 and higher.
-```c++
+```cpp
auto c1 = absl::MakeCleanup([] {});
const auto c2 = absl::MakeCleanup(std::function<void()>([] {}));
@@ -15,9 +15,8 @@ const auto c2 = absl::MakeCleanup(std::function<void()>([] {}));
becomes
-```c++
+```cpp
absl::Cleanup c1 = [] {};
const absl::Cleanup c2 = std::function<void()>([] {});
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md
index 33f38e3d5944b..1e873d24c017f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-addition.md
@@ -10,7 +10,7 @@ of a similar scale, and make that inference explicit.
Examples:
-```c++
+```cpp
// Original - Addition in the integer domain
int x;
absl::Time t;
@@ -19,4 +19,3 @@ int result = absl::ToUnixSeconds(t) + x;
// Suggestion - Addition in the absl::Time domain
int result = absl::ToUnixSeconds(t + absl::Seconds(x));
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md
index 2dbd7abab663f..89f3eb917cc16 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/duration-factory-float.md
@@ -13,7 +13,7 @@ superfluous casts.
Examples:
-```c++
+```cpp
// Original - Providing a floating-point literal.
absl::Duration d = absl::Seconds(10.0);
@@ -27,4 +27,3 @@ absl::Duration d = absl::Seconds(static_cast<double>(10));
// Suggested - Remove the explicit cast
absl::Duration d = absl::Seconds(10);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md
index aec3f19dcbef8..0b78cb835767c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-internal-dependencies.md
@@ -12,7 +12,7 @@ compatibility guidelines and may result in breakage. See
The following cases will result in warnings:
-```c++
+```cpp
absl::strings_internal::foo();
// warning triggered on this line
class foo {
@@ -22,4 +22,3 @@ class foo {
absl::memory_internal::MakeUniqueResult();
// warning triggered on this line
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md
index 36bf87c67b897..2c3610ed574f0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/no-namespace.md
@@ -9,7 +9,7 @@ conflicts with Abseil's compatibility guidelines and may result in breakage.
Any code that uses:
-```c++
+```cpp
namespace absl {
...
}
@@ -18,4 +18,3 @@ namespace absl {
will be prompted with a warning.
See [the full Abseil compatibility guidelines](https://abseil.io/about/compatibility) for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md
index feed2b31963e7..d7c161cf62864 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/redundant-strcat-calls.md
@@ -11,7 +11,7 @@ them makes the code smaller and faster.
Examples:
-```c++
+```cpp
std::string s = absl::StrCat("A", absl::StrCat("B", absl::StrCat("C", "D")));
//before
@@ -24,4 +24,3 @@ absl::StrAppend(&s, absl::StrCat("E", "F", "G"));
absl::StrAppend(&s, "E", "F", "G");
//after
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md
index 96ea3e6aa840c..cfb9e72ff64dd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/str-cat-append.md
@@ -9,10 +9,9 @@ Flags uses of `absl::StrCat()` to append to a `std::string`. Suggests
The extra calls cause unnecessary temporary strings to be constructed. Removing
them makes the code smaller and faster.
-```c++
+```cpp
a = absl::StrCat(a, b); // Use absl::StrAppend(&a, b) instead.
```
Does not diagnose cases where `absl::StrCat()` is used as a template
argument for a functor.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md b/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md
index 8db85430700f9..f0abe667030e6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/abseil/time-comparison.md
@@ -12,7 +12,7 @@ practice this is very rare, and still indicates a bug which should be fixed.
Examples:
-```c++
+```cpp
// Original - Comparison in the integer domain
int x;
absl::Time t;
@@ -21,4 +21,3 @@ if (x < absl::ToUnixSeconds(t)) ...
// Suggested - Compare in the absl::Time domain instead
if (absl::FromUnixSeconds(x) < t) ...
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md b/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md
index fc7589c7930d1..fc0ff95e546e7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/altera/id-dependent-backward-branch.md
@@ -6,7 +6,7 @@
Finds ID-dependent variables and fields that are used within loops. This causes
branches to occur inside the loops, and thus leads to performance degradation.
-```c++
+```cpp
// The following code will produce a warning because this ID-dependent
// variable is used in a loop condition statement.
int ThreadID = get_local_id(0);
@@ -24,5 +24,6 @@ for (int i = 0; i < 100; ++i) {
}
```
-Based on the [Altera SDK for OpenCL: Best Practices Guide](https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_optimization_guide.pdf).
+Based on the [Altera SDK for OpenCL: Best Practices Guide][altera-guide].
+[altera-guide]: https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_optimization_guide.pdf
diff --git a/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md b/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md
index 283a3521d015d..2f5582e1fa1e2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/altera/kernel-name-restriction.md
@@ -10,6 +10,5 @@ Such kernel file names cause the offline compiler to generate intermediate
design files that have the same names as certain internal files, which
leads to a compilation error.
-Based on the `Guidelines for Naming the Kernel` section in the
+Based on the Guidelines for Naming the Kernel section in the
[Intel FPGA SDK for OpenCL Pro Edition: Programming Guide](https://www.intel.com/content/www/us/en/programmable/documentation/mwh1391807965224.html#ewa1412973930963).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md
index 18c5d76dcfb18..4204c5d305be8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept.md
@@ -9,11 +9,10 @@ a fork+exec to a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
accept(sockfd, addr, addrlen);
// becomes
accept4(sockfd, addr, addrlen, SOCK_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md
index 714a25375a131..9c3085ad5dc35 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-accept4.md
@@ -9,11 +9,10 @@ remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
accept4(sockfd, addr, addrlen, SOCK_NONBLOCK);
// becomes
accept4(sockfd, addr, addrlen, SOCK_NONBLOCK | SOCK_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md
index 91ec1d671dfa8..6f993493b2b70 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-creat.md
@@ -7,11 +7,10 @@ The usage of `creat()` is not recommended, it's better to use `open()`.
Examples:
-```c++
+```cpp
int fd = creat(path, mode);
// becomes
int fd = open(path, O_WRONLY | O_CREAT | O_TRUNC | O_CLOEXEC, mode);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md
index 654d058f03f2b..56afeb8f4d620 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-dup.md
@@ -9,11 +9,10 @@ remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
int fd = dup(oldfd);
// becomes
int fd = fcntl(oldfd, F_DUPFD_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md
index affdda6ae3d97..10f85fd065895 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create.md
@@ -8,11 +8,10 @@ The usage of `epoll_create()` is not recommended, it's better to use
Examples:
-```c++
+```cpp
epoll_create(size);
// becomes
epoll_create1(EPOLL_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md
index 9733f7346c756..9a1ab98c4fb97 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-epoll-create1.md
@@ -9,11 +9,10 @@ would remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
epoll_create1(0);
// becomes
epoll_create1(EPOLL_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md
index f80dc16b72197..e620e261708fc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-fopen.md
@@ -4,15 +4,14 @@
# android-cloexec-fopen
`fopen()` should include `e` in their mode string; so `re` would be
-valid. This is equivalent to having set `FD_CLOEXEC on` that descriptor.
+valid. This is equivalent to having set `FD_CLOEXEC` on that descriptor.
Examples:
-```c++
+```cpp
fopen("fn", "r");
// becomes
fopen("fn", "re");
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md
index 301080a7b62fe..ced2c30265940 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init.md
@@ -8,11 +8,10 @@ The usage of `inotify_init()` is not recommended, it's better to use
Examples:
-```c++
+```cpp
inotify_init();
// becomes
inotify_init1(IN_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md
index 695b6e1c0f53a..2f90b655de989 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-inotify-init1.md
@@ -10,7 +10,7 @@ lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
inotify_init1(IN_NONBLOCK);
// becomes
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md
index 75be610d78dc3..389842bd7c1c8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-memfd-create.md
@@ -9,11 +9,10 @@ remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
memfd_create(name, MFD_ALLOW_SEALING);
// becomes
memfd_create(name, MFD_ALLOW_SEALING | MFD_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md
index 967eb9d837b75..cd1748834c2d2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-open.md
@@ -11,7 +11,7 @@ sensitive data. Open-like functions including `open()`, `openat()`, and
Examples:
-```c++
+```cpp
open("filename", O_RDWR);
open64("filename", O_RDWR);
openat(0, "filename", O_RDWR);
@@ -22,4 +22,3 @@ open("filename", O_RDWR | O_CLOEXEC);
open64("filename", O_RDWR | O_CLOEXEC);
openat(0, "filename", O_RDWR | O_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md
index 267c2889272e2..bad87af6742cf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe.md
@@ -11,13 +11,13 @@ child process, potentially into a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
pipe(pipefd);
```
Suggested replacement:
-```c++
+```cpp
pipe2(pipefd, O_CLOEXEC);
```
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md
index 1f15991693ad1..11dccdd39325b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-pipe2.md
@@ -11,13 +11,12 @@ potentially into a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
pipe2(pipefd, O_NONBLOCK);
```
Suggested replacement:
-```c++
+```cpp
pipe2(pipefd, O_NONBLOCK | O_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md
index c12bdf045781a..33de2151cf53a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/android/cloexec-socket.md
@@ -9,11 +9,10 @@ remain open across a fork+exec to a lower-privileged SELinux domain.
Examples:
-```c++
+```cpp
socket(domain, type, SOCK_STREAM);
// becomes
socket(domain, type, SOCK_STREAM | SOCK_CLOEXEC);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md b/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md
index d142af0e68ce5..285175aa1b614 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/boost/use-to-string.md
@@ -10,7 +10,7 @@ and replace it with calls to `std::to_string` and `std::to_wstring`.
It doesn't replace conversion from floating points despite the `to_string`
overloads, because it would change the behavior.
-```c++
+```cpp
auto str = boost::lexical_cast<std::string>(42);
auto wstr = boost::lexical_cast<std::wstring>(2137LL);
@@ -18,4 +18,3 @@ auto wstr = boost::lexical_cast<std::wstring>(2137LL);
auto str = std::to_string(42);
auto wstr = std::to_wstring(2137LL);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md
index 6f2a10452712f..6241e7068d68f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/assignment-in-if-condition.md
@@ -13,7 +13,7 @@ including assignments that call an overloaded `operator=()`. The identified
assignments violate
[BARR group "Rule 8.2.c"](https://barrgroup.com/embedded-systems/books/embedded-c-coding-standard/statement-rules/if-else-statements).
-```c++
+```cpp
int f = 3;
if(f = 4) { // This is identified by both `Wparentheses` and this check - should it have been: `if (f == 4)` ?
f = f + 1;
@@ -23,4 +23,3 @@ if((f == 5) || (f = 6)) { // the assignment here `(f = 6)` is identified by this
f = f + 2;
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md
index 002d80634ceb3..e96960dd7cbdc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bad-signal-to-kill-thread.md
@@ -7,7 +7,7 @@ Finds `pthread_kill` function calls when a thread is terminated by
raising `SIGTERM` signal and the signal kills the entire process, not
just the individual thread. Use any signal except `SIGTERM`.
-```c++
+```cpp
pthread_kill(thread, SIGTERM);
```
@@ -15,4 +15,3 @@ This check corresponds to the CERT C Coding Standard rule
[POS44-C. Do not use signals to terminate threads](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/posix-pos/pos44-c/).
`cert-pos44-c` redirects here as an alias of this check.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md
index df4702f9cc4bd..fe2da9155d4df 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/bool-pointer-implicit-conversion.md
@@ -8,10 +8,9 @@ Checks for conditions based on implicit conversion from a `bool` pointer to
Example:
-```c++
+```cpp
bool *p;
if (p) {
// Never used in a pointer-specific way.
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md
index 9ba630dbe639f..4a3cd9b59ef6a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/command-processor.md
@@ -11,5 +11,6 @@ but does not actually attempt to execute a command.
## References
This check corresponds to the CERT C Coding Standard rule
-[ENV33-C. Do not call system()](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/environment-env/env33-c/).
+[ENV33-C. Do not call system()][ENV33-C].
+[ENV33-C]: https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/environment-env/env33-c/
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md
index 6c62844091456..6901475746a19 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/copy-constructor-mutates-argument.md
@@ -7,5 +7,6 @@ Finds assignments to the copied object and its direct or indirect members
in copy constructors and copy assignment operators.
This check corresponds to the CERT C Coding Standard rule
-[OOP58-CPP. Copy operations must not mutate the source object](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop58-cpp/).
+[OOP58-CPP. Copy operations must not mutate the source object][cert-oop58-cpp].
+[cert-oop58-cpp]: https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop58-cpp/
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md
index 0b2204f50c05d..5517e663e90df 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/default-operator-new-on-overaligned-type.md
@@ -15,5 +15,6 @@ assume that the user provided the correct memory allocation).
## References
This check corresponds to the CERT C++ Coding Standard rule
-[MEM57-CPP. Avoid using default operator new for over-aligned types](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/).
+[MEM57-CPP. Avoid using default operator new for over-aligned types][mem57-cpp].
+[mem57-cpp]: https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md
index a430ec5d6b403..35a9177ddeab8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/dynamic-static-initializers.md
@@ -17,7 +17,7 @@ variable initialization will not cause problems.
Consider the following code:
-```c
+```cpp
int foo() {
static int k = bar();
return k;
@@ -27,4 +27,3 @@ int foo() {
When synchronization of static initialization is disabled, if two threads both
call `foo` for the first time, there is the possibility that `k` will be double
initialized, creating a race condition.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md
index 23515489fcd12..96faf6a26801b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/forward-declaration-namespace.md
@@ -9,7 +9,7 @@ The check inspects all unused forward declarations and checks if there is any
declaration/definition with the same name existing, which could indicate that
the forward declaration is in a potentially wrong namespace.
-```c++
+```cpp
namespace na { struct A; }
namespace nb { struct A {}; }
nb::A a;
@@ -19,4 +19,3 @@ nb::A a;
This check can only generate warnings, but it can't suggest a fix at this
point.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md
index 38135ba58e3bb..ad4220d91d1ba 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/inaccurate-erase.md
@@ -13,7 +13,7 @@ removed due to using an inappropriate overload.
For example, the following code erases only one element:
-```c++
+```cpp
std::vector<int> xs;
...
xs.erase(std::remove(xs.begin(), xs.end(), 10));
@@ -21,9 +21,8 @@ xs.erase(std::remove(xs.begin(), xs.end(), 10));
Call the two-argument overload of `erase()` to remove the subrange:
-```c++
+```cpp
std::vector<int> xs;
...
xs.erase(std::remove(xs.begin(), xs.end(), 10), xs.end());
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md
index 6141f5a58bd61..94d2d0c4367d1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/incorrect-roundings.md
@@ -6,7 +6,7 @@
Checks the usage of patterns known to produce incorrect rounding.
Programmers often use:
-```
+```cpp
(int)(double_expression + 0.5)
```
@@ -16,4 +16,3 @@ to round the double expression to an integer. The problem with this:
2. It is incorrect. The number 0.499999975 (smallest representable float
number below 0.5) rounds to 1.0. Even worse behavior for negative
numbers where both -0.5f and -1.4f both round to 0.0.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md
index c2c66b53ac121..ce90b288ef86e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/multiple-statement-macro.md
@@ -9,9 +9,8 @@ ones will be executed unconditionally.
Example:
-```c++
+```cpp
#define INCREMENT_TWO(x, y) (x)++; (y)++
if (do_increment)
INCREMENT_TWO(a, b); // (b)++ will be executed unconditionally.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md
index 557fe208b7445..e4cee3533a9bf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/no-escape.md
@@ -10,11 +10,10 @@ with the `noescape` attribute is captured by one of these blocks.
The following is an example of an invalid use of the `noescape` attribute.
-> ```objc
-> void foo(__attribute__((noescape)) int *p) {
-> dispatch_async(queue, ^{
-> *p = 123;
-> });
-> });
-> ```
-
+```objc
+void foo(__attribute__((noescape)) int *p) {
+ dispatch_async(queue, ^{
+ *p = 123;
+ });
+});
+```
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md
index 77061ce992893..81d0b73fb8a95 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/parent-virtual-call.md
@@ -6,7 +6,7 @@
Detects and fixes calls to grand-...parent virtual methods instead of calls
to overridden parent's virtual methods.
-```c++
+```cpp
struct A {
int virtual foo() {...}
};
@@ -21,4 +21,3 @@ struct C: public B {
// warning: qualified name A::foo refers to a member overridden in subclass; did you mean 'B'? [bugprone-parent-virtual-call]
};
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md
index 612e1bcd0ea1a..52fbad231d957 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/signed-bitwise.md
@@ -11,7 +11,7 @@ lead to undefined or implementation dependent behavior. In particular, right
shift a signed integer is implementation dependent, while left shift a signed
integer may result in undefined behavior.
-```c++
+```cpp
int main(){
int x = -4;
int y = x >> 1; // y can be -2 or 2147483646
@@ -20,11 +20,9 @@ int main(){
## Options
-```{eval-rst}
-.. option:: IgnorePositiveIntegerLiterals
+```{option} IgnorePositiveIntegerLiterals
- If this option is set to `true`, the check will not warn on bitwise
- operations with positive integer literals, e.g. ``~0``, ``2 << 1``, etc.
- Default value is `false`.
+If this option is set to `true`, the check will not warn on bitwise
+operations with positive integer literals, e.g. `~0`, `2 << 1`, etc.
+Default value is `false`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md
index 4d7075fb33b3f..38dc6e5865988 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/sizeof-container.md
@@ -12,7 +12,7 @@ All class/struct types declared in namespace `std::` having a const
Examples:
-```c++
+```cpp
std::string s;
int a = 47 + sizeof(s); // warning: sizeof() doesn't return the size of the container. Did you mean .size()?
@@ -24,4 +24,3 @@ int c = sizeof(array_of_strings) / sizeof(array_of_strings[0]); // no warning, d
std::array<int, 3> std_array;
int d = sizeof(std_array); // no warning, probably intended.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md
index de3b8bf2ff567..2ca5d3c2f39d6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/spuriously-wake-up-functions.md
@@ -8,7 +8,7 @@ Finds `cnd_wait`, `cnd_timedwait`, `wait`, `wait_for`, or
that checks whether a condition predicate holds or the function has a
condition parameter.
-```c++
+```cpp
if (condition_predicate) {
condition.wait(lk);
}
@@ -25,4 +25,3 @@ This check corresponds to the CERT C++ Coding Standard rule
[CON54-CPP. Wrap functions that can spuriously wake up in a loop](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/concurrency-con/con54-cpp/).
and CERT C Coding Standard rule
[CON36-C. Wrap functions that can spuriously wake up in a loop](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/concurrency-con/con36-c/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md
index a0093f36c81ef..b68357a51159f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/suspicious-include.md
@@ -8,7 +8,7 @@ implementation file, which often leads to hard-to-track-down ODR violations.
Examples:
-```c++
+```cpp
#include "Dinosaur.hpp" // OK, .hpp files tend not to have definitions.
#include "Pterodactyl.h" // OK, .h files tend not to have definitions.
#include "Velociraptor.cpp" // Warning, filename is suspicious.
@@ -17,10 +17,7 @@ Examples:
## Options
-```{eval-rst}
-.. option:: IgnoredRegex
-
- A regular expression for the file name to be ignored by the check. Default
- is empty string.
+```{option} IgnoredRegex
+A regular expression for the file name to be ignored by the check. Default
+is empty string.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md
index 2bff03b12a8ae..7d71ccec9b6b4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/terminating-continue.md
@@ -7,7 +7,7 @@ Detects `do while` loops with a condition always evaluating to false that
have a `continue` statement, as this `continue` terminates the loop
effectively.
-```c++
+```cpp
void f() {
do {
// some code
@@ -15,4 +15,3 @@ do {
// some other code
} while(false);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md
index 3ff01a88dcbc5..1328a69e5cf24 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throw-keyword-missing.md
@@ -10,7 +10,7 @@ that the programmer's intention was to throw that object.
Example:
-```c++
+```cpp
void f(int i) {
if (i < 0) {
// Exception is created but is not thrown.
@@ -18,4 +18,3 @@ void f(int i) {
}
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md
index 8015cddcbc1f8..1e3b1eb4fcc70 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/throwing-static-initialization.md
@@ -8,20 +8,18 @@ initializer for the object may throw an exception.
## Options
-```{eval-rst}
-.. option:: AllowedTypes
+```{option} AllowedTypes
A semicolon-separated list of names of types that will be excluded from
this check (declarations with matching type will be excluded). Regular
- expressions are accepted, e.g. ``[Rr]ef(erence)?$`` matches every type with
- suffix ``Ref``, ``ref``, ``Reference`` and ``reference``. If a name in the
+ expressions are accepted, e.g. `[Rr]ef(erence)?$` matches every type with
+ suffix `Ref`, `ref`, `Reference` and `reference`. If a name in the
list contains the sequence `::`, it is matched against the qualified type
- name (i.e. ``namespace::Type``), otherwise it is matched against only the
- type name (i.e. ``Type``). Default is an empty string.
+ name (i.e. `namespace::Type`), otherwise it is matched against only the
+ type name (i.e. `Type`). Default is an empty string.
```
## References
This check corresponds to the CERT C++ Coding Standard rule
[ERR58-CPP. Handle all exceptions thrown before main() begins executing](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err58-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md b/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md
index c6c3ca30d993a..88f1cb3277d7c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/bugprone/virtual-near-miss.md
@@ -9,7 +9,7 @@ class.
Example:
-```c++
+```cpp
struct Base {
virtual void func();
};
@@ -19,4 +19,3 @@ struct Derived : Base {
// warning: 'Derived::funk' has a similar name and the same signature as virtual method 'Base::func'; did you mean to override it?
};
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md
index 1bc5bee151cf2..6dafb31cb1bff 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/con36-c.md
@@ -4,7 +4,5 @@
# cert-con36-c
The `cert-con36-c` check is an alias, please see
-{doc}`bugprone-spuriously-wake-up-functions
-<../bugprone/spuriously-wake-up-functions>`
+{doc}`bugprone-spuriously-wake-up-functions <../bugprone/spuriously-wake-up-functions>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md
index c25173ec3d55e..d479cfd79193e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/con54-cpp.md
@@ -4,7 +4,5 @@
# cert-con54-cpp
The `cert-con54-cpp` check is an alias, please see
-{doc}`bugprone-spuriously-wake-up-functions
-<../bugprone/spuriously-wake-up-functions>`
+{doc}`bugprone-spuriously-wake-up-functions <../bugprone/spuriously-wake-up-functions>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md
index d7ba4cb7e65c1..55365c8f6fb21 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/ctr56-cpp.md
@@ -4,6 +4,5 @@
# cert-ctr56-cpp
The `cert-ctr56-cpp` check is an alias, please see
-{doc}`bugprone-pointer-arithmetic-on-polymorphic-object
-<../bugprone/pointer-arithmetic-on-polymorphic-object>` for more information.
-
+{doc}`bugprone-pointer-arithmetic-on-polymorphic-object <../bugprone/pointer-arithmetic-on-polymorphic-object>`
+for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md
index 7506be25c88cf..57118119c2a78 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl03-c.md
@@ -4,5 +4,5 @@
# cert-dcl03-c
The `cert-dcl03-c` check is an alias, please see
-{doc}`misc-static-assert <../misc/static-assert>` for more information.
-
+{doc}`misc-static-assert <../misc/static-assert>`
+for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md
index 355338dce681e..a46bb862abb9c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl16-c.md
@@ -4,6 +4,4 @@
# cert-dcl16-c
The `cert-dcl16-c` check is an alias, please see
-{doc}`readability-uppercase-literal-suffix
-<../readability/uppercase-literal-suffix>` for more information.
-
+{doc}`readability-uppercase-literal-suffix <../readability/uppercase-literal-suffix>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md
index d8885ac12a04e..5bcec6977e1dd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl50-cpp.md
@@ -4,10 +4,8 @@
# cert-dcl50-cpp
The `cert-dcl50-cpp` check is an alias, please see
-{doc}`modernize-avoid-variadic-functions
-<../modernize/avoid-variadic-functions>`
+{doc}`modernize-avoid-variadic-functions <../modernize/avoid-variadic-functions>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[DCL50-CPP. Do not define a C-style variadic function](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl50-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md
index 09c3bc60a653a..b8276acf67d6e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl51-cpp.md
@@ -4,6 +4,4 @@
# cert-dcl51-cpp
The `cert-dcl51-cpp` check is an alias, please see
-{doc}`bugprone-reserved-identifier <../bugprone/reserved-identifier>` for more
-information.
-
+{doc}`bugprone-reserved-identifier <../bugprone/reserved-identifier>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md
index 0d8decf05c10c..bccc011df1233 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl54-cpp.md
@@ -4,6 +4,4 @@
# cert-dcl54-cpp
The `cert-dcl54-cpp` check is an alias, please see
-{doc}`misc-new-delete-overloads <../misc/new-delete-overloads>` for more
-information.
-
+{doc}`misc-new-delete-overloads <../misc/new-delete-overloads>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md
index 373c4d6dd8519..8d02176c3d051 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl58-cpp.md
@@ -4,10 +4,8 @@
# cert-dcl58-cpp
The `cert-dcl58-cpp` is an alias, please see
-{doc}`bugprone-std-namespace-modification
-<../bugprone/std-namespace-modification>`
+{doc}`bugprone-std-namespace-modification <../bugprone/std-namespace-modification>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[DCL58-CPP. Do not modify the standard namespaces](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/declarations-and-initialization-dcl/dcl58-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md
index ec77f5763ca73..b8b2349bb4c6e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/dcl59-cpp.md
@@ -4,7 +4,5 @@
# cert-dcl59-cpp
The `cert-dcl59-cpp` check is an alias, please see
-{doc}`misc-anonymous-namespace-in-header
-<../misc/anonymous-namespace-in-header>`
+{doc}`misc-anonymous-namespace-in-header <../misc/anonymous-namespace-in-header>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md
index 9543349d4103d..15f3f356874d4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err09-cpp.md
@@ -4,8 +4,7 @@
# cert-err09-cpp
The `cert-err09-cpp` check is an alias, please see
-{doc}`misc-throw-by-value-catch-by-reference
-<../misc/throw-by-value-catch-by-reference>`
+{doc}`misc-throw-by-value-catch-by-reference <../misc/throw-by-value-catch-by-reference>`
for more information.
This check corresponds to the CERT C++ Coding Standard recommendation
@@ -13,4 +12,3 @@ ERR09-CPP. Throw anonymous temporaries. However, all of the CERT
recommendations have been removed from public view, and so their
justification for the behavior of this check requires an account on
their wiki to view.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md
index 1b2caa78efd3d..75b06c79270e5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err34-c.md
@@ -4,7 +4,5 @@
# cert-err34-c
The cert-err34-c check is an alias, please see
-{doc}`bugprone-unchecked-string-to-number-conversion
-<../bugprone/unchecked-string-to-number-conversion>`
+{doc}`bugprone-unchecked-string-to-number-conversion <../bugprone/unchecked-string-to-number-conversion>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md
index 2a9c9007cec98..3d2ed6f5b0055 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err58-cpp.md
@@ -4,10 +4,8 @@
# cert-err58-cpp
The `cert-err58-cpp` check is an alias, please see
-{doc}`bugprone-throwing-static-initialization
-<../bugprone/throwing-static-initialization>`
+{doc}`bugprone-throwing-static-initialization <../bugprone/throwing-static-initialization>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[ERR58-CPP. Handle all exceptions thrown before main() begins executing](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err58-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md
index b792e70dd4571..46b3a3db16413 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err60-cpp.md
@@ -4,10 +4,8 @@
# cert-err60-cpp
The `cert-err60-cpp` check is an alias, please see
-{doc}`bugprone-exception-copy-constructor-throws
-<../bugprone/exception-copy-constructor-throws>`
+{doc}`bugprone-exception-copy-constructor-throws <../bugprone/exception-copy-constructor-throws>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[ERR60-CPP. Exception objects must be nothrow copy constructible](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/exceptions-and-error-handling-err/err60-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md
index 1b0c11011850f..8a2f580d3a677 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/err61-cpp.md
@@ -4,7 +4,5 @@
# cert-err61-cpp
The `cert-err61-cpp` check is an alias, please see
-{doc}`misc-throw-by-value-catch-by-reference
-<../misc/throw-by-value-catch-by-reference>`
+{doc}`misc-throw-by-value-catch-by-reference <../misc/throw-by-value-catch-by-reference>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md
index 0ca23a6e8dbb4..96224776a8f48 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/exp42-c.md
@@ -4,6 +4,4 @@
# cert-exp42-c
The `cert-exp42-c` check is an alias, please see
-{doc}`bugprone-suspicious-memory-comparison
-<../bugprone/suspicious-memory-comparison>` for more information.
-
+{doc}`bugprone-suspicious-memory-comparison <../bugprone/suspicious-memory-comparison>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md
index 1298cb4ebfc75..0841fc21b5232 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/exp45-c.md
@@ -4,6 +4,4 @@
# cert-exp45-c
The `cert-exp45-c` check is an alias, please see
-{doc}`bugprone-assignment-in-selection-statement
-<../bugprone/assignment-in-selection-statement>` for more information.
-
+{doc}`bugprone-assignment-in-selection-statement <../bugprone/assignment-in-selection-statement>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md
index c824a12c25617..37a3c1782ef2a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/fio38-c.md
@@ -4,8 +4,6 @@
# cert-fio38-c
The `cert-fio38-c` check is an alias, please see
-{doc}`misc-non-copyable-objects <../misc/non-copyable-objects>` for more
-information.
+{doc}`misc-non-copyable-objects <../misc/non-copyable-objects>` for more information.
This check corresponds to CERT C++ Coding Standard rule [FIO38-C. Do not copy a FILE object](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/input-output-fio/fio38-c/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md
index 97c744286eded..a8e66ee48a88c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/flp37-c.md
@@ -4,6 +4,4 @@
# cert-flp37-c
The `cert-flp37-c` check is an alias, please see
-{doc}`bugprone-suspicious-memory-comparison
-<../bugprone/suspicious-memory-comparison>` for more information.
-
+{doc}`bugprone-suspicious-memory-comparison <../bugprone/suspicious-memory-comparison>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md
index 9cca7d8c82940..1d11b1e0ce23c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/int09-c.md
@@ -4,6 +4,4 @@
# cert-int09-c
The `cert-int09-c` check is an alias, please see
-{doc}`readability-enum-initial-value <../readability/enum-initial-value>` for
-more information.
-
+{doc}`readability-enum-initial-value <../readability/enum-initial-value>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md
index 82e9bff105733..5ff38469b93f2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/mem57-cpp.md
@@ -4,10 +4,8 @@
# cert-mem57-cpp
The `cert-mem57-cpp` is an alias, please see
-{doc}`bugprone-default-operator-new-on-overaligned-type
-<../bugprone/default-operator-new-on-overaligned-type>`
+{doc}`bugprone-default-operator-new-on-overaligned-type <../bugprone/default-operator-new-on-overaligned-type>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[MEM57-CPP. Avoid using default operator new for over-aligned types](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/memory-management-mem/mem57-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md
index 01fab7b6843d0..462730afe3ce0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc24-c.md
@@ -4,6 +4,4 @@
# cert-msc24-c
The `cert-msc24-c` check is an alias, please see
-{doc}`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more
-information.
-
+{doc}`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md
index 1824a44b3265e..eca398831d2e9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc33-c.md
@@ -4,6 +4,4 @@
# cert-msc33-c
The `cert-msc33-c` check is an alias, please see
-{doc}`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more
-information.
-
+{doc}`bugprone-unsafe-functions <../bugprone/unsafe-functions>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md
index ad708754b242a..16f148473babd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/msc51-cpp.md
@@ -4,10 +4,8 @@
# cert-msc51-cpp
The `cert-msc51-cpp` check is an alias, please see
-{doc}`bugprone-random-generator-seed
-<../bugprone/random-generator-seed>`
+{doc}`bugprone-random-generator-seed <../bugprone/random-generator-seed>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[MSC51-CPP. Ensure your random number generator is properly seeded](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/miscellaneous-msc/msc51-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md
index 6c320a7d7f787..e674a79dc5f7f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop11-cpp.md
@@ -3,7 +3,7 @@
# cert-oop11-cpp
-The `cert-oop11-cpp check` is an alias, please see
+The `cert-oop11-cpp` check is an alias, please see
{doc}`performance-move-constructor-init <../performance/move-constructor-init>`
for more information.
@@ -12,4 +12,3 @@ OOP11-CPP. Do not copy-initialize members or base classes from a move
constructor. However, all of the CERT recommendations have been removed from
public view, and so their justification for the behavior of this check requires
an account on their wiki to view.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md
index 49e464e9a3424..6b904120152db 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop54-cpp.md
@@ -4,7 +4,5 @@
# cert-oop54-cpp
The `cert-oop54-cpp` check is an alias, please see
-{doc}`bugprone-unhandled-self-assignment
-<../bugprone/unhandled-self-assignment>`
+{doc}`bugprone-unhandled-self-assignment <../bugprone/unhandled-self-assignment>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md
index 713bc9d498ef3..6abf1b39f1c96 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop57-cpp.md
@@ -4,11 +4,9 @@
# cert-oop57-cpp
The `cert-oop57-cpp` check is an alias, please see
-{doc}`bugprone-raw-memory-call-on-non-trivial-type
-<../bugprone/raw-memory-call-on-non-trivial-type>`
+{doc}`bugprone-raw-memory-call-on-non-trivial-type <../bugprone/raw-memory-call-on-non-trivial-type>`
for more information.
This check corresponds to the CERT C++ Coding Standard rule
[OOP57-CPP. Prefer special member functions and overloaded operators to C
Standard Library functions](https://cmu-sei.github.io/secure-coding-standards/sei-cert-cpp-coding-standard/rules/object-oriented-programming-oop/oop57-cpp/).
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md b/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md
index b9a6d58a09077..3258d415c928d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/oop58-cpp.md
@@ -4,7 +4,5 @@
# cert-oop58-cpp
The `cert-oop58-cpp` check is an alias, please see
-{doc}`bugprone-copy-constructor-mutates-argument
-<../bugprone/copy-constructor-mutates-argument>`
+{doc}`bugprone-copy-constructor-mutates-argument <../bugprone/copy-constructor-mutates-argument>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md
index 69ecbf5646310..5f6df5d9271da 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/pos44-c.md
@@ -4,6 +4,4 @@
# cert-pos44-c
The `cert-pos44-c` check is an alias, please see
-{doc}`bugprone-bad-signal-to-kill-thread
-<../bugprone/bad-signal-to-kill-thread>` for more information.
-
+{doc}`bugprone-bad-signal-to-kill-thread <../bugprone/bad-signal-to-kill-thread>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md
index 3a48ce8413a90..c2353df9f8e5b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/pos47-c.md
@@ -4,6 +4,4 @@
# cert-pos47-c
The `cert-pos47-c` check is an alias, please see
-{doc}`concurrency-thread-canceltype-asynchronous
-<../concurrency/thread-canceltype-asynchronous>` for more information.
-
+{doc}`concurrency-thread-canceltype-asynchronous <../concurrency/thread-canceltype-asynchronous>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md b/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md
index ae2fd5f15c2e7..47a88d42a518b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cert/sig30-c.md
@@ -3,7 +3,4 @@
# cert-sig30-c
-The `cert-sig30-c` check is an alias, please see
-{doc}`bugprone-signal-handler <../bugprone/signal-handler>`
-for more information.
-
+The `cert-sig30-c` check is an alias, please see {doc}`bugprone-signal-handler <../bugprone/signal-handler>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md
index 6dffeb511fc97..7bc029705ca7a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.BitwiseShift.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.BitwiseShift
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-bitwiseshift"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-bitwiseshift
+```{title} clang-tidy - clang-analyzer-core.BitwiseShift
```
# clang-analyzer-core.BitwiseShift
@@ -13,4 +14,3 @@ Finds cases where bitwise shift operation causes undefined behaviour.
The `clang-analyzer-core.BitwiseShift` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-bitwiseshift)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md
index 3fa4a206caf64..5e371b3cebdcb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.CallAndMessage.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.CallAndMessage
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-callandmessage"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-callandmessage
+```{title} clang-tidy - clang-analyzer-core.CallAndMessage
```
# clang-analyzer-core.CallAndMessage
@@ -14,4 +15,3 @@ Check for logical errors for function calls and Objective-C message expressions
The `clang-analyzer-core.CallAndMessage` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-callandmessage)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md
index 36a9bd800a1d0..d062ac4d0e21c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.DivideZero.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.DivideZero
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-dividezero"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-dividezero
+```{title} clang-tidy - clang-analyzer-core.DivideZero
```
# clang-analyzer-core.DivideZero
@@ -13,4 +14,3 @@ Check for division by zero.
The `clang-analyzer-core.DivideZero` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-dividezero)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md
index 57f556141f520..397c6826906bd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NonNullParamChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.NonNullParamChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-nonnullparamchecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-nonnullparamchecker
+```{title} clang-tidy - clang-analyzer-core.NonNullParamChecker
```
# clang-analyzer-core.NonNullParamChecker
@@ -14,4 +15,3 @@ references or marked with the 'nonnull' attribute.
The `clang-analyzer-core.NonNullParamChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-nonnullparamchecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md
index 03aa80b8d3fac..a11f5715c2b39 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.NullDereference.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.NullDereference
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-nulldereference"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-nulldereference
+```{title} clang-tidy - clang-analyzer-core.NullDereference
```
# clang-analyzer-core.NullDereference
@@ -13,4 +14,3 @@ Check for dereferences of null pointers.
The `clang-analyzer-core.NullDereference` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-nulldereference)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md
index b958e393f28d7..cd42174b3980a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.StackAddressEscape.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.StackAddressEscape
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-stackaddressescape"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-stackaddressescape
+```{title} clang-tidy - clang-analyzer-core.StackAddressEscape
```
# clang-analyzer-core.StackAddressEscape
@@ -13,4 +14,3 @@ Check that addresses to stack memory do not escape the function.
The `clang-analyzer-core.StackAddressEscape` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-stackaddressescape)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md
index a609f7f2bb0da..cee548d6e576d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.UndefinedBinaryOperatorResult.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.UndefinedBinaryOperatorResult
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-undefinedbinaryoperatorresult"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-undefinedbinaryoperatorresult
+```{title} clang-tidy - clang-analyzer-core.UndefinedBinaryOperatorResult
```
# clang-analyzer-core.UndefinedBinaryOperatorResult
@@ -13,4 +14,3 @@ Check for undefined results of binary operators.
The `clang-analyzer-core.UndefinedBinaryOperatorResult` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-undefinedbinaryoperatorresult)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md
index da1964436a346..6ae040e749176 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.VLASize.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.VLASize
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-vlasize"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-vlasize
+```{title} clang-tidy - clang-analyzer-core.VLASize
```
# clang-analyzer-core.VLASize
@@ -13,4 +14,3 @@ Check for declarations of VLA of undefined or zero size.
The `clang-analyzer-core.VLASize` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-vlasize)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md
index a448ef18bde32..1768d907751ad 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.ArraySubscript.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.uninitialized.ArraySubscript
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-arraysubscript"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-arraysubscript
+```{title} clang-tidy - clang-analyzer-core.uninitialized.ArraySubscript
```
# clang-analyzer-core.uninitialized.ArraySubscript
@@ -13,4 +14,3 @@ Check for uninitialized values used as array subscripts.
The `clang-analyzer-core.uninitialized.ArraySubscript` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-arraysubscript)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md
index 705a64ea36ad6..560566b6d5c09 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Assign.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.uninitialized.Assign
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-assign"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-assign
+```{title} clang-tidy - clang-analyzer-core.uninitialized.Assign
```
# clang-analyzer-core.uninitialized.Assign
@@ -13,4 +14,3 @@ Check for assigning uninitialized values.
The `clang-analyzer-core.uninitialized.Assign` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-assign)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md
index 54738668691ad..b7336a3626ee6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.Branch.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.uninitialized.Branch
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-branch"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-branch
+```{title} clang-tidy - clang-analyzer-core.uninitialized.Branch
```
# clang-analyzer-core.uninitialized.Branch
@@ -13,4 +14,3 @@ Check for uninitialized values used as branch conditions.
The `clang-analyzer-core.uninitialized.Branch` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-branch)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md
index 9e0695775e794..123277515369e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.CapturedBlockVariable.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.uninitialized.CapturedBlockVariable
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-capturedblockvariable"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-capturedblockvariable
+```{title} clang-tidy - clang-analyzer-core.uninitialized.CapturedBlockVariable
```
# clang-analyzer-core.uninitialized.CapturedBlockVariable
@@ -13,4 +14,3 @@ Check for blocks that capture uninitialized values.
The `clang-analyzer-core.uninitialized.CapturedBlockVariable` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-capturedblockvariable)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md
index 526200dba4633..1ce9700235ad5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.NewArraySize.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.uninitialized.NewArraySize
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-newarraysize"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-newarraysize
+```{title} clang-tidy - clang-analyzer-core.uninitialized.NewArraySize
```
# clang-analyzer-core.uninitialized.NewArraySize
@@ -13,4 +14,3 @@ Check if the size of the array in a new[] expression is undefined.
The `clang-analyzer-core.uninitialized.NewArraySize` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-newarraysize)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md
index 20cd7e0f4957b..e010a5c69d4f8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/core.uninitialized.UndefReturn.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-core.uninitialized.UndefReturn
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-undefreturn"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-undefreturn
+```{title} clang-tidy - clang-analyzer-core.uninitialized.UndefReturn
```
# clang-analyzer-core.uninitialized.UndefReturn
@@ -13,4 +14,3 @@ Check for uninitialized values being returned to the caller.
The `clang-analyzer-core.uninitialized.UndefReturn` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#core-uninitialized-undefreturn)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md
index 1b4a103c926e5..cdd12d6d943b3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.ArrayDelete.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.ArrayDelete
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-arraydelete"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-arraydelete
+```{title} clang-tidy - clang-analyzer-cplusplus.ArrayDelete
```
# clang-analyzer-cplusplus.ArrayDelete
@@ -14,4 +15,3 @@ their base class.
The `clang-analyzer-cplusplus.ArrayDelete` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-arraydelete)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md
index fa7b79b719a03..426328f7a051c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.InnerPointer.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.InnerPointer
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-innerpointer"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-innerpointer
+```{title} clang-tidy - clang-analyzer-cplusplus.InnerPointer
```
# clang-analyzer-cplusplus.InnerPointer
@@ -13,4 +14,3 @@ Check for inner pointers of C++ containers used after re/deallocation.
The `clang-analyzer-cplusplus.InnerPointer` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-innerpointer)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md
index 224cf6f398dab..8b782b429df48 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.Move.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.Move
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-move"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-move
+```{title} clang-tidy - clang-analyzer-cplusplus.Move
```
# clang-analyzer-cplusplus.Move
@@ -13,4 +14,3 @@ Find use-after-move bugs in C++.
The `clang-analyzer-cplusplus.Move` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-move)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md
index 9aeff02b3cd51..32aabaf13f8a1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDelete.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.NewDelete
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdelete"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdelete
+```{title} clang-tidy - clang-analyzer-cplusplus.NewDelete
```
# clang-analyzer-cplusplus.NewDelete
@@ -14,4 +15,3 @@ new/delete.
The `clang-analyzer-cplusplus.NewDelete` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdelete)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md
index 2179cff75f1e2..2885ab16a25ee 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.NewDeleteLeaks.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.NewDeleteLeaks
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdeleteleaks"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdeleteleaks
+```{title} clang-tidy - clang-analyzer-cplusplus.NewDeleteLeaks
```
# clang-analyzer-cplusplus.NewDeleteLeaks
@@ -13,4 +14,3 @@ Check for memory leaks. Traces memory managed by new/delete.
The `clang-analyzer-cplusplus.NewDeleteLeaks` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-newdeleteleaks)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md
index 9b727086417cb..29252a47162a5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.PlacementNew.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.PlacementNew
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-placementnew"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-placementnew
+```{title} clang-tidy - clang-analyzer-cplusplus.PlacementNew
```
# clang-analyzer-cplusplus.PlacementNew
@@ -14,4 +15,3 @@ capacity.
The `clang-analyzer-cplusplus.PlacementNew` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-placementnew)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md
index 666e7a4f0a072..4501e68b9cedd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.SelfAssignment.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.SelfAssignment
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-selfassignment"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-selfassignment
+```{title} clang-tidy - clang-analyzer-cplusplus.SelfAssignment
```
# clang-analyzer-cplusplus.SelfAssignment
@@ -11,6 +12,5 @@
Checks C++ copy and move assignment operators for self assignment.
The `clang-analyzer-cplusplus.SelfAssignment` check is an alias, please see
-[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker)
+[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-selfassignment)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md
index 845e0aae0b0f7..2c93f327fd362 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/cplusplus.StringChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-cplusplus.StringChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker
+```{title} clang-tidy - clang-analyzer-cplusplus.StringChecker
```
# clang-analyzer-cplusplus.StringChecker
@@ -13,4 +14,3 @@ Checks C++ std::string bugs.
The `clang-analyzer-cplusplus.StringChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#cplusplus-stringchecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md
index e320575ea087d..3bf7039dde4ca 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/deadcode.DeadStores.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-deadcode.DeadStores
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#deadcode-deadstores"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#deadcode-deadstores
+```{title} clang-tidy - clang-analyzer-deadcode.DeadStores
```
# clang-analyzer-deadcode.DeadStores
@@ -13,4 +14,3 @@ Check for values stored to variables that are never read afterwards.
The `clang-analyzer-deadcode.DeadStores` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#deadcode-deadstores)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md
index 8a3b59a9b6f91..0709e61da966b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/fuchsia.HandleChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-fuchsia.HandleChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#fuchsia-handlechecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#fuchsia-handlechecker
+```{title} clang-tidy - clang-analyzer-fuchsia.HandleChecker
```
# clang-analyzer-fuchsia.HandleChecker
@@ -13,4 +14,3 @@ A Checker that detect leaks related to Fuchsia handles.
The `clang-analyzer-fuchsia.HandleChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#fuchsia-handlechecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md
index 02ca0e14aa41f..fce4cbb4e70de 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullPassedToNonnull.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-nullability.NullPassedToNonnull
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullpassedtononnull"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullpassedtononnull
+```{title} clang-tidy - clang-analyzer-nullability.NullPassedToNonnull
```
# clang-analyzer-nullability.NullPassedToNonnull
@@ -13,4 +14,3 @@ Warns when a null pointer is passed to a pointer which has a \_Nonnull type.
The `clang-analyzer-nullability.NullPassedToNonnull` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullpassedtononnull)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md
index 4943cf8697759..f51adaeed92b4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullReturnedFromNonnull.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-nullability.NullReturnedFromNonnull
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullreturnedfromnonnull"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullreturnedfromnonnull
+```{title} clang-tidy - clang-analyzer-nullability.NullReturnedFromNonnull
```
# clang-analyzer-nullability.NullReturnedFromNonnull
@@ -14,4 +15,3 @@ type.
The `clang-analyzer-nullability.NullReturnedFromNonnull` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullreturnedfromnonnull)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md
index 2eaf77a9af733..94b6c5869cb32 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableDereferenced.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-nullability.NullableDereferenced
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullabledereferenced"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullabledereferenced
+```{title} clang-tidy - clang-analyzer-nullability.NullableDereferenced
```
# clang-analyzer-nullability.NullableDereferenced
@@ -13,4 +14,3 @@ Warns when a nullable pointer is dereferenced.
The `clang-analyzer-nullability.NullableDereferenced` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullabledereferenced)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md
index 302a0ad63779c..9a0382db43ee5 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullablePassedToNonnull.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-nullability.NullablePassedToNonnull
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablepassedtononnull"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablepassedtononnull
+```{title} clang-tidy - clang-analyzer-nullability.NullablePassedToNonnull
```
# clang-analyzer-nullability.NullablePassedToNonnull
@@ -13,4 +14,3 @@ Warns when a nullable pointer is passed to a pointer which has a \_Nonnull type.
The `clang-analyzer-nullability.NullablePassedToNonnull` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablepassedtononnull)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md
index cb7654416fbcc..9b5615cadf5e0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/nullability.NullableReturnedFromNonnull.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-nullability.NullableReturnedFromNonnull
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablereturnedfromnonnull"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablereturnedfromnonnull
+```{title} clang-tidy - clang-analyzer-nullability.NullableReturnedFromNonnull
```
# clang-analyzer-nullability.NullableReturnedFromNonnull
@@ -14,4 +15,3 @@ return type.
The `clang-analyzer-nullability.NullableReturnedFromNonnull` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#nullability-nullablereturnedfromnonnull)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md
index d28b91477966d..ffbe137498758 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.core.EnumCastOutOfRange.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.core.EnumCastOutOfRange
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-core-enumcastoutofrange"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-core-enumcastoutofrange
+```{title} clang-tidy - clang-analyzer-optin.core.EnumCastOutOfRange
```
# clang-analyzer-optin.core.EnumCastOutOfRange
@@ -13,4 +14,3 @@ Check integer to enumeration casts for out of range values.
The `clang-analyzer-optin.core.EnumCastOutOfRange` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-core-enumcastoutofrange)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md
index fb5441d595fb4..5d9f6e0e95804 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.UninitializedObject.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.cplusplus.UninitializedObject
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-uninitializedobject"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-uninitializedobject
+```{title} clang-tidy - clang-analyzer-optin.cplusplus.UninitializedObject
```
# clang-analyzer-optin.cplusplus.UninitializedObject
@@ -13,4 +14,3 @@ Reports uninitialized fields after object construction.
The `clang-analyzer-optin.cplusplus.UninitializedObject` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-uninitializedobject)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md
index 64c1a1043cf26..f1e574f9b716e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.cplusplus.VirtualCall.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.cplusplus.VirtualCall
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-virtualcall"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-virtualcall
+```{title} clang-tidy - clang-analyzer-optin.cplusplus.VirtualCall
```
# clang-analyzer-optin.cplusplus.VirtualCall
@@ -13,4 +14,3 @@ Check virtual function calls during construction/destruction.
The `clang-analyzer-optin.cplusplus.VirtualCall` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-cplusplus-virtualcall)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md
index 5d9f0f0f6f1be..cd1cb5e83f95d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.mpi.MPI-Checker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.mpi.MPI-Checker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-mpi-mpi-checker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-mpi-mpi-checker
+```{title} clang-tidy - clang-analyzer-optin.mpi.MPI-Checker
```
# clang-analyzer-optin.mpi.MPI-Checker
@@ -13,4 +14,3 @@ Checks MPI code.
The `clang-analyzer-optin.mpi.MPI-Checker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-mpi-mpi-checker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md
index a6451823f9985..e41d614da09c9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.EmptyLocalizationContextChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-emptylocalizationcontextchecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-emptylocalizationcontextchecker
+```{title} clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
```
# clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker
@@ -13,4 +14,3 @@ Check that NSLocalizedString macros include a comment for context.
The `clang-analyzer-optin.osx.cocoa.localizability.EmptyLocalizationContextChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-emptylocalizationcontextchecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md
index 94f1642c4e5f7..49042a697e248 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.osx.cocoa.localizability.NonLocalizedStringChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-nonlocalizedstringchecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-nonlocalizedstringchecker
+```{title} clang-tidy - clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
```
# clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker
@@ -14,4 +15,3 @@ localized NSStrings.
The `clang-analyzer-optin.osx.cocoa.localizability.NonLocalizedStringChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-osx-cocoa-localizability-nonlocalizedstringchecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md
index 27f03abe68b10..08234fc6798a2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.GCDAntipattern.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.performance.GCDAntipattern
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-gcdantipattern"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-gcdantipattern
+```{title} clang-tidy - clang-analyzer-optin.performance.GCDAntipattern
```
# clang-analyzer-optin.performance.GCDAntipattern
@@ -13,4 +14,3 @@ Check for performance anti-patterns when using Grand Central Dispatch.
The `clang-analyzer-optin.performance.GCDAntipattern` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-gcdantipattern)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md
index 890605955ef39..3504532821c9d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.performance.Padding.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.performance.Padding
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-padding"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-padding
+```{title} clang-tidy - clang-analyzer-optin.performance.Padding
```
# clang-analyzer-optin.performance.Padding
@@ -13,4 +14,3 @@ Check for excessively padded structs.
The `clang-analyzer-optin.performance.Padding` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-performance-padding)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md
index 3a840d9e62a9e..c39eb57b9e871 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.portability.UnixAPI.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.portability.UnixAPI
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-portability-unixapi"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-portability-unixapi
+```{title} clang-tidy - clang-analyzer-optin.portability.UnixAPI
```
# clang-analyzer-optin.portability.UnixAPI
@@ -13,4 +14,3 @@ Finds implementation-defined behavior in UNIX/Posix functions.
The `clang-analyzer-optin.portability.UnixAPI` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-portability-unixapi)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md
index 1b1b95c4c487e..39d21dbfb5c34 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/optin.taint.TaintedAlloc.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-optin.taint.TaintedAlloc
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-taint-taintedalloc"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#optin-taint-taintedalloc
+```{title} clang-tidy - clang-analyzer-optin.taint.TaintedAlloc
```
# clang-analyzer-optin.taint.TaintedAlloc
@@ -14,4 +15,3 @@ Check for memory allocations, where the size parameter might be a tainted
The `clang-analyzer-optin.taint.TaintedAlloc` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#optin-taint-taintedalloc)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md
index 81dc66073f481..a03c25e7c259c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.API.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.API
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-api"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-api
+```{title} clang-tidy - clang-analyzer-osx.API
```
# clang-analyzer-osx.API
@@ -13,4 +14,3 @@ Check for proper uses of various Apple APIs.
The `clang-analyzer-osx.API` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-api)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md
index 43a92542c008e..f4c2e31ecd73d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.NumberObjectConversion.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.NumberObjectConversion
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-numberobjectconversion"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-numberobjectconversion
+```{title} clang-tidy - clang-analyzer-osx.NumberObjectConversion
```
# clang-analyzer-osx.NumberObjectConversion
@@ -13,4 +14,3 @@ Check for erroneous conversions of objects representing numbers into numbers.
The `clang-analyzer-osx.NumberObjectConversion` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-numberobjectconversion)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md
index 322ba1aff5bc3..ce05e92d835c0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.ObjCProperty.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.ObjCProperty
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-objcproperty"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-objcproperty
+```{title} clang-tidy - clang-analyzer-osx.ObjCProperty
```
# clang-analyzer-osx.ObjCProperty
@@ -13,4 +14,3 @@ Check for proper uses of Objective-C properties.
The `clang-analyzer-osx.ObjCProperty` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-objcproperty)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md
index cfa928ca167f4..163c7663c5ecc 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.SecKeychainAPI.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.SecKeychainAPI
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-seckeychainapi"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-seckeychainapi
+```{title} clang-tidy - clang-analyzer-osx.SecKeychainAPI
```
# clang-analyzer-osx.SecKeychainAPI
@@ -13,4 +14,3 @@ Check for proper uses of Secure Keychain APIs.
The `clang-analyzer-osx.SecKeychainAPI` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-seckeychainapi)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md
index 85c7c45f727e8..ed7cb155487da 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AtSync.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.AtSync
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-atsync"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-atsync
+```{title} clang-tidy - clang-analyzer-osx.cocoa.AtSync
```
# clang-analyzer-osx.cocoa.AtSync
@@ -13,4 +14,3 @@ Check for nil pointers used as mutexes for @synchronized.
The `clang-analyzer-osx.cocoa.AtSync` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-atsync)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md
index 5b2dd1c1c94d9..b23200ec6a170 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.AutoreleaseWrite.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.AutoreleaseWrite
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-autoreleasewrite"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-autoreleasewrite
+```{title} clang-tidy - clang-analyzer-osx.cocoa.AutoreleaseWrite
```
# clang-analyzer-osx.cocoa.AutoreleaseWrite
@@ -14,4 +15,3 @@ autoreleasing pools in Objective-C.
The `clang-analyzer-osx.cocoa.AutoreleaseWrite` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-autoreleasewrite)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md
index 5a6c685a35b47..b1b5edcbb799f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ClassRelease.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.ClassRelease
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-classrelease"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-classrelease
+```{title} clang-tidy - clang-analyzer-osx.cocoa.ClassRelease
```
# clang-analyzer-osx.cocoa.ClassRelease
@@ -13,4 +14,3 @@ Check for sending 'retain', 'release', or 'autorelease' directly to a Class.
The `clang-analyzer-osx.cocoa.ClassRelease` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-classrelease)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md
index 65c12a21a9e86..3554d29dd143c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Dealloc.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.Dealloc
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-dealloc"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-dealloc
+```{title} clang-tidy - clang-analyzer-osx.cocoa.Dealloc
```
# clang-analyzer-osx.cocoa.Dealloc
@@ -13,4 +14,3 @@ Warn about Objective-C classes that lack a correct implementation of -dealloc.
The `clang-analyzer-osx.cocoa.Dealloc` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-dealloc)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md
index 2a39cf7005730..ef4968acc1403 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.IncompatibleMethodTypes.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.IncompatibleMethodTypes
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-incompatiblemethodtypes"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-incompatiblemethodtypes
+```{title} clang-tidy - clang-analyzer-osx.cocoa.IncompatibleMethodTypes
```
# clang-analyzer-osx.cocoa.IncompatibleMethodTypes
@@ -13,4 +14,3 @@ Warn about Objective-C method signatures with type incompatibilities.
The `clang-analyzer-osx.cocoa.IncompatibleMethodTypes` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-incompatiblemethodtypes)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md
index e20bccb258de3..546da9075fbbf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.Loops.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.Loops
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-loops"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-loops
+```{title} clang-tidy - clang-analyzer-osx.cocoa.Loops
```
# clang-analyzer-osx.cocoa.Loops
@@ -13,4 +14,3 @@ Improved modeling of loops using Cocoa collection types.
The `clang-analyzer-osx.cocoa.Loops` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-loops)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md
index 09c62c3b36684..5a6adf32ab194 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.MissingSuperCall.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.MissingSuperCall
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-missingsupercall"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-missingsupercall
+```{title} clang-tidy - clang-analyzer-osx.cocoa.MissingSuperCall
```
# clang-analyzer-osx.cocoa.MissingSuperCall
@@ -13,4 +14,3 @@ Warn about Objective-C methods that lack a necessary call to super.
The `clang-analyzer-osx.cocoa.MissingSuperCall` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-missingsupercall)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md
index 004988fa79e3d..6c49225e53917 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSAutoreleasePool.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.NSAutoreleasePool
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nsautoreleasepool"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nsautoreleasepool
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NSAutoreleasePool
```
# clang-analyzer-osx.cocoa.NSAutoreleasePool
@@ -13,4 +14,3 @@ Warn for suboptimal uses of NSAutoreleasePool in Objective-C GC mode.
The `clang-analyzer-osx.cocoa.NSAutoreleasePool` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nsautoreleasepool)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md
index 0e5f68d7a40ed..9c785d3ec5f09 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NSError.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.NSError
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nserror"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nserror
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NSError
```
# clang-analyzer-osx.cocoa.NSError
@@ -13,4 +14,3 @@ Check usage of NSError\*\* parameters.
The `clang-analyzer-osx.cocoa.NSError` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nserror)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md
index 03c78d462b25d..3ccfe42052fe1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NilArg.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.NilArg
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nilarg"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nilarg
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NilArg
```
# clang-analyzer-osx.cocoa.NilArg
@@ -13,4 +14,3 @@ Check for prohibited nil arguments to ObjC method calls.
The `clang-analyzer-osx.cocoa.NilArg` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nilarg)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md
index 8eb3d8227f583..c9ee3db82fd44 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.NonNilReturnValue.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.NonNilReturnValue
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nonnilreturnvalue"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nonnilreturnvalue
+```{title} clang-tidy - clang-analyzer-osx.cocoa.NonNilReturnValue
```
# clang-analyzer-osx.cocoa.NonNilReturnValue
@@ -13,4 +14,3 @@ Model the APIs that are guaranteed to return a non-nil value.
The `clang-analyzer-osx.cocoa.NonNilReturnValue` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-nonnilreturnvalue)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md
index df3fe1be5207e..4c4a5f18d67b6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.ObjCGenerics.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.ObjCGenerics
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-objcgenerics"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-objcgenerics
+```{title} clang-tidy - clang-analyzer-osx.cocoa.ObjCGenerics
```
# clang-analyzer-osx.cocoa.ObjCGenerics
@@ -13,4 +14,3 @@ Check for type errors when using Objective-C generics.
The `clang-analyzer-osx.cocoa.ObjCGenerics` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-objcgenerics)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md
index e2b041f4e7ab4..26bb8b55c14d8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RetainCount.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.RetainCount
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-retaincount"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-retaincount
+```{title} clang-tidy - clang-analyzer-osx.cocoa.RetainCount
```
# clang-analyzer-osx.cocoa.RetainCount
@@ -13,4 +14,3 @@ Check for leaks and improper reference count management.
The `clang-analyzer-osx.cocoa.RetainCount` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-retaincount)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md
index f9d6e230aae34..7b80541c5fe48 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.RunLoopAutoreleaseLeak.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-runloopautoreleaseleak"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-runloopautoreleaseleak
+```{title} clang-tidy - clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
```
# clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak
@@ -13,4 +14,3 @@ Check for leaked memory in autorelease pools that will never be drained.
The `clang-analyzer-osx.cocoa.RunLoopAutoreleaseLeak` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-runloopautoreleaseleak)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md
index 2a4f3392f3966..9d10e57aea172 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SelfInit.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.SelfInit
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-selfinit"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-selfinit
+```{title} clang-tidy - clang-analyzer-osx.cocoa.SelfInit
```
# clang-analyzer-osx.cocoa.SelfInit
@@ -13,4 +14,3 @@ Check that 'self' is properly initialized inside an initializer method.
The `clang-analyzer-osx.cocoa.SelfInit` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-selfinit)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md
index da8fc4f188159..8191d7eeefc17 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.SuperDealloc.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.SuperDealloc
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-superdealloc"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-superdealloc
+```{title} clang-tidy - clang-analyzer-osx.cocoa.SuperDealloc
```
# clang-analyzer-osx.cocoa.SuperDealloc
@@ -13,4 +14,3 @@ Warn about improper use of '[super dealloc]' in Objective-C.
The `clang-analyzer-osx.cocoa.SuperDealloc` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-superdealloc)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md
index 3226ac073acb9..b6e6a9c9ab956 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.UnusedIvars.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.UnusedIvars
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-unusedivars"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-unusedivars
+```{title} clang-tidy - clang-analyzer-osx.cocoa.UnusedIvars
```
# clang-analyzer-osx.cocoa.UnusedIvars
@@ -13,4 +14,3 @@ Warn about private ivars that are never used.
The `clang-analyzer-osx.cocoa.UnusedIvars` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-unusedivars)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md
index 9f65e5efdfbd5..122d4a4a78f3d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.cocoa.VariadicMethodTypes.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.cocoa.VariadicMethodTypes
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-variadicmethodtypes"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-variadicmethodtypes
+```{title} clang-tidy - clang-analyzer-osx.cocoa.VariadicMethodTypes
```
# clang-analyzer-osx.cocoa.VariadicMethodTypes
@@ -14,4 +15,3 @@ methods that expect only Objective-C types.
The `clang-analyzer-osx.cocoa.VariadicMethodTypes` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-cocoa-variadicmethodtypes)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md
index 27afcb8081342..13aa1b13dd4eb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFError.md
@@ -1,16 +1,16 @@
-```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFError
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cferror"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cferror
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFError
```
# clang-analyzer-osx.coreFoundation.CFError
-Check usage of CFErrorRef\* parameters.
+Check usage of `CFErrorRef *` parameters.
The `clang-analyzer-osx.coreFoundation.CFError` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cferror)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md
index cc77356508e5a..ccc8fed6ceb2a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFNumber.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFNumber
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfnumber"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfnumber
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFNumber
```
# clang-analyzer-osx.coreFoundation.CFNumber
@@ -13,4 +14,3 @@ Check for proper uses of CFNumber APIs.
The `clang-analyzer-osx.coreFoundation.CFNumber` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfnumber)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md
index a74c36bba82e5..e07555b1d7206 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.CFRetainRelease.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFRetainRelease
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfretainrelease"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfretainrelease
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.CFRetainRelease
```
# clang-analyzer-osx.coreFoundation.CFRetainRelease
@@ -13,4 +14,3 @@ Check for null arguments to CFRetain/CFRelease/CFMakeCollectable.
The `clang-analyzer-osx.coreFoundation.CFRetainRelease` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-cfretainrelease)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md
index 3c92207b598ad..01ef741b26263 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.OutOfBounds.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.coreFoundation.containers.OutOfBounds
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-outofbounds"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-outofbounds
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.containers.OutOfBounds
```
# clang-analyzer-osx.coreFoundation.containers.OutOfBounds
@@ -13,4 +14,3 @@ Checks for index out-of-bounds when using 'CFArray' API.
The `clang-analyzer-osx.coreFoundation.containers.OutOfBounds` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-outofbounds)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md
index 648900cb83e9c..38a89c1be0008 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/osx.coreFoundation.containers.PointerSizedValues.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-pointersizedvalues"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-pointersizedvalues
+```{title} clang-tidy - clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
```
# clang-analyzer-osx.coreFoundation.containers.PointerSizedValues
@@ -14,4 +15,3 @@ values.
The `clang-analyzer-osx.coreFoundation.containers.PointerSizedValues` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#osx-corefoundation-containers-pointersizedvalues)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md
index 5ee97a863e8d9..f5d025f8cf648 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.FloatLoopCounter.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.FloatLoopCounter
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-floatloopcounter"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-floatloopcounter
+```{title} clang-tidy - clang-analyzer-security.FloatLoopCounter
```
# clang-analyzer-security.FloatLoopCounter
@@ -14,4 +15,3 @@ FLP30-CPP).
The `clang-analyzer-security.FloatLoopCounter` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-floatloopcounter)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md
index a0021039a6627..7e7b67bbb36ca 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.PutenvStackArray.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.PutenvStackArray
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-putenvstackarray-c"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-putenvstackarray-c
+```{title} clang-tidy - clang-analyzer-security.PutenvStackArray
```
# clang-analyzer-security.PutenvStackArray
@@ -17,4 +18,3 @@ after exiting from the function.
The `clang-analyzer-security.PutenvStackArray` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-putenvstackarray-c)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md
index 7cc71f790fc2b..09f9127d05155 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.SetgidSetuidOrder.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.SetgidSetuidOrder
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-setgidsetuidorder-c"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-setgidsetuidorder-c
+```{title} clang-tidy - clang-analyzer-security.SetgidSetuidOrder
```
# clang-analyzer-security.SetgidSetuidOrder
@@ -19,4 +20,3 @@ a variable.
The `clang-analyzer-security.SetgidSetuidOrder` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-setgidsetuidorder-c)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md
index f7e935d8f3a83..bcf14bcdbd513 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.cert.env.InvalidPtr.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.cert.env.InvalidPtr
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-cert-env-invalidptr"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-cert-env-invalidptr
+```{title} clang-tidy - clang-analyzer-security.cert.env.InvalidPtr
```
# clang-analyzer-security.cert.env.InvalidPtr
@@ -13,4 +14,3 @@ Finds usages of possibly invalidated pointers.
The `clang-analyzer-security.cert.env.InvalidPtr` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-cert-env-invalidptr)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md
index 39046f2c3a384..a3235183796df 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.DeprecatedOrUnsafeBufferHandling.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-deprecatedorunsafebufferhandling"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-deprecatedorunsafebufferhandling
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
```
# clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling
@@ -13,4 +14,3 @@ Warn on uses of unsecure or deprecated buffer manipulating functions.
The `clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-deprecatedorunsafebufferhandling)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md
index 7f8ef7f62d1c0..7ec00c4f1045e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.UncheckedReturn.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.UncheckedReturn
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-uncheckedreturn"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-uncheckedreturn
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.UncheckedReturn
```
# clang-analyzer-security.insecureAPI.UncheckedReturn
@@ -13,4 +14,3 @@ Warn on uses of functions whose return values must be always checked.
The `clang-analyzer-security.insecureAPI.UncheckedReturn` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-uncheckedreturn)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md
index 4adc2683a13ae..422117f1c8ac7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcmp.md
@@ -1,16 +1,16 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.bcmp
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcmp"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcmp
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.bcmp
```
# clang-analyzer-security.insecureAPI.bcmp
-Warn on uses of the 'bcmp' function.
+Warn on uses of the `bcmp` function.
The `clang-analyzer-security.insecureAPI.bcmp` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcmp)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md
index 67665bbc979cc..307638b60aa4b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bcopy.md
@@ -1,16 +1,16 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.bcopy
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcopy"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcopy
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.bcopy
```
# clang-analyzer-security.insecureAPI.bcopy
-Warn on uses of the 'bcopy' function.
+Warn on uses of the `bcopy` function.
The `clang-analyzer-security.insecureAPI.bcopy` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bcopy)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md
index 4927986d2634f..fcef8619de5a9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.bzero.md
@@ -1,16 +1,16 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.bzero
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bzero"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bzero
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.bzero
```
# clang-analyzer-security.insecureAPI.bzero
-Warn on uses of the 'bzero' function.
+Warn on uses of the `bzero` function.
The `clang-analyzer-security.insecureAPI.bzero` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-bzero)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md
index d3d8efed90045..ccf64e51b8971 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.decodeValueOfObjCType.md
@@ -1,16 +1,16 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.decodeValueOfObjCType
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-decodevalueofobjctype"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-decodevalueofobjctype
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.decodeValueOfObjCType
```
# clang-analyzer-security.insecureAPI.decodeValueOfObjCType
-Warn on uses of the '-decodeValueOfObjCType:at:' method.
+Warn on uses of the `-decodeValueOfObjCType:at:` method.
The `clang-analyzer-security.insecureAPI.decodeValueOfObjCType` check is an alias, please see
[Clang Static Analyzer security.insecureAPI.decodeValueOfObjCType](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-decodevalueofobjctype)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md
index 14942b8513a90..b09aadc429c0e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.getpw.md
@@ -1,16 +1,16 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.getpw
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-getpw"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-getpw
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.getpw
```
# clang-analyzer-security.insecureAPI.getpw
-Warn on uses of the 'getpw' function.
+Warn on uses of the `getpw` function.
The `clang-analyzer-security.insecureAPI.getpw` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-getpw)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md
index cd5873022108d..58cdeda8238b4 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.gets.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.gets
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-gets"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-gets
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.gets
```
# clang-analyzer-security.insecureAPI.gets
@@ -13,4 +14,3 @@ Warn on uses of the 'gets' function.
The `clang-analyzer-security.insecureAPI.gets` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-gets)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md
index 92609acdb3a6d..66d8b5be3b9bf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mkstemp.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.mkstemp
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mkstemp"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mkstemp
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.mkstemp
```
# clang-analyzer-security.insecureAPI.mkstemp
@@ -13,4 +14,3 @@ Warn when 'mkstemp' is passed fewer than 6 X's in the format string.
The `clang-analyzer-security.insecureAPI.mkstemp` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mkstemp)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md
index ad4b01918e219..517a735cbdd58 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.mktemp.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.mktemp
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mktemp"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mktemp
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.mktemp
```
# clang-analyzer-security.insecureAPI.mktemp
@@ -13,4 +14,3 @@ Warn on uses of the 'mktemp' function.
The `clang-analyzer-security.insecureAPI.mktemp` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-mktemp)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md
index 9f41836183cea..33fb45b9361a6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.rand.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.rand
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-rand"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-rand
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.rand
```
# clang-analyzer-security.insecureAPI.rand
@@ -13,4 +14,3 @@ Warn on uses of the 'rand', 'random', and related functions.
The `clang-analyzer-security.insecureAPI.rand` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-rand)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md
index b2f7e24e3cc64..77323857b3a80 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.strcpy.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.strcpy
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-strcpy"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-strcpy
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.strcpy
```
# clang-analyzer-security.insecureAPI.strcpy
@@ -13,4 +14,3 @@ Warn on uses of the 'strcpy' and 'strcat' functions.
The `clang-analyzer-security.insecureAPI.strcpy` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-strcpy)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md
index 3b9486fa75f86..e7e16b4e44dcb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/security.insecureAPI.vfork.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-security.insecureAPI.vfork
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-vfork"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-vfork
+```{title} clang-tidy - clang-analyzer-security.insecureAPI.vfork
```
# clang-analyzer-security.insecureAPI.vfork
@@ -13,4 +14,3 @@ Warn on uses of the 'vfork' function.
The `clang-analyzer-security.insecureAPI.vfork` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#security-insecureapi-vfork)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md
index ffd6485a81964..b2756d9fd4a00 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.API.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.API
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-api"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-api
+```{title} clang-tidy - clang-analyzer-unix.API
```
# clang-analyzer-unix.API
@@ -13,4 +14,3 @@ Check calls to various UNIX/Posix functions.
The `clang-analyzer-unix.API` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-api)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md
index 0998aaa766323..c92835e215f3c 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.BlockInCriticalSection.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.BlockInCriticalSection
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-blockincriticalsection"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-blockincriticalsection
+```{title} clang-tidy - clang-analyzer-unix.BlockInCriticalSection
```
# clang-analyzer-unix.BlockInCriticalSection
@@ -13,4 +14,3 @@ Check for calls to blocking functions inside a critical section.
The `clang-analyzer-unix.BlockInCriticalSection` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-blockincriticalsection)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md
index a0e96a6134184..ad8320deb6f68 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Errno.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.Errno
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-errno"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-errno
+```{title} clang-tidy - clang-analyzer-unix.Errno
```
# clang-analyzer-unix.Errno
@@ -13,4 +14,3 @@ Check for improper use of 'errno'.
The `clang-analyzer-unix.Errno` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-errno)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md
index d89551e9f2713..9b332903e7e90 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Malloc.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.Malloc
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-malloc"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-malloc
+```{title} clang-tidy - clang-analyzer-unix.Malloc
```
# clang-analyzer-unix.Malloc
@@ -14,4 +15,3 @@ managed by malloc()/free().
The `clang-analyzer-unix.Malloc` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-malloc)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md
index a71e38eb61773..89b8f6d6cc206 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MallocSizeof.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.MallocSizeof
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-mallocsizeof"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-mallocsizeof
+```{title} clang-tidy - clang-analyzer-unix.MallocSizeof
```
# clang-analyzer-unix.MallocSizeof
@@ -13,4 +14,3 @@ Check for dubious malloc arguments involving sizeof.
The `clang-analyzer-unix.MallocSizeof` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-mallocsizeof)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md
index 1643399d2793e..cb7f6f8b70bac 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.MismatchedDeallocator.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.MismatchedDeallocator
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-mismatcheddeallocator"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-mismatcheddeallocator
+```{title} clang-tidy - clang-analyzer-unix.MismatchedDeallocator
```
# clang-analyzer-unix.MismatchedDeallocator
@@ -13,4 +14,3 @@ Check for mismatched deallocators.
The `clang-analyzer-unix.MismatchedDeallocator` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-mismatcheddeallocator)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md
index 8399b0ff6d50b..161489e32af94 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.StdCLibraryFunctions.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.StdCLibraryFunctions
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-stdclibraryfunctions"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-stdclibraryfunctions
+```{title} clang-tidy - clang-analyzer-unix.StdCLibraryFunctions
```
# clang-analyzer-unix.StdCLibraryFunctions
@@ -14,4 +15,3 @@ relations between arguments and return value.
The `clang-analyzer-unix.StdCLibraryFunctions` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-stdclibraryfunctions)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md
index 79a469dc9b2bc..c824437464b28 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Stream.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.Stream
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-stream"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-stream
+```{title} clang-tidy - clang-analyzer-unix.Stream
```
# clang-analyzer-unix.Stream
@@ -13,4 +14,3 @@ Check stream handling functions.
The `clang-analyzer-unix.Stream` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-stream)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md
index 6ba5bac2a20e0..1b56561edc93b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.Vfork.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.Vfork
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-vfork"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-vfork
+```{title} clang-tidy - clang-analyzer-unix.Vfork
```
# clang-analyzer-unix.Vfork
@@ -13,4 +14,3 @@ Check for proper usage of vfork.
The `clang-analyzer-unix.Vfork` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-vfork)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md
index e157bdcda26bf..914ecc6245367 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.BadSizeArg.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.cstring.BadSizeArg
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-badsizearg"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-badsizearg
+```{title} clang-tidy - clang-analyzer-unix.cstring.BadSizeArg
```
# clang-analyzer-unix.cstring.BadSizeArg
@@ -14,4 +15,3 @@ patterns.
The `clang-analyzer-unix.cstring.BadSizeArg` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-badsizearg)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md
index bda662aa7b60a..5aba8e338debb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/unix.cstring.NullArg.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-unix.cstring.NullArg
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-nullarg"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-nullarg
+```{title} clang-tidy - clang-analyzer-unix.cstring.NullArg
```
# clang-analyzer-unix.cstring.NullArg
@@ -13,4 +14,3 @@ Check for null pointers being passed as arguments to C string functions.
The `clang-analyzer-unix.cstring.NullArg` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#unix-cstring-nullarg)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md
index 6629bdcfbe1e0..e3c0f2c133bc9 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.NoUncountedMemberChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-webkit.NoUncountedMemberChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-nouncountedmemberchecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-nouncountedmemberchecker
+```{title} clang-tidy - clang-analyzer-webkit.NoUncountedMemberChecker
```
# clang-analyzer-webkit.NoUncountedMemberChecker
@@ -13,4 +14,3 @@ Check for no uncounted member variables.
The `clang-analyzer-webkit.NoUncountedMemberChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#webkit-nouncountedmemberchecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md
index 7a11b350921cb..927d2aef5803f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.RefCntblBaseVirtualDtor.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-webkit.RefCntblBaseVirtualDtor
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-refcntblbasevirtualdtor"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-refcntblbasevirtualdtor
+```{title} clang-tidy - clang-analyzer-webkit.RefCntblBaseVirtualDtor
```
# clang-analyzer-webkit.RefCntblBaseVirtualDtor
@@ -13,4 +14,3 @@ Check for any ref-countable base class having virtual destructor.
The `clang-analyzer-webkit.RefCntblBaseVirtualDtor` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#webkit-refcntblbasevirtualdtor)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md
index 0f69f94d7ff79..14518a095930b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/clang-analyzer/webkit.UncountedLambdaCapturesChecker.md
@@ -1,9 +1,10 @@
-```{title} clang-tidy - clang-analyzer-webkit.UncountedLambdaCapturesChecker
-```
+---
+myst:
+ html_meta:
+ "http-equiv=refresh": "5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-uncountedlambdacaptureschecker"
+---
-```{eval-rst}
-.. meta::
- :http-equiv=refresh: 5;URL=https://clang.llvm.org/docs/analyzer/checkers.html#webkit-uncountedlambdacaptureschecker
+```{title} clang-tidy - clang-analyzer-webkit.UncountedLambdaCapturesChecker
```
# clang-analyzer-webkit.UncountedLambdaCapturesChecker
@@ -13,4 +14,3 @@ Check uncounted lambda captures.
The `clang-analyzer-webkit.UncountedLambdaCapturesChecker` check is an alias, please see
[Clang Static Analyzer Available Checkers](https://clang.llvm.org/docs/analyzer/checkers.html#webkit-uncountedlambdacaptureschecker)
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md b/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md
index 521e78ce4d2ff..462dd103edf70 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/concurrency/thread-canceltype-asynchronous.md
@@ -10,7 +10,7 @@ type is set to asynchronous. Asynchronous cancellation type
cancellation, a cancellation point in an asynchronous signal handler may still
be acted upon and the effect is as if it was an asynchronous cancellation.
-```c++
+```cpp
pthread_setcanceltype(PTHREAD_CANCEL_ASYNCHRONOUS, &oldtype);
```
@@ -18,4 +18,3 @@ This check corresponds to the CERT C Coding Standard rule
[POS47-C. Do not use threads that can be canceled asynchronously](https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/rules/posix-pos/pos47-c/).
`cert-pos47-c` redirects here as an alias of this check.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md
index 4904021dfdcb2..ee9ddaeb25f4b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/avoid-reference-coroutine-parameters.md
@@ -9,7 +9,7 @@ parameters as values.
Examples:
-```c++
+```cpp
std::future<int> someCoroutine(int& val) {
co_await ...;
// When the coroutine is resumed, 'val' might no longer be valid.
@@ -19,4 +19,3 @@ std::future<int> someCoroutine(int& val) {
This check implements [CP.53](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#rcoro-reference-parameters)
from the C++ Core Guidelines.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md
index ce4764e047edf..552f59fb94edb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/c-copy-assignment-signature.md
@@ -4,6 +4,4 @@
# cppcoreguidelines-c-copy-assignment-signature
The `cppcoreguidelines-c-copy-assignment-signature` check is an alias,
-please see {doc}`misc-unconventional-assign-operator
-<../misc/unconventional-assign-operator>` for more information.
-
+please see {doc}`misc-unconventional-assign-operator <../misc/unconventional-assign-operator>` for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md
index 86a45039164e7..2434c7e55b325 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-move-operations.md
@@ -7,6 +7,5 @@ This check implements [C.66](https://isocpp.github.io/CppCoreGuidelines/CppCoreG
from the C++ Core Guidelines.
The `cppcoreguidelines-noexcept-move-operations` check is an alias, please see
-{doc}`performance-noexcept-move-constructor
-<../performance/noexcept-move-constructor>` for more information.
-
+{doc}`performance-noexcept-move-constructor <../performance/noexcept-move-constructor>`
+for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md
index fb8a9a6d7868b..f7c6b88ab6533 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/noexcept-swap.md
@@ -3,12 +3,11 @@
# cppcoreguidelines-noexcept-swap
-This check implements [C.83](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c83-for-value-like-types-consider-providing-a-noexcept-swap-function)
-, [C.84](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c84-a-swap-function-must-not-fail)
+This check implements [C.83](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c83-for-value-like-types-consider-providing-a-noexcept-swap-function),
+[C.84](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c84-a-swap-function-must-not-fail)
and [C.85](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c85-make-swap-noexcept)
from the C++ Core Guidelines.
-The `cppcoreguidelines-noexcept-swap check` is an alias, please see
+The `cppcoreguidelines-noexcept-swap` check is an alias, please see
{doc}`performance-noexcept-swap <../performance/noexcept-swap>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md
index 876b2c0d62725..3ff48b256d681 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/non-private-member-variables-in-classes.md
@@ -4,6 +4,5 @@
# cppcoreguidelines-non-private-member-variables-in-classes
The `cppcoreguidelines-non-private-member-variables-in-classes` check is
-an alias, please see {doc}`misc-non-private-member-variables-in-classes
-<../misc/non-private-member-variables-in-classes>` for more information.
-
+an alias, please see {doc}`misc-non-private-member-variables-in-classes <../misc/non-private-member-variables-in-classes>`
+for more information.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md
index c847408d56318..8b15508bc8eda 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-constant-array-index.md
@@ -15,18 +15,15 @@ Optionally, this check can generate fixes using `gsl::at` for indexing.
## Options
-```{eval-rst}
-.. option:: GslHeader
+```{option} GslHeader
- The check can generate fixes after this option has been set to the name of
- the include file that contains ``gsl::at()``, e.g. `"gsl/gsl.h"`.
- Default is an empty string.
+The check can generate fixes after this option has been set to the name of
+the include file that contains `gsl::at()`, e.g. `"gsl/gsl.h"`.
+Default is an empty string.
```
-```{eval-rst}
-.. option:: IncludeStyle
+```{option} IncludeStyle
- A string specifying which include-style is used, `llvm` or `google`. Default
- is `llvm`.
+A string specifying which include-style is used, `llvm` or `google`. Default
+is `llvm`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md
index b309c2ea2c4f0..7c6efe1f88917 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-bounds-pointer-arithmetic.md
@@ -15,10 +15,8 @@ profile from the C++ Core Guidelines.
## Options
-```{eval-rst}
-.. option:: AllowIncrementDecrementOperators
+```{option} AllowIncrementDecrementOperators
- When enabled, the check will allow using the prefix/postfix increment or
- decrement operators on pointers. Default is ``false``.
+When enabled, the check will allow using the prefix/postfix increment or
+decrement operators on pointers. Default is `false`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md
index 714e7c6c85287..f7635b4a3d796 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/pro-type-static-cast-downcast.md
@@ -16,10 +16,8 @@ profile from the C++ Core Guidelines.
## Options
-```{eval-rst}
-.. option:: StrictMode
+```{option} StrictMode
- When set to `false`, no warnings are emitted for casts on non-polymorphic
- types. Default is `true`.
+When set to `false`, no warnings are emitted for casts on non-polymorphic
+types. Default is `true`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md
index 4b390d22e9ee8..ce030ea740e48 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/cppcoreguidelines/slicing.md
@@ -8,7 +8,7 @@ derived object into a base object: the members of the derived object (both
member variables and virtual member functions) will be discarded. This can be
misleading especially for member function slicing, for example:
-```c++
+```cpp
struct B { int a; virtual int f(); };
struct D : B { int b; int f() override; };
@@ -23,4 +23,3 @@ use(d); // Slice.
This check implements [ES.63](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es63-dont-slice)
and [C.145](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c145-access-polymorphic-objects-through-pointers-and-references)
from the C++ Core Guidelines.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md
index 1c9c0190cd9b7..df467e392a254 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-calls.md
@@ -7,17 +7,16 @@ Warns if a function or method is called with default arguments.
For example, given the declaration:
-```c++
+```cpp
int foo(int value = 5) { return value; }
```
A function call expression that uses a default argument will be diagnosed.
Calling it without defaults will not cause a warning:
-```c++
+```cpp
foo(); // warning
foo(0); // no warning
```
See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md
index 97037510404dc..2fb9725255450 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/default-arguments-declarations.md
@@ -7,11 +7,10 @@ Warns if a function or method is declared with default parameters.
For example, the declaration:
-```c++
+```cpp
int foo(int value = 5) { return value; }
```
will cause a warning.
See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md
index fb0fec670f56a..c6a2cdb2465f7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/header-anon-namespaces.md
@@ -4,7 +4,5 @@
# fuchsia-header-anon-namespaces
The `fuchsia-header-anon-namespaces` check is an alias, please see
-{doc}`misc-anonymous-namespace-in-header
-<../misc/anonymous-namespace-in-header>`
+{doc}`misc-anonymous-namespace-in-header <../misc/anonymous-namespace-in-header>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md
index aa2f9d1fc254f..47da89631de65 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/overloaded-operator.md
@@ -8,7 +8,7 @@ operators.
For example:
-```c++
+```cpp
int operator+(int); // Warning
B &operator=(const B &Other); // No warning
@@ -16,4 +16,3 @@ B &operator=(B &&Other) // No warning
```
See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md
index bb17ab0ab3d28..117fa0c9a9780 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/fuchsia/virtual-inheritance.md
@@ -7,9 +7,8 @@ Warns if classes are defined with virtual inheritance.
For example, classes should not be defined with virtual inheritance:
-```c++
+```cpp
class B : public virtual A {}; // warning
```
See the features disallowed in Fuchsia at <https://fuchsia.dev/fuchsia-src/development/languages/c-cpp/cxx?hl=en>
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md b/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md
index f9986e7e30b85..7806e5696bfd3 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/build-namespaces.md
@@ -4,8 +4,7 @@
# google-build-namespaces
The `google-build-namespaces` check is an alias, please see
-{doc}`misc-anonymous-namespace-in-header
-<../misc/anonymous-namespace-in-header>`
+{doc}`misc-anonymous-namespace-in-header <../misc/anonymous-namespace-in-header>`
for more information.
Finds anonymous namespaces in headers.
@@ -13,4 +12,3 @@ Finds anonymous namespaces in headers.
<https://google.github.io/styleguide/cppguide.html#Namespaces>
Corresponding cpplint.py check name: `build/namespaces`.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md
index fb4f8046ba98a..cadc5a6d94dcd 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/build-using-namespace.md
@@ -11,10 +11,9 @@ The check implements the following rule of the
> You may not use a using-directive to make all names from a namespace
> available.
-```c++
+```cpp
// Forbidden -- This pollutes the namespace.
using namespace foo;
```
Corresponding cpplint.py check name: `build/namespaces`.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md
index 8c6a14e809048..fc6f941c676d1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-braces-around-statements.md
@@ -4,7 +4,5 @@
# google-readability-braces-around-statements
The `google-readability-braces-around-statements` check is an alias, please see
-{doc}`readability-braces-around-statements
-<../readability/braces-around-statements>`
+{doc}`readability-braces-around-statements <../readability/braces-around-statements>`
for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md
index 3ad55fd0f289c..c497923344147 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-namespace-comments.md
@@ -3,6 +3,5 @@
# google-readability-namespace-comments
-The `google-readability-namespace-comments check` is an alias, please see
+The `google-readability-namespace-comments` check is an alias, please see
{doc}`llvm-namespace-comment <../llvm/namespace-comment>` for more information.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md b/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md
index ed3b1188050fb..4d400169dd23f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/readability-todo.md
@@ -12,13 +12,11 @@ Corresponding cpplint.py check: `readability/todo`
## Options
-```{eval-rst}
-.. option:: Style
+```{option} Style
- A string specifying the TODO style for fix-it hints. Accepted values are
- `Hyphen` and `Parentheses`. Default is `Hyphen`.
+A string specifying the TODO style for fix-it hints. Accepted values are
+`Hyphen` and `Parentheses`. Default is `Hyphen`.
- * `Hyphen` will format the fix-it as: ``// TODO: username - details``.
- * `Parentheses` will format the fix-it as: ``// TODO(username): details``.
+* `Hyphen` will format the fix-it as: `// TODO: username - details`.
+* `Parentheses` will format the fix-it as: `// TODO(username): details`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md
index 191859d911a1e..5b959d3a045e6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/google/runtime-int.md
@@ -13,21 +13,14 @@ Corresponding cpplint.py check: `runtime/int`.
## Options
-```{eval-rst}
-.. option:: UnsignedTypePrefix
-
- A string specifying the unsigned type prefix. Default is `uint`.
+```{option} UnsignedTypePrefix
+A string specifying the unsigned type prefix. Default is `uint`.
```
-```{eval-rst}
-.. option:: SignedTypePrefix
-
- A string specifying the signed type prefix. Default is `int`.
+```{option} SignedTypePrefix
+A string specifying the signed type prefix. Default is `int`.
```
-```{eval-rst}
-.. option:: TypeSuffix
-
- A string specifying the type suffix. Default is an empty string.
+```{option} TypeSuffix
+A string specifying the type suffix. Default is an empty string.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md
index 1ce5d8316f285..19822c6f1f817 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/prefer-register-over-unsigned.md
@@ -9,7 +9,7 @@ them to use `Register`.
Currently this works by finding all variables of unsigned integer type whose
initializer begins with an implicit cast from `Register` to `unsigned`.
-```c++
+```cpp
void example(MachineOperand &MO) {
unsigned Reg = MO.getReg();
...
@@ -18,10 +18,9 @@ void example(MachineOperand &MO) {
becomes:
-```c++
+```cpp
void example(MachineOperand &MO) {
Register Reg = MO.getReg();
...
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md b/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md
index 80e17a0a23111..ecfe58e0f4666 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvm/use-new-mlir-op-builder.md
@@ -8,13 +8,12 @@ and suggests using `T::create` instead.
## Example
-```c++
+```cpp
builder.create<FooOp>(builder.getUnknownLoc(), "baz");
```
Transforms to:
-```c++
+```cpp
FooOp::create(builder, builder.getUnknownLoc(), "baz");
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md
index cb4530fef4bf7..5b290dc2dae83 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/llvmlibc/callee-namespace.md
@@ -5,7 +5,7 @@
Checks all calls resolve to functions within correct namespace.
-```c++
+```cpp
// Implementation inside the LIBC_NAMESPACE namespace.
// Correct if:
// - LIBC_NAMESPACE is a macro
@@ -26,4 +26,3 @@ strlen("world");
} // namespace LIBC_NAMESPACE
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md b/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md
index 29ddfea0a3ef6..2ac6a5ca3b7f8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/misleading-bidirectional.md
@@ -8,7 +8,7 @@ as described in the [Trojan Source](https://www.trojansource.codes) attack.
Example:
-```c++
+```cpp
#include <iostream>
int main() {
@@ -19,4 +19,3 @@ int main() {
return 0;
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md b/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md
index d9c5e6a001635..4f64eb4ff4eb7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/misplaced-const.md
@@ -11,7 +11,7 @@ rather than the pointee.
For instance, in the following code, the resulting type is `int * const`
rather than `const int *`:
-```c++
+```cpp
typedef int *int_ptr;
void f(const int_ptr ptr) {
*ptr = 0; // potentially quite unexpectedly the int can be modified here
@@ -23,4 +23,3 @@ The check does not diagnose when the underlying `typedef`/`using` type is a
pointer to a `const` type or a function pointer type. This is because the
`const` qualifier is less likely to be mistaken because it would be redundant
(or disallowed) on the underlying pointee type.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md b/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md
index 9c2e63605faf3..34863a7494a25 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/non-private-member-variables-in-classes.md
@@ -14,18 +14,15 @@ classes or class consumers.
## Options
-```{eval-rst}
-.. option:: IgnoreClassesWithAllMemberVariablesBeingPublic
+```{option} IgnoreClassesWithAllMemberVariablesBeingPublic
- When `true`, allows to completely ignore classes if **all** the member
- variables in that class declared with a ``public`` access specifier.
- Default is `false`.
+When `true`, allows to completely ignore classes if **all** the member
+variables in that class declared with a `public` access specifier.
+Default is `false`.
```
-```{eval-rst}
-.. option:: IgnorePublicMemberVariables
+```{option} IgnorePublicMemberVariables
- When `true`, allows to ignore (not diagnose) **all** the member variables
- declared with a ``public`` access specifier. Default is `false`.
+When `true`, allows to ignore (not diagnose) **all** the member variables
+declared with a `public` access specifier. Default is `false`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md b/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md
index 5cdb3ad6879cc..7f1f7d632a368 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/unconventional-assign-operator.md
@@ -6,10 +6,9 @@
Finds declarations of assign operators with the wrong return and/or argument
types and definitions with good return type but wrong `return` statements.
-> - The return type must be `Class&`.
-> - The assignment may be from the class type by value, const lvalue
-> reference, non-const rvalue reference, or from a completely different
-> type (e.g. `int`).
-> - Private and deleted operators are ignored.
-> - The operator must always return `*this`.
-
+- The return type must be `Class&`.
+- The assignment may be from the class type by value, const lvalue
+ reference, non-const rvalue reference, or from a completely different
+ type (e.g. `int`).
+- Private and deleted operators are ignored.
+- The operator must always return `*this`.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md b/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md
index 7162e6e489c3e..3948b5d7a538b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/uniqueptr-reset-release.md
@@ -7,7 +7,7 @@ Find and replace `unique_ptr::reset(release())` with `std::move()`.
Example:
-```c++
+```cpp
std::unique_ptr<Foo> x, y;
x.reset(y.release()); -> x = std::move(y);
```
@@ -17,10 +17,8 @@ also be `std::unique_ptr<Foo>*`.
## Options
-```{eval-rst}
-.. option:: IncludeStyle
+```{option} IncludeStyle
- A string specifying which include-style is used, `llvm` or `google`. Default
- is `llvm`.
+A string specifying which include-style is used, `llvm` or `google`. Default
+is `llvm`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md
index 18fbcc2cf7a73..5991dc919e539 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-alias-decls.md
@@ -5,10 +5,9 @@
Finds unused namespace alias declarations.
-```c++
+```cpp
namespace my_namespace {
class C {};
}
namespace unused_alias = ::my_namespace;
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md
index 1c655da7d29ed..a9fb66dcdae21 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc/unused-using-decls.md
@@ -12,9 +12,8 @@ option `HeaderFileExtensions`.
Example:
-```c++
+```cpp
// main.cpp
namespace n { class C; }
using n::C; // Never actually used.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md
index fa6c50a4f6af8..64a94921a7fd0 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/return-braced-init-list.md
@@ -7,7 +7,7 @@ Replaces explicit calls to the constructor in a return with a braced
initializer list. This way the return type is not needlessly duplicated in the
function definition and the return statement.
-```c++
+```cpp
Foo bar() {
Baz baz;
return Foo(baz);
@@ -20,4 +20,3 @@ Foo bar() {
return {baz};
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md
index a4e451c6ed507..e665c14de9f94 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/unary-static-assert.md
@@ -11,7 +11,7 @@ The check is only applicable for C++17 and later code.
The following code:
-```c++
+```cpp
void f_textless(int a) {
static_assert(sizeof(a) <= 10, "");
}
@@ -19,9 +19,8 @@ void f_textless(int a) {
is replaced by:
-```c++
+```cpp
void f_textless(int a) {
static_assert(sizeof(a) <= 10);
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md
index 1c8969b167c84..a4295cbfa54ce 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-bool-literals.md
@@ -5,7 +5,7 @@
Finds integer literals which are cast to `bool`.
-```c++
+```cpp
bool p = 1;
bool f = static_cast<bool>(1);
std::ios_base::sync_with_stdio(0);
@@ -21,10 +21,8 @@ bool x = p ? true : false;
## Options
-```{eval-rst}
-.. option:: IgnoreMacros
+```{option} IgnoreMacros
- If set to `true`, the check will not give warnings inside macros. Default
- is `true`.
+If set to `true`, the check will not give warnings inside macros. Default
+is `true`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md
index 8a41c5c27ba41..14eb5beeb2ac8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/modernize/use-starts-ends-with.md
@@ -9,20 +9,15 @@ this will work with `std::string` and `std::string_view`.
Covered scenarios:
-```{eval-rst}
-==================================================== =====================
-Expression Replacement
----------------------------------------------------- ---------------------
-``u.find(v) == 0`` ``u.starts_with(v)``
-``u.find(v, 0) == 0`` ``u.starts_with(v)``
-``u.find(v, 0, v.size()) == 0`` ``u.starts_with(v)``
-``u.rfind(v, 0) != 0`` ``!u.starts_with(v)``
-``u.rfind(v, 0, v.size()) != 0`` ``!u.starts_with(v)``
-``u.compare(0, v.size(), v) == 0`` ``u.starts_with(v)``
-``u.substr(0, v.size()) == v`` ``u.starts_with(v)``
-``v != u.substr(0, v.size())`` ``!u.starts_with(v)``
-``u.compare(u.size() - v.size(), v.size(), v) == 0`` ``u.ends_with(v)``
-``u.rfind(v) == u.size() - v.size()`` ``u.ends_with(v)``
-==================================================== =====================
-```
-
+| Expression | Replacement |
+| ---------- | ----------- |
+| `u.find(v) == 0` | `u.starts_with(v)` |
+| `u.find(v, 0) == 0` | `u.starts_with(v)` |
+| `u.find(v, 0, v.size()) == 0` | `u.starts_with(v)` |
+| `u.rfind(v, 0) != 0` | `!u.starts_with(v)` |
+| `u.rfind(v, 0, v.size()) != 0` | `!u.starts_with(v)` |
+| `u.compare(0, v.size(), v) == 0` | `u.starts_with(v)` |
+| `u.substr(0, v.size()) == v` | `u.starts_with(v)` |
+| `v != u.substr(0, v.size())` | `!u.starts_with(v)` |
+| `u.compare(u.size() - v.size(), v.size(), v) == 0` | `u.ends_with(v)` |
+| `u.rfind(v) == u.size() - v.size()` | `u.ends_with(v)` |
diff --git a/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md b/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md
index cfaa1dd800dbd..c08e04dc646ce 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/mpi/buffer-deref.md
@@ -12,7 +12,7 @@ warning emitted.
Examples:
-```c++
+```cpp
// A double pointer is passed to the MPI function.
char *buf;
MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
@@ -25,4 +25,3 @@ MPI_Send(buf, 1, MPI_SHORT, 0, 0, MPI_COMM_WORLD);
short *buf[1];
MPI_Send(buf, 1, MPI_SHORT, 0, 0, MPI_COMM_WORLD);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md b/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md
index 24864f4de2a3a..4945591ded584 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/mpi/type-mismatch.md
@@ -11,7 +11,7 @@ of verification.
Example:
-```c++
+```cpp
// In this case, the buffer type matches MPI datatype.
char buf;
MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
@@ -20,4 +20,3 @@ MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
int buf;
MPI_Send(&buf, 1, MPI_CHAR, 0, 0, MPI_COMM_WORLD);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md b/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md
index 423abb7702188..a3a30e84030e6 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/objc/forbidden-subclassing.md
@@ -19,12 +19,10 @@ See <https://clang.llvm.org/docs/AttributeReference.html#objc-subclassing-restri
## Options
-```{eval-rst}
-.. option:: ForbiddenSuperClassNames
+```{option} ForbiddenSuperClassNames
- Semicolon-separated list of names of Objective-C classes which
- do not support subclassing.
+Semicolon-separated list of names of Objective-C classes which
+do not support subclassing.
- Defaults to `ABNewPersonViewController;ABPeoplePickerNavigationController;ABPersonViewController;ABUnknownPersonViewController;NSHashTable;NSMapTable;NSPointerArray;NSPointerFunctions;NSTimer;UIActionSheet;UIAlertView;UIImagePickerController;UITextInputMode;UIWebView`.
+Defaults to `ABNewPersonViewController;ABPeoplePickerNavigationController;ABPersonViewController;ABUnknownPersonViewController;NSHashTable;NSMapTable;NSPointerArray;NSPointerFunctions;NSTimer;UIActionSheet;UIAlertView;UIImagePickerController;UITextInputMode;UIWebView`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md b/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md
index 45b102e56001d..284da9ce46717 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/openmp/exception-escape.md
@@ -18,10 +18,8 @@ WARNING! This check may be expensive on large source files.
## Options
-```{eval-rst}
-.. option:: IgnoredExceptions
+```{option} IgnoredExceptions
- Comma-separated list containing type names which are not counted as thrown
- exceptions in the check. Default value is an empty string.
+Comma-separated list containing type names which are not counted as thrown
+exceptions in the check. Default value is an empty string.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md
index 51f7211aae822..f2ff5bf41a2cb 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-cast-in-loop.md
@@ -7,6 +7,4 @@ orphan: true
# performance-implicit-cast-in-loop
-This check has been renamed to {doc}`performance-implicit-conversion-in-loop
-<../performance/implicit-conversion-in-loop>`.
-
+This check has been renamed to {doc}`performance-implicit-conversion-in-loop <../performance/implicit-conversion-in-loop>`.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md
index 86ac0415a1367..f6500580b88c8 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/implicit-conversion-in-loop.md
@@ -10,7 +10,7 @@ result in expensive deep copies.
Example:
-```c++
+```cpp
map<int, vector<string>> my_map;
for (const pair<int, vector<string>>& p : my_map) {}
// The iterator type is in fact pair<const int, vector<string>>, which means
@@ -19,4 +19,3 @@ for (const pair<int, vector<string>>& p : my_map) {}
The easiest solution is usually to use `const auto&` instead of writing the
type manually.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md b/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md
index 7416d94e7b622..d96149601f33b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-algorithm.md
@@ -9,7 +9,7 @@ Associative containers implement some of the algorithms as methods which
should be preferred to the algorithms in the algorithm header. The methods
can take advantage of the order of the elements.
-```c++
+```cpp
std::set<int> s;
auto it = std::find(s.begin(), s.end(), 43);
@@ -18,7 +18,7 @@ auto it = std::find(s.begin(), s.end(), 43);
auto it = s.find(43);
```
-```c++
+```cpp
std::set<int> s;
auto c = std::count(s.begin(), s.end(), 43);
@@ -26,4 +26,3 @@ auto c = std::count(s.begin(), s.end(), 43);
auto c = s.count(43);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md b/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md
index 032c8bab3afd6..56e7496a52d52 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/trivially-destructible.md
@@ -6,11 +6,10 @@
Finds types that could be made trivially-destructible by removing out-of-line
defaulted destructor declarations.
-```c++
+```cpp
struct A: TrivialType {
~A(); // Makes A non-trivially-destructible.
TrivialType trivial_fields;
};
A::~A() = default;
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md b/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md
index b30dcdd003c2f..71418dbc9988f 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/type-promotion-in-math-fn.md
@@ -10,7 +10,7 @@ For example, warns on `::sin(0.f)`, because this function's parameter is a
double. You probably meant to call `std::sin(0.f)` (in C++), or `sinf(0.f)`
(in C).
-```c++
+```cpp
float a;
asin(a);
@@ -19,4 +19,3 @@ asin(a);
float a;
std::asin(a);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md b/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md
index 2cc0e5daa62cf..2e892d03d0475 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/performance/use-std-move.md
@@ -6,7 +6,7 @@
Suggests insertion of `std::move(...)` to turn copy assignment operator calls
into move assignment ones, when deemed valid and profitable.
-```c++
+```cpp
void assign(std::vector<int>& out) {
std::vector<int> some = make_vector();
use_vector(some);
@@ -21,4 +21,3 @@ void assign(std::vector<int>& out) {
out = std::move(some);
}
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md b/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md
index 10b79deb1a9b0..68fc3fe44998d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/portability/no-assembler.md
@@ -7,7 +7,6 @@ Checks for assembler statements. Use of inline assembly should be avoided
since it ties to a specific CPU architecture and syntax making code that
uses it non-portable across platforms.
-```c++
+```cpp
asm("mov al, 2"); // warning: do not use assembler statements
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md
index db982afa6353a..1f9d5193e8089 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-const-params-in-decls.md
@@ -11,17 +11,15 @@ they should not be put there.
Examples:
-```c++
+```cpp
void f(const string); // Bad: const is top level.
void f(const string&); // Good: const is not top level.
```
## Options
-```{eval-rst}
-.. option:: IgnoreMacros
+```{option} IgnoreMacros
- If set to `true`, the check will not give warnings inside macros. Default
- is `true`.
+If set to `true`, the check will not give warnings inside macros. Default
+is `true`.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md
index e2123b8ddc7ef..e0719a78200c7 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/avoid-nested-conditional-operator.md
@@ -11,9 +11,8 @@ several statements and stored the intermediate results in temporary variable.
Examples:
-```c++
+```cpp
int NestInConditional = (condition1 ? true1 : false1) ? true2 : false2;
int NestInTrue = condition1 ? (condition2 ? true1 : false1) : false2;
int NestInFalse = condition1 ? true1 : condition2 ? true2 : false1;
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md b/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md
index 020d903d816cc..be38f8ad145f1 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/container-data-pointer.md
@@ -14,10 +14,8 @@ pointer access does not perform an errant memory access.
## Options
-```{eval-rst}
-.. option:: IgnoredContainers
+```{option} IgnoredContainers
- Semicolon-separated list of containers regexp for which this check won't be
- enforced. Default is an empty string.
+Semicolon-separated list of containers regexp for which this check won't be
+enforced. Default is an empty string.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md b/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md
index 52c8cc0f03666..bbd9389b8e968 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/convert-member-functions-to-static.md
@@ -10,7 +10,5 @@ After applying modifications as suggested by the check, running the check again
might find more opportunities to mark member functions `static`.
After making a member function `static`, you might want to run the check
-{doc}`readability-static-accessed-through-instance
-<../readability/static-accessed-through-instance>` to replace calls like
+{doc}`readability-static-accessed-through-instance <../readability/static-accessed-through-instance>` to replace calls like
`Instance.method()` by `Class::method()`.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md b/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md
index 51b54f1da5b45..6129405c0cc30 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/delete-null-pointer.md
@@ -7,9 +7,8 @@ Checks the `if` statements where a pointer's existence is checked and
then deletes the pointer.
The check is unnecessary as deleting a null pointer has no effect.
-```c++
+```cpp
int *p;
if (p)
delete p;
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md b/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md
index 5ccaa85e0c4c2..7bf1f35d3f636 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/implicit-bool-cast.md
@@ -7,6 +7,4 @@ orphan: true
# readability-implicit-bool-cast
-This check has been renamed to {doc}`readability-implicit-bool-conversion
-<../readability/implicit-bool-conversion>`.
-
+This check has been renamed to {doc}`readability-implicit-bool-conversion <../readability/implicit-bool-conversion>`.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md b/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md
index 8821b31413c8e..bd8993452a97e 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/math-missing-parentheses.md
@@ -16,13 +16,12 @@ more maintainable code.
Before:
-```c++
+```cpp
int x = 1 + 2 * 3 - 4 / 5;
```
After:
-```c++
+```cpp
int x = 1 + (2 * 3) - (4 / 5);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md b/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md
index f0dae62df1009..e5c79c7f22ec2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/misplaced-array-index.md
@@ -7,7 +7,7 @@ This check warns for unusual array index syntax.
The following code has unusual array index syntax:
-```c++
+```cpp
void f(int *X, int Y) {
Y[X] = 0;
}
@@ -15,13 +15,12 @@ void f(int *X, int Y) {
becomes
-```c++
+```cpp
void f(int *X, int Y) {
X[Y] = 0;
}
```
The check warns about such unusual syntax for readability reasons:
-: - There are programmers that are not familiar with this unusual syntax.
- - It is possible that variables are mixed up.
-
+: - There are programmers that are not familiar with this unusual syntax.
+ - It is possible that variables are mixed up.
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md
index 87d7e7b07a736..4c2244a2b74ed 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-function-ptr-dereference.md
@@ -7,7 +7,7 @@ Finds redundant dereferences of a function pointer.
Before:
-```c++
+```cpp
int f(int,int);
int (*p)(int, int) = &f;
@@ -16,10 +16,9 @@ int i = (**p)(10, 50);
After:
-```c++
+```cpp
int f(int,int);
int (*p)(int, int) = &f;
int i = (*p)(10, 50);
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md
index a5261ad7fbdba..6e5307f710d8d 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-smartptr-get.md
@@ -7,7 +7,7 @@ Find and remove redundant calls to smart pointer's `.get()` method.
Examples:
-```c++
+```cpp
ptr.get()->Foo() ==> ptr->Foo()
*ptr.get() ==> *ptr
*ptr->get() ==> **ptr
@@ -16,10 +16,8 @@ if (ptr.get() == nullptr) ... => if (ptr == nullptr) ...
## Options
-```{eval-rst}
-.. option:: IgnoreMacros
+```{option} IgnoreMacros
- If this option is set to `true` (default is `true`), the check will not warn
- about calls inside macros.
+If this option is set to `true` (default is `true`), the check will not warn
+about calls inside macros.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md
index cb5baa2935c07..26588e2181d0b 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/redundant-string-cstr.md
@@ -8,15 +8,13 @@ Finds unnecessary calls to `std::string::c_str()` and
## Options
-```{eval-rst}
-.. option:: StringParameterFunctions
+```{option} StringParameterFunctions
- A semicolon-separated list of regular expressions matching the
- (fully qualified) names of function/method/operator, with the requirement
- that any parameter currently accepting a ``const char*`` input should also
- be able to accept ``std::string`` inputs, or proper overload candidates that
- can do so should exist. This can be used to configure functions such as
- ``fmt::format``, ``spdlog::logger::info``, or wrappers around these and
- similar functions. The default value is the empty string.
+A semicolon-separated list of regular expressions matching the
+(fully qualified) names of function/method/operator, with the requirement
+that any parameter currently accepting a `const char*` input should also
+be able to accept `std::string` inputs, or proper overload candidates that
+can do so should exist. This can be used to configure functions such as
+`fmt::format`, `spdlog::logger::info`, or wrappers around these and
+similar functions. The default value is the empty string.
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md b/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md
index fc18ad1381430..30023c42cbbf2 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/simplify-subscript-expr.md
@@ -9,17 +9,15 @@ single element, in which case simply calling `operator[]` suffice.
Examples:
-```c++
+```cpp
std::string s = ...;
char c = s.data()[i]; // char c = s[i];
```
## Options
-```{eval-rst}
-.. option:: Types
+```{option} Types
- The list of type(s) that triggers this check. Default is
- `::std::basic_string;::std::basic_string_view;::std::vector;::std::array;::std::span`
+The list of type(s) that triggers this check. Default is
+`::std::basic_string;::std::basic_string_view;::std::vector;::std::array;::std::span`
```
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md b/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md
index 330f1d53d48a3..44b1f08da364a 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/static-definition-in-anonymous-namespace.md
@@ -8,7 +8,7 @@ Finds static function and variable definitions in anonymous namespace.
In this case, `static` is redundant, because anonymous namespace limits the
visibility of definitions to a single translation unit.
-```c++
+```cpp
namespace {
static int a = 1; // Warning.
static const int b = 1; // Warning.
@@ -19,4 +19,3 @@ namespace {
```
The check will apply a fix by removing the redundant `static` qualifier.
-
diff --git a/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md b/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md
index 5b6b2cd624f56..b50b17467b450 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md
+++ b/clang-tools-extra/docs/clang-tidy/checks/readability/use-std-min-max.md
@@ -10,7 +10,7 @@ additional stores compared to the original if statement.
Before:
-```c++
+```cpp
void foo() {
int a = 2, b = 3;
if (a < b)
@@ -20,10 +20,9 @@ void foo() {
After:
-```c++
+```cpp
void foo() {
int a = 2, b = 3;
a = std::max(a, b);
}
```
-
More information about the llvm-branch-commits
mailing list