[gcc(refs/users/marxin/heads/sphinx-v7)] sphinx: copy files from texi2rst-generated
Martin Liska
marxin@gcc.gnu.org
Thu Aug 18 13:56:40 GMT 2022
https://gcc.gnu.org/g:43f65c0bab08a5ba99e63be995bff3c65210f79e
commit 43f65c0bab08a5ba99e63be995bff3c65210f79e
Author: Martin Liska <mliska@suse.cz>
Date: Tue Jul 26 10:42:39 2022 +0200
sphinx: copy files from texi2rst-generated
ChangeLog:
* doc/Makefile: New file.
* doc/_static/custom.css: New file.
* doc/baseconf.py: New file.
* doc/bsd.rst: New file.
* doc/contrib.rst: New file.
* doc/contribute.rst: New file.
* doc/cppdiropts.rst: New file.
* doc/cppenv.rst: New file.
* doc/cppopts.rst: New file.
* doc/cppwarnopts.rst: New file.
* doc/favicon.ico: New file.
* doc/funding.rst: New file.
* doc/gcc_sphinx.py: New file.
* doc/gnu.rst: New file.
* doc/gnu_free_documentation_license.rst: New file.
* doc/gpl-3.0.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/lgpl-2.1.rst: New file.
* doc/logo.pdf: New file.
* doc/logo.svg: New file.
* doc/md.rst: New file.
gcc/d/ChangeLog:
* doc/conf.py: New file.
* doc/copyright.rst: New file.
* doc/general-public-license-3.rst: New file.
* doc/gnu-free-documentation-license.rst: New file.
* doc/index.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/invoking-gdc.rst: New file.
* doc/invoking-gdc/code-generation.rst: New file.
* doc/invoking-gdc/developer-options.rst: New file.
* doc/invoking-gdc/input-and-output-files.rst: New file.
* doc/invoking-gdc/options-for-directory-search.rst: New file.
* doc/invoking-gdc/options-for-linking.rst: New file.
* doc/invoking-gdc/runtime-options.rst: New file.
* doc/invoking-gdc/warnings.rst: New file.
gcc/ChangeLog:
* doc/cpp/character-sets.rst: New file.
* doc/cpp/conditional-syntax.rst: New file.
* doc/cpp/conditional-uses.rst: New file.
* doc/cpp/conditionals.rst: New file.
* doc/cpp/conf.py: New file.
* doc/cpp/copyright.rst: New file.
* doc/cpp/deleted-code.rst: New file.
* doc/cpp/diagnostics.rst: New file.
* doc/cpp/environment-variables.rst: New file.
* doc/cpp/gnu-free-documentation-license.rst: New file.
* doc/cpp/header-files.rst: New file.
* doc/cpp/header-files/alternatives-to-wrapper-ifndef.rst: New file.
* doc/cpp/header-files/computed-includes.rst: New file.
* doc/cpp/header-files/include-operation.rst: New file.
* doc/cpp/header-files/include-syntax.rst: New file.
* doc/cpp/header-files/once-only-headers.rst: New file.
* doc/cpp/header-files/search-path.rst: New file.
* doc/cpp/header-files/system-headers.rst: New file.
* doc/cpp/header-files/wrapper-headers.rst: New file.
* doc/cpp/implementation-defined-behavior.rst: New file.
* doc/cpp/implementation-details.rst: New file.
* doc/cpp/implementation-limits.rst: New file.
* doc/cpp/index.rst: New file.
* doc/cpp/indices-and-tables.rst: New file.
* doc/cpp/initial-processing.rst: New file.
* doc/cpp/invocation.rst: New file.
* doc/cpp/line-control.rst: New file.
* doc/cpp/macros.rst: New file.
* doc/cpp/macros/concatenation.rst: New file.
* doc/cpp/macros/directives-within-macro-arguments.rst: New file.
* doc/cpp/macros/function-like-macros.rst: New file.
* doc/cpp/macros/macro-arguments.rst: New file.
* doc/cpp/macros/macro-pitfalls.rst: New file.
* doc/cpp/macros/object-like-macros.rst: New file.
* doc/cpp/macros/predefined-macros.rst: New file.
* doc/cpp/macros/stringizing.rst: New file.
* doc/cpp/macros/undefining-and-redefining-macros.rst: New file.
* doc/cpp/macros/variadic-macros.rst: New file.
* doc/cpp/obsolete-features.rst: New file.
* doc/cpp/other-directives.rst: New file.
* doc/cpp/overview.rst: New file.
* doc/cpp/pragmas.rst: New file.
* doc/cpp/preprocessor-output.rst: New file.
* doc/cpp/the-preprocessing-language.rst: New file.
* doc/cpp/tokenization.rst: New file.
* doc/cpp/traditional-lexical-analysis.rst: New file.
* doc/cpp/traditional-macros.rst: New file.
* doc/cpp/traditional-miscellany.rst: New file.
* doc/cpp/traditional-mode.rst: New file.
* doc/cpp/traditional-warnings.rst: New file.
* doc/cppinternals/conf.py: New file.
* doc/cppinternals/copyright.rst: New file.
* doc/cppinternals/cppinternals.rst: New file.
* doc/cppinternals/cpplib.rst: New file.
* doc/cppinternals/files.rst: New file.
* doc/cppinternals/index.rst: New file.
* doc/cppinternals/indices-and-tables.rst: New file.
* doc/cppinternals/internal-representation-of-macros.rst: New file.
* doc/cppinternals/just-which-line-number-anyway.rst: New file.
* doc/cppinternals/lexing-a-line.rst: New file.
* doc/cppinternals/lexing-a-token.rst: New file.
* doc/cppinternals/looking-for-a-function-like-macros-opening-parenthesis.rst: New file.
* doc/cppinternals/macro-expansion-overview.rst: New file.
* doc/cppinternals/marking-tokens-ineligible-for-future-expansion.rst: New file.
* doc/cppinternals/multiple-include-optimization.rst: New file.
* doc/cppinternals/overview.rst: New file.
* doc/cppinternals/representation-of-line-numbers.rst: New file.
* doc/cppinternals/scanning-the-replacement-list-for-macros-to-expand.rst: New file.
* doc/gcc/binary-compatibility.rst: New file.
* doc/gcc/c++-implementation-defined-behavior.rst: New file.
* doc/gcc/c-implementation-defined-behavior.rst: New file.
* doc/gcc/c-implementation-defined-behavior/architecture.rst: New file.
* doc/gcc/c-implementation-defined-behavior/arrays-and-pointers.rst: New file.
* doc/gcc/c-implementation-defined-behavior/characters.rst: New file.
* doc/gcc/c-implementation-defined-behavior/declarators.rst: New file.
* doc/gcc/c-implementation-defined-behavior/environment.rst: New file.
* doc/gcc/c-implementation-defined-behavior/floating-point.rst: New file.
* doc/gcc/c-implementation-defined-behavior/hints.rst: New file.
* doc/gcc/c-implementation-defined-behavior/identifiers.rst: New file.
* doc/gcc/c-implementation-defined-behavior/integers.rst: New file.
* doc/gcc/c-implementation-defined-behavior/library-functions.rst: New file.
* doc/gcc/c-implementation-defined-behavior/locale-specific-behavior.rst: New file.
* doc/gcc/c-implementation-defined-behavior/preprocessing-directives.rst: New file.
* doc/gcc/c-implementation-defined-behavior/qualifiers.rst: New file.
* doc/gcc/c-implementation-defined-behavior/statements.rst: New file.
* doc/gcc/c-implementation-defined-behavior/structures-unions-enumerations-and-bit-fields.rst:
New file.
* doc/gcc/c-implementation-defined-behavior/translation.rst: New file.
* doc/gcc/conditionally-supported-behavior.rst: New file.
* doc/gcc/conf.py: New file.
* doc/gcc/contributing-to-gcc-development.rst: New file.
* doc/gcc/contributors-to-gcc.rst: New file.
* doc/gcc/copyright.rst: New file.
* doc/gcc/exception-handling.rst: New file.
* doc/gcc/extensions-to-the-c++-language.rst: New file.
* doc/gcc/extensions-to-the-c++-language/backwards-compatibility.rst: New file.
* doc/gcc/extensions-to-the-c++-language/c++-concepts.rst: New file.
* doc/gcc/extensions-to-the-c++-language/c++-interface-and-implementation-pragmas.rst:
New file.
* doc/gcc/extensions-to-the-c++-language/c++-specific-variable-function-and-type-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c++-language/deprecated-features.rst: New file.
* doc/gcc/extensions-to-the-c++-language/extracting-the-function-pointer-from-a-bound-pointer-to-member-function.rst:
New file.
* doc/gcc/extensions-to-the-c++-language/function-multiversioning.rst: New file.
* doc/gcc/extensions-to-the-c++-language/restricting-pointer-aliasing.rst: New file.
* doc/gcc/extensions-to-the-c++-language/type-traits.rst: New file.
* doc/gcc/extensions-to-the-c++-language/vague-linkage.rst: New file.
* doc/gcc/extensions-to-the-c++-language/when-is-a-volatile-c++-object-accessed.rst:
New file.
* doc/gcc/extensions-to-the-c++-language/wheres-the-template.rst: New file.
* doc/gcc/extensions-to-the-c-language-family.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/128-bit-integers.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/additional-floating-types.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/alternate-keywords.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/an-inline-function-is-as-fast-as-a-macro.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/arithmetic-on-void-and-function-pointers.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/arrays-of-length-zero.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/arrays-of-variable-length.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/attribute-syntax.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/binary-constants-using-the-0b-prefix.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/built-in-functions-for-memory-model-aware-atomic-operations.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/built-in-functions-to-perform-arithmetic-with-overflow-checking.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/c++-style-comments.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/case-ranges.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/cast-to-a-union-type.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/complex-numbers.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/compound-literals.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/conditionals-with-omitted-operands.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/constructing-function-calls.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/decimal-floating-types.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/aarch64-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/amd-gcn-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/arc-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/arm-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/avr-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/blackfin-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/bpf-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/c-sky-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/common-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/cr16-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/epiphany-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/h8-300-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/ia-64-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/m32c-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/m32r-d-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/m68k-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/mcore-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/mep-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/microblaze-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/microsoft-windows-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/mips-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/msp430-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/nds32-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/nios-ii-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/nvidia-ptx-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/powerpc-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/risc-v-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/rl78-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/rx-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/s-390-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/sh-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/symbian-os-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/v850-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/visium-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/x86-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/declaring-attributes-of-functions/xstormy16-function-attributes.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/designated-initializers.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/determining-the-alignment-of-functions-types-or-variables.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/dollar-signs-in-identifier-names.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/double-word-integers.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/enumerator-attributes.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/fixed-point-types.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/format-checks-specific-to-particular-target-machines.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/function-names-as-strings.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/getting-the-return-or-frame-address-of-a-function.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/half-precision-floating-point.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/hex-floats.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/how-to-use-inline-assembly-language-in-c-code.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/incomplete-enum-types.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/label-attributes.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/labels-as-values.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/legacy-sync-built-in-functions-for-atomic-memory-access.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/locally-declared-labels.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/macros-with-a-variable-number-of-arguments.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/mixed-declarations-labels-and-code.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/named-address-spaces.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/nested-functions.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/non-constant-initializers.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/non-lvalue-arrays-may-have-subscripts.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/nonlocal-gotos.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/object-size-checking-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/other-built-in-functions-provided-by-gcc.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/pointer-arguments-in-variadic-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/pointers-to-arrays-with-qualifiers-work-as-expected.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/pragmas-accepted-by-gcc.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/prototypes-and-old-style-function-definitions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/referring-to-a-type-with-typeof.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/slightly-looser-rules-for-escaped-newlines.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/specifying-attributes-of-types.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/specifying-attributes-of-variables.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/statement-attributes.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/statements-and-declarations-in-expressions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/structures-with-no-members.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/support-for-offsetof.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/aarch64-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/alpha-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/altera-nios-ii-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/arc-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/arc-simd-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/arm-armv8-m-security-extensions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/arm-c-language-extensions-acle.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/arm-floating-point-status-and-control-intrinsics.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/arm-iwmmxt-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/avr-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/basic-powerpc-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/blackfin-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/bpf-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/fr-v-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/mips-dsp-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/mips-loongson-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/mips-paired-single-support.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/mips-simd-architecture-msa-support.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/msp430-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/nds32-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/other-mips-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/picochip-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/powerpc-altivec-vsx-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/powerpc-atomic-memory-operation-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/powerpc-hardware-transactional-memory-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/powerpc-matrix-multiply-assist-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/pru-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/risc-v-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/rx-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/s-390-system-z-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/sh-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/sparc-vis-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/ti-c6x-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/x86-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/x86-control-flow-protection-intrinsics.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/target-builtins/x86-transactional-memory-intrinsics.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/the-character-esc-in-constants.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/thread-local-storage.rst: New file.
* doc/gcc/extensions-to-the-c-language-family/unnamed-structure-and-union-fields.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/using-vector-instructions-through-built-in-functions.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/when-is-a-volatile-object-accessed.rst:
New file.
* doc/gcc/extensions-to-the-c-language-family/x86-specific-memory-model-extensions-for-transactional-memory.rst:
New file.
* doc/gcc/funding.rst: New file.
* doc/gcc/gcc-command-options.rst: New file.
* doc/gcc/gcc-command-options/c++-modules.rst: New file.
* doc/gcc/gcc-command-options/compiling-c++-programs.rst: New file.
* doc/gcc/gcc-command-options/description.rst: New file.
* doc/gcc/gcc-command-options/environment-variables-affecting-gcc.rst: New file.
* doc/gcc/gcc-command-options/gcc-developer-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/aarch64-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/adapteva-epiphany-options.rst:
New file.
* doc/gcc/gcc-command-options/machine-dependent-options/amd-gcn-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/arc-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/arm-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/avr-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/blackfin-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/c-sky-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/c6x-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/cr16-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/cris-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/darwin-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/dec-alpha-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/ebpf-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/fr30-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/frv-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/ft32-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/gnu-linux-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/h8-300-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/hppa-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/ia-64-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/ibm-rs-6000-and-powerpc-options.rst:
New file.
* doc/gcc/gcc-command-options/machine-dependent-options/lm32-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/loongarch-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/m32c-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/m32r-d-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/m680x0-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/mcore-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/mep-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/microblaze-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/mips-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/mmix-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/mn10300-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/moxie-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/msp430-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/nds32-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/nios-ii-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/nvidia-ptx-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/openrisc-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/options-for-system-v.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/pdp-11-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/picochip-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/powerpc-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/pru-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/risc-v-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/rl78-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/rx-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/s-390-and-zseries-options.rst:
New file.
* doc/gcc/gcc-command-options/machine-dependent-options/score-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/sh-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/solaris-2-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/sparc-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/v850-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/vax-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/visium-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/vms-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/vxworks-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/x86-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/x86-windows-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/xstormy16-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/xtensa-options.rst: New file.
* doc/gcc/gcc-command-options/machine-dependent-options/zseries-options.rst: New file.
* doc/gcc/gcc-command-options/option-summary.rst: New file.
* doc/gcc/gcc-command-options/options-controlling-c++-dialect.rst: New file.
* doc/gcc/gcc-command-options/options-controlling-c-dialect.rst: New file.
* doc/gcc/gcc-command-options/options-controlling-objective-c-and-objective-c++-dialects.rst:
New file.
* doc/gcc/gcc-command-options/options-controlling-the-kind-of-output.rst: New file.
* doc/gcc/gcc-command-options/options-controlling-the-preprocessor.rst: New file.
* doc/gcc/gcc-command-options/options-for-code-generation-conventions.rst: New file.
* doc/gcc/gcc-command-options/options-for-debugging-your-program.rst: New file.
* doc/gcc/gcc-command-options/options-for-directory-search.rst: New file.
* doc/gcc/gcc-command-options/options-for-linking.rst: New file.
* doc/gcc/gcc-command-options/options-that-control-optimization.rst: New file.
* doc/gcc/gcc-command-options/options-that-control-static-analysis.rst: New file.
* doc/gcc/gcc-command-options/options-to-control-diagnostic-messages-formatting.rst:
New file.
* doc/gcc/gcc-command-options/options-to-request-or-suppress-warnings.rst: New file.
* doc/gcc/gcc-command-options/passing-options-to-the-assembler.rst: New file.
* doc/gcc/gcc-command-options/program-instrumentation-options.rst: New file.
* doc/gcc/gcc-command-options/specifying-subprocesses-and-the-switches-to-pass-to-them.rst:
New file.
* doc/gcc/gcc-command-options/using-precompiled-headers.rst: New file.
* doc/gcc/gcc.rst: New file.
* doc/gcc/gcov-dump.rst: New file.
* doc/gcc/gcov-tool.rst: New file.
* doc/gcc/gcov.rst: New file.
* doc/gcc/gcov/brief-description-of-gcov-data-files.rst: New file.
* doc/gcc/gcov/data-file-relocation-to-support-cross-profiling.rst: New file.
* doc/gcc/gcov/introduction-to-gcov.rst: New file.
* doc/gcc/gcov/invoking-gcov.rst: New file.
* doc/gcc/gcov/profiling-and-test-coverage-in-freestanding-environments.rst: New file.
* doc/gcc/gcov/using-gcov-with-gcc-optimization.rst: New file.
* doc/gcc/general-public-license-3.rst: New file.
* doc/gcc/gnu-free-documentation-license.rst: New file.
* doc/gcc/gnu-objective-c-features.rst: New file.
* doc/gcc/gnu-objective-c-features/compatibilityalias.rst: New file.
* doc/gcc/gnu-objective-c-features/constant-string-objects.rst: New file.
* doc/gcc/gnu-objective-c-features/exceptions.rst: New file.
* doc/gcc/gnu-objective-c-features/fast-enumeration.rst: New file.
* doc/gcc/gnu-objective-c-features/garbage-collection.rst: New file.
* doc/gcc/gnu-objective-c-features/gnu-objective-c-runtime-api.rst: New file.
* doc/gcc/gnu-objective-c-features/load-executing-code-before-main.rst: New file.
* doc/gcc/gnu-objective-c-features/messaging-with-the-gnu-objective-c-runtime.rst: New file.
* doc/gcc/gnu-objective-c-features/synchronization.rst: New file.
* doc/gcc/gnu-objective-c-features/type-encoding.rst: New file.
* doc/gcc/gnu.rst: New file.
* doc/gcc/have-you-found-a-bug.rst: New file.
* doc/gcc/how-and-where-to-report-bugs.rst: New file.
* doc/gcc/how-to-get-help-with-gcc.rst: New file.
* doc/gcc/index.rst: New file.
* doc/gcc/indices-and-tables.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc/actual-bugs-we-havent-fixed-yet.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc/certain-changes-we-dont-want-to-make.rst:
New file.
* doc/gcc/known-causes-of-trouble-with-gcc/common-misunderstandings-with-gnu-c.rst:
New file.
* doc/gcc/known-causes-of-trouble-with-gcc/disappointments-and-misunderstandings.rst:
New file.
* doc/gcc/known-causes-of-trouble-with-gcc/fixed-header-files.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc/incompatibilities-of-gcc.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc/interoperation.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc/standard-libraries.rst: New file.
* doc/gcc/known-causes-of-trouble-with-gcc/warning-messages-and-error-messages.rst:
New file.
* doc/gcc/language-standards-supported-by-gcc.rst: New file.
* doc/gcc/language-standards-supported-by-gcc/c++-language.rst: New file.
* doc/gcc/language-standards-supported-by-gcc/c-language.rst: New file.
* doc/gcc/language-standards-supported-by-gcc/d-language.rst: New file.
* doc/gcc/language-standards-supported-by-gcc/go-language.rst: New file.
* doc/gcc/language-standards-supported-by-gcc/objective-c-and-objective-c++-languages.rst:
New file.
* doc/gcc/language-standards-supported-by-gcc/references-for-other-languages.rst: New file.
* doc/gcc/lto-dump.rst: New file.
* doc/gcc/programming-languages-supported-by-gcc.rst: New file.
* doc/gcc/reporting-bugs.rst: New file.
* doc/gccint/analysis-and-optimization-of-gimple-tuples.rst: New file.
* doc/gccint/analysis-and-optimization-of-gimple-tuples/alias-analysis.rst: New file.
* doc/gccint/analysis-and-optimization-of-gimple-tuples/annotations.rst: New file.
* doc/gccint/analysis-and-optimization-of-gimple-tuples/memory-model.rst: New file.
* doc/gccint/analysis-and-optimization-of-gimple-tuples/ssa-operands.rst: New file.
* doc/gccint/analysis-and-optimization-of-gimple-tuples/static-single-assignment.rst:
New file.
* doc/gccint/analysis-and-representation-of-loops.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/data-dependency-analysis.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/iv-analysis-on-rtl.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/loop-closed-ssa-form.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/loop-manipulation.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/loop-querying.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/loop-representation.rst: New file.
* doc/gccint/analysis-and-representation-of-loops/number-of-iterations-analysis.rst:
New file.
* doc/gccint/analysis-and-representation-of-loops/scalar-evolutions.rst: New file.
* doc/gccint/analyzer-internals.rst: New file.
* doc/gccint/collect2.rst: New file.
* doc/gccint/conf.py: New file.
* doc/gccint/contributing-to-gcc-development.rst: New file.
* doc/gccint/contributors-to-gcc.rst: New file.
* doc/gccint/control-flow-graph.rst: New file.
* doc/gccint/control-flow-graph/basic-blocks.rst: New file.
* doc/gccint/control-flow-graph/edges.rst: New file.
* doc/gccint/control-flow-graph/liveness-information.rst: New file.
* doc/gccint/control-flow-graph/maintaining-the-cfg.rst: New file.
* doc/gccint/control-flow-graph/profile-information.rst: New file.
* doc/gccint/copyright.rst: New file.
* doc/gccint/debugging-the-analyzer.rst: New file.
* doc/gccint/funding.rst: New file.
* doc/gccint/gcc-and-portability.rst: New file.
* doc/gccint/general-public-license-3.rst: New file.
* doc/gccint/generic.rst: New file.
* doc/gccint/generic/attributes-in-trees.rst: New file.
* doc/gccint/generic/c-and-c++-trees.rst: New file.
* doc/gccint/generic/declarations.rst: New file.
* doc/gccint/generic/deficiencies.rst: New file.
* doc/gccint/generic/expressions.rst: New file.
* doc/gccint/generic/functions.rst: New file.
* doc/gccint/generic/language-dependent-trees.rst: New file.
* doc/gccint/generic/overview.rst: New file.
* doc/gccint/generic/statements.rst: New file.
* doc/gccint/generic/types.rst: New file.
* doc/gccint/gimple-api.rst: New file.
* doc/gccint/gimple.rst: New file.
* doc/gccint/gimple/adding-a-new-gimple-statement-code.rst: New file.
* doc/gccint/gimple/class-hierarchy-of-gimple-statements.rst: New file.
* doc/gccint/gimple/exception-handling.rst: New file.
* doc/gccint/gimple/gimple-instruction-set.rst: New file.
* doc/gccint/gimple/gimple-sequences.rst: New file.
* doc/gccint/gimple/manipulating-gimple-statements.rst: New file.
* doc/gccint/gimple/operands.rst: New file.
* doc/gccint/gimple/sequence-iterators.rst: New file.
* doc/gccint/gimple/statement-and-operand-traversals.rst: New file.
* doc/gccint/gimple/temporaries.rst: New file.
* doc/gccint/gimple/tuple-representation.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleasm.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleassign.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplebind.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplecall.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplecatch.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplecond.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpledebug.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleehfilter.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplegoto.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplelabel.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplenop.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompatomicload.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompatomicstore.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompcontinue.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompcritical.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompfor.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompmaster.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompordered.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompparallel.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompreturn.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompsection.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompsections.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleompsingle.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplephi.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleresx.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplereturn.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpleswitch.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimpletry.rst: New file.
* doc/gccint/gimple/tuple-specific-accessors/gimplewithcleanupexpr.rst: New file.
* doc/gccint/gnu-free-documentation-license.rst: New file.
* doc/gccint/guidelines-for-diagnostics.rst: New file.
* doc/gccint/guidelines-for-options.rst: New file.
* doc/gccint/host-common.rst: New file.
* doc/gccint/host-configuration.rst: New file.
* doc/gccint/host-filesystem.rst: New file.
* doc/gccint/host-makefile-fragments.rst: New file.
* doc/gccint/host-misc.rst: New file.
* doc/gccint/index.rst: New file.
* doc/gccint/indices-and-tables.rst: New file.
* doc/gccint/interfacing-to-gcc-output.rst: New file.
* doc/gccint/introduction.rst: New file.
* doc/gccint/language-front-ends-in-gcc.rst: New file.
* doc/gccint/link-time-optimization.rst: New file.
* doc/gccint/link-time-optimization/design-overview.rst: New file.
* doc/gccint/link-time-optimization/internal-flags-controlling-lto1.rst: New file.
* doc/gccint/link-time-optimization/lto-file-sections.rst: New file.
* doc/gccint/link-time-optimization/using-summary-information-in-ipa-passes.rst: New file.
* doc/gccint/link-time-optimization/whole-program-assumptions-linker-plugin-and-symbol-visibilities.rst:
New file.
* doc/gccint/machine-descriptions.rst: New file.
* doc/gccint/machine-descriptions/c-statements-for-assembler-output.rst: New file.
* doc/gccint/machine-descriptions/canonicalization-of-instructions.rst: New file.
* doc/gccint/machine-descriptions/conditional-execution.rst: New file.
* doc/gccint/machine-descriptions/constant-definitions.rst: New file.
* doc/gccint/machine-descriptions/defining-how-to-split-instructions.rst: New file.
* doc/gccint/machine-descriptions/defining-jump-instruction-patterns.rst: New file.
* doc/gccint/machine-descriptions/defining-looping-instruction-patterns.rst: New file.
* doc/gccint/machine-descriptions/defining-rtl-sequences-for-code-generation.rst: New file.
* doc/gccint/machine-descriptions/everything-about-instruction-patterns.rst: New file.
* doc/gccint/machine-descriptions/example-of-defineinsn.rst: New file.
* doc/gccint/machine-descriptions/including-patterns-in-machine-descriptions.rst: New file.
* doc/gccint/machine-descriptions/instruction-attributes.rst: New file.
* doc/gccint/machine-descriptions/interdependence-of-patterns.rst: New file.
* doc/gccint/machine-descriptions/iterators.rst: New file.
* doc/gccint/machine-descriptions/machine-specific-peephole-optimizers.rst: New file.
* doc/gccint/machine-descriptions/operand-constraints.rst: New file.
* doc/gccint/machine-descriptions/output-templates-and-operand-substitution.rst: New file.
* doc/gccint/machine-descriptions/overview-of-how-the-machine-description-is-used.rst:
New file.
* doc/gccint/machine-descriptions/predicates.rst: New file.
* doc/gccint/machine-descriptions/rtl-template.rst: New file.
* doc/gccint/machine-descriptions/rtl-templates-transformations.rst: New file.
* doc/gccint/machine-descriptions/standard-pattern-names-for-generation.rst: New file.
* doc/gccint/machine-descriptions/when-the-order-of-patterns-matters.rst: New file.
* doc/gccint/makefile-fragments.rst: New file.
* doc/gccint/match-and-simplify.rst: New file.
* doc/gccint/memory-management-and-type-information.rst: New file.
* doc/gccint/memory-management-and-type-information/how-to-invoke-the-garbage-collector.rst:
New file.
* doc/gccint/memory-management-and-type-information/marking-roots-for-the-garbage-collector.rst:
New file.
* doc/gccint/memory-management-and-type-information/source-files-containing-type-information.rst:
New file.
* doc/gccint/memory-management-and-type-information/support-for-inheritance.rst: New file.
* doc/gccint/memory-management-and-type-information/support-for-user-provided-gc-marking-routines.rst:
New file.
* doc/gccint/memory-management-and-type-information/the-inside-of-a-gty.rst: New file.
* doc/gccint/memory-management-and-type-information/troubleshooting-the-garbage-collector.rst:
New file.
* doc/gccint/option-file-format.rst: New file.
* doc/gccint/option-properties.rst: New file.
* doc/gccint/option-specification-files.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler/gimplification-pass.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler/inter-procedural-optimization-passes.rst:
New file.
* doc/gccint/passes-and-files-of-the-compiler/optimization-info.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler/parsing-pass.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler/pass-manager.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler/rtl-passes.rst: New file.
* doc/gccint/passes-and-files-of-the-compiler/tree-ssa-passes.rst: New file.
* doc/gccint/plugins.rst: New file.
* doc/gccint/plugins/building-gcc-plugins.rst: New file.
* doc/gccint/plugins/controlling-which-passes-are-being-run.rst: New file.
* doc/gccint/plugins/giving-information-about-a-plugin.rst: New file.
* doc/gccint/plugins/interacting-with-the-gcc-garbage-collector.rst: New file.
* doc/gccint/plugins/interacting-with-the-pass-manager.rst: New file.
* doc/gccint/plugins/keeping-track-of-available-passes.rst: New file.
* doc/gccint/plugins/loading-plugins.rst: New file.
* doc/gccint/plugins/plugin-api.rst: New file.
* doc/gccint/plugins/recording-information-about-pass-execution.rst: New file.
* doc/gccint/plugins/registering-custom-attributes-or-pragmas.rst: New file.
* doc/gccint/rtl-representation.rst: New file.
* doc/gccint/rtl-representation/access-to-operands.rst: New file.
* doc/gccint/rtl-representation/access-to-special-operands.rst: New file.
* doc/gccint/rtl-representation/assembler-instructions-as-expressions.rst: New file.
* doc/gccint/rtl-representation/bit-fields.rst: New file.
* doc/gccint/rtl-representation/comparison-operations.rst: New file.
* doc/gccint/rtl-representation/constant-expression-types.rst: New file.
* doc/gccint/rtl-representation/conversions.rst: New file.
* doc/gccint/rtl-representation/declarations.rst: New file.
* doc/gccint/rtl-representation/embedded-side-effects-on-addresses.rst: New file.
* doc/gccint/rtl-representation/flags-in-an-rtl-expression.rst: New file.
* doc/gccint/rtl-representation/insns.rst: New file.
* doc/gccint/rtl-representation/machine-modes.rst: New file.
* doc/gccint/rtl-representation/on-the-side-ssa-form-for-rtl.rst: New file.
* doc/gccint/rtl-representation/reading-rtl.rst: New file.
* doc/gccint/rtl-representation/registers-and-memory.rst: New file.
* doc/gccint/rtl-representation/rtl-classes-and-formats.rst: New file.
* doc/gccint/rtl-representation/rtl-expressions-for-arithmetic.rst: New file.
* doc/gccint/rtl-representation/rtl-object-types.rst: New file.
* doc/gccint/rtl-representation/rtl-representation-of-function-call-insns.rst: New file.
* doc/gccint/rtl-representation/side-effect-expressions.rst: New file.
* doc/gccint/rtl-representation/structure-sharing-assumptions.rst: New file.
* doc/gccint/rtl-representation/variable-location-debug-information-in-rtl.rst: New file.
* doc/gccint/rtl-representation/vector-operations.rst: New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants.rst: New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/alignment-of-polyints.rst: New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/arithmetic-on-polyints.rst: New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/comparisons-involving-polyint.rst:
New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/computing-bounds-on-polyints.rst:
New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/consequences-of-using-polyint.rst:
New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/converting-polyints.rst: New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/guidelines-for-using-polyint.rst:
New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/miscellaneous-polyint-routines.rst:
New file.
* doc/gccint/sizes-and-offsets-as-runtime-invariants/overview-of-polyint.rst: New file.
* doc/gccint/source-tree-structure-and-build-system.rst: New file.
* doc/gccint/source-tree-structure-and-build-system/configure-terms-and-history.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory.rst: New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/anatomy-of-a-language-front-end.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/anatomy-of-a-target-back-end.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/build-system-in-the-gcc-directory.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/building-documentation.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/configuration-in-the-gcc-directory.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/headers-installed-by-gcc.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/library-source-files-and-headers-under-the-gcc-directory.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/makefile-targets.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/the-gcc-subdirectory/subdirectories-of-gcc.rst:
New file.
* doc/gccint/source-tree-structure-and-build-system/top-level-source-directory.rst:
New file.
* doc/gccint/standard-header-file-directories.rst: New file.
* doc/gccint/static-analyzer.rst: New file.
* doc/gccint/target-macros.rst: New file.
* doc/gccint/target-macros/adding-support-for-named-address-spaces.rst: New file.
* doc/gccint/target-macros/addressing-modes.rst: New file.
* doc/gccint/target-macros/adjusting-the-instruction-scheduler.rst: New file.
* doc/gccint/target-macros/anchored-addresses.rst: New file.
* doc/gccint/target-macros/c++-abi-parameters.rst: New file.
* doc/gccint/target-macros/condition-code-status.rst: New file.
* doc/gccint/target-macros/controlling-debugging-information-format.rst: New file.
* doc/gccint/target-macros/controlling-the-compilation-driver-gcc.rst: New file.
* doc/gccint/target-macros/cross-compilation-and-floating-point.rst: New file.
* doc/gccint/target-macros/d-abi-parameters.rst: New file.
* doc/gccint/target-macros/defining-coprocessor-specifics-for-mips-targets.rst: New file.
* doc/gccint/target-macros/defining-data-structures-for-per-function-information.rst:
New file.
* doc/gccint/target-macros/defining-target-specific-uses-of-attribute.rst: New file.
* doc/gccint/target-macros/defining-the-output-assembler-language.rst: New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-alignment.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/assembler-commands-for-exception-regions.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/how-initialization-functions-are-handled.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/macros-controlling-initialization-routines.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/output-and-generation-of-labels.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/output-of-assembler-instructions.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/output-of-data.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/output-of-dispatch-tables.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/output-of-uninitialized-variables.rst:
New file.
* doc/gccint/target-macros/defining-the-output-assembler-language/the-overall-framework-of-an-assembler-file.rst:
New file.
* doc/gccint/target-macros/describing-relative-costs-of-operations.rst: New file.
* doc/gccint/target-macros/dividing-the-output-into-sections-texts-data.rst: New file.
* doc/gccint/target-macros/emulating-tls.rst: New file.
* doc/gccint/target-macros/implementing-the-varargs-macros.rst: New file.
* doc/gccint/target-macros/implicit-calls-to-library-routines.rst: New file.
* doc/gccint/target-macros/layout-of-source-language-data-types.rst: New file.
* doc/gccint/target-macros/miscellaneous-parameters.rst: New file.
* doc/gccint/target-macros/mode-switching-instructions.rst: New file.
* doc/gccint/target-macros/parameters-for-precompiled-header-validity-checking.rst:
New file.
* doc/gccint/target-macros/position-independent-code.rst: New file.
* doc/gccint/target-macros/register-classes.rst: New file.
* doc/gccint/target-macros/register-usage.rst: New file.
* doc/gccint/target-macros/run-time-target-specification.rst: New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions.rst: New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/basic-stack-layout.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/caller-saves-register-allocation.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/eliminating-frame-pointer-and-arg-pointer.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/exception-handling-support.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/function-entry-and-exit.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/generating-code-for-profiling.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/how-large-values-are-returned.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/how-scalar-function-values-are-returned.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/miscellaneous-register-hooks.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-arguments-in-registers.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/passing-function-arguments-on-the-stack.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/permitting-tail-calls.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/registers-that-address-the-stack-frame.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/shrink-wrapping-separate-components.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/specifying-how-stack-checking-is-done.rst:
New file.
* doc/gccint/target-macros/stack-layout-and-calling-conventions/stack-smashing-protection.rst:
New file.
* doc/gccint/target-macros/storage-layout.rst: New file.
* doc/gccint/target-macros/support-for-nested-functions.rst: New file.
* doc/gccint/target-macros/the-global-targetm-variable.rst: New file.
* doc/gccint/target-makefile-fragments.rst: New file.
* doc/gccint/testsuites.rst: New test.
* doc/gccint/testsuites/ada-language-testsuites.rst: New test.
* doc/gccint/testsuites/c-language-testsuites.rst: New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests.rst: New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests/commands-for-use-in-dg-final.rst:
New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests/features-for-dg-add-options.rst:
New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests/keywords-describing-target-attributes.rst:
New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests/selecting-targets-to-which-a-test-applies.rst:
New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests/syntax-and-descriptions-of-test-directives.rst:
New test.
* doc/gccint/testsuites/directives-used-within-dejagnu-tests/variants-of-dg-require-support.rst:
New test.
* doc/gccint/testsuites/idioms-used-in-testsuite-code.rst: New test.
* doc/gccint/testsuites/support-for-testing-binary-compatibility.rst: New test.
* doc/gccint/testsuites/support-for-testing-gcov.rst: New test.
* doc/gccint/testsuites/support-for-testing-gimple-passes.rst: New test.
* doc/gccint/testsuites/support-for-testing-link-time-optimizations.rst: New test.
* doc/gccint/testsuites/support-for-testing-profile-directed-optimizations.rst: New test.
* doc/gccint/testsuites/support-for-testing-rtl-passes.rst: New test.
* doc/gccint/testsuites/support-for-torture-testing-using-multiple-options.rst: New test.
* doc/gccint/the-gcc-low-level-runtime-library.rst: New file.
* doc/gccint/the-gcc-low-level-runtime-library/language-independent-routines-for-exception-handling.rst:
New file.
* doc/gccint/the-gcc-low-level-runtime-library/miscellaneous-runtime-library-routines.rst:
New file.
* doc/gccint/the-gcc-low-level-runtime-library/routines-for-decimal-floating-point-emulation.rst:
New file.
* doc/gccint/the-gcc-low-level-runtime-library/routines-for-fixed-point-fractional-emulation.rst:
New file.
* doc/gccint/the-gcc-low-level-runtime-library/routines-for-floating-point-emulation.rst:
New file.
* doc/gccint/the-gcc-low-level-runtime-library/routines-for-integer-arithmetic.rst:
New file.
* doc/gccint/the-language.rst: New file.
* doc/gccint/user-experience-guidelines.rst: New file.
* doc/install/binaries.rst: New file.
* doc/install/building.rst: New file.
* doc/install/building/building-a-cross-compiler.rst: New file.
* doc/install/building/building-a-native-compiler.rst: New file.
* doc/install/building/building-in-parallel.rst: New file.
* doc/install/building/building-the-ada-compiler.rst: New file.
* doc/install/building/building-the-d-compiler.rst: New file.
* doc/install/building/building-with-profile-feedback.rst: New file.
* doc/install/conf.py: New file.
* doc/install/configuration.rst: New file.
* doc/install/copyright.rst: New file.
* doc/install/downloading-gcc.rst: New file.
* doc/install/final-installation.rst: New file.
* doc/install/gnu-free-documentation-license.rst: New file.
* doc/install/host-target-specific-installation-notes-for-gcc.rst: New file.
* doc/install/how-can-you-run-the-testsuite-on-selected-tests.rst: New test.
* doc/install/how-to-interpret-test-results.rst: New file.
* doc/install/index.rst: New file.
* doc/install/indices-and-tables.rst: New file.
* doc/install/installing-gcc.rst: New file.
* doc/install/passing-options-and-running-multiple-testsuites.rst: New test.
* doc/install/prerequisites.rst: New file.
* doc/install/submitting-test-results.rst: New file.
* doc/install/testing.rst: New file.
gcc/fortran/ChangeLog:
* doc/gfc-internals/code-that-interacts-with-the-user.rst: New file.
* doc/gfc-internals/command-line-options.rst: New file.
* doc/gfc-internals/conf.py: New file.
* doc/gfc-internals/copyright.rst: New file.
* doc/gfc-internals/error-handling.rst: New file.
* doc/gfc-internals/frontend-data-structures.rst: New file.
* doc/gfc-internals/generating-the-intermediate-language-for-later-stages.rst: New file.
* doc/gfc-internals/generating-the-intermediate-language-for-later-stages/accessing-declarations.rst:
New file.
* doc/gfc-internals/generating-the-intermediate-language-for-later-stages/basic-data-structures.rst:
New file.
* doc/gfc-internals/generating-the-intermediate-language-for-later-stages/converting-expressions-to-tree.rst:
New file.
* doc/gfc-internals/generating-the-intermediate-language-for-later-stages/translating-statements.rst:
New file.
* doc/gfc-internals/gfccode.rst: New file.
* doc/gfc-internals/gfcexpr.rst: New file.
* doc/gfc-internals/gnu-free-documentation-license.rst: New file.
* doc/gfc-internals/index.rst: New file.
* doc/gfc-internals/indices-and-tables.rst: New file.
* doc/gfc-internals/internals-of-fortran-2003-oop-features.rst: New file.
* doc/gfc-internals/introduction.rst: New file.
* doc/gfc-internals/symbol-versioning.rst: New file.
* doc/gfc-internals/the-libgfortran-runtime-library.rst: New file.
* doc/gfc-internals/type-bound-operators.rst: New file.
* doc/gfc-internals/type-bound-procedures.rst: New file.
* doc/gfortran/about-gnu-fortran.rst: New file.
* doc/gfortran/coarray-programming.rst: New file.
* doc/gfortran/compiler-characteristics.rst: New file.
* doc/gfortran/compiler-characteristics/asynchronous-i-o.rst: New file.
* doc/gfortran/compiler-characteristics/data-consistency-and-durability.rst: New file.
* doc/gfortran/compiler-characteristics/evaluation-of-logical-expressions.rst: New file.
* doc/gfortran/compiler-characteristics/file-format-of-unformatted-sequential-files.rst:
New file.
* doc/gfortran/compiler-characteristics/file-operations-on-symbolic-links.rst: New file.
* doc/gfortran/compiler-characteristics/files-opened-without-an-explicit-action=-specifier.rst:
New file.
* doc/gfortran/compiler-characteristics/internal-representation-of-logical-variables.rst:
New file.
* doc/gfortran/compiler-characteristics/kind-type-parameters.rst: New file.
* doc/gfortran/compiler-characteristics/max-and-min-intrinsics-with-real-nan-arguments.rst:
New file.
* doc/gfortran/compiler-characteristics/thread-safety-of-the-runtime-library.rst: New file.
* doc/gfortran/conf.py: New file.
* doc/gfortran/contributing.rst: New file.
* doc/gfortran/contributors-to-gnu-fortran.rst: New file.
* doc/gfortran/copyright.rst: New file.
* doc/gfortran/extensions-implemented-in-gnu-fortran.rst: New file.
* doc/gfortran/extensions-not-implemented-in-gnu-fortran.rst: New file.
* doc/gfortran/extensions.rst: New file.
* doc/gfortran/function-abi-documentation.rst: New file.
* doc/gfortran/funding.rst: New file.
* doc/gfortran/general-public-license-3.rst: New file.
* doc/gfortran/gnu-fortran-and-gcc.rst: New file.
* doc/gfortran/gnu-fortran-command-options.rst: New file.
* doc/gfortran/gnu-fortran-command-options/description.rst: New file.
* doc/gfortran/gnu-fortran-command-options/enable-and-customize-preprocessing.rst: New file.
* doc/gfortran/gnu-fortran-command-options/environment-variables-affecting-gfortran.rst:
New file.
* doc/gfortran/gnu-fortran-command-options/influencing-runtime-behavior.rst: New file.
* doc/gfortran/gnu-fortran-command-options/influencing-the-linking-step.rst: New file.
* doc/gfortran/gnu-fortran-command-options/option-summary.rst: New file.
* doc/gfortran/gnu-fortran-command-options/options-controlling-fortran-dialect.rst:
New file.
* doc/gfortran/gnu-fortran-command-options/options-for-code-generation-conventions.rst:
New file.
* doc/gfortran/gnu-fortran-command-options/options-for-debugging-your-program-or-gnu-fortran.rst:
New file.
* doc/gfortran/gnu-fortran-command-options/options-for-directory-search.rst: New file.
* doc/gfortran/gnu-fortran-command-options/options-for-interoperability-with-other-languages.rst:
New file.
* doc/gfortran/gnu-fortran-command-options/options-to-request-or-suppress-errors-and-warnings.rst:
New file.
* doc/gfortran/gnu-fortran-compiler-directives.rst: New file.
* doc/gfortran/gnu-free-documentation-license.rst: New file.
* doc/gfortran/index.rst: New file.
* doc/gfortran/indices-and-tables.rst: New file.
* doc/gfortran/interoperability-with-c.rst: New file.
* doc/gfortran/intrinsic-modules.rst: New file.
* doc/gfortran/intrinsic-modules/ieee-modules-ieeeexceptions-ieeearithmetic-and-ieeefeatures.rst:
New file.
* doc/gfortran/intrinsic-modules/isocbinding.rst: New file.
* doc/gfortran/intrinsic-modules/isofortranenv.rst: New file.
* doc/gfortran/intrinsic-modules/openacc-module-openacc.rst: New file.
* doc/gfortran/intrinsic-modules/openmp-modules-omplib-and-omplibkinds.rst: New file.
* doc/gfortran/intrinsic-procedures.rst: New file.
* doc/gfortran/intrinsic-procedures/abort.rst: New file.
* doc/gfortran/intrinsic-procedures/abs.rst: New file.
* doc/gfortran/intrinsic-procedures/access.rst: New file.
* doc/gfortran/intrinsic-procedures/achar.rst: New file.
* doc/gfortran/intrinsic-procedures/acos.rst: New file.
* doc/gfortran/intrinsic-procedures/acosd.rst: New file.
* doc/gfortran/intrinsic-procedures/acosh.rst: New file.
* doc/gfortran/intrinsic-procedures/adjustl.rst: New file.
* doc/gfortran/intrinsic-procedures/adjustr.rst: New file.
* doc/gfortran/intrinsic-procedures/aimag.rst: New file.
* doc/gfortran/intrinsic-procedures/aint.rst: New file.
* doc/gfortran/intrinsic-procedures/alarm.rst: New file.
* doc/gfortran/intrinsic-procedures/all.rst: New file.
* doc/gfortran/intrinsic-procedures/allocated.rst: New file.
* doc/gfortran/intrinsic-procedures/and.rst: New file.
* doc/gfortran/intrinsic-procedures/anint.rst: New file.
* doc/gfortran/intrinsic-procedures/any.rst: New file.
* doc/gfortran/intrinsic-procedures/asin.rst: New file.
* doc/gfortran/intrinsic-procedures/asind.rst: New file.
* doc/gfortran/intrinsic-procedures/asinh.rst: New file.
* doc/gfortran/intrinsic-procedures/associated.rst: New file.
* doc/gfortran/intrinsic-procedures/atan.rst: New file.
* doc/gfortran/intrinsic-procedures/atan2.rst: New file.
* doc/gfortran/intrinsic-procedures/atan2d.rst: New file.
* doc/gfortran/intrinsic-procedures/atand.rst: New file.
* doc/gfortran/intrinsic-procedures/atanh.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicadd.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicand.rst: New file.
* doc/gfortran/intrinsic-procedures/atomiccas.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicdefine.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicfetchadd.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicfetchand.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicfetchor.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicfetchxor.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicor.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicref.rst: New file.
* doc/gfortran/intrinsic-procedures/atomicxor.rst: New file.
* doc/gfortran/intrinsic-procedures/backtrace.rst: New file.
* doc/gfortran/intrinsic-procedures/besselj0.rst: New file.
* doc/gfortran/intrinsic-procedures/besselj1.rst: New file.
* doc/gfortran/intrinsic-procedures/besseljn.rst: New file.
* doc/gfortran/intrinsic-procedures/bessely0.rst: New file.
* doc/gfortran/intrinsic-procedures/bessely1.rst: New file.
* doc/gfortran/intrinsic-procedures/besselyn.rst: New file.
* doc/gfortran/intrinsic-procedures/bge.rst: New file.
* doc/gfortran/intrinsic-procedures/bgt.rst: New file.
* doc/gfortran/intrinsic-procedures/bitsize.rst: New file.
* doc/gfortran/intrinsic-procedures/ble.rst: New file.
* doc/gfortran/intrinsic-procedures/blt.rst: New file.
* doc/gfortran/intrinsic-procedures/btest.rst: New file.
* doc/gfortran/intrinsic-procedures/cassociated.rst: New file.
* doc/gfortran/intrinsic-procedures/ceiling.rst: New file.
* doc/gfortran/intrinsic-procedures/cfpointer.rst: New file.
* doc/gfortran/intrinsic-procedures/cfprocpointer.rst: New file.
* doc/gfortran/intrinsic-procedures/cfunloc.rst: New file.
* doc/gfortran/intrinsic-procedures/char.rst: New file.
* doc/gfortran/intrinsic-procedures/chdir.rst: New file.
* doc/gfortran/intrinsic-procedures/chmod.rst: New file.
* doc/gfortran/intrinsic-procedures/cloc.rst: New file.
* doc/gfortran/intrinsic-procedures/cmplx.rst: New file.
* doc/gfortran/intrinsic-procedures/cobroadcast.rst: New file.
* doc/gfortran/intrinsic-procedures/comax.rst: New file.
* doc/gfortran/intrinsic-procedures/comin.rst: New file.
* doc/gfortran/intrinsic-procedures/commandargumentcount.rst: New file.
* doc/gfortran/intrinsic-procedures/compileroptions.rst: New file.
* doc/gfortran/intrinsic-procedures/compilerversion.rst: New file.
* doc/gfortran/intrinsic-procedures/complex.rst: New file.
* doc/gfortran/intrinsic-procedures/conjg.rst: New file.
* doc/gfortran/intrinsic-procedures/coreduce.rst: New file.
* doc/gfortran/intrinsic-procedures/cos.rst: New file.
* doc/gfortran/intrinsic-procedures/cosd.rst: New file.
* doc/gfortran/intrinsic-procedures/cosh.rst: New file.
* doc/gfortran/intrinsic-procedures/cosum.rst: New file.
* doc/gfortran/intrinsic-procedures/cotan.rst: New file.
* doc/gfortran/intrinsic-procedures/cotand.rst: New file.
* doc/gfortran/intrinsic-procedures/count.rst: New file.
* doc/gfortran/intrinsic-procedures/cputime.rst: New file.
* doc/gfortran/intrinsic-procedures/cshift.rst: New file.
* doc/gfortran/intrinsic-procedures/csizeof.rst: New file.
* doc/gfortran/intrinsic-procedures/ctime.rst: New file.
* doc/gfortran/intrinsic-procedures/dateandtime.rst: New file.
* doc/gfortran/intrinsic-procedures/dble.rst: New file.
* doc/gfortran/intrinsic-procedures/dcmplx.rst: New file.
* doc/gfortran/intrinsic-procedures/digits.rst: New file.
* doc/gfortran/intrinsic-procedures/dim.rst: New file.
* doc/gfortran/intrinsic-procedures/dotproduct.rst: New file.
* doc/gfortran/intrinsic-procedures/dprod.rst: New file.
* doc/gfortran/intrinsic-procedures/dreal.rst: New file.
* doc/gfortran/intrinsic-procedures/dshiftl.rst: New file.
* doc/gfortran/intrinsic-procedures/dshiftr.rst: New file.
* doc/gfortran/intrinsic-procedures/dtime.rst: New file.
* doc/gfortran/intrinsic-procedures/eoshift.rst: New file.
* doc/gfortran/intrinsic-procedures/epsilon.rst: New file.
* doc/gfortran/intrinsic-procedures/erf.rst: New file.
* doc/gfortran/intrinsic-procedures/erfc.rst: New file.
* doc/gfortran/intrinsic-procedures/erfcscaled.rst: New file.
* doc/gfortran/intrinsic-procedures/etime.rst: New file.
* doc/gfortran/intrinsic-procedures/eventquery.rst: New file.
* doc/gfortran/intrinsic-procedures/executecommandline.rst: New file.
* doc/gfortran/intrinsic-procedures/exit.rst: New file.
* doc/gfortran/intrinsic-procedures/exp.rst: New file.
* doc/gfortran/intrinsic-procedures/exponent.rst: New file.
* doc/gfortran/intrinsic-procedures/extendstypeof.rst: New file.
* doc/gfortran/intrinsic-procedures/fdate.rst: New file.
* doc/gfortran/intrinsic-procedures/fget.rst: New file.
* doc/gfortran/intrinsic-procedures/fgetc.rst: New file.
* doc/gfortran/intrinsic-procedures/findloc.rst: New file.
* doc/gfortran/intrinsic-procedures/floor.rst: New file.
* doc/gfortran/intrinsic-procedures/flush.rst: New file.
* doc/gfortran/intrinsic-procedures/fnum.rst: New file.
* doc/gfortran/intrinsic-procedures/fput.rst: New file.
* doc/gfortran/intrinsic-procedures/fputc.rst: New file.
* doc/gfortran/intrinsic-procedures/fraction.rst: New file.
* doc/gfortran/intrinsic-procedures/free.rst: New file.
* doc/gfortran/intrinsic-procedures/fseek.rst: New file.
* doc/gfortran/intrinsic-procedures/fstat.rst: New file.
* doc/gfortran/intrinsic-procedures/ftell.rst: New file.
* doc/gfortran/intrinsic-procedures/gamma.rst: New file.
* doc/gfortran/intrinsic-procedures/gerror.rst: New file.
* doc/gfortran/intrinsic-procedures/getarg.rst: New file.
* doc/gfortran/intrinsic-procedures/getcommand.rst: New file.
* doc/gfortran/intrinsic-procedures/getcommandargument.rst: New file.
* doc/gfortran/intrinsic-procedures/getcwd.rst: New file.
* doc/gfortran/intrinsic-procedures/getenv.rst: New file.
* doc/gfortran/intrinsic-procedures/getenvironmentvariable.rst: New file.
* doc/gfortran/intrinsic-procedures/getgid.rst: New file.
* doc/gfortran/intrinsic-procedures/getlog.rst: New file.
* doc/gfortran/intrinsic-procedures/getpid.rst: New file.
* doc/gfortran/intrinsic-procedures/getuid.rst: New file.
* doc/gfortran/intrinsic-procedures/gmtime.rst: New file.
* doc/gfortran/intrinsic-procedures/hostnm.rst: New file.
* doc/gfortran/intrinsic-procedures/huge.rst: New file.
* doc/gfortran/intrinsic-procedures/hypot.rst: New file.
* doc/gfortran/intrinsic-procedures/iachar.rst: New file.
* doc/gfortran/intrinsic-procedures/iall.rst: New file.
* doc/gfortran/intrinsic-procedures/iand.rst: New file.
* doc/gfortran/intrinsic-procedures/iany.rst: New file.
* doc/gfortran/intrinsic-procedures/iargc.rst: New file.
* doc/gfortran/intrinsic-procedures/ibclr.rst: New file.
* doc/gfortran/intrinsic-procedures/ibits.rst: New file.
* doc/gfortran/intrinsic-procedures/ibset.rst: New file.
* doc/gfortran/intrinsic-procedures/ichar.rst: New file.
* doc/gfortran/intrinsic-procedures/idate.rst: New file.
* doc/gfortran/intrinsic-procedures/ieor.rst: New file.
* doc/gfortran/intrinsic-procedures/ierrno.rst: New file.
* doc/gfortran/intrinsic-procedures/imageindex.rst: New file.
* doc/gfortran/intrinsic-procedures/index.rst: New file.
* doc/gfortran/intrinsic-procedures/int.rst: New file.
* doc/gfortran/intrinsic-procedures/int2.rst: New file.
* doc/gfortran/intrinsic-procedures/int8.rst: New file.
* doc/gfortran/intrinsic-procedures/introduction-to-intrinsic-procedures.rst: New file.
* doc/gfortran/intrinsic-procedures/ior.rst: New file.
* doc/gfortran/intrinsic-procedures/iparity.rst: New file.
* doc/gfortran/intrinsic-procedures/irand.rst: New file.
* doc/gfortran/intrinsic-procedures/isatty.rst: New file.
* doc/gfortran/intrinsic-procedures/iscontiguous.rst: New file.
* doc/gfortran/intrinsic-procedures/ishft.rst: New file.
* doc/gfortran/intrinsic-procedures/ishftc.rst: New file.
* doc/gfortran/intrinsic-procedures/isiostatend.rst: New file.
* doc/gfortran/intrinsic-procedures/isiostateor.rst: New file.
* doc/gfortran/intrinsic-procedures/isnan.rst: New file.
* doc/gfortran/intrinsic-procedures/itime.rst: New file.
* doc/gfortran/intrinsic-procedures/kill.rst: New file.
* doc/gfortran/intrinsic-procedures/kind.rst: New file.
* doc/gfortran/intrinsic-procedures/lbound.rst: New file.
* doc/gfortran/intrinsic-procedures/lcobound.rst: New file.
* doc/gfortran/intrinsic-procedures/leadz.rst: New file.
* doc/gfortran/intrinsic-procedures/len.rst: New file.
* doc/gfortran/intrinsic-procedures/lentrim.rst: New file.
* doc/gfortran/intrinsic-procedures/lge.rst: New file.
* doc/gfortran/intrinsic-procedures/lgt.rst: New file.
* doc/gfortran/intrinsic-procedures/link.rst: New file.
* doc/gfortran/intrinsic-procedures/lle.rst: New file.
* doc/gfortran/intrinsic-procedures/llt.rst: New file.
* doc/gfortran/intrinsic-procedures/lnblnk.rst: New file.
* doc/gfortran/intrinsic-procedures/loc.rst: New file.
* doc/gfortran/intrinsic-procedures/log.rst: New file.
* doc/gfortran/intrinsic-procedures/log10.rst: New file.
* doc/gfortran/intrinsic-procedures/loggamma.rst: New file.
* doc/gfortran/intrinsic-procedures/logical.rst: New file.
* doc/gfortran/intrinsic-procedures/lshift.rst: New file.
* doc/gfortran/intrinsic-procedures/lstat.rst: New file.
* doc/gfortran/intrinsic-procedures/ltime.rst: New file.
* doc/gfortran/intrinsic-procedures/malloc.rst: New file.
* doc/gfortran/intrinsic-procedures/maskl.rst: New file.
* doc/gfortran/intrinsic-procedures/maskr.rst: New file.
* doc/gfortran/intrinsic-procedures/matmul.rst: New file.
* doc/gfortran/intrinsic-procedures/max.rst: New file.
* doc/gfortran/intrinsic-procedures/maxexponent.rst: New file.
* doc/gfortran/intrinsic-procedures/maxloc.rst: New file.
* doc/gfortran/intrinsic-procedures/maxval.rst: New file.
* doc/gfortran/intrinsic-procedures/mclock.rst: New file.
* doc/gfortran/intrinsic-procedures/mclock8.rst: New file.
* doc/gfortran/intrinsic-procedures/merge.rst: New file.
* doc/gfortran/intrinsic-procedures/mergebits.rst: New file.
* doc/gfortran/intrinsic-procedures/min.rst: New file.
* doc/gfortran/intrinsic-procedures/minexponent.rst: New file.
* doc/gfortran/intrinsic-procedures/minloc.rst: New file.
* doc/gfortran/intrinsic-procedures/minval.rst: New file.
* doc/gfortran/intrinsic-procedures/mod.rst: New file.
* doc/gfortran/intrinsic-procedures/modulo.rst: New file.
* doc/gfortran/intrinsic-procedures/movealloc.rst: New file.
* doc/gfortran/intrinsic-procedures/mvbits.rst: New file.
* doc/gfortran/intrinsic-procedures/nearest.rst: New file.
* doc/gfortran/intrinsic-procedures/newline.rst: New file.
* doc/gfortran/intrinsic-procedures/nint.rst: New file.
* doc/gfortran/intrinsic-procedures/norm2.rst: New file.
* doc/gfortran/intrinsic-procedures/not.rst: New file.
* doc/gfortran/intrinsic-procedures/null.rst: New file.
* doc/gfortran/intrinsic-procedures/numimages.rst: New file.
* doc/gfortran/intrinsic-procedures/or.rst: New file.
* doc/gfortran/intrinsic-procedures/pack.rst: New file.
* doc/gfortran/intrinsic-procedures/parity.rst: New file.
* doc/gfortran/intrinsic-procedures/perror.rst: New file.
* doc/gfortran/intrinsic-procedures/popcnt.rst: New file.
* doc/gfortran/intrinsic-procedures/poppar.rst: New file.
* doc/gfortran/intrinsic-procedures/precision.rst: New file.
* doc/gfortran/intrinsic-procedures/present.rst: New file.
* doc/gfortran/intrinsic-procedures/product.rst: New file.
* doc/gfortran/intrinsic-procedures/radix.rst: New file.
* doc/gfortran/intrinsic-procedures/ran.rst: New file.
* doc/gfortran/intrinsic-procedures/rand.rst: New file.
* doc/gfortran/intrinsic-procedures/randominit.rst: New file.
* doc/gfortran/intrinsic-procedures/randomnumber.rst: New file.
* doc/gfortran/intrinsic-procedures/randomseed.rst: New file.
* doc/gfortran/intrinsic-procedures/range.rst: New file.
* doc/gfortran/intrinsic-procedures/rank.rst: New file.
* doc/gfortran/intrinsic-procedures/real.rst: New file.
* doc/gfortran/intrinsic-procedures/rename.rst: New file.
* doc/gfortran/intrinsic-procedures/repeat.rst: New file.
* doc/gfortran/intrinsic-procedures/reshape.rst: New file.
* doc/gfortran/intrinsic-procedures/rrspacing.rst: New file.
* doc/gfortran/intrinsic-procedures/rshift.rst: New file.
* doc/gfortran/intrinsic-procedures/sametypeas.rst: New file.
* doc/gfortran/intrinsic-procedures/scale.rst: New file.
* doc/gfortran/intrinsic-procedures/scan.rst: New file.
* doc/gfortran/intrinsic-procedures/secnds.rst: New file.
* doc/gfortran/intrinsic-procedures/second.rst: New file.
* doc/gfortran/intrinsic-procedures/selectedcharkind.rst: New file.
* doc/gfortran/intrinsic-procedures/selectedintkind.rst: New file.
* doc/gfortran/intrinsic-procedures/selectedrealkind.rst: New file.
* doc/gfortran/intrinsic-procedures/setexponent.rst: New file.
* doc/gfortran/intrinsic-procedures/shape.rst: New file.
* doc/gfortran/intrinsic-procedures/shifta.rst: New file.
* doc/gfortran/intrinsic-procedures/shiftl.rst: New file.
* doc/gfortran/intrinsic-procedures/shiftr.rst: New file.
* doc/gfortran/intrinsic-procedures/sign.rst: New file.
* doc/gfortran/intrinsic-procedures/signal.rst: New file.
* doc/gfortran/intrinsic-procedures/sin.rst: New file.
* doc/gfortran/intrinsic-procedures/sind.rst: New file.
* doc/gfortran/intrinsic-procedures/sinh.rst: New file.
* doc/gfortran/intrinsic-procedures/size.rst: New file.
* doc/gfortran/intrinsic-procedures/sizeof.rst: New file.
* doc/gfortran/intrinsic-procedures/sleep.rst: New file.
* doc/gfortran/intrinsic-procedures/spacing.rst: New file.
* doc/gfortran/intrinsic-procedures/spread.rst: New file.
* doc/gfortran/intrinsic-procedures/sqrt.rst: New file.
* doc/gfortran/intrinsic-procedures/srand.rst: New file.
* doc/gfortran/intrinsic-procedures/stat.rst: New file.
* doc/gfortran/intrinsic-procedures/storagesize.rst: New file.
* doc/gfortran/intrinsic-procedures/sum.rst: New file.
* doc/gfortran/intrinsic-procedures/symlnk.rst: New file.
* doc/gfortran/intrinsic-procedures/system.rst: New file.
* doc/gfortran/intrinsic-procedures/systemclock.rst: New file.
* doc/gfortran/intrinsic-procedures/tan.rst: New file.
* doc/gfortran/intrinsic-procedures/tand.rst: New file.
* doc/gfortran/intrinsic-procedures/tanh.rst: New file.
* doc/gfortran/intrinsic-procedures/thisimage.rst: New file.
* doc/gfortran/intrinsic-procedures/time.rst: New file.
* doc/gfortran/intrinsic-procedures/time8.rst: New file.
* doc/gfortran/intrinsic-procedures/tiny.rst: New file.
* doc/gfortran/intrinsic-procedures/trailz.rst: New file.
* doc/gfortran/intrinsic-procedures/transfer.rst: New file.
* doc/gfortran/intrinsic-procedures/transpose.rst: New file.
* doc/gfortran/intrinsic-procedures/trim.rst: New file.
* doc/gfortran/intrinsic-procedures/ttynam.rst: New file.
* doc/gfortran/intrinsic-procedures/ubound.rst: New file.
* doc/gfortran/intrinsic-procedures/ucobound.rst: New file.
* doc/gfortran/intrinsic-procedures/umask.rst: New file.
* doc/gfortran/intrinsic-procedures/unlink.rst: New file.
* doc/gfortran/intrinsic-procedures/unpack.rst: New file.
* doc/gfortran/intrinsic-procedures/verify.rst: New file.
* doc/gfortran/intrinsic-procedures/xor.rst: New file.
* doc/gfortran/introduction.rst: New file.
* doc/gfortran/mixed-language-programming.rst: New file.
* doc/gfortran/naming-and-argument-passing-conventions.rst: New file.
* doc/gfortran/non-fortran-main-program.rst: New file.
* doc/gfortran/projects.rst: New file.
* doc/gfortran/runtime.rst: New file.
* doc/gfortran/runtime/gfortranconvertunit.rst: New file.
* doc/gfortran/runtime/gfortranerrorbacktrace.rst: New file.
* doc/gfortran/runtime/gfortranformattedbuffersize.rst: New file.
* doc/gfortran/runtime/gfortranlistseparator.rst: New file.
* doc/gfortran/runtime/gfortranoptionalplus.rst: New file.
* doc/gfortran/runtime/gfortranshowlocus.rst: New file.
* doc/gfortran/runtime/gfortranstderrunit.rst: New file.
* doc/gfortran/runtime/gfortranstdinunit.rst: New file.
* doc/gfortran/runtime/gfortranstdoutunit.rst: New file.
* doc/gfortran/runtime/gfortranunbufferedall.rst: New file.
* doc/gfortran/runtime/gfortranunbufferedpreconnected.rst: New file.
* doc/gfortran/runtime/gfortranunformattedbuffersize.rst: New file.
* doc/gfortran/runtime/tmpdir.rst: New file.
* doc/gfortran/standards.rst: New file.
* doc/gfortran/type-and-enum-abi-documentation.rst: New file.
gcc/go/ChangeLog:
* doc/c-interoperability.rst: New file.
* doc/c-type-interoperability.rst: New file.
* doc/compiler-directives.rst: New file.
* doc/conf.py: New file.
* doc/copyright.rst: New file.
* doc/function-names.rst: New file.
* doc/general-public-license-3.rst: New file.
* doc/gnu-free-documentation-license.rst: New file.
* doc/import-and-export.rst: New file.
* doc/index.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/introduction.rst: New file.
* doc/invoking-gccgo.rst: New file.
libgomp/ChangeLog:
* doc/conf.py: New file.
* doc/copyright.rst: New file.
* doc/cuda-streams-usage.rst: New file.
* doc/enabling-openacc.rst: New file.
* doc/enabling-openmp.rst: New file.
* doc/first-invocation-nvidia-cublas-library-api.rst: New file.
* doc/first-invocation-openacc-library-api.rst: New file.
* doc/funding.rst: New file.
* doc/general-public-license-3.rst: New file.
* doc/gnu-free-documentation-license.rst: New file.
* doc/implementation-status-and-implementation-defined-behavior.rst: New file.
* doc/index.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/introduction.rst: New file.
* doc/offload-target-specifics.rst: New file.
* doc/openacc-environment-variables.rst: New file.
* doc/openacc-environment-variables/accdevicenum.rst: New file.
* doc/openacc-environment-variables/accdevicetype.rst: New file.
* doc/openacc-environment-variables/accproflib.rst: New file.
* doc/openacc-environment-variables/gccaccnotify.rst: New file.
* doc/openacc-introduction.rst: New file.
* doc/openacc-library-and-environment-variables.rst: New file.
* doc/openacc-library-interoperability.rst: New file.
* doc/openacc-profiling-interface.rst: New file.
* doc/openacc-runtime-library-routines.rst: New file.
* doc/openacc-runtime-library-routines/accasynctest.rst: New file.
* doc/openacc-runtime-library-routines/accasynctestall.rst: New file.
* doc/openacc-runtime-library-routines/accattach.rst: New file.
* doc/openacc-runtime-library-routines/acccopyin.rst: New file.
* doc/openacc-runtime-library-routines/acccopyout.rst: New file.
* doc/openacc-runtime-library-routines/acccreate.rst: New file.
* doc/openacc-runtime-library-routines/accdelete.rst: New file.
* doc/openacc-runtime-library-routines/accdetach.rst: New file.
* doc/openacc-runtime-library-routines/accdeviceptr.rst: New file.
* doc/openacc-runtime-library-routines/accfree.rst: New file.
* doc/openacc-runtime-library-routines/accgetcudastream.rst: New file.
* doc/openacc-runtime-library-routines/accgetcurrentcudacontext.rst: New file.
* doc/openacc-runtime-library-routines/accgetcurrentcudadevice.rst: New file.
* doc/openacc-runtime-library-routines/accgetdevicenum.rst: New file.
* doc/openacc-runtime-library-routines/accgetdevicetype.rst: New file.
* doc/openacc-runtime-library-routines/accgetnumdevices.rst: New file.
* doc/openacc-runtime-library-routines/accgetproperty.rst: New file.
* doc/openacc-runtime-library-routines/acchostptr.rst: New file.
* doc/openacc-runtime-library-routines/accinit.rst: New file.
* doc/openacc-runtime-library-routines/accispresent.rst: New file.
* doc/openacc-runtime-library-routines/accmalloc.rst: New file.
* doc/openacc-runtime-library-routines/accmapdata.rst: New file.
* doc/openacc-runtime-library-routines/accmemcpyfromdevice.rst: New file.
* doc/openacc-runtime-library-routines/accmemcpytodevice.rst: New file.
* doc/openacc-runtime-library-routines/accondevice.rst: New file.
* doc/openacc-runtime-library-routines/accpresentorcopyin.rst: New file.
* doc/openacc-runtime-library-routines/accpresentorcreate.rst: New file.
* doc/openacc-runtime-library-routines/accproflookup.rst: New file.
* doc/openacc-runtime-library-routines/accprofregister.rst: New file.
* doc/openacc-runtime-library-routines/accprofunregister.rst: New file.
* doc/openacc-runtime-library-routines/accregisterlibrary.rst: New file.
* doc/openacc-runtime-library-routines/accsetcudastream.rst: New file.
* doc/openacc-runtime-library-routines/accsetdevicenum.rst: New file.
* doc/openacc-runtime-library-routines/accsetdevicetype.rst: New file.
* doc/openacc-runtime-library-routines/accshutdown.rst: New file.
* doc/openacc-runtime-library-routines/accunmapdata.rst: New file.
* doc/openacc-runtime-library-routines/accupdatedevice.rst: New file.
* doc/openacc-runtime-library-routines/accupdateself.rst: New file.
* doc/openacc-runtime-library-routines/accwait.rst: New file.
* doc/openacc-runtime-library-routines/accwaitall.rst: New file.
* doc/openacc-runtime-library-routines/accwaitallasync.rst: New file.
* doc/openacc-runtime-library-routines/accwaitasync.rst: New file.
* doc/openmp-context-selectors.rst: New file.
* doc/openmp-environment-variables.rst: New file.
* doc/openmp-environment-variables/gompcpuaffinity.rst: New file.
* doc/openmp-environment-variables/gompdebug.rst: New file.
* doc/openmp-environment-variables/gomprtemsthreadpools.rst: New file.
* doc/openmp-environment-variables/gompspincount.rst: New file.
* doc/openmp-environment-variables/gompstacksize.rst: New file.
* doc/openmp-environment-variables/ompcancellation.rst: New file.
* doc/openmp-environment-variables/ompdefaultdevice.rst: New file.
* doc/openmp-environment-variables/ompdisplayenv.rst: New file.
* doc/openmp-environment-variables/ompdynamic.rst: New file.
* doc/openmp-environment-variables/ompmaxactivelevels.rst: New file.
* doc/openmp-environment-variables/ompmaxtaskpriority.rst: New file.
* doc/openmp-environment-variables/ompnested.rst: New file.
* doc/openmp-environment-variables/ompnumteams.rst: New file.
* doc/openmp-environment-variables/ompnumthreads.rst: New file.
* doc/openmp-environment-variables/ompplaces.rst: New file.
* doc/openmp-environment-variables/ompprocbind.rst: New file.
* doc/openmp-environment-variables/ompschedule.rst: New file.
* doc/openmp-environment-variables/ompstacksize.rst: New file.
* doc/openmp-environment-variables/omptargetoffload.rst: New file.
* doc/openmp-environment-variables/ompteamsthreadlimit.rst: New file.
* doc/openmp-environment-variables/ompthreadlimit.rst: New file.
* doc/openmp-environment-variables/ompwaitpolicy.rst: New file.
* doc/openmp-implementation-status.rst: New file.
* doc/openmp-implementation-status/openmp-45.rst: New file.
* doc/openmp-implementation-status/openmp-50.rst: New file.
* doc/openmp-implementation-status/openmp-51.rst: New file.
* doc/openmp-implementation-status/openmp-52.rst: New file.
* doc/openmp-runtime-library-routines.rst: New file.
* doc/openmp-runtime-library-routines/ompdestroylock.rst: New file.
* doc/openmp-runtime-library-routines/ompdestroynestlock.rst: New file.
* doc/openmp-runtime-library-routines/ompfulfillevent.rst: New file.
* doc/openmp-runtime-library-routines/ompgetactivelevel.rst: New file.
* doc/openmp-runtime-library-routines/ompgetancestorthreadnum.rst: New file.
* doc/openmp-runtime-library-routines/ompgetcancellation.rst: New file.
* doc/openmp-runtime-library-routines/ompgetdefaultdevice.rst: New file.
* doc/openmp-runtime-library-routines/ompgetdevicenum.rst: New file.
* doc/openmp-runtime-library-routines/ompgetdynamic.rst: New file.
* doc/openmp-runtime-library-routines/ompgetinitialdevice.rst: New file.
* doc/openmp-runtime-library-routines/ompgetlevel.rst: New file.
* doc/openmp-runtime-library-routines/ompgetmaxactivelevels.rst: New file.
* doc/openmp-runtime-library-routines/ompgetmaxtaskpriority.rst: New file.
* doc/openmp-runtime-library-routines/ompgetmaxteams.rst: New file.
* doc/openmp-runtime-library-routines/ompgetmaxthreads.rst: New file.
* doc/openmp-runtime-library-routines/ompgetnested.rst: New file.
* doc/openmp-runtime-library-routines/ompgetnumdevices.rst: New file.
* doc/openmp-runtime-library-routines/ompgetnumprocs.rst: New file.
* doc/openmp-runtime-library-routines/ompgetnumteams.rst: New file.
* doc/openmp-runtime-library-routines/ompgetnumthreads.rst: New file.
* doc/openmp-runtime-library-routines/ompgetprocbind.rst: New file.
* doc/openmp-runtime-library-routines/ompgetschedule.rst: New file.
* doc/openmp-runtime-library-routines/ompgetsupportedactivelevels.rst: New file.
* doc/openmp-runtime-library-routines/ompgetteamnum.rst: New file.
* doc/openmp-runtime-library-routines/ompgetteamsize.rst: New file.
* doc/openmp-runtime-library-routines/ompgetteamsthreadlimit.rst: New file.
* doc/openmp-runtime-library-routines/ompgetthreadlimit.rst: New file.
* doc/openmp-runtime-library-routines/ompgetthreadnum.rst: New file.
* doc/openmp-runtime-library-routines/ompgetwtick.rst: New file.
* doc/openmp-runtime-library-routines/ompgetwtime.rst: New file.
* doc/openmp-runtime-library-routines/ompinfinal.rst: New file.
* doc/openmp-runtime-library-routines/ompinitlock.rst: New file.
* doc/openmp-runtime-library-routines/ompinitnestlock.rst: New file.
* doc/openmp-runtime-library-routines/ompinparallel.rst: New file.
* doc/openmp-runtime-library-routines/ompisinitialdevice.rst: New file.
* doc/openmp-runtime-library-routines/ompsetdefaultdevice.rst: New file.
* doc/openmp-runtime-library-routines/ompsetdynamic.rst: New file.
* doc/openmp-runtime-library-routines/ompsetlock.rst: New file.
* doc/openmp-runtime-library-routines/ompsetmaxactivelevels.rst: New file.
* doc/openmp-runtime-library-routines/ompsetnested.rst: New file.
* doc/openmp-runtime-library-routines/ompsetnestlock.rst: New file.
* doc/openmp-runtime-library-routines/ompsetnumteams.rst: New file.
* doc/openmp-runtime-library-routines/ompsetnumthreads.rst: New file.
* doc/openmp-runtime-library-routines/ompsetschedule.rst: New file.
* doc/openmp-runtime-library-routines/ompsetteamsthreadlimit.rst: New file.
* doc/openmp-runtime-library-routines/omptestlock.rst: New file.
* doc/openmp-runtime-library-routines/omptestnestlock.rst: New file.
* doc/openmp-runtime-library-routines/ompunsetlock.rst: New file.
* doc/openmp-runtime-library-routines/ompunsetnestlock.rst: New file.
* doc/reporting-bugs.rst: New file.
* doc/the-libgomp-abi.rst: New file.
* doc/the-libgomp-abi/implementing-atomic-construct.rst: New file.
* doc/the-libgomp-abi/implementing-barrier-construct.rst: New file.
* doc/the-libgomp-abi/implementing-critical-construct.rst: New file.
* doc/the-libgomp-abi/implementing-firstprivate-lastprivate-copyin-and-copyprivate-clauses.rst:
New file.
* doc/the-libgomp-abi/implementing-flush-construct.rst: New file.
* doc/the-libgomp-abi/implementing-for-construct.rst: New file.
* doc/the-libgomp-abi/implementing-master-construct.rst: New file.
* doc/the-libgomp-abi/implementing-openaccs-parallel-construct.rst: New file.
* doc/the-libgomp-abi/implementing-ordered-construct.rst: New file.
* doc/the-libgomp-abi/implementing-parallel-construct.rst: New file.
* doc/the-libgomp-abi/implementing-private-clause.rst: New file.
* doc/the-libgomp-abi/implementing-reduction-clause.rst: New file.
* doc/the-libgomp-abi/implementing-sections-construct.rst: New file.
* doc/the-libgomp-abi/implementing-single-construct.rst: New file.
* doc/the-libgomp-abi/implementing-threadprivate-construct.rst: New file.
libiberty/ChangeLog:
* doc/bsd.rst: New file.
* doc/conf.py: New file.
* doc/copyright.rst: New file.
* doc/extensions.rst: New file.
* doc/function-variable-and-macro-listing.rst: New file.
* doc/index.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/introduction.rst: New file.
* doc/lesser-general-public-license-2.1.rst: New file.
* doc/overview.rst: New file.
* doc/replacement-functions.rst: New file.
* doc/supplemental-functions.rst: New file.
* doc/using.rst: New file.
libitm/ChangeLog:
* doc/c-c++-language-constructs-for-tm.rst: New file.
* doc/conf.py: New file.
* doc/copyright.rst: New file.
* doc/enabling-libitm.rst: New file.
* doc/gnu-free-documentation-license.rst: New file.
* doc/index.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/internals.rst: New file.
* doc/locking-conventions.rst: New file.
* doc/nesting-flat-vs-closed.rst: New file.
* doc/the-libitm-abi.rst: New file.
* doc/the-libitm-abi/function-list.rst: New file.
* doc/the-libitm-abi/future-enhancements-to-the-abi.rst: New file.
* doc/the-libitm-abi/library-design-principles.rst: New file.
* doc/the-libitm-abi/memory-model.rst: New file.
* doc/the-libitm-abi/non-objectives.rst: New file.
* doc/the-libitm-abi/objectives.rst: New file.
* doc/the-libitm-abi/sample-code.rst: New file.
* doc/the-libitm-abi/types-and-macros-list.rst: New file.
* doc/tm-methods-and-method-groups.rst: New file.
libquadmath/ChangeLog:
* doc/conf.py: New file.
* doc/copyright.rst: New file.
* doc/gnu-free-documentation-license.rst: New file.
* doc/i-o-library-routines.rst: New file.
* doc/index.rst: New file.
* doc/indices-and-tables.rst: New file.
* doc/introduction.rst: New file.
* doc/math-library-routines.rst: New file.
* doc/quadmathsnprintf.rst: New file.
* doc/reporting-bugs.rst: New file.
* doc/strtoflt128.rst: New file.
* doc/typedef-and-constants.rst: New file.
Diff:
---
doc/Makefile | 20 +
doc/_static/custom.css | 11 +
doc/baseconf.py | 186 +
doc/bsd.rst | 39 +
doc/contrib.rst | 1273 +++++
doc/contribute.rst | 21 +
doc/cppdiropts.rst | 217 +
doc/cppenv.rst | 97 +
doc/cppopts.rst | 555 +++
doc/cppwarnopts.rst | 4 +
doc/favicon.ico | Bin 0 -> 766 bytes
doc/funding.rst | 47 +
doc/gcc_sphinx.py | 15 +
doc/gnu.rst | 19 +
doc/gnu_free_documentation_license.rst | 476 ++
doc/gpl-3.0.rst | 707 +++
doc/indices-and-tables.rst | 6 +
doc/lgpl-2.1.rst | 514 +++
doc/logo.pdf | Bin 0 -> 8978 bytes
doc/logo.svg | 108 +
doc/md.rst | 3179 +++++++++++++
gcc/d/doc/conf.py | 29 +
gcc/d/doc/copyright.rst | 13 +
gcc/d/doc/general-public-license-3.rst | 6 +
gcc/d/doc/gnu-free-documentation-license.rst | 6 +
gcc/d/doc/index.rst | 22 +
gcc/d/doc/indices-and-tables.rst | 1 +
gcc/d/doc/invoking-gdc.rst | 48 +
gcc/d/doc/invoking-gdc/code-generation.rst | 170 +
gcc/d/doc/invoking-gdc/developer-options.rst | 31 +
gcc/d/doc/invoking-gdc/input-and-output-files.rst | 45 +
.../invoking-gdc/options-for-directory-search.rst | 92 +
gcc/d/doc/invoking-gdc/options-for-linking.rst | 59 +
gcc/d/doc/invoking-gdc/runtime-options.rst | 307 ++
gcc/d/doc/invoking-gdc/warnings.rst | 148 +
gcc/doc/cpp/character-sets.rst | 56 +
gcc/doc/cpp/conditional-syntax.rst | 411 ++
gcc/doc/cpp/conditional-uses.rst | 32 +
gcc/doc/cpp/conditionals.rst | 44 +
gcc/doc/cpp/conf.py | 29 +
gcc/doc/cpp/copyright.rst | 24 +
gcc/doc/cpp/deleted-code.rst | 34 +
gcc/doc/cpp/diagnostics.rst | 51 +
gcc/doc/cpp/environment-variables.rst | 23 +
gcc/doc/cpp/gnu-free-documentation-license.rst | 6 +
gcc/doc/cpp/header-files.rst | 56 +
.../alternatives-to-wrapper-ifndef.rst | 40 +
gcc/doc/cpp/header-files/computed-includes.rst | 86 +
gcc/doc/cpp/header-files/include-operation.rst | 67 +
gcc/doc/cpp/header-files/include-syntax.rst | 42 +
gcc/doc/cpp/header-files/once-only-headers.rst | 52 +
gcc/doc/cpp/header-files/search-path.rst | 53 +
gcc/doc/cpp/header-files/system-headers.rst | 41 +
gcc/doc/cpp/header-files/wrapper-headers.rst | 58 +
gcc/doc/cpp/implementation-defined-behavior.rst | 97 +
gcc/doc/cpp/implementation-details.rst | 23 +
gcc/doc/cpp/implementation-limits.rst | 68 +
gcc/doc/cpp/index.rst | 35 +
gcc/doc/cpp/indices-and-tables.rst | 1 +
gcc/doc/cpp/initial-processing.rst | 164 +
gcc/doc/cpp/invocation.rst | 81 +
gcc/doc/cpp/line-control.rst | 55 +
gcc/doc/cpp/macros.rst | 37 +
gcc/doc/cpp/macros/concatenation.rst | 85 +
.../macros/directives-within-macro-arguments.rst | 39 +
gcc/doc/cpp/macros/function-like-macros.rst | 55 +
gcc/doc/cpp/macros/macro-arguments.rst | 112 +
gcc/doc/cpp/macros/macro-pitfalls.rst | 449 ++
gcc/doc/cpp/macros/object-like-macros.rst | 126 +
gcc/doc/cpp/macros/predefined-macros.rst | 876 ++++
gcc/doc/cpp/macros/stringizing.rst | 86 +
.../macros/undefining-and-redefining-macros.rst | 67 +
gcc/doc/cpp/macros/variadic-macros.rst | 141 +
gcc/doc/cpp/obsolete-features.rst | 98 +
gcc/doc/cpp/other-directives.rst | 30 +
gcc/doc/cpp/overview.rst | 67 +
gcc/doc/cpp/pragmas.rst | 121 +
gcc/doc/cpp/preprocessor-output.rst | 86 +
gcc/doc/cpp/the-preprocessing-language.rst | 69 +
gcc/doc/cpp/tokenization.rst | 168 +
gcc/doc/cpp/traditional-lexical-analysis.rst | 74 +
gcc/doc/cpp/traditional-macros.rst | 99 +
gcc/doc/cpp/traditional-miscellany.rst | 30 +
gcc/doc/cpp/traditional-mode.rst | 35 +
gcc/doc/cpp/traditional-warnings.rst | 49 +
gcc/doc/cppinternals/conf.py | 23 +
gcc/doc/cppinternals/copyright.rst | 19 +
gcc/doc/cppinternals/cppinternals.rst | 284 ++
gcc/doc/cppinternals/cpplib.rst | 29 +
gcc/doc/cppinternals/files.rst | 70 +
gcc/doc/cppinternals/index.rst | 21 +
gcc/doc/cppinternals/indices-and-tables.rst | 1 +
.../internal-representation-of-macros.rst | 27 +
.../cppinternals/just-which-line-number-anyway.rst | 62 +
gcc/doc/cppinternals/lexing-a-line.rst | 91 +
gcc/doc/cppinternals/lexing-a-token.rst | 177 +
...-a-function-like-macros-opening-parenthesis.rst | 24 +
gcc/doc/cppinternals/macro-expansion-overview.rst | 51 +
...king-tokens-ineligible-for-future-expansion.rst | 24 +
.../cppinternals/multiple-include-optimization.rst | 117 +
gcc/doc/cppinternals/overview.rst | 24 +
.../representation-of-line-numbers.rst | 32 +
...g-the-replacement-list-for-macros-to-expand.rst | 57 +
gcc/doc/gcc/binary-compatibility.rst | 151 +
.../gcc/c++-implementation-defined-behavior.rst | 33 +
gcc/doc/gcc/c-implementation-defined-behavior.rst | 46 +
.../architecture.rst | 47 +
.../arrays-and-pointers.rst | 46 +
.../characters.rst | 93 +
.../declarators.rst | 14 +
.../environment.rst | 18 +
.../floating-point.rst | 88 +
.../c-implementation-defined-behavior/hints.rst | 35 +
.../identifiers.rst | 28 +
.../c-implementation-defined-behavior/integers.rst | 66 +
.../library-functions.rst | 19 +
.../locale-specific-behavior.rst | 12 +
.../preprocessing-directives.rst | 54 +
.../qualifiers.rst | 53 +
.../statements.rst | 14 +
...ructures-unions-enumerations-and-bit-fields.rst | 78 +
.../translation.rst | 20 +
gcc/doc/gcc/conditionally-supported-behavior.rst | 20 +
gcc/doc/gcc/conf.py | 36 +
gcc/doc/gcc/contributing-to-gcc-development.rst | 6 +
gcc/doc/gcc/contributors-to-gcc.rst | 6 +
gcc/doc/gcc/copyright.rst | 25 +
gcc/doc/gcc/exception-handling.rst | 15 +
gcc/doc/gcc/extensions-to-the-c++-language.rst | 34 +
.../backwards-compatibility.rst | 27 +
.../c++-concepts.rst | 44 +
.../c++-interface-and-implementation-pragmas.rst | 97 +
...cific-variable-function-and-type-attributes.rst | 95 +
.../deprecated-features.rst | 43 +
...ter-from-a-bound-pointer-to-member-function.rst | 48 +
.../function-multiversioning.rst | 65 +
.../restricting-pointer-aliasing.rst | 52 +
.../extensions-to-the-c++-language/type-traits.rst | 159 +
.../vague-linkage.rst | 80 +
.../when-is-a-volatile-c++-object-accessed.rst | 58 +
.../wheres-the-template.rst | 131 +
.../gcc/extensions-to-the-c-language-family.rst | 92 +
.../128-bit-integers.rst | 18 +
.../additional-floating-types.rst | 83 +
.../alternate-keywords.rst | 46 +
.../an-inline-function-is-as-fast-as-a-macro.rst | 126 +
.../arithmetic-on-void-and-function-pointers.rst | 23 +
.../arrays-of-length-zero.rst | 111 +
.../arrays-of-variable-length.rst | 99 +
.../attribute-syntax.rst | 259 ++
.../binary-constants-using-the-0b-prefix.rst | 29 +
...ns-for-memory-model-aware-atomic-operations.rst | 290 ++
...o-perform-arithmetic-with-overflow-checking.rst | 102 +
.../c++-style-comments.rst | 18 +
.../case-ranges.rst | 43 +
.../cast-to-a-union-type.rst | 69 +
.../complex-numbers.rst | 122 +
.../compound-literals.rst | 104 +
.../conditionals-with-omitted-operands.rst | 39 +
.../constructing-function-calls.rst | 125 +
.../decimal-floating-types.rst | 47 +
.../declaring-attributes-of-functions.rst | 110 +
.../aarch64-function-attributes.rst | 192 +
.../amd-gcn-function-attributes.rst | 93 +
.../arc-function-attributes.rst | 88 +
.../arm-function-attributes.rst | 168 +
.../avr-function-attributes.rst | 120 +
.../blackfin-function-attributes.rst | 91 +
.../bpf-function-attributes.rst | 24 +
.../c-sky-function-attributes.rst | 37 +
.../common-function-attributes.rst | 1891 ++++++++
.../cr16-function-attributes.rst | 20 +
.../epiphany-function-attributes.rst | 82 +
.../h8-300-function-attributes.rst | 39 +
.../ia-64-function-attributes.rst | 36 +
.../m32c-function-attributes.rst | 75 +
.../m32r-d-function-attributes.rst | 42 +
.../m68k-function-attributes.rst | 30 +
.../mcore-function-attributes.rst | 24 +
.../mep-function-attributes.rst | 53 +
.../microblaze-function-attributes.rst | 46 +
.../microsoft-windows-function-attributes.rst | 104 +
.../mips-function-attributes.rst | 134 +
.../msp430-function-attributes.rst | 103 +
.../nds32-function-attributes.rst | 96 +
.../nios-ii-function-attributes.rst | 42 +
.../nvidia-ptx-function-attributes.rst | 22 +
.../powerpc-function-attributes.rst | 225 +
.../risc-v-function-attributes.rst | 43 +
.../rl78-function-attributes.rst | 37 +
.../rx-function-attributes.rst | 75 +
.../s-390-function-attributes.rst | 52 +
.../sh-function-attributes.rst | 101 +
.../symbian-os-function-attributes.rst | 12 +
.../v850-function-attributes.rst | 20 +
.../visium-function-attributes.rst | 22 +
.../x86-function-attributes.rst | 978 ++++
.../xstormy16-function-attributes.rst | 20 +
.../designated-initializers.rst | 147 +
...e-alignment-of-functions-types-or-variables.rst | 44 +
.../dollar-signs-in-identifier-names.rst | 16 +
.../double-word-integers.rst | 35 +
.../enumerator-attributes.rst | 53 +
.../fixed-point-types.rst | 128 +
...ecks-specific-to-particular-target-machines.rst | 47 +
.../function-names-as-strings.rst | 71 +
...g-the-return-or-frame-address-of-a-function.rst | 97 +
.../half-precision-floating-point.rst | 76 +
.../hex-floats.rst | 30 +
...w-to-use-inline-assembly-language-in-c-code.rst | 1979 ++++++++
.../incomplete-enum-types.rst | 23 +
.../label-attributes.rst | 65 +
.../labels-as-values.rst | 86 +
...built-in-functions-for-atomic-memory-access.rst | 171 +
.../locally-declared-labels.rst | 82 +
.../macros-with-a-variable-number-of-arguments.rst | 68 +
.../mixed-declarations-labels-and-code.rst | 27 +
.../named-address-spaces.rst | 240 +
.../nested-functions.rst | 132 +
.../non-constant-initializers.rst | 23 +
.../non-lvalue-arrays-may-have-subscripts.rst | 30 +
.../nonlocal-gotos.rst | 62 +
.../object-size-checking-built-in-functions.rst | 145 +
.../other-built-in-functions-provided-by-gcc.rst | 1229 +++++
.../pointer-arguments-in-variadic-functions.rst | 22 +
...-to-arrays-with-qualifiers-work-as-expected.rst | 27 +
.../pragmas-accepted-by-gcc.rst | 729 +++
...ototypes-and-old-style-function-definitions.rst | 63 +
.../referring-to-a-type-with-typeof.rst | 137 +
.../slightly-looser-rules-for-escaped-newlines.rst | 23 +
.../specifying-attributes-of-types.rst | 713 +++
.../specifying-attributes-of-variables.rst | 1142 +++++
.../statement-attributes.rst | 46 +
.../statements-and-declarations-in-expressions.rst | 164 +
.../structures-with-no-members.rst | 22 +
.../support-for-offsetof.rst | 34 +
.../target-builtins.rst | 53 +
.../target-builtins/aarch64-built-in-functions.rst | 24 +
.../target-builtins/alpha-built-in-functions.rst | 88 +
.../altera-nios-ii-built-in-functions.rst | 118 +
.../target-builtins/arc-built-in-functions.rst | 233 +
.../arc-simd-built-in-functions.rst | 245 +
.../arm-armv8-m-security-extensions.rst | 35 +
.../arm-c-language-extensions-acle.rst | 30 +
...loating-point-status-and-control-intrinsics.rst | 17 +
.../arm-iwmmxt-built-in-functions.rst | 159 +
.../target-builtins/avr-built-in-functions.rst | 114 +
.../basic-powerpc-built-in-functions.rst | 724 +++
.../blackfin-built-in-functions.rst | 20 +
.../target-builtins/bpf-built-in-functions.rst | 27 +
.../target-builtins/fr-v-built-in-functions.rst | 474 ++
.../mips-dsp-built-in-functions.rst | 312 ++
.../mips-loongson-built-in-functions.rst | 447 ++
.../target-builtins/mips-paired-single-support.rst | 45 +
.../mips-simd-architecture-msa-support.rst | 812 ++++
.../target-builtins/msp430-built-in-functions.rst | 36 +
.../target-builtins/nds32-built-in-functions.rst | 44 +
.../other-mips-built-in-functions.rst | 27 +
.../picochip-built-in-functions.rst | 45 +
.../powerpc-altivec-vsx-built-in-functions.rst | 2181 +++++++++
.../powerpc-atomic-memory-operation-functions.rst | 68 +
...are-transactional-memory-built-in-functions.rst | 226 +
...c-matrix-multiply-assist-built-in-functions.rst | 104 +
.../target-builtins/pru-built-in-functions.rst | 34 +
.../target-builtins/risc-v-built-in-functions.rst | 16 +
.../target-builtins/rx-built-in-functions.rst | 122 +
.../s-390-system-z-built-in-functions.rst | 121 +
.../target-builtins/sh-built-in-functions.rst | 50 +
.../sparc-vis-built-in-functions.rst | 226 +
.../target-builtins/ti-c6x-built-in-functions.rst | 43 +
.../target-builtins/x86-built-in-functions.rst | 1686 +++++++
.../x86-control-flow-protection-intrinsics.rst | 50 +
.../x86-transactional-memory-intrinsics.rst | 102 +
.../the-character-esc-in-constants.rst | 12 +
.../thread-local-storage.rst | 219 +
.../unnamed-structure-and-union-fields.rst | 86 +
...tor-instructions-through-built-in-functions.rst | 285 ++
.../when-is-a-volatile-object-accessed.rst | 86 +
...y-model-extensions-for-transactional-memory.rst | 38 +
gcc/doc/gcc/funding.rst | 6 +
gcc/doc/gcc/gcc-command-options.rst | 64 +
gcc/doc/gcc/gcc-command-options/c++-modules.rst | 352 ++
.../gcc-command-options/compiling-c++-programs.rst | 42 +
gcc/doc/gcc/gcc-command-options/description.rst | 73 +
.../environment-variables-affecting-gcc.rst | 163 +
.../gcc-command-options/gcc-developer-options.rst | 1147 +++++
.../machine-dependent-options.rst | 93 +
.../machine-dependent-options/aarch64-options.rst | 541 +++
.../adapteva-epiphany-options.rst | 163 +
.../machine-dependent-options/amd-gcn-options.rst | 58 +
.../machine-dependent-options/arc-options.rst | 763 +++
.../machine-dependent-options/arm-options.rst | 1026 +++++
.../machine-dependent-options/avr-options.rst | 634 +++
.../machine-dependent-options/blackfin-options.rst | 227 +
.../machine-dependent-options/c-sky-options.rst | 193 +
.../machine-dependent-options/c6x-options.rst | 55 +
.../machine-dependent-options/cr16-options.rst | 44 +
.../machine-dependent-options/cris-options.rst | 102 +
.../machine-dependent-options/darwin-options.rst | 224 +
.../dec-alpha-options.rst | 274 ++
.../machine-dependent-options/ebpf-options.rst | 94 +
.../machine-dependent-options/fr30-options.rst | 27 +
.../machine-dependent-options/frv-options.rst | 279 ++
.../machine-dependent-options/ft32-options.rst | 44 +
.../gnu-linux-options.rst | 56 +
.../machine-dependent-options/h8-300-options.rst | 64 +
.../machine-dependent-options/hppa-options.rst | 245 +
.../machine-dependent-options/ia-64-options.rst | 261 ++
.../ibm-rs-6000-and-powerpc-options.rst | 1010 ++++
.../machine-dependent-options/lm32-options.rst | 35 +
.../loongarch-options.rst | 191 +
.../machine-dependent-options/m32c-options.rst | 38 +
.../machine-dependent-options/m32r-d-options.rst | 137 +
.../machine-dependent-options/m680x0-options.rst | 407 ++
.../machine-dependent-options/mcore-options.rst | 66 +
.../machine-dependent-options/mep-options.rst | 167 +
.../microblaze-options.rst | 120 +
.../machine-dependent-options/mips-options.rst | 984 ++++
.../machine-dependent-options/mmix-options.rst | 75 +
.../machine-dependent-options/mn10300-options.rst | 93 +
.../machine-dependent-options/moxie-options.rst | 31 +
.../machine-dependent-options/msp430-options.rst | 189 +
.../machine-dependent-options/nds32-options.rst | 116 +
.../machine-dependent-options/nios-ii-options.rst | 363 ++
.../nvidia-ptx-options.rst | 96 +
.../machine-dependent-options/openrisc-options.rst | 95 +
.../options-for-system-v.rst | 43 +
.../machine-dependent-options/pdp-11-options.rst | 73 +
.../machine-dependent-options/picochip-options.rst | 55 +
.../machine-dependent-options/powerpc-options.rst | 15 +
.../machine-dependent-options/pru-options.rst | 63 +
.../machine-dependent-options/risc-v-options.rst | 212 +
.../machine-dependent-options/rl78-options.rst | 91 +
.../machine-dependent-options/rx-options.rst | 209 +
.../s-390-and-zseries-options.rst | 244 +
.../machine-dependent-options/score-options.rst | 51 +
.../machine-dependent-options/sh-options.rst | 444 ++
.../solaris-2-options.rst | 42 +
.../machine-dependent-options/sparc-options.rst | 388 ++
.../machine-dependent-options/v850-options.rst | 207 +
.../machine-dependent-options/vax-options.rst | 35 +
.../machine-dependent-options/visium-options.rst | 73 +
.../machine-dependent-options/vms-options.rst | 38 +
.../machine-dependent-options/vxworks-options.rst | 45 +
.../machine-dependent-options/x86-options.rst | 1578 +++++++
.../x86-windows-options.rst | 95 +
.../xstormy16-options.rst | 19 +
.../machine-dependent-options/xtensa-options.rst | 138 +
.../machine-dependent-options/zseries-options.rst | 15 +
gcc/doc/gcc/gcc-command-options/option-summary.rst | 1527 ++++++
.../options-controlling-c++-dialect.rst | 2057 +++++++++
.../options-controlling-c-dialect.rst | 515 +++
...ling-objective-c-and-objective-c++-dialects.rst | 316 ++
.../options-controlling-the-kind-of-output.rst | 736 +++
.../options-controlling-the-preprocessor.rst | 79 +
.../options-for-code-generation-conventions.rst | 711 +++
.../options-for-debugging-your-program.rst | 502 ++
.../options-for-directory-search.rst | 102 +
.../gcc-command-options/options-for-linking.rst | 407 ++
.../options-that-control-optimization.rst | 4849 ++++++++++++++++++++
.../options-that-control-static-analysis.rst | 923 ++++
...s-to-control-diagnostic-messages-formatting.rst | 900 ++++
.../options-to-request-or-suppress-warnings.rst | 4799 +++++++++++++++++++
.../passing-options-to-the-assembler.rst | 27 +
.../program-instrumentation-options.rst | 1108 +++++
...bprocesses-and-the-switches-to-pass-to-them.rst | 687 +++
.../using-precompiled-headers.rst | 132 +
gcc/doc/gcc/gcc.rst | 47 +
gcc/doc/gcc/gcov-dump.rst | 65 +
gcc/doc/gcc/gcov-tool.rst | 209 +
gcc/doc/gcc/gcov.rst | 53 +
.../gcov/brief-description-of-gcov-data-files.rst | 33 +
...-file-relocation-to-support-cross-profiling.rst | 43 +
gcc/doc/gcc/gcov/introduction-to-gcov.rst | 62 +
gcc/doc/gcc/gcov/invoking-gcov.rst | 656 +++
...-test-coverage-in-freestanding-environments.rst | 391 ++
.../gcc/gcov/using-gcov-with-gcc-optimization.rst | 86 +
gcc/doc/gcc/general-public-license-3.rst | 6 +
gcc/doc/gcc/gnu-free-documentation-license.rst | 6 +
gcc/doc/gcc/gnu-objective-c-features.rst | 27 +
.../compatibilityalias.rst | 26 +
.../constant-string-objects.rst | 64 +
.../gcc/gnu-objective-c-features/exceptions.rst | 79 +
.../gnu-objective-c-features/fast-enumeration.rst | 221 +
.../garbage-collection.rst | 81 +
.../gnu-objective-c-runtime-api.rst | 98 +
.../load-executing-code-before-main.rst | 141 +
.../messaging-with-the-gnu-objective-c-runtime.rst | 145 +
.../gnu-objective-c-features/synchronization.rst | 36 +
.../gcc/gnu-objective-c-features/type-encoding.rst | 280 ++
gcc/doc/gcc/gnu.rst | 1 +
gcc/doc/gcc/have-you-found-a-bug.rst | 62 +
gcc/doc/gcc/how-and-where-to-report-bugs.rst | 13 +
gcc/doc/gcc/how-to-get-help-with-gcc.rst | 26 +
gcc/doc/gcc/index.rst | 40 +
gcc/doc/gcc/indices-and-tables.rst | 1 +
gcc/doc/gcc/known-causes-of-trouble-with-gcc.rst | 32 +
.../actual-bugs-we-havent-fixed-yet.rst | 14 +
.../certain-changes-we-dont-want-to-make.rst | 236 +
.../common-misunderstandings-with-gnu-c.rst | 296 ++
.../disappointments-and-misunderstandings.rst | 102 +
.../fixed-header-files.rst | 39 +
.../incompatibilities-of-gcc.rst | 233 +
.../interoperation.rst | 153 +
.../standard-libraries.rst | 33 +
.../warning-messages-and-error-messages.rst | 46 +
.../gcc/language-standards-supported-by-gcc.rst | 23 +
.../c++-language.rst | 71 +
.../c-language.rst | 139 +
.../d-language.rst | 11 +
.../go-language.rst | 10 +
.../objective-c-and-objective-c++-languages.rst | 62 +
.../references-for-other-languages.rst | 13 +
gcc/doc/gcc/lto-dump.rst | 117 +
.../gcc/programming-languages-supported-by-gcc.rst | 54 +
gcc/doc/gcc/reporting-bugs.rst | 23 +
.../analysis-and-optimization-of-gimple-tuples.rst | 44 +
.../alias-analysis.rst | 104 +
.../annotations.rst | 17 +
.../memory-model.rst | 34 +
.../ssa-operands.rst | 388 ++
.../static-single-assignment.rst | 259 ++
.../analysis-and-representation-of-loops.rst | 27 +
.../data-dependency-analysis.rst | 135 +
.../iv-analysis-on-rtl.rst | 55 +
.../loop-closed-ssa-form.rst | 47 +
.../loop-manipulation.rst | 58 +
.../loop-querying.rst | 81 +
.../loop-representation.rst | 137 +
.../number-of-iterations-analysis.rst | 85 +
.../scalar-evolutions.rst | 71 +
gcc/doc/gccint/analyzer-internals.rst | 420 ++
gcc/doc/gccint/collect2.rst | 77 +
gcc/doc/gccint/conf.py | 23 +
gcc/doc/gccint/contributing-to-gcc-development.rst | 6 +
gcc/doc/gccint/contributors-to-gcc.rst | 6 +
gcc/doc/gccint/control-flow-graph.rst | 43 +
gcc/doc/gccint/control-flow-graph/basic-blocks.rst | 141 +
gcc/doc/gccint/control-flow-graph/edges.rst | 241 +
.../control-flow-graph/liveness-information.rst | 48 +
.../control-flow-graph/maintaining-the-cfg.rst | 145 +
.../control-flow-graph/profile-information.rst | 112 +
gcc/doc/gccint/copyright.rst | 25 +
gcc/doc/gccint/debugging-the-analyzer.rst | 135 +
gcc/doc/gccint/funding.rst | 6 +
gcc/doc/gccint/gcc-and-portability.rst | 41 +
gcc/doc/gccint/general-public-license-3.rst | 6 +
gcc/doc/gccint/generic.rst | 47 +
gcc/doc/gccint/generic/attributes-in-trees.rst | 35 +
gcc/doc/gccint/generic/c-and-c++-trees.rst | 886 ++++
gcc/doc/gccint/generic/declarations.rst | 346 ++
gcc/doc/gccint/generic/deficiencies.rst | 14 +
gcc/doc/gccint/generic/expressions.rst | 910 ++++
gcc/doc/gccint/generic/functions.rst | 212 +
.../gccint/generic/language-dependent-trees.rst | 25 +
gcc/doc/gccint/generic/overview.rst | 213 +
gcc/doc/gccint/generic/statements.rst | 516 +++
gcc/doc/gccint/generic/types.rst | 299 ++
gcc/doc/gccint/gimple-api.rst | 47 +
gcc/doc/gccint/gimple.rst | 88 +
.../gimple/adding-a-new-gimple-statement-code.rst | 36 +
.../class-hierarchy-of-gimple-statements.rst | 150 +
gcc/doc/gccint/gimple/exception-handling.rst | 46 +
gcc/doc/gccint/gimple/gimple-instruction-set.rst | 106 +
gcc/doc/gccint/gimple/gimple-sequences.rst | 94 +
.../gimple/manipulating-gimple-statements.rst | 176 +
gcc/doc/gccint/gimple/operands.rst | 319 ++
gcc/doc/gccint/gimple/sequence-iterators.rst | 223 +
.../gimple/statement-and-operand-traversals.rst | 62 +
gcc/doc/gccint/gimple/temporaries.rst | 43 +
gcc/doc/gccint/gimple/tuple-representation.rst | 242 +
gcc/doc/gccint/gimple/tuple-specific-accessors.rst | 44 +
.../gimple/tuple-specific-accessors/gimpleasm.rst | 66 +
.../tuple-specific-accessors/gimpleassign.rst | 126 +
.../gimple/tuple-specific-accessors/gimplebind.rst | 56 +
.../gimple/tuple-specific-accessors/gimplecall.rst | 116 +
.../tuple-specific-accessors/gimplecatch.rst | 37 +
.../gimple/tuple-specific-accessors/gimplecond.rst | 80 +
.../tuple-specific-accessors/gimpledebug.rst | 106 +
.../tuple-specific-accessors/gimpleehfilter.rst | 45 +
.../gimple/tuple-specific-accessors/gimplegoto.rst | 21 +
.../tuple-specific-accessors/gimplelabel.rst | 23 +
.../gimple/tuple-specific-accessors/gimplenop.rst | 17 +
.../gimpleompatomicload.rst | 31 +
.../gimpleompatomicstore.rst | 22 +
.../tuple-specific-accessors/gimpleompcontinue.rst | 43 +
.../tuple-specific-accessors/gimpleompcritical.rst | 28 +
.../tuple-specific-accessors/gimpleompfor.rst | 97 +
.../tuple-specific-accessors/gimpleompmaster.rst | 14 +
.../tuple-specific-accessors/gimpleompordered.rst | 16 +
.../tuple-specific-accessors/gimpleompparallel.rst | 76 +
.../tuple-specific-accessors/gimpleompreturn.rst | 23 +
.../tuple-specific-accessors/gimpleompsection.rst | 24 +
.../tuple-specific-accessors/gimpleompsections.rst | 48 +
.../tuple-specific-accessors/gimpleompsingle.rst | 28 +
.../gimple/tuple-specific-accessors/gimplephi.rst | 41 +
.../gimple/tuple-specific-accessors/gimpleresx.rst | 24 +
.../tuple-specific-accessors/gimplereturn.rst | 21 +
.../tuple-specific-accessors/gimpleswitch.rst | 52 +
.../gimple/tuple-specific-accessors/gimpletry.rst | 51 +
.../gimplewithcleanupexpr.rst | 30 +
gcc/doc/gccint/gnu-free-documentation-license.rst | 6 +
gcc/doc/gccint/guidelines-for-diagnostics.rst | 598 +++
gcc/doc/gccint/guidelines-for-options.rst | 13 +
gcc/doc/gccint/host-common.rst | 57 +
gcc/doc/gccint/host-configuration.rst | 32 +
gcc/doc/gccint/host-filesystem.rst | 103 +
gcc/doc/gccint/host-makefile-fragments.rst | 14 +
gcc/doc/gccint/host-misc.rst | 70 +
gcc/doc/gccint/index.rst | 51 +
gcc/doc/gccint/indices-and-tables.rst | 1 +
gcc/doc/gccint/interfacing-to-gcc-output.rst | 71 +
gcc/doc/gccint/introduction.rst | 26 +
gcc/doc/gccint/language-front-ends-in-gcc.rst | 39 +
gcc/doc/gccint/link-time-optimization.rst | 33 +
.../link-time-optimization/design-overview.rst | 123 +
.../internal-flags-controlling-lto1.rst | 42 +
.../link-time-optimization/lto-file-sections.rst | 110 +
.../using-summary-information-in-ipa-passes.rst | 206 +
...tions-linker-plugin-and-symbol-visibilities.rst | 91 +
gcc/doc/gccint/machine-descriptions.rst | 49 +
.../c-statements-for-assembler-output.rst | 122 +
.../canonicalization-of-instructions.rst | 152 +
.../machine-descriptions/conditional-execution.rst | 98 +
.../machine-descriptions/constant-definitions.rst | 185 +
.../defining-how-to-split-instructions.rst | 374 ++
.../defining-jump-instruction-patterns.rst | 37 +
.../defining-looping-instruction-patterns.rst | 134 +
.../defining-rtl-sequences-for-code-generation.rst | 206 +
.../everything-about-instruction-patterns.rst | 106 +
.../machine-descriptions/example-of-defineinsn.rst | 54 +
.../including-patterns-in-machine-descriptions.rst | 70 +
.../instruction-attributes.rst | 1248 +++++
.../interdependence-of-patterns.rst | 43 +
gcc/doc/gccint/machine-descriptions/iterators.rst | 543 +++
.../machine-specific-peephole-optimizers.rst | 330 ++
.../machine-descriptions/operand-constraints.rst | 426 ++
.../output-templates-and-operand-substitution.rst | 99 +
...view-of-how-the-machine-description-is-used.rst | 47 +
gcc/doc/gccint/machine-descriptions/predicates.rst | 343 ++
.../gccint/machine-descriptions/rtl-template.rst | 255 +
.../rtl-templates-transformations.rst | 225 +
.../standard-pattern-names-for-generation.rst | 3399 ++++++++++++++
.../when-the-order-of-patterns-matters.rst | 29 +
gcc/doc/gccint/makefile-fragments.rst | 37 +
gcc/doc/gccint/match-and-simplify.rst | 34 +
.../memory-management-and-type-information.rst | 103 +
.../how-to-invoke-the-garbage-collector.rst | 36 +
.../marking-roots-for-the-garbage-collector.rst | 28 +
.../source-files-containing-type-information.rst | 60 +
.../support-for-inheritance.rst | 59 +
...pport-for-user-provided-gc-marking-routines.rst | 121 +
.../the-inside-of-a-gty.rst | 305 ++
.../troubleshooting-the-garbage-collector.rst | 27 +
gcc/doc/gccint/option-file-format.rst | 175 +
gcc/doc/gccint/option-properties.rst | 376 ++
gcc/doc/gccint/option-specification-files.rst | 21 +
.../gccint/passes-and-files-of-the-compiler.rst | 27 +
.../gimplification-pass.rst | 44 +
.../inter-procedural-optimization-passes.rst | 269 ++
.../optimization-info.rst | 262 ++
.../parsing-pass.rst | 80 +
.../pass-manager.rst | 42 +
.../rtl-passes.rst | 275 ++
.../tree-ssa-passes.rst | 477 ++
gcc/doc/gccint/plugins.rst | 35 +
gcc/doc/gccint/plugins/building-gcc-plugins.rst | 97 +
.../controlling-which-passes-are-being-run.rst | 16 +
.../plugins/giving-information-about-a-plugin.rst | 24 +
.../interacting-with-the-gcc-garbage-collector.rst | 37 +
.../plugins/interacting-with-the-pass-manager.rst | 57 +
.../plugins/keeping-track-of-available-passes.rst | 17 +
gcc/doc/gccint/plugins/loading-plugins.rst | 31 +
gcc/doc/gccint/plugins/plugin-api.rst | 213 +
.../recording-information-about-pass-execution.rst | 20 +
.../registering-custom-attributes-or-pragmas.rst | 73 +
gcc/doc/gccint/rtl-representation.rst | 48 +
.../rtl-representation/access-to-operands.rst | 73 +
.../access-to-special-operands.rst | 188 +
.../assembler-instructions-as-expressions.rst | 45 +
gcc/doc/gccint/rtl-representation/bit-fields.rst | 48 +
.../rtl-representation/comparison-operations.rst | 112 +
.../constant-expression-types.rst | 313 ++
gcc/doc/gccint/rtl-representation/conversions.rst | 152 +
gcc/doc/gccint/rtl-representation/declarations.rst | 27 +
.../embedded-side-effects-on-addresses.rst | 100 +
.../flags-in-an-rtl-expression.rst | 447 ++
gcc/doc/gccint/rtl-representation/insns.rst | 624 +++
.../gccint/rtl-representation/machine-modes.rst | 635 +++
.../on-the-side-ssa-form-for-rtl.rst | 748 +++
gcc/doc/gccint/rtl-representation/reading-rtl.rst | 28 +
.../rtl-representation/registers-and-memory.rst | 451 ++
.../rtl-representation/rtl-classes-and-formats.rst | 192 +
.../rtl-expressions-for-arithmetic.rst | 310 ++
.../gccint/rtl-representation/rtl-object-types.rst | 84 +
.../rtl-representation-of-function-call-insns.rst | 72 +
.../rtl-representation/side-effect-expressions.rst | 374 ++
.../structure-sharing-assumptions.rst | 99 +
.../variable-location-debug-information-in-rtl.rst | 64 +
.../rtl-representation/vector-operations.rst | 60 +
.../sizes-and-offsets-as-runtime-invariants.rst | 51 +
.../alignment-of-polyints.rst | 84 +
.../arithmetic-on-polyints.rst | 178 +
.../comparisons-involving-polyint.rst | 324 ++
.../computing-bounds-on-polyints.rst | 34 +
.../consequences-of-using-polyint.rst | 55 +
.../converting-polyints.rst | 91 +
.../guidelines-for-using-polyint.rst | 119 +
.../miscellaneous-polyint-routines.rst | 16 +
.../overview-of-polyint.rst | 78 +
.../source-tree-structure-and-build-system.rst | 21 +
.../configure-terms-and-history.rst | 64 +
.../the-gcc-subdirectory.rst | 28 +
.../anatomy-of-a-language-front-end.rst | 277 ++
.../anatomy-of-a-target-back-end.rst | 114 +
.../build-system-in-the-gcc-directory.rst | 14 +
.../building-documentation.rst | 178 +
.../configuration-in-the-gcc-directory.rst | 127 +
.../headers-installed-by-gcc.rst | 49 +
...e-files-and-headers-under-the-gcc-directory.rst | 15 +
.../the-gcc-subdirectory/makefile-targets.rst | 185 +
.../the-gcc-subdirectory/subdirectories-of-gcc.rst | 55 +
.../top-level-source-directory.rst | 138 +
.../gccint/standard-header-file-directories.rst | 35 +
gcc/doc/gccint/static-analyzer.rst | 19 +
gcc/doc/gccint/target-macros.rst | 60 +
.../adding-support-for-named-address-spaces.rst | 163 +
gcc/doc/gccint/target-macros/addressing-modes.rst | 821 ++++
.../adjusting-the-instruction-scheduler.rst | 660 +++
.../gccint/target-macros/anchored-addresses.rst | 92 +
.../gccint/target-macros/c++-abi-parameters.rst | 164 +
.../gccint/target-macros/condition-code-status.rst | 210 +
.../controlling-debugging-information-format.rst | 517 +++
.../controlling-the-compilation-driver-gcc.rst | 482 ++
.../cross-compilation-and-floating-point.rst | 73 +
gcc/doc/gccint/target-macros/d-abi-parameters.rst | 107 +
...ning-coprocessor-specifics-for-mips-targets.rst | 35 +
...ata-structures-for-per-function-information.rst | 62 +
.../defining-target-specific-uses-of-attribute.rst | 319 ++
.../defining-the-output-assembler-language.rst | 27 +
.../assembler-commands-for-alignment.rst | 95 +
.../assembler-commands-for-exception-regions.rst | 188 +
.../how-initialization-functions-are-handled.rst | 122 +
.../macros-controlling-initialization-routines.rst | 182 +
.../output-and-generation-of-labels.rst | 586 +++
.../output-of-assembler-instructions.rst | 252 +
.../output-of-data.rst | 191 +
.../output-of-dispatch-tables.rst | 171 +
.../output-of-uninitialized-variables.rst | 105 +
.../the-overall-framework-of-an-assembler-file.rst | 287 ++
.../describing-relative-costs-of-operations.rst | 528 +++
...ividing-the-output-into-sections-texts-data.rst | 445 ++
gcc/doc/gccint/target-macros/emulating-tls.rst | 125 +
.../implementing-the-varargs-macros.rst | 190 +
.../implicit-calls-to-library-routines.rst | 141 +
.../layout-of-source-language-data-types.rst | 355 ++
.../target-macros/miscellaneous-parameters.rst | 1717 +++++++
.../target-macros/mode-switching-instructions.rst | 121 +
...rs-for-precompiled-header-validity-checking.rst | 63 +
.../target-macros/position-independent-code.rst | 53 +
gcc/doc/gccint/target-macros/register-classes.rst | 801 ++++
gcc/doc/gccint/target-macros/register-usage.rst | 563 +++
.../run-time-target-specification.rst | 253 +
.../stack-layout-and-calling-conventions.rst | 35 +
.../basic-stack-layout.rst | 298 ++
.../caller-saves-register-allocation.rst | 21 +
.../eliminating-frame-pointer-and-arg-pointer.rst | 102 +
.../exception-handling-support.rst | 137 +
.../function-entry-and-exit.rst | 265 ++
.../generating-code-for-profiling.rst | 61 +
.../how-large-values-are-returned.rst | 132 +
.../how-scalar-function-values-are-returned.rst | 166 +
.../miscellaneous-register-hooks.rst | 26 +
.../passing-arguments-in-registers.rst | 633 +++
.../passing-function-arguments-on-the-stack.rst | 193 +
.../permitting-tail-calls.rst | 60 +
.../registers-that-address-the-stack-frame.rst | 198 +
.../shrink-wrapping-separate-components.rst | 93 +
.../specifying-how-stack-checking-is-done.rst | 118 +
.../stack-smashing-protection.rst | 75 +
gcc/doc/gccint/target-macros/storage-layout.rst | 729 +++
.../target-macros/support-for-nested-functions.rst | 222 +
.../target-macros/the-global-targetm-variable.rst | 65 +
gcc/doc/gccint/target-makefile-fragments.rst | 245 +
gcc/doc/gccint/testsuites.rst | 29 +
.../gccint/testsuites/ada-language-testsuites.rst | 38 +
.../gccint/testsuites/c-language-testsuites.rst | 112 +
.../directives-used-within-dejagnu-tests.rst | 19 +
.../commands-for-use-in-dg-final.rst | 291 ++
.../features-for-dg-add-options.rst | 122 +
.../keywords-describing-target-attributes.rst | 1501 ++++++
.../selecting-targets-to-which-a-test-applies.rst | 106 +
.../syntax-and-descriptions-of-test-directives.rst | 311 ++
.../variants-of-dg-require-support.rst | 83 +
.../testsuites/idioms-used-in-testsuite-code.rst | 84 +
.../support-for-testing-binary-compatibility.rst | 109 +
.../gccint/testsuites/support-for-testing-gcov.rst | 72 +
.../support-for-testing-gimple-passes.rst | 55 +
...support-for-testing-link-time-optimizations.rst | 46 +
...-for-testing-profile-directed-optimizations.rst | 51 +
.../testsuites/support-for-testing-rtl-passes.rst | 48 +
...-for-torture-testing-using-multiple-options.rst | 52 +
.../gccint/the-gcc-low-level-runtime-library.rst | 50 +
...independent-routines-for-exception-handling.rst | 42 +
.../miscellaneous-runtime-library-routines.rst | 59 +
...utines-for-decimal-floating-point-emulation.rst | 312 ++
...utines-for-fixed-point-fractional-emulation.rst | 1432 ++++++
.../routines-for-floating-point-emulation.rst | 283 ++
.../routines-for-integer-arithmetic.rst | 183 +
gcc/doc/gccint/the-language.rst | 384 ++
gcc/doc/gccint/user-experience-guidelines.rst | 30 +
gcc/doc/install/binaries.rst | 57 +
gcc/doc/install/building.rst | 67 +
.../install/building/building-a-cross-compiler.rst | 74 +
.../building/building-a-native-compiler.rst | 191 +
gcc/doc/install/building/building-in-parallel.rst | 15 +
.../install/building/building-the-ada-compiler.rst | 9 +
.../install/building/building-the-d-compiler.rst | 9 +
.../building/building-with-profile-feedback.rst | 34 +
gcc/doc/install/conf.py | 23 +
gcc/doc/install/configuration.rst | 2078 +++++++++
gcc/doc/install/copyright.rst | 24 +
gcc/doc/install/downloading-gcc.rst | 42 +
gcc/doc/install/final-installation.rst | 128 +
gcc/doc/install/gnu-free-documentation-license.rst | 6 +
...-target-specific-installation-notes-for-gcc.rst | 1343 ++++++
...can-you-run-the-testsuite-on-selected-tests.rst | 46 +
gcc/doc/install/how-to-interpret-test-results.rst | 32 +
gcc/doc/install/index.rst | 27 +
gcc/doc/install/indices-and-tables.rst | 1 +
gcc/doc/install/installing-gcc.rst | 39 +
...ing-options-and-running-multiple-testsuites.rst | 74 +
gcc/doc/install/prerequisites.rst | 319 ++
gcc/doc/install/submitting-test-results.rst | 22 +
gcc/doc/install/testing.rst | 69 +
.../code-that-interacts-with-the-user.rst | 15 +
.../doc/gfc-internals/command-line-options.rst | 30 +
gcc/fortran/doc/gfc-internals/conf.py | 26 +
gcc/fortran/doc/gfc-internals/copyright.rst | 25 +
gcc/fortran/doc/gfc-internals/error-handling.rst | 75 +
.../doc/gfc-internals/frontend-data-structures.rst | 23 +
...-the-intermediate-language-for-later-stages.rst | 24 +
.../accessing-declarations.rst | 16 +
.../basic-data-structures.rst | 67 +
.../converting-expressions-to-tree.rst | 48 +
.../translating-statements.rst | 14 +
gcc/fortran/doc/gfc-internals/gfccode.rst | 146 +
gcc/fortran/doc/gfc-internals/gfcexpr.rst | 156 +
.../gnu-free-documentation-license.rst | 6 +
gcc/fortran/doc/gfc-internals/index.rst | 24 +
.../doc/gfc-internals/indices-and-tables.rst | 1 +
.../internals-of-fortran-2003-oop-features.rst | 15 +
gcc/fortran/doc/gfc-internals/introduction.rst | 32 +
.../doc/gfc-internals/symbol-versioning.rst | 63 +
.../the-libgfortran-runtime-library.rst | 14 +
.../doc/gfc-internals/type-bound-operators.rst | 33 +
.../doc/gfc-internals/type-bound-procedures.rst | 101 +
gcc/fortran/doc/gfortran/about-gnu-fortran.rst | 115 +
gcc/fortran/doc/gfortran/coarray-programming.rst | 17 +
.../doc/gfortran/compiler-characteristics.rst | 27 +
.../compiler-characteristics/asynchronous-i-o.rst | 21 +
.../data-consistency-and-durability.rst | 80 +
.../evaluation-of-logical-expressions.rst | 18 +
...file-format-of-unformatted-sequential-files.rst | 63 +
.../file-operations-on-symbolic-links.rst | 28 +
...pened-without-an-explicit-action=-specifier.rst | 23 +
...nternal-representation-of-logical-variables.rst | 24 +
.../kind-type-parameters.rst | 54 +
...-and-min-intrinsics-with-real-nan-arguments.rst | 21 +
.../thread-safety-of-the-runtime-library.rst | 53 +
gcc/fortran/doc/gfortran/conf.py | 32 +
gcc/fortran/doc/gfortran/contributing.rst | 28 +
.../doc/gfortran/contributors-to-gnu-fortran.rst | 109 +
gcc/fortran/doc/gfortran/copyright.rst | 25 +
.../extensions-implemented-in-gnu-fortran.rst | 1535 +++++++
.../extensions-not-implemented-in-gnu-fortran.rst | 186 +
gcc/fortran/doc/gfortran/extensions.rst | 24 +
.../doc/gfortran/function-abi-documentation.rst | 1526 ++++++
gcc/fortran/doc/gfortran/funding.rst | 6 +
.../doc/gfortran/general-public-license-3.rst | 6 +
gcc/fortran/doc/gfortran/gnu-fortran-and-gcc.rst | 48 +
.../doc/gfortran/gnu-fortran-command-options.rst | 33 +
.../gnu-fortran-command-options/description.rst | 39 +
.../enable-and-customize-preprocessing.rst | 298 ++
.../environment-variables-affecting-gfortran.rst | 24 +
.../influencing-runtime-behavior.rst | 67 +
.../influencing-the-linking-step.rst | 24 +
.../gnu-fortran-command-options/option-summary.rst | 104 +
.../options-controlling-fortran-dialect.rst | 411 ++
.../options-for-code-generation-conventions.rst | 583 +++
...s-for-debugging-your-program-or-gnu-fortran.rst | 134 +
.../options-for-directory-search.rst | 54 +
...s-for-interoperability-with-other-languages.rst | 63 +
...-to-request-or-suppress-errors-and-warnings.rst | 407 ++
.../gfortran/gnu-fortran-compiler-directives.rst | 174 +
.../gfortran/gnu-free-documentation-license.rst | 6 +
gcc/fortran/doc/gfortran/index.rst | 56 +
gcc/fortran/doc/gfortran/indices-and-tables.rst | 1 +
.../doc/gfortran/interoperability-with-c.rst | 413 ++
gcc/fortran/doc/gfortran/intrinsic-modules.rst | 20 +
...eexceptions-ieeearithmetic-and-ieeefeatures.rst | 29 +
.../doc/gfortran/intrinsic-modules/isocbinding.rst | 230 +
.../gfortran/intrinsic-modules/isofortranenv.rst | 116 +
.../intrinsic-modules/openacc-module-openacc.rst | 27 +
.../openmp-modules-omplib-and-omplibkinds.rst | 161 +
gcc/fortran/doc/gfortran/intrinsic-procedures.rst | 299 ++
.../doc/gfortran/intrinsic-procedures/abort.rst | 44 +
.../doc/gfortran/intrinsic-procedures/abs.rst | 117 +
.../doc/gfortran/intrinsic-procedures/access.rst | 61 +
.../doc/gfortran/intrinsic-procedures/achar.rst | 56 +
.../doc/gfortran/intrinsic-procedures/acos.rst | 73 +
.../doc/gfortran/intrinsic-procedures/acosd.rst | 74 +
.../doc/gfortran/intrinsic-procedures/acosh.rst | 70 +
.../doc/gfortran/intrinsic-procedures/adjustl.rst | 48 +
.../doc/gfortran/intrinsic-procedures/adjustr.rst | 48 +
.../doc/gfortran/intrinsic-procedures/aimag.rst | 81 +
.../doc/gfortran/intrinsic-procedures/aint.rst | 78 +
.../doc/gfortran/intrinsic-procedures/alarm.rst | 59 +
.../doc/gfortran/intrinsic-procedures/all.rst | 61 +
.../gfortran/intrinsic-procedures/allocated.rst | 49 +
.../doc/gfortran/intrinsic-procedures/and.rst | 60 +
.../doc/gfortran/intrinsic-procedures/anint.rst | 76 +
.../doc/gfortran/intrinsic-procedures/any.rst | 61 +
.../doc/gfortran/intrinsic-procedures/asin.rst | 73 +
.../doc/gfortran/intrinsic-procedures/asind.rst | 74 +
.../doc/gfortran/intrinsic-procedures/asinh.rst | 70 +
.../gfortran/intrinsic-procedures/associated.rst | 74 +
.../doc/gfortran/intrinsic-procedures/atan.rst | 80 +
.../doc/gfortran/intrinsic-procedures/atan2.rst | 85 +
.../doc/gfortran/intrinsic-procedures/atan2d.rst | 85 +
.../doc/gfortran/intrinsic-procedures/atand.rst | 80 +
.../doc/gfortran/intrinsic-procedures/atanh.rst | 70 +
.../gfortran/intrinsic-procedures/atomicadd.rst | 60 +
.../gfortran/intrinsic-procedures/atomicand.rst | 60 +
.../gfortran/intrinsic-procedures/atomiccas.rst | 67 +
.../gfortran/intrinsic-procedures/atomicdefine.rst | 62 +
.../intrinsic-procedures/atomicfetchadd.rst | 65 +
.../intrinsic-procedures/atomicfetchand.rst | 64 +
.../intrinsic-procedures/atomicfetchor.rst | 64 +
.../intrinsic-procedures/atomicfetchxor.rst | 64 +
.../doc/gfortran/intrinsic-procedures/atomicor.rst | 60 +
.../gfortran/intrinsic-procedures/atomicref.rst | 68 +
.../gfortran/intrinsic-procedures/atomicxor.rst | 60 +
.../gfortran/intrinsic-procedures/backtrace.rst | 34 +
.../doc/gfortran/intrinsic-procedures/besselj0.rst | 64 +
.../doc/gfortran/intrinsic-procedures/besselj1.rst | 64 +
.../doc/gfortran/intrinsic-procedures/besseljn.rst | 85 +
.../doc/gfortran/intrinsic-procedures/bessely0.rst | 62 +
.../doc/gfortran/intrinsic-procedures/bessely1.rst | 62 +
.../doc/gfortran/intrinsic-procedures/besselyn.rst | 85 +
.../doc/gfortran/intrinsic-procedures/bge.rst | 42 +
.../doc/gfortran/intrinsic-procedures/bgt.rst | 41 +
.../doc/gfortran/intrinsic-procedures/bitsize.rst | 44 +
.../doc/gfortran/intrinsic-procedures/ble.rst | 42 +
.../doc/gfortran/intrinsic-procedures/blt.rst | 41 +
.../doc/gfortran/intrinsic-procedures/btest.rst | 89 +
.../gfortran/intrinsic-procedures/cassociated.rst | 54 +
.../doc/gfortran/intrinsic-procedures/ceiling.rst | 51 +
.../gfortran/intrinsic-procedures/cfpointer.rst | 63 +
.../intrinsic-procedures/cfprocpointer.rst | 64 +
.../doc/gfortran/intrinsic-procedures/cfunloc.rst | 64 +
.../doc/gfortran/intrinsic-procedures/char.rst | 71 +
.../doc/gfortran/intrinsic-procedures/chdir.rst | 51 +
.../doc/gfortran/intrinsic-procedures/chmod.rst | 70 +
.../doc/gfortran/intrinsic-procedures/cloc.rst | 51 +
.../doc/gfortran/intrinsic-procedures/cmplx.rst | 61 +
.../gfortran/intrinsic-procedures/cobroadcast.rst | 65 +
.../doc/gfortran/intrinsic-procedures/comax.rst | 66 +
.../doc/gfortran/intrinsic-procedures/comin.rst | 66 +
.../intrinsic-procedures/commandargumentcount.rst | 43 +
.../intrinsic-procedures/compileroptions.rst | 48 +
.../intrinsic-procedures/compilerversion.rst | 47 +
.../doc/gfortran/intrinsic-procedures/complex.rst | 50 +
.../doc/gfortran/intrinsic-procedures/conjg.rst | 63 +
.../doc/gfortran/intrinsic-procedures/coreduce.rst | 94 +
.../doc/gfortran/intrinsic-procedures/cos.rst | 91 +
.../doc/gfortran/intrinsic-procedures/cosd.rst | 91 +
.../doc/gfortran/intrinsic-procedures/cosh.rst | 73 +
.../doc/gfortran/intrinsic-procedures/cosum.rst | 67 +
.../doc/gfortran/intrinsic-procedures/cotan.rst | 71 +
.../doc/gfortran/intrinsic-procedures/cotand.rst | 74 +
.../doc/gfortran/intrinsic-procedures/count.rst | 72 +
.../doc/gfortran/intrinsic-procedures/cputime.rst | 49 +
.../doc/gfortran/intrinsic-procedures/cshift.rst | 61 +
.../doc/gfortran/intrinsic-procedures/csizeof.rst | 55 +
.../doc/gfortran/intrinsic-procedures/ctime.rst | 62 +
.../gfortran/intrinsic-procedures/dateandtime.rst | 70 +
.../doc/gfortran/intrinsic-procedures/dble.rst | 46 +
.../doc/gfortran/intrinsic-procedures/dcmplx.rst | 54 +
.../doc/gfortran/intrinsic-procedures/digits.rst | 46 +
.../doc/gfortran/intrinsic-procedures/dim.rst | 78 +
.../gfortran/intrinsic-procedures/dotproduct.rst | 57 +
.../doc/gfortran/intrinsic-procedures/dprod.rst | 62 +
.../doc/gfortran/intrinsic-procedures/dreal.rst | 43 +
.../doc/gfortran/intrinsic-procedures/dshiftl.rst | 52 +
.../doc/gfortran/intrinsic-procedures/dshiftr.rst | 52 +
.../doc/gfortran/intrinsic-procedures/dtime.rst | 64 +
.../doc/gfortran/intrinsic-procedures/eoshift.rst | 67 +
.../doc/gfortran/intrinsic-procedures/epsilon.rst | 43 +
.../doc/gfortran/intrinsic-procedures/erf.rst | 57 +
.../doc/gfortran/intrinsic-procedures/erfc.rst | 57 +
.../gfortran/intrinsic-procedures/erfcscaled.rst | 41 +
.../doc/gfortran/intrinsic-procedures/etime.rst | 62 +
.../gfortran/intrinsic-procedures/eventquery.rst | 57 +
.../intrinsic-procedures/executecommandline.rst | 70 +
.../doc/gfortran/intrinsic-procedures/exit.rst | 47 +
.../doc/gfortran/intrinsic-procedures/exp.rst | 83 +
.../doc/gfortran/intrinsic-procedures/exponent.rst | 44 +
.../intrinsic-procedures/extendstypeof.rst | 41 +
.../doc/gfortran/intrinsic-procedures/fdate.rst | 57 +
.../doc/gfortran/intrinsic-procedures/fget.rst | 60 +
.../doc/gfortran/intrinsic-procedures/fgetc.rst | 62 +
.../doc/gfortran/intrinsic-procedures/findloc.rst | 78 +
.../doc/gfortran/intrinsic-procedures/floor.rst | 51 +
.../doc/gfortran/intrinsic-procedures/flush.rst | 72 +
.../doc/gfortran/intrinsic-procedures/fnum.rst | 44 +
.../doc/gfortran/intrinsic-procedures/fput.rst | 54 +
.../doc/gfortran/intrinsic-procedures/fputc.rst | 60 +
.../doc/gfortran/intrinsic-procedures/fraction.rst | 44 +
.../doc/gfortran/intrinsic-procedures/free.rst | 43 +
.../doc/gfortran/intrinsic-procedures/fseek.rst | 72 +
.../doc/gfortran/intrinsic-procedures/fstat.rst | 47 +
.../doc/gfortran/intrinsic-procedures/ftell.rst | 50 +
.../doc/gfortran/intrinsic-procedures/gamma.rst | 67 +
.../doc/gfortran/intrinsic-procedures/gerror.rst | 43 +
.../doc/gfortran/intrinsic-procedures/getarg.rst | 64 +
.../gfortran/intrinsic-procedures/getcommand.rst | 58 +
.../intrinsic-procedures/getcommandargument.rst | 76 +
.../doc/gfortran/intrinsic-procedures/getcwd.rst | 46 +
.../doc/gfortran/intrinsic-procedures/getenv.rst | 49 +
.../getenvironmentvariable.rst | 68 +
.../doc/gfortran/intrinsic-procedures/getgid.rst | 37 +
.../doc/gfortran/intrinsic-procedures/getlog.rst | 47 +
.../doc/gfortran/intrinsic-procedures/getpid.rst | 43 +
.../doc/gfortran/intrinsic-procedures/getuid.rst | 37 +
.../doc/gfortran/intrinsic-procedures/gmtime.rst | 47 +
.../doc/gfortran/intrinsic-procedures/hostnm.rst | 38 +
.../doc/gfortran/intrinsic-procedures/huge.rst | 41 +
.../doc/gfortran/intrinsic-procedures/hypot.rst | 45 +
.../doc/gfortran/intrinsic-procedures/iachar.rst | 55 +
.../doc/gfortran/intrinsic-procedures/iall.rst | 61 +
.../doc/gfortran/intrinsic-procedures/iand.rst | 99 +
.../doc/gfortran/intrinsic-procedures/iany.rst | 61 +
.../doc/gfortran/intrinsic-procedures/iargc.rst | 44 +
.../doc/gfortran/intrinsic-procedures/ibclr.rst | 87 +
.../doc/gfortran/intrinsic-procedures/ibits.rst | 93 +
.../doc/gfortran/intrinsic-procedures/ibset.rst | 85 +
.../doc/gfortran/intrinsic-procedures/ichar.rst | 93 +
.../doc/gfortran/intrinsic-procedures/idate.rst | 50 +
.../doc/gfortran/intrinsic-procedures/ieor.rst | 91 +
.../doc/gfortran/intrinsic-procedures/ierrno.rst | 37 +
.../gfortran/intrinsic-procedures/imageindex.rst | 48 +
.../doc/gfortran/intrinsic-procedures/index.rst | 72 +
.../doc/gfortran/intrinsic-procedures/int.rst | 76 +
.../doc/gfortran/intrinsic-procedures/int2.rst | 39 +
.../doc/gfortran/intrinsic-procedures/int8.rst | 39 +
.../introduction-to-intrinsic-procedures.rst | 43 +
.../doc/gfortran/intrinsic-procedures/ior.rst | 91 +
.../doc/gfortran/intrinsic-procedures/iparity.rst | 62 +
.../doc/gfortran/intrinsic-procedures/irand.rst | 48 +
.../doc/gfortran/intrinsic-procedures/isatty.rst | 46 +
.../gfortran/intrinsic-procedures/iscontiguous.rst | 52 +
.../doc/gfortran/intrinsic-procedures/ishft.rst | 85 +
.../doc/gfortran/intrinsic-procedures/ishftc.rst | 91 +
.../gfortran/intrinsic-procedures/isiostatend.rst | 48 +
.../gfortran/intrinsic-procedures/isiostateor.rst | 48 +
.../doc/gfortran/intrinsic-procedures/isnan.rst | 45 +
.../doc/gfortran/intrinsic-procedures/itime.rst | 50 +
.../doc/gfortran/intrinsic-procedures/kill.rst | 51 +
.../doc/gfortran/intrinsic-procedures/kind.rst | 46 +
.../doc/gfortran/intrinsic-procedures/lbound.rst | 51 +
.../doc/gfortran/intrinsic-procedures/lcobound.rst | 48 +
.../doc/gfortran/intrinsic-procedures/leadz.rst | 47 +
.../doc/gfortran/intrinsic-procedures/len.rst | 62 +
.../doc/gfortran/intrinsic-procedures/lentrim.rst | 43 +
.../doc/gfortran/intrinsic-procedures/lge.rst | 63 +
.../doc/gfortran/intrinsic-procedures/lgt.rst | 63 +
.../doc/gfortran/intrinsic-procedures/link.rst | 45 +
.../doc/gfortran/intrinsic-procedures/lle.rst | 63 +
.../doc/gfortran/intrinsic-procedures/llt.rst | 63 +
.../doc/gfortran/intrinsic-procedures/lnblnk.rst | 39 +
.../doc/gfortran/intrinsic-procedures/loc.rst | 44 +
.../doc/gfortran/intrinsic-procedures/log.rst | 93 +
.../doc/gfortran/intrinsic-procedures/log10.rst | 69 +
.../doc/gfortran/intrinsic-procedures/loggamma.rst | 76 +
.../doc/gfortran/intrinsic-procedures/logical.rst | 43 +
.../doc/gfortran/intrinsic-procedures/lshift.rst | 48 +
.../doc/gfortran/intrinsic-procedures/lstat.rst | 49 +
.../doc/gfortran/intrinsic-procedures/ltime.rst | 46 +
.../doc/gfortran/intrinsic-procedures/malloc.rst | 66 +
.../doc/gfortran/intrinsic-procedures/maskl.rst | 42 +
.../doc/gfortran/intrinsic-procedures/maskr.rst | 42 +
.../doc/gfortran/intrinsic-procedures/matmul.rst | 44 +
.../doc/gfortran/intrinsic-procedures/max.rst | 86 +
.../gfortran/intrinsic-procedures/maxexponent.rst | 45 +
.../doc/gfortran/intrinsic-procedures/maxloc.rst | 76 +
.../doc/gfortran/intrinsic-procedures/maxval.rst | 58 +
.../doc/gfortran/intrinsic-procedures/mclock.rst | 39 +
.../doc/gfortran/intrinsic-procedures/mclock8.rst | 39 +
.../doc/gfortran/intrinsic-procedures/merge.rst | 41 +
.../gfortran/intrinsic-procedures/mergebits.rst | 44 +
.../doc/gfortran/intrinsic-procedures/min.rst | 86 +
.../gfortran/intrinsic-procedures/minexponent.rst | 37 +
.../doc/gfortran/intrinsic-procedures/minloc.rst | 76 +
.../doc/gfortran/intrinsic-procedures/minval.rst | 58 +
.../doc/gfortran/intrinsic-procedures/mod.rst | 118 +
.../doc/gfortran/intrinsic-procedures/modulo.rst | 55 +
.../gfortran/intrinsic-procedures/movealloc.rst | 51 +
.../doc/gfortran/intrinsic-procedures/mvbits.rst | 95 +
.../doc/gfortran/intrinsic-procedures/nearest.rst | 51 +
.../doc/gfortran/intrinsic-procedures/newline.rst | 42 +
.../doc/gfortran/intrinsic-procedures/nint.rst | 75 +
.../doc/gfortran/intrinsic-procedures/norm2.rst | 46 +
.../doc/gfortran/intrinsic-procedures/not.rst | 85 +
.../doc/gfortran/intrinsic-procedures/null.rst | 41 +
.../gfortran/intrinsic-procedures/numimages.rst | 61 +
.../doc/gfortran/intrinsic-procedures/or.rst | 60 +
.../doc/gfortran/intrinsic-procedures/pack.rst | 72 +
.../doc/gfortran/intrinsic-procedures/parity.rst | 46 +
.../doc/gfortran/intrinsic-procedures/perror.rst | 35 +
.../doc/gfortran/intrinsic-procedures/popcnt.rst | 48 +
.../doc/gfortran/intrinsic-procedures/poppar.rst | 50 +
.../gfortran/intrinsic-procedures/precision.rst | 50 +
.../doc/gfortran/intrinsic-procedures/present.rst | 47 +
.../doc/gfortran/intrinsic-procedures/product.rst | 56 +
.../doc/gfortran/intrinsic-procedures/radix.rst | 44 +
.../doc/gfortran/intrinsic-procedures/ran.rst | 27 +
.../doc/gfortran/intrinsic-procedures/rand.rst | 51 +
.../gfortran/intrinsic-procedures/randominit.rst | 62 +
.../gfortran/intrinsic-procedures/randomnumber.rst | 42 +
.../gfortran/intrinsic-procedures/randomseed.rst | 62 +
.../doc/gfortran/intrinsic-procedures/range.rst | 42 +
.../doc/gfortran/intrinsic-procedures/rank.rst | 43 +
.../doc/gfortran/intrinsic-procedures/real.rst | 104 +
.../doc/gfortran/intrinsic-procedures/rename.rst | 44 +
.../doc/gfortran/intrinsic-procedures/repeat.rst | 43 +
.../doc/gfortran/intrinsic-procedures/reshape.rst | 62 +
.../gfortran/intrinsic-procedures/rrspacing.rst | 38 +
.../doc/gfortran/intrinsic-procedures/rshift.rst | 50 +
.../gfortran/intrinsic-procedures/sametypeas.rst | 41 +
.../doc/gfortran/intrinsic-procedures/scale.rst | 45 +
.../doc/gfortran/intrinsic-procedures/scan.rst | 57 +
.../doc/gfortran/intrinsic-procedures/secnds.rst | 52 +
.../doc/gfortran/intrinsic-procedures/second.rst | 40 +
.../intrinsic-procedures/selectedcharkind.rst | 56 +
.../intrinsic-procedures/selectedintkind.rst | 48 +
.../intrinsic-procedures/selectedrealkind.rst | 67 +
.../gfortran/intrinsic-procedures/setexponent.rst | 48 +
.../doc/gfortran/intrinsic-procedures/shape.rst | 55 +
.../doc/gfortran/intrinsic-procedures/shifta.rst | 46 +
.../doc/gfortran/intrinsic-procedures/shiftl.rst | 44 +
.../doc/gfortran/intrinsic-procedures/shiftr.rst | 44 +
.../doc/gfortran/intrinsic-procedures/sign.rst | 78 +
.../doc/gfortran/intrinsic-procedures/signal.rst | 59 +
.../doc/gfortran/intrinsic-procedures/sin.rst | 89 +
.../doc/gfortran/intrinsic-procedures/sind.rst | 89 +
.../doc/gfortran/intrinsic-procedures/sinh.rst | 66 +
.../doc/gfortran/intrinsic-procedures/size.rst | 55 +
.../doc/gfortran/intrinsic-procedures/sizeof.rst | 58 +
.../doc/gfortran/intrinsic-procedures/sleep.rst | 36 +
.../doc/gfortran/intrinsic-procedures/spacing.rst | 47 +
.../doc/gfortran/intrinsic-procedures/spread.rst | 54 +
.../doc/gfortran/intrinsic-procedures/sqrt.rst | 86 +
.../doc/gfortran/intrinsic-procedures/srand.rst | 53 +
.../doc/gfortran/intrinsic-procedures/stat.rst | 72 +
.../gfortran/intrinsic-procedures/storagesize.rst | 42 +
.../doc/gfortran/intrinsic-procedures/sum.rst | 56 +
.../doc/gfortran/intrinsic-procedures/symlnk.rst | 46 +
.../doc/gfortran/intrinsic-procedures/system.rst | 41 +
.../gfortran/intrinsic-procedures/systemclock.rst | 57 +
.../doc/gfortran/intrinsic-procedures/tan.rst | 70 +
.../doc/gfortran/intrinsic-procedures/tand.rst | 70 +
.../doc/gfortran/intrinsic-procedures/tanh.rst | 72 +
.../gfortran/intrinsic-procedures/thisimage.rst | 75 +
.../doc/gfortran/intrinsic-procedures/time.rst | 39 +
.../doc/gfortran/intrinsic-procedures/time8.rst | 39 +
.../doc/gfortran/intrinsic-procedures/tiny.rst | 36 +
.../doc/gfortran/intrinsic-procedures/trailz.rst | 46 +
.../doc/gfortran/intrinsic-procedures/transfer.rst | 55 +
.../gfortran/intrinsic-procedures/transpose.rst | 34 +
.../doc/gfortran/intrinsic-procedures/trim.rst | 45 +
.../doc/gfortran/intrinsic-procedures/ttynam.rst | 47 +
.../doc/gfortran/intrinsic-procedures/ubound.rst | 52 +
.../doc/gfortran/intrinsic-procedures/ucobound.rst | 48 +
.../doc/gfortran/intrinsic-procedures/umask.rst | 36 +
.../doc/gfortran/intrinsic-procedures/unlink.rst | 41 +
.../doc/gfortran/intrinsic-procedures/unpack.rst | 57 +
.../doc/gfortran/intrinsic-procedures/verify.rst | 59 +
.../doc/gfortran/intrinsic-procedures/xor.rst | 60 +
gcc/fortran/doc/gfortran/introduction.rst | 18 +
.../doc/gfortran/mixed-language-programming.rst | 37 +
.../naming-and-argument-passing-conventions.rst | 180 +
.../doc/gfortran/non-fortran-main-program.rst | 251 +
gcc/fortran/doc/gfortran/projects.rst | 29 +
gcc/fortran/doc/gfortran/runtime.rst | 33 +
.../doc/gfortran/runtime/gfortranconvertunit.rst | 97 +
.../gfortran/runtime/gfortranerrorbacktrace.rst | 16 +
.../runtime/gfortranformattedbuffersize.rst | 13 +
.../doc/gfortran/runtime/gfortranlistseparator.rst | 21 +
.../doc/gfortran/runtime/gfortranoptionalplus.rst | 15 +
.../doc/gfortran/runtime/gfortranshowlocus.rst | 14 +
.../doc/gfortran/runtime/gfortranstderrunit.rst | 13 +
.../doc/gfortran/runtime/gfortranstdinunit.rst | 13 +
.../doc/gfortran/runtime/gfortranstdoutunit.rst | 13 +
.../doc/gfortran/runtime/gfortranunbufferedall.rst | 15 +
.../runtime/gfortranunbufferedpreconnected.rst | 15 +
.../runtime/gfortranunformattedbuffersize.rst | 13 +
gcc/fortran/doc/gfortran/runtime/tmpdir.rst | 22 +
gcc/fortran/doc/gfortran/standards.rst | 131 +
.../gfortran/type-and-enum-abi-documentation.rst | 189 +
gcc/go/doc/c-interoperability.rst | 23 +
gcc/go/doc/c-type-interoperability.rst | 77 +
gcc/go/doc/compiler-directives.rst | 47 +
gcc/go/doc/conf.py | 29 +
gcc/go/doc/copyright.rst | 24 +
gcc/go/doc/function-names.rst | 61 +
gcc/go/doc/general-public-license-3.rst | 6 +
gcc/go/doc/gnu-free-documentation-license.rst | 6 +
gcc/go/doc/import-and-export.rst | 50 +
gcc/go/doc/index.rst | 23 +
gcc/go/doc/indices-and-tables.rst | 1 +
gcc/go/doc/introduction.rst | 8 +
gcc/go/doc/invoking-gccgo.rst | 214 +
libgomp/doc/conf.py | 23 +
libgomp/doc/copyright.rst | 25 +
libgomp/doc/cuda-streams-usage.rst | 50 +
libgomp/doc/enabling-openacc.rst | 24 +
libgomp/doc/enabling-openmp.rst | 22 +
.../first-invocation-nvidia-cublas-library-api.rst | 52 +
.../doc/first-invocation-openacc-library-api.rst | 74 +
libgomp/doc/funding.rst | 6 +
libgomp/doc/general-public-license-3.rst | 6 +
libgomp/doc/gnu-free-documentation-license.rst | 6 +
...-status-and-implementation-defined-behavior.rst | 281 ++
libgomp/doc/index.rst | 34 +
libgomp/doc/indices-and-tables.rst | 1 +
libgomp/doc/introduction.rst | 20 +
libgomp/doc/offload-target-specifics.rst | 16 +
libgomp/doc/openacc-environment-variables.rst | 23 +
.../openacc-environment-variables/accdevicenum.rst | 13 +
.../accdevicetype.rst | 13 +
.../openacc-environment-variables/accproflib.rst | 16 +
.../openacc-environment-variables/gccaccnotify.rst | 12 +
libgomp/doc/openacc-introduction.rst | 21 +
.../openacc-library-and-environment-variables.rst | 30 +
libgomp/doc/openacc-library-interoperability.rst | 17 +
libgomp/doc/openacc-profiling-interface.rst | 14 +
libgomp/doc/openacc-runtime-library-routines.rst | 74 +
.../accasynctest.rst | 36 +
.../accasynctestall.rst | 34 +
.../openacc-runtime-library-routines/accattach.rst | 25 +
.../openacc-runtime-library-routines/acccopyin.rst | 58 +
.../acccopyout.rst | 85 +
.../openacc-runtime-library-routines/acccreate.rst | 58 +
.../openacc-runtime-library-routines/accdelete.rst | 85 +
.../openacc-runtime-library-routines/accdetach.rst | 29 +
.../accdeviceptr.rst | 23 +
.../openacc-runtime-library-routines/accfree.rst | 22 +
.../accgetcudastream.rst | 23 +
.../accgetcurrentcudacontext.rst | 23 +
.../accgetcurrentcudadevice.rst | 23 +
.../accgetdevicenum.rst | 34 +
.../accgetdevicetype.rst | 36 +
.../accgetnumdevices.rst | 31 +
.../accgetproperty.rst | 60 +
.../acchostptr.rst | 23 +
.../openacc-runtime-library-routines/accinit.rst | 31 +
.../accispresent.rst | 50 +
.../openacc-runtime-library-routines/accmalloc.rst | 23 +
.../accmapdata.rst | 24 +
.../accmemcpyfromdevice.rst | 24 +
.../accmemcpytodevice.rst | 24 +
.../accondevice.rst | 37 +
.../accpresentorcopyin.rst | 58 +
.../accpresentorcreate.rst | 58 +
.../accproflookup.rst | 25 +
.../accprofregister.rst | 25 +
.../accprofunregister.rst | 25 +
.../accregisterlibrary.rst | 25 +
.../accsetcudastream.rst | 28 +
.../accsetdevicenum.rst | 34 +
.../accsetdevicetype.rst | 31 +
.../accshutdown.rst | 31 +
.../accunmapdata.rst | 23 +
.../accupdatedevice.rst | 58 +
.../accupdateself.rst | 58 +
.../openacc-runtime-library-routines/accwait.rst | 37 +
.../accwaitall.rst | 32 +
.../accwaitallasync.rst | 32 +
.../accwaitasync.rst | 31 +
libgomp/doc/openmp-context-selectors.rst | 32 +
libgomp/doc/openmp-environment-variables.rst | 39 +
.../gompcpuaffinity.rst | 37 +
.../doc/openmp-environment-variables/gompdebug.rst | 18 +
.../gomprtemsthreadpools.rst | 46 +
.../openmp-environment-variables/gompspincount.rst | 30 +
.../openmp-environment-variables/gompstacksize.rst | 25 +
.../ompcancellation.rst | 21 +
.../ompdefaultdevice.rst | 24 +
.../openmp-environment-variables/ompdisplayenv.rst | 21 +
.../openmp-environment-variables/ompdynamic.rst | 23 +
.../ompmaxactivelevels.rst | 26 +
.../ompmaxtaskpriority.rst | 25 +
.../doc/openmp-environment-variables/ompnested.rst | 28 +
.../openmp-environment-variables/ompnumteams.rst | 23 +
.../openmp-environment-variables/ompnumthreads.rst | 24 +
.../doc/openmp-environment-variables/ompplaces.rst | 54 +
.../openmp-environment-variables/ompprocbind.rst | 34 +
.../openmp-environment-variables/ompschedule.rst | 24 +
.../openmp-environment-variables/ompstacksize.rst | 24 +
.../omptargetoffload.rst | 27 +
.../ompteamsthreadlimit.rst | 24 +
.../ompthreadlimit.rst | 22 +
.../openmp-environment-variables/ompwaitpolicy.rst | 24 +
libgomp/doc/openmp-implementation-status.rst | 21 +
.../doc/openmp-implementation-status/openmp-45.rst | 11 +
.../doc/openmp-implementation-status/openmp-50.rst | 212 +
.../doc/openmp-implementation-status/openmp-51.rst | 174 +
.../doc/openmp-implementation-status/openmp-52.rst | 130 +
libgomp/doc/openmp-runtime-library-routines.rst | 87 +
.../ompdestroylock.rst | 33 +
.../ompdestroynestlock.rst | 33 +
.../ompfulfillevent.rst | 36 +
.../ompgetactivelevel.rst | 31 +
.../ompgetancestorthreadnum.rst | 35 +
.../ompgetcancellation.rst | 33 +
.../ompgetdefaultdevice.rst | 30 +
.../ompgetdevicenum.rst | 33 +
.../ompgetdynamic.rst | 37 +
.../ompgetinitialdevice.rst | 32 +
.../ompgetlevel.rst | 31 +
.../ompgetmaxactivelevels.rst | 30 +
.../ompgetmaxtaskpriority.rst | 29 +
.../ompgetmaxteams.rst | 31 +
.../ompgetmaxthreads.rst | 31 +
.../ompgetnested.rst | 48 +
.../ompgetnumdevices.rst | 27 +
.../ompgetnumprocs.rst | 27 +
.../ompgetnumteams.rst | 27 +
.../ompgetnumthreads.rst | 38 +
.../ompgetprocbind.rst | 34 +
.../ompgetschedule.rst | 37 +
.../ompgetsupportedactivelevels.rst | 31 +
.../ompgetteamnum.rst | 27 +
.../ompgetteamsize.rst | 36 +
.../ompgetteamsthreadlimit.rst | 31 +
.../ompgetthreadlimit.rst | 30 +
.../ompgetthreadnum.rst | 34 +
.../ompgetwtick.rst | 31 +
.../ompgetwtime.rst | 33 +
.../openmp-runtime-library-routines/ompinfinal.rst | 29 +
.../ompinitlock.rst | 33 +
.../ompinitnestlock.rst | 33 +
.../ompinparallel.rst | 29 +
.../ompisinitialdevice.rst | 29 +
.../ompsetdefaultdevice.rst | 33 +
.../ompsetdynamic.rst | 35 +
.../openmp-runtime-library-routines/ompsetlock.rst | 35 +
.../ompsetmaxactivelevels.rst | 35 +
.../ompsetnested.rst | 40 +
.../ompsetnestlock.rst | 35 +
.../ompsetnumteams.rst | 34 +
.../ompsetnumthreads.rst | 34 +
.../ompsetschedule.rst | 40 +
.../ompsetteamsthreadlimit.rst | 35 +
.../omptestlock.rst | 36 +
.../omptestnestlock.rst | 36 +
.../ompunsetlock.rst | 36 +
.../ompunsetnestlock.rst | 36 +
libgomp/doc/reporting-bugs.rst | 14 +
libgomp/doc/the-libgomp-abi.rst | 31 +
.../implementing-atomic-construct.rst | 21 +
.../implementing-barrier-construct.rst | 13 +
.../implementing-critical-construct.rst | 30 +
...-lastprivate-copyin-and-copyprivate-clauses.rst | 45 +
.../implementing-flush-construct.rst | 11 +
.../the-libgomp-abi/implementing-for-construct.rst | 73 +
.../implementing-master-construct.rst | 18 +
.../implementing-openaccs-parallel-construct.rst | 13 +
.../implementing-ordered-construct.rst | 14 +
.../implementing-parallel-construct.rst | 55 +
.../implementing-private-clause.rst | 17 +
.../implementing-reduction-clause.rst | 15 +
.../implementing-sections-construct.rst | 42 +
.../implementing-single-construct.rst | 48 +
.../implementing-threadprivate-construct.rst | 18 +
libiberty/doc/bsd.rst | 6 +
libiberty/doc/conf.py | 24 +
libiberty/doc/copyright.rst | 13 +
libiberty/doc/extensions.rst | 767 ++++
.../doc/function-variable-and-macro-listing.rst | 1857 ++++++++
libiberty/doc/index.rst | 23 +
libiberty/doc/indices-and-tables.rst | 1 +
libiberty/doc/introduction.rst | 8 +
.../doc/lesser-general-public-license-2.1.rst | 6 +
libiberty/doc/overview.rst | 20 +
libiberty/doc/replacement-functions.rst | 62 +
libiberty/doc/supplemental-functions.rst | 31 +
libiberty/doc/using.rst | 40 +
libitm/doc/c-c++-language-constructs-for-tm.rst | 39 +
libitm/doc/conf.py | 23 +
libitm/doc/copyright.rst | 13 +
libitm/doc/enabling-libitm.rst | 13 +
libitm/doc/gnu-free-documentation-license.rst | 6 +
libitm/doc/index.rst | 27 +
libitm/doc/indices-and-tables.rst | 1 +
libitm/doc/internals.rst | 16 +
libitm/doc/locking-conventions.rst | 261 ++
libitm/doc/nesting-flat-vs-closed.rst | 28 +
libitm/doc/the-libitm-abi.rst | 27 +
libitm/doc/the-libitm-abi/function-list.rst | 271 ++
.../future-enhancements-to-the-abi.rst | 7 +
.../the-libitm-abi/library-design-principles.rst | 61 +
libitm/doc/the-libitm-abi/memory-model.rst | 18 +
libitm/doc/the-libitm-abi/non-objectives.rst | 7 +
libitm/doc/the-libitm-abi/objectives.rst | 7 +
libitm/doc/the-libitm-abi/sample-code.rst | 10 +
.../doc/the-libitm-abi/types-and-macros-list.rst | 10 +
libitm/doc/tm-methods-and-method-groups.rst | 47 +
libquadmath/doc/conf.py | 23 +
libquadmath/doc/copyright.rst | 18 +
libquadmath/doc/gnu-free-documentation-license.rst | 6 +
libquadmath/doc/i-o-library-routines.rst | 15 +
libquadmath/doc/index.rst | 23 +
libquadmath/doc/indices-and-tables.rst | 1 +
libquadmath/doc/introduction.rst | 7 +
libquadmath/doc/math-library-routines.rst | 104 +
libquadmath/doc/quadmathsnprintf.rst | 74 +
libquadmath/doc/reporting-bugs.rst | 12 +
libquadmath/doc/strtoflt128.rst | 40 +
libquadmath/doc/typedef-and-constants.rst | 43 +
1331 files changed, 176130 insertions(+)
diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644
index 00000000000..3805f545d0a
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS ?= -j auto -q
+SPHINXBUILD ?= sphinx-build
+SOURCEDIR = .
+BUILDDIR = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+ @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/doc/_static/custom.css b/doc/_static/custom.css
new file mode 100644
index 00000000000..1282a993e2a
--- /dev/null
+++ b/doc/_static/custom.css
@@ -0,0 +1,11 @@
+.sidebar-brand-text {
+ font-size: 13pt;
+}
+
+.literal {
+ white-space: nowrap !important;
+}
+
+.wy-nav-content {
+ max-width: initial;
+}
diff --git a/doc/baseconf.py b/doc/baseconf.py
new file mode 100644
index 00000000000..06abbd97584
--- /dev/null
+++ b/doc/baseconf.py
@@ -0,0 +1,186 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import subprocess
+import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+# gccint needs a deeper stack limit
+sys.setrecursionlimit(2000)
+
+# -- Project information -----------------------------------------------------
+
+# The full version, including alpha/beta/rc tags
+
+# FIXME
+folder = os.path.dirname(os.path.realpath(__file__))
+gcc_srcdir = os.path.join(folder, './objdir')
+
+def __read_file(name):
+ path = os.path.join(gcc_srcdir, name)
+ if os.path.exists(path):
+ return open(path).read().strip()
+ else:
+ return ''
+
+
+def __get_git_revision():
+ try:
+ r = subprocess.check_output('git rev-parse --short HEAD', shell=True, encoding='utf8',
+ stderr=subprocess.DEVNULL)
+ return r.strip()
+ except subprocess.CalledProcessError:
+ return None
+
+
+gcc_BASEVER = __read_file('BASE-VER')
+gcc_DEVPHASE = __read_file('DEV-PHASE')
+gcc_DATESTAMP = __read_file('DATESTAMP')
+gcc_REVISION = __read_file('REVISION')
+
+VERSION_PACKAGE = os.getenv('VERSION_PACKAGE', '(GCC)')
+BUGURL = os.getenv('BUGURL', 'https://gcc.gnu.org/bugs/')
+
+# The short X.Y version.
+version = gcc_BASEVER
+
+# The full version, including alpha/beta/rc tags.
+release = ('%s (%s %s%s)'
+ % (gcc_BASEVER, gcc_DEVPHASE, gcc_DATESTAMP,
+ (' %s' % gcc_REVISION) if gcc_REVISION else ''))
+
+rst_prolog = r'''
+.. |gol| raw:: latex
+
+ \\
+'''
+
+needs_sphinx = '5.1'
+
+rst_epilog = '''
+.. |gcc_version| replace:: %s
+.. |package_version| replace:: %s
+.. |bugurl| replace:: %s
+.. |needs_sphinx| replace:: %s
+''' % (gcc_BASEVER, VERSION_PACKAGE, BUGURL, needs_sphinx)
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+ 'gcc_sphinx',
+ 'sphinx.ext.intersphinx',
+ 'sphinx_copybutton'
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ['_build']
+
+# Do not highlight by default
+highlight_language = 'none'
+
+# Select C++ as a primary domain
+primary_domain = 'cpp'
+
+cpp_id_attributes = ['HOST_WIDE_INT', '__memx']
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages. See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'furo'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further. For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+ 'navigation_with_keys': True,
+}
+
+html_logo = '../logo.svg'
+
+html_favicon = '../favicon.ico'
+
+html_last_updated_fmt = ''
+
+html_context = {
+ 'commit': __get_git_revision ()
+}
+
+html_static_path = [
+ '../_static'
+]
+
+html_css_files = [
+ 'custom.css'
+]
+
+# By default, do not generate any manual pages
+man_pages = []
+
+# FIXME: handle WARNINGs: unknown option issues and cross refs
+suppress_warnings = [
+ 'ref.option',
+]
+
+# Use xelatex by default
+latex_engine = 'xelatex'
+
+latex_logo = '../logo.pdf'
+
+# TODO: Remove once xindy works in an openSUSE container
+latex_use_xindy = False
+
+latex_elements = {
+ 'fontpkg': r'''
+\setmonofont[Scale=0.8]{DejaVu Sans Mono}
+''',
+ 'preamble': r'''
+\fvset{formatcom=\let\textbf\relax}
+\protected\def\sphinxcrossref#1{#1}
+''',
+}
+
+texinfo_cross_references = False
+
+texinfo_elements = { 'preamble': """
+@definfoenclose strong,*,*
+@definfoenclose emph,','
+"""
+}
+
+# Use default as RTD theme uses default as well
+pygments_style = 'default'
+
+option_emphasise_placeholders = True
+
+# Ignore GitHub domain for link checking:
+# https://github.com/sphinx-doc/sphinx/issues/9016
+linkcheck_ignore = [
+ 'https://github.com/.*#.*'
+]
+
+# Cross manual reference mapping
+intersphinx_mapping = {}
+for manual in ['cpp', 'cppinternals', 'gfortran', 'gcc', 'gccgo', 'gccint', 'gdc',
+ 'gfc-internals', 'gnat-style', 'gnat_rm', 'gnat_ugn', 'install',
+ 'libgccjit', 'libgomp', 'libiberty', 'libitm', 'libquadmath']:
+ intersphinx_mapping[manual] = (f'https://splichal.eu/scripts/sphinx/{manual}/_build/html/', None)
diff --git a/doc/bsd.rst b/doc/bsd.rst
new file mode 100644
index 00000000000..c95404eb7bf
--- /dev/null
+++ b/doc/bsd.rst
@@ -0,0 +1,39 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+BSD
+===
+
+Copyright (C) 1990 Regents of the University of California.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+#. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+
+#. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+#. [rescinded 22 July 1999]
+
+#. Neither the name of the University nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS 'AS IS' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.
\ No newline at end of file
diff --git a/doc/contrib.rst b/doc/contrib.rst
new file mode 100644
index 00000000000..1ad87f0ebbd
--- /dev/null
+++ b/doc/contrib.rst
@@ -0,0 +1,1273 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: contributors
+
+.. _contributors:
+
+Contributors to GCC
+===================
+
+The GCC project would like to thank its many contributors. Without them the
+project would not have been nearly as successful as it has been. Any omissions
+in this list are accidental. Feel free to contact
+law@redhat.com or gerald@pfeifer.com if you have been left
+out or some of your contributions are not listed. Please keep this list in
+alphabetical order.
+
+* Analog Devices helped implement the support for complex data types
+ and iterators.
+
+* John David Anglin for threading-related fixes and improvements to
+ libstdc++-v3, and the HP-UX port.
+
+* James van Artsdalen wrote the code that makes efficient use of
+ the Intel 80387 register stack.
+
+* Abramo and Roberto Bagnara for the SysV68 Motorola 3300 Delta Series
+ port.
+
+* Alasdair Baird for various bug fixes.
+
+* Giovanni Bajo for analyzing lots of complicated C++ problem reports.
+
+* Peter Barada for his work to improve code generation for new
+ ColdFire cores.
+
+* Gerald Baumgartner added the signature extension to the C++ front end.
+
+* Godmar Back for his Java improvements and encouragement.
+
+* Scott Bambrough for help porting the Java compiler.
+
+* Wolfgang Bangerth for processing tons of bug reports.
+
+* Jon Beniston for his Microsoft Windows port of Java and port to Lattice Mico32.
+
+* Daniel Berlin for better DWARF 2 support, faster/better optimizations,
+ improved alias analysis, plus migrating GCC to Bugzilla.
+
+* Geoff Berry for his Java object serialization work and various patches.
+
+* David Binderman tests weekly snapshots of GCC trunk against Fedora Rawhide
+ for several architectures.
+
+* Laurynas Biveinis for memory management work and DJGPP port fixes.
+
+* Uros Bizjak for the implementation of x87 math built-in functions and
+ for various middle end and i386 back end improvements and bug fixes.
+
+* Eric Blake for helping to make GCJ and libgcj conform to the
+ specifications.
+
+* Janne Blomqvist for contributions to GNU Fortran.
+
+* Hans-J. Boehm for his garbage collector, IA-64 libffi port, and other
+ Java work.
+
+* Segher Boessenkool for helping maintain the PowerPC port and the
+ instruction combiner plus various contributions to the middle end.
+
+* Neil Booth for work on cpplib, lang hooks, debug hooks and other
+ miscellaneous clean-ups.
+
+* Steven Bosscher for integrating the GNU Fortran front end into GCC and for
+ contributing to the tree-ssa branch.
+
+* Eric Botcazou for fixing middle- and backend bugs left and right.
+
+* Per Bothner for his direction via the steering committee and various
+ improvements to the infrastructure for supporting new languages. Chill
+ front end implementation. Initial implementations of
+ cpplib, fix-header, config.guess, libio, and past C++ library (libg++)
+ maintainer. Dreaming up, designing and implementing much of GCJ.
+
+* Devon Bowen helped port GCC to the Tahoe.
+
+* Don Bowman for mips-vxworks contributions.
+
+* James Bowman for the FT32 port.
+
+* Dave Brolley for work on cpplib and Chill.
+
+* Paul Brook for work on the ARM architecture and maintaining GNU Fortran.
+
+* Robert Brown implemented the support for Encore 32000 systems.
+
+* Christian Bruel for improvements to local store elimination.
+
+* Herman A.J. ten Brugge for various fixes.
+
+* Joerg Brunsmann for Java compiler hacking and help with the GCJ FAQ.
+
+* Joe Buck for his direction via the steering committee from its creation
+ to 2013.
+
+* Iain Buclaw for the D frontend.
+
+* Craig Burley for leadership of the G77 Fortran effort.
+
+* Tobias Burnus for contributions to GNU Fortran.
+
+* Stephan Buys for contributing Doxygen notes for libstdc++.
+
+* Paolo Carlini for libstdc++ work: lots of efficiency improvements to
+ the C++ strings, streambufs and formatted I/O, hard detective work on
+ the frustrating localization issues, and keeping up with the problem reports.
+
+* John Carr for his alias work, SPARC hacking, infrastructure improvements,
+ previous contributions to the steering committee, loop optimizations, etc.
+
+* Stephane Carrez for 68HC11 and 68HC12 ports.
+
+* Steve Chamberlain for support for the Renesas SH and H8 processors
+ and the PicoJava processor, and for GCJ config fixes.
+
+* Glenn Chambers for help with the GCJ FAQ.
+
+* John-Marc Chandonia for various libgcj patches.
+
+* Denis Chertykov for contributing and maintaining the AVR port, the first GCC port
+ for an 8-bit architecture.
+
+* Kito Cheng for his work on the RISC-V port, including bringing up the test
+ suite and maintenance.
+
+* Scott Christley for his Objective-C contributions.
+
+* Eric Christopher for his Java porting help and clean-ups.
+
+* Branko Cibej for more warning contributions.
+
+* The `GNU Classpath project <https://www.gnu.org/software/classpath/>`_
+ for all of their merged runtime code.
+
+* Nick Clifton for arm, mcore, fr30, v850, m32r, msp430 rx work,
+ :option:`--help`, and other random hacking.
+
+* Michael Cook for libstdc++ cleanup patches to reduce warnings.
+
+* R. Kelley Cook for making GCC buildable from a read-only directory as
+ well as other miscellaneous build process and documentation clean-ups.
+
+* Ralf Corsepius for SH testing and minor bug fixing.
+
+* François-Xavier Coudert for contributions to GNU Fortran.
+
+* Stan Cox for care and feeding of the x86 port and lots of behind
+ the scenes hacking.
+
+* Alex Crain provided changes for the 3b1.
+
+* Ian Dall for major improvements to the NS32k port.
+
+* Paul Dale for his work to add uClinux platform support to the
+ m68k backend.
+
+* Palmer Dabbelt for his work maintaining the RISC-V port.
+
+* Dario Dariol contributed the four varieties of sample programs
+ that print a copy of their source.
+
+* Russell Davidson for fstream and stringstream fixes in libstdc++.
+
+* Bud Davis for work on the G77 and GNU Fortran compilers.
+
+* Mo DeJong for GCJ and libgcj bug fixes.
+
+* Jerry DeLisle for contributions to GNU Fortran.
+
+* DJ Delorie for the DJGPP port, build and libiberty maintenance,
+ various bug fixes, and the M32C, MeP, MSP430, and RL78 ports.
+
+* Arnaud Desitter for helping to debug GNU Fortran.
+
+* Gabriel Dos Reis for contributions to G++, contributions and
+ maintenance of GCC diagnostics infrastructure, libstdc++-v3,
+ including ``valarray<>``, ``complex<>``, maintaining the numerics library
+ (including that pesky ``<limits>`` :-) and keeping up-to-date anything
+ to do with numbers.
+
+* Ulrich Drepper for his work on glibc, testing of GCC using glibc, ISO C99
+ support, CFG dumping support, etc., plus support of the C++ runtime
+ libraries including for all kinds of C interface issues, contributing and
+ maintaining ``complex<>``, sanity checking and disbursement, configuration
+ architecture, libio maintenance, and early math work.
+
+* François Dumont for his work on libstdc++-v3, especially maintaining and
+ improving ``debug-mode`` and associative and unordered containers.
+
+* Zdenek Dvorak for a new loop unroller and various fixes.
+
+* Michael Eager for his work on the Xilinx MicroBlaze port.
+
+* Richard Earnshaw for his ongoing work with the ARM.
+
+* David Edelsohn for his direction via the steering committee, ongoing work
+ with the RS6000/PowerPC port, help cleaning up Haifa loop changes,
+ doing the entire AIX port of libstdc++ with his bare hands, and for
+ ensuring GCC properly keeps working on AIX.
+
+* Kevin Ediger for the floating point formatting of num_put::do_put in
+ libstdc++.
+
+* Phil Edwards for libstdc++ work including configuration hackery,
+ documentation maintainer, chief breaker of the web pages, the occasional
+ iostream bug fix, and work on shared library symbol versioning.
+
+* Paul Eggert for random hacking all over GCC.
+
+* Mark Elbrecht for various DJGPP improvements, and for libstdc++
+ configuration support for locales and fstream-related fixes.
+
+* Vadim Egorov for libstdc++ fixes in strings, streambufs, and iostreams.
+
+* Christian Ehrhardt for dealing with bug reports.
+
+* Ben Elliston for his work to move the Objective-C runtime into its
+ own subdirectory and for his work on autoconf.
+
+* Revital Eres for work on the PowerPC 750CL port.
+
+* Marc Espie for OpenBSD support.
+
+* Doug Evans for much of the global optimization framework, arc, m32r,
+ and SPARC work.
+
+* Christopher Faylor for his work on the Cygwin port and for caring and
+ feeding the gcc.gnu.org box and saving its users tons of spam.
+
+* Fred Fish for BeOS support and Ada fixes.
+
+* Ivan Fontes Garcia for the Portuguese translation of the GCJ FAQ.
+
+* Peter Gerwinski for various bug fixes and the Pascal front end.
+
+* Kaveh R. Ghazi for his direction via the steering committee, amazing
+ work to make :samp:`-W -Wall -W* -Werror` useful, and
+ testing GCC on a plethora of platforms. Kaveh extends his gratitude to
+ the CAIP Center at Rutgers University for providing him with computing
+ resources to work on Free Software from the late 1980s to 2010.
+
+* John Gilmore for a donation to the FSF earmarked improving GNU Java.
+
+* Judy Goldberg for c++ contributions.
+
+* Torbjorn Granlund for various fixes and the c-torture testsuite,
+ multiply- and divide-by-constant optimization, improved long long
+ support, improved leaf function register allocation, and his direction
+ via the steering committee.
+
+* Jonny Grant for improvements to ``collect2's`` :option:`--help` documentation.
+
+* Anthony Green for his :option:`-Os` contributions, the moxie port, and
+ Java front end work.
+
+* Stu Grossman for gdb hacking, allowing GCJ developers to debug Java code.
+
+* Michael K. Gschwind contributed the port to the PDP-11.
+
+* Richard Biener for his ongoing middle-end contributions and bug fixes
+ and for release management.
+
+* Ron Guilmette implemented the :command:`protoize` and :command:`unprotoize`
+ tools, the support for DWARF 1 symbolic debugging information, and much of
+ the support for System V Release 4. He has also worked heavily on the
+ Intel 386 and 860 support.
+
+* Sumanth Gundapaneni for contributing the CR16 port.
+
+* Mostafa Hagog for Swing Modulo Scheduling (SMS) and post reload GCSE.
+
+* Bruno Haible for improvements in the runtime overhead for EH, new
+ warnings and assorted bug fixes.
+
+* Andrew Haley for his amazing Java compiler and library efforts.
+
+* Chris Hanson assisted in making GCC work on HP-UX for the 9000 series 300.
+
+* Michael Hayes for various thankless work he's done trying to get
+ the c30/c40 ports functional. Lots of loop and unroll improvements and
+ fixes.
+
+* Dara Hazeghi for wading through myriads of target-specific bug reports.
+
+* Kate Hedstrom for staking the G77 folks with an initial testsuite.
+
+* Richard Henderson for his ongoing SPARC, alpha, ia32, and ia64 work, loop
+ opts, and generally fixing lots of old problems we've ignored for
+ years, flow rewrite and lots of further stuff, including reviewing
+ tons of patches.
+
+* Aldy Hernandez for working on the PowerPC port, SIMD support, and
+ various fixes.
+
+* Nobuyuki Hikichi of Software Research Associates, Tokyo, contributed
+ the support for the Sony NEWS machine.
+
+* Kazu Hirata for caring and feeding the Renesas H8/300 port and various fixes.
+
+* Katherine Holcomb for work on GNU Fortran.
+
+* Manfred Hollstein for his ongoing work to keep the m88k alive, lots
+ of testing and bug fixing, particularly of GCC configury code.
+
+* Steve Holmgren for MachTen patches.
+
+* Mat Hostetter for work on the TILE-Gx and TILEPro ports.
+
+* Jan Hubicka for his x86 port improvements.
+
+* Falk Hueffner for working on C and optimization bug reports.
+
+* Bernardo Innocenti for his m68k work, including merging of
+ ColdFire improvements and uClinux support.
+
+* Christian Iseli for various bug fixes.
+
+* Kamil Iskra for general m68k hacking.
+
+* Lee Iverson for random fixes and MIPS testing.
+
+* Balaji V. Iyer for Cilk+ development and merging.
+
+* Andreas Jaeger for testing and benchmarking of GCC and various bug fixes.
+
+* Martin Jambor for his work on inter-procedural optimizations, the
+ switch conversion pass, and scalar replacement of aggregates.
+
+* Jakub Jelinek for his SPARC work and sibling call optimizations as well
+ as lots of bug fixes and test cases, and for improving the Java build
+ system.
+
+* Janis Johnson for ia64 testing and fixes, her quality improvement
+ sidetracks, and web page maintenance.
+
+* Kean Johnston for SCO OpenServer support and various fixes.
+
+* Tim Josling for the sample language treelang based originally on Richard
+ Kenner's 'toy' language.
+
+* Nicolai Josuttis for additional libstdc++ documentation.
+
+* Klaus Kaempf for his ongoing work to make alpha-vms a viable target.
+
+* Steven G. Kargl for work on GNU Fortran.
+
+* David Kashtan of SRI adapted GCC to VMS.
+
+* Ryszard Kabatek for many, many libstdc++ bug fixes and optimizations of
+ strings, especially member functions, and for auto_ptr fixes.
+
+* Geoffrey Keating for his ongoing work to make the PPC work for GNU/Linux
+ and his automatic regression tester.
+
+* Brendan Kehoe for his ongoing work with G++ and for a lot of early work
+ in just about every part of libstdc++.
+
+* Oliver M. Kellogg of Deutsche Aerospace contributed the port to the
+ MIL-STD-1750A.
+
+* Richard Kenner of the New York University Ultracomputer Research
+ Laboratory wrote the machine descriptions for the AMD 29000, the DEC
+ Alpha, the IBM RT PC, and the IBM RS/6000 as well as the support for
+ instruction attributes. He also made changes to better support RISC
+ processors including changes to common subexpression elimination,
+ strength reduction, function calling sequence handling, and condition
+ code support, in addition to generalizing the code for frame pointer
+ elimination and delay slot scheduling. Richard Kenner was also the
+ head maintainer of GCC for several years.
+
+* Mumit Khan for various contributions to the Cygwin and Mingw32 ports and
+ maintaining binary releases for Microsoft Windows hosts, and for massive libstdc++
+ porting work to Cygwin/Mingw32.
+
+* Robin Kirkham for cpu32 support.
+
+* Mark Klein for PA improvements.
+
+* Thomas Koenig for various bug fixes.
+
+* Bruce Korb for the new and improved fixincludes code.
+
+* Benjamin Kosnik for his G++ work and for leading the libstdc++-v3 effort.
+
+* Maxim Kuvyrkov for contributions to the instruction scheduler, the Android
+ and m68k/Coldfire ports, and optimizations.
+
+* Charles LaBrec contributed the support for the Integrated Solutions
+ 68020 system.
+
+* Asher Langton and Mike Kumbera for contributing Cray pointer support
+ to GNU Fortran, and for other GNU Fortran improvements.
+
+* Jeff Law for his direction via the steering committee, coordinating the
+ entire egcs project and GCC 2.95, rolling out snapshots and releases,
+ handling merges from GCC2, reviewing tons of patches that might have
+ fallen through the cracks else, and random but extensive hacking.
+
+* Walter Lee for work on the TILE-Gx and TILEPro ports.
+
+* Marc Lehmann for his direction via the steering committee and helping
+ with analysis and improvements of x86 performance.
+
+* Victor Leikehman for work on GNU Fortran.
+
+* Ted Lemon wrote parts of the RTL reader and printer.
+
+* Kriang Lerdsuwanakij for C++ improvements including template as template
+ parameter support, and many C++ fixes.
+
+* Warren Levy for tremendous work on libgcj (Java Runtime Library) and
+ random work on the Java front end.
+
+* Alain Lichnewsky ported GCC to the MIPS CPU.
+
+* Oskar Liljeblad for hacking on AWT and his many Java bug reports and
+ patches.
+
+* Robert Lipe for OpenServer support, new testsuites, testing, etc.
+
+* Chen Liqin for various S+core related fixes/improvement, and for
+ maintaining the S+core port.
+
+* Martin Liska for his work on identical code folding, the sanitizers,
+ HSA, general bug fixing and for running automated regression testing of GCC
+ and reporting numerous bugs.
+
+* Weiwen Liu for testing and various bug fixes.
+
+* Manuel López-Ibáñez for improving :option:`-Wconversion` and
+ many other diagnostics fixes and improvements.
+
+* Dave Love for his ongoing work with the Fortran front end and
+ runtime libraries.
+
+* Martin von Löwis for internal consistency checking infrastructure,
+ various C++ improvements including namespace support, and tons of
+ assistance with libstdc++/compiler merges.
+
+* H.J. Lu for his previous contributions to the steering committee, many x86
+ bug reports, prototype patches, and keeping the GNU/Linux ports working.
+
+* Greg McGary for random fixes and (someday) bounded pointers.
+
+* Andrew MacLeod for his ongoing work in building a real EH system,
+ various code generation improvements, work on the global optimizer, etc.
+
+* Vladimir Makarov for hacking some ugly i960 problems, PowerPC hacking
+ improvements to compile-time performance, overall knowledge and
+ direction in the area of instruction scheduling, design and
+ implementation of the automaton based instruction scheduler and
+ design and implementation of the integrated and local register allocators.
+
+* David Malcolm for his work on improving GCC diagnostics, JIT, self-tests
+ and unit testing.
+
+* Bob Manson for his behind the scenes work on dejagnu.
+
+* John Marino for contributing the DragonFly BSD port.
+
+* Philip Martin for lots of libstdc++ string and vector iterator fixes and
+ improvements, and string clean up and testsuites.
+
+* Michael Matz for his work on dominance tree discovery, the x86-64 port,
+ link-time optimization framework and general optimization improvements.
+
+* All of the Mauve project contributors for Java test code.
+
+* Bryce McKinlay for numerous GCJ and libgcj fixes and improvements.
+
+* Adam Megacz for his work on the Microsoft Windows port of GCJ.
+
+* Michael Meissner for LRS framework, ia32, m32r, v850, m88k, MIPS,
+ powerpc, haifa, ECOFF debug support, and other assorted hacking.
+
+* Jason Merrill for his direction via the steering committee and leading
+ the G++ effort.
+
+* Martin Michlmayr for testing GCC on several architectures using the
+ entire Debian archive.
+
+* David Miller for his direction via the steering committee, lots of
+ SPARC work, improvements in jump.cc and interfacing with the Linux kernel
+ developers.
+
+* Gary Miller ported GCC to Charles River Data Systems machines.
+
+* Alfred Minarik for libstdc++ string and ios bug fixes, and turning the
+ entire libstdc++ testsuite namespace-compatible.
+
+* Mark Mitchell for his direction via the steering committee, mountains of
+ C++ work, load/store hoisting out of loops, alias analysis improvements,
+ ISO C ``restrict`` support, and serving as release manager from 2000
+ to 2011.
+
+* Alan Modra for various GNU/Linux bits and testing.
+
+* Toon Moene for his direction via the steering committee, Fortran
+ maintenance, and his ongoing work to make us make Fortran run fast.
+
+* Jason Molenda for major help in the care and feeding of all the services
+ on the gcc.gnu.org (formerly egcs.cygnus.com) machine---mail, web
+ services, ftp services, etc etc. Doing all this work on scrap paper and
+ the backs of envelopes would have been... difficult.
+
+* Catherine Moore for fixing various ugly problems we have sent her
+ way, including the haifa bug which was killing the Alpha & PowerPC
+ Linux kernels.
+
+* Mike Moreton for his various Java patches.
+
+* David Mosberger-Tang for various Alpha improvements, and for the initial
+ IA-64 port.
+
+* Stephen Moshier contributed the floating point emulator that assists in
+ cross-compilation and permits support for floating point numbers wider
+ than 64 bits and for ISO C99 support.
+
+* Bill Moyer for his behind the scenes work on various issues.
+
+* Philippe De Muyter for his work on the m68k port.
+
+* Joseph S. Myers for his work on the PDP-11 port, format checking and ISO
+ C99 support, and continuous emphasis on (and contributions to) documentation.
+
+* Nathan Myers for his work on libstdc++-v3: architecture and authorship
+ through the first three snapshots, including implementation of locale
+ infrastructure, string, shadow C headers, and the initial project
+ documentation (DESIGN, CHECKLIST, and so forth). Later, more work on
+ MT-safe string and shadow headers.
+
+* Felix Natter for documentation on porting libstdc++.
+
+* Nathanael Nerode for cleaning up the configuration/build process.
+
+* NeXT, Inc. donated the front end that supports the Objective-C
+ language.
+
+* Hans-Peter Nilsson for the CRIS and MMIX ports, improvements to the search
+ engine setup, various documentation fixes and other small fixes.
+
+* Geoff Noer for his work on getting cygwin native builds working.
+
+* Vegard Nossum for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Diego Novillo for his work on Tree SSA, OpenMP, SPEC performance
+ tracking web pages, GIMPLE tuples, and assorted fixes.
+
+* David O'Brien for the FreeBSD/alpha, FreeBSD/AMD x86-64, FreeBSD/ARM,
+ FreeBSD/PowerPC, and FreeBSD/SPARC64 ports and related infrastructure
+ improvements.
+
+* Alexandre Oliva for various build infrastructure improvements, scripts and
+ amazing testing work, including keeping libtool issues sane and happy.
+
+* Stefan Olsson for work on mt_alloc.
+
+* Melissa O'Neill for various NeXT fixes.
+
+* Rainer Orth for random MIPS work, including improvements to GCC's o32
+ ABI support, improvements to dejagnu's MIPS support, Java configuration
+ clean-ups and porting work, and maintaining the IRIX, Solaris 2, and
+ Tru64 UNIX ports.
+
+* Steven Pemberton for his contribution of :samp:`enquire` which allowed GCC to
+ determine various properties of the floating point unit and generate
+ :samp:`float.h` in older versions of GCC.
+
+* Hartmut Penner for work on the s390 port.
+
+* Paul Petersen wrote the machine description for the Alliant FX/8.
+
+* Alexandre Petit-Bianco for implementing much of the Java compiler and
+ continued Java maintainership.
+
+* Matthias Pfaller for major improvements to the NS32k port.
+
+* Gerald Pfeifer for his direction via the steering committee, pointing
+ out lots of problems we need to solve, maintenance of the web pages, and
+ taking care of documentation maintenance in general.
+
+* Marek Polacek for his work on the C front end, the sanitizers and general
+ bug fixing.
+
+* Andrew Pinski for processing bug reports by the dozen.
+
+* Ovidiu Predescu for his work on the Objective-C front end and runtime
+ libraries.
+
+* Jerry Quinn for major performance improvements in C++ formatted I/O.
+
+* Ken Raeburn for various improvements to checker, MIPS ports and various
+ cleanups in the compiler.
+
+* Rolf W. Rasmussen for hacking on AWT.
+
+* David Reese of Sun Microsystems contributed to the Solaris on PowerPC
+ port.
+
+* John Regehr for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Volker Reichelt for running automated regression testing of GCC and reporting
+ numerous bugs and for keeping up with the problem reports.
+
+* Joern Rennecke for maintaining the sh port, loop, regmove & reload
+ hacking and developing and maintaining the Epiphany port.
+
+* Loren J. Rittle for improvements to libstdc++-v3 including the FreeBSD
+ port, threading fixes, thread-related configury changes, critical
+ threading documentation, and solutions to really tricky I/O problems,
+ as well as keeping GCC properly working on FreeBSD and continuous testing.
+
+* Craig Rodrigues for processing tons of bug reports.
+
+* Ola Rönnerup for work on mt_alloc.
+
+* Gavin Romig-Koch for lots of behind the scenes MIPS work.
+
+* David Ronis inspired and encouraged Craig to rewrite the G77
+ documentation in texinfo format by contributing a first pass at a
+ translation of the old :samp:`g77-0.5.16/f/DOC` file.
+
+* Ken Rose for fixes to GCC's delay slot filling code.
+
+* Ira Rosen for her contributions to the auto-vectorizer.
+
+* Paul Rubin wrote most of the preprocessor.
+
+* Pétur Runólfsson for major performance improvements in C++ formatted I/O and
+ large file support in C++ filebuf.
+
+* Chip Salzenberg for libstdc++ patches and improvements to locales, traits,
+ Makefiles, libio, libtool hackery, and 'long long' support.
+
+* Juha Sarlin for improvements to the H8 code generator.
+
+* Greg Satz assisted in making GCC work on HP-UX for the 9000 series 300.
+
+* Roger Sayle for improvements to constant folding and GCC's RTL optimizers
+ as well as for fixing numerous bugs.
+
+* Bradley Schatz for his work on the GCJ FAQ.
+
+* Peter Schauer wrote the code to allow debugging to work on the Alpha.
+
+* William Schelter did most of the work on the Intel 80386 support.
+
+* Tobias Schlüter for work on GNU Fortran.
+
+* Bernd Schmidt for various code generation improvements and major
+ work in the reload pass, serving as release manager for
+ GCC 2.95.3, and work on the Blackfin and C6X ports.
+
+* Peter Schmid for constant testing of libstdc++---especially application
+ testing, going above and beyond what was requested for the release
+ criteria---and libstdc++ header file tweaks.
+
+* Jason Schroeder for jcf-dump patches.
+
+* Andreas Schwab for his work on the m68k port.
+
+* Lars Segerlund for work on GNU Fortran.
+
+* Dodji Seketeli for numerous C++ bug fixes and debug info improvements.
+
+* Tim Shen for major work on ``<regex>``.
+
+* Joel Sherrill for his direction via the steering committee, RTEMS
+ contributions and RTEMS testing.
+
+* Nathan Sidwell for many C++ fixes/improvements.
+
+* Jeffrey Siegal for helping RMS with the original design of GCC, some
+ code which handles the parse tree and RTL data structures, constant
+ folding and help with the original VAX & m68k ports.
+
+* Kenny Simpson for prompting libstdc++ fixes due to defect reports from
+ the LWG (thereby keeping GCC in line with updates from the ISO).
+
+* Franz Sirl for his ongoing work with making the PPC port stable
+ for GNU/Linux.
+
+* Andrey Slepuhin for assorted AIX hacking.
+
+* Trevor Smigiel for contributing the SPU port.
+
+* Christopher Smith did the port for Convex machines.
+
+* Danny Smith for his major efforts on the Mingw (and Cygwin) ports.
+ Retired from GCC maintainership August 2010, having mentored two
+ new maintainers into the role.
+
+* Randy Smith finished the Sun FPA support.
+
+* Ed Smith-Rowland for his continuous work on libstdc++-v3, special functions,
+ ``<random>``, and various improvements to C++11 features.
+
+* Scott Snyder for queue, iterator, istream, and string fixes and libstdc++
+ testsuite entries. Also for providing the patch to G77 to add
+ rudimentary support for ``INTEGER*1``, ``INTEGER*2``, and
+ ``LOGICAL*1``.
+
+* Zdenek Sojka for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Arseny Solokha for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Jayant Sonar for contributing the CR16 port.
+
+* Brad Spencer for contributions to the GLIBCPP_FORCE_NEW technique.
+
+* Richard Stallman, for writing the original GCC and launching the GNU project.
+
+* Jan Stein of the Chalmers Computer Society provided support for
+ Genix, as well as part of the 32000 machine description.
+
+* Gerhard Steinmetz for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Nigel Stephens for various mips16 related fixes/improvements.
+
+* Jonathan Stone wrote the machine description for the Pyramid computer.
+
+* Graham Stott for various infrastructure improvements.
+
+* John Stracke for his Java HTTP protocol fixes.
+
+* Mike Stump for his Elxsi port, G++ contributions over the years and more
+ recently his vxworks contributions
+
+* Jeff Sturm for Java porting help, bug fixes, and encouragement.
+
+* Zhendong Su for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Chengnian Sun for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Shigeya Suzuki for this fixes for the bsdi platforms.
+
+* Ian Lance Taylor for the Go frontend, the initial mips16 and mips64
+ support, general configury hacking, fixincludes, etc.
+
+* Holger Teutsch provided the support for the Clipper CPU.
+
+* Gary Thomas for his ongoing work to make the PPC work for GNU/Linux.
+
+* Paul Thomas for contributions to GNU Fortran.
+
+* Philipp Thomas for random bug fixes throughout the compiler
+
+* Jason Thorpe for thread support in libstdc++ on NetBSD.
+
+* Kresten Krab Thorup wrote the run time support for the Objective-C
+ language and the fantastic Java bytecode interpreter.
+
+* Michael Tiemann for random bug fixes, the first instruction scheduler,
+ initial C++ support, function integration, NS32k, SPARC and M88k
+ machine description work, delay slot scheduling.
+
+* Andreas Tobler for his work porting libgcj to Darwin.
+
+* Teemu Torma for thread safe exception handling support.
+
+* Leonard Tower wrote parts of the parser, RTL generator, and RTL
+ definitions, and of the VAX machine description.
+
+* Daniel Towner and Hariharan Sandanagobalane contributed and
+ maintain the picoChip port.
+
+* Tom Tromey for internationalization support and for his many Java
+ contributions and libgcj maintainership.
+
+* Lassi Tuura for improvements to config.guess to determine HP processor
+ types.
+
+* Petter Urkedal for libstdc++ CXXFLAGS, math, and algorithms fixes.
+
+* Andy Vaught for the design and initial implementation of the GNU Fortran
+ front end.
+
+* Brent Verner for work with the libstdc++ cshadow files and their
+ associated configure steps.
+
+* Todd Vierling for contributions for NetBSD ports.
+
+* Andrew Waterman for contributing the RISC-V port, as well as maintaining it.
+
+* Jonathan Wakely for contributing libstdc++ Doxygen notes and XHTML
+ guidance and maintaining libstdc++.
+
+* Dean Wakerley for converting the install documentation from HTML to texinfo
+ in time for GCC 3.0.
+
+* Krister Walfridsson for random bug fixes.
+
+* Feng Wang for contributions to GNU Fortran.
+
+* Stephen M. Webb for time and effort on making libstdc++ shadow files
+ work with the tricky Solaris 8+ headers, and for pushing the build-time
+ header tree. Also, for starting and driving the ``<regex>`` effort.
+
+* John Wehle for various improvements for the x86 code generator,
+ related infrastructure improvements to help x86 code generation,
+ value range propagation and other work, WE32k port.
+
+* Ulrich Weigand for work on the s390 port.
+
+* Janus Weil for contributions to GNU Fortran.
+
+* Zack Weinberg for major work on cpplib and various other bug fixes.
+
+* Matt Welsh for help with Linux Threads support in GCJ.
+
+* Urban Widmark for help fixing java.io.
+
+* Mark Wielaard for new Java library code and his work integrating with
+ Classpath.
+
+* Dale Wiles helped port GCC to the Tahoe.
+
+* Bob Wilson from Tensilica, Inc. for the Xtensa port.
+
+* Jim Wilson for his direction via the steering committee, tackling hard
+ problems in various places that nobody else wanted to work on, strength
+ reduction and other loop optimizations.
+
+* Paul Woegerer and Tal Agmon for the CRX port.
+
+* Carlo Wood for various fixes.
+
+* Tom Wood for work on the m88k port.
+
+* Chung-Ju Wu for his work on the Andes NDS32 port.
+
+* Canqun Yang for work on GNU Fortran.
+
+* Masanobu Yuhara of Fujitsu Laboratories implemented the machine
+ description for the Tron architecture (specifically, the Gmicro).
+
+* Kevin Zachmann helped port GCC to the Tahoe.
+
+* Ayal Zaks for Swing Modulo Scheduling (SMS).
+
+* Qirun Zhang for running automated regression testing of GCC and reporting
+ numerous bugs.
+
+* Xiaoqiang Zhang for work on GNU Fortran.
+
+* Gilles Zunino for help porting Java to Irix.
+
+The following people are recognized for their contributions to GNAT,
+the Ada front end of GCC:
+
+* Bernard Banner
+
+* Romain Berrendonner
+
+* Geert Bosch
+
+* Emmanuel Briot
+
+* Joel Brobecker
+
+* Ben Brosgol
+
+* Vincent Celier
+
+* Arnaud Charlet
+
+* Chien Chieng
+
+* Cyrille Comar
+
+* Cyrille Crozes
+
+* Robert Dewar
+
+* Gary Dismukes
+
+* Robert Duff
+
+* Ed Falis
+
+* Ramon Fernandez
+
+* Sam Figueroa
+
+* Vasiliy Fofanov
+
+* Michael Friess
+
+* Franco Gasperoni
+
+* Ted Giering
+
+* Matthew Gingell
+
+* Laurent Guerby
+
+* Jerome Guitton
+
+* Olivier Hainque
+
+* Jerome Hugues
+
+* Hristian Kirtchev
+
+* Jerome Lambourg
+
+* Bruno Leclerc
+
+* Albert Lee
+
+* Sean McNeil
+
+* Javier Miranda
+
+* Laurent Nana
+
+* Pascal Obry
+
+* Dong-Ik Oh
+
+* Laurent Pautet
+
+* Brett Porter
+
+* Thomas Quinot
+
+* Nicolas Roche
+
+* Pat Rogers
+
+* Jose Ruiz
+
+* Douglas Rupp
+
+* Sergey Rybin
+
+* Gail Schenker
+
+* Ed Schonberg
+
+* Nicolas Setton
+
+* Samuel Tardieu
+
+The following people are recognized for their contributions of new
+features, bug reports, testing and integration of classpath/libgcj for
+GCC version 4.1:
+
+* Lillian Angel for ``JTree`` implementation and lots Free Swing
+ additions and bug fixes.
+
+* Wolfgang Baer for ``GapContent`` bug fixes.
+
+* Anthony Balkissoon for ``JList``, Free Swing 1.5 updates and mouse event
+ fixes, lots of Free Swing work including ``JTable`` editing.
+
+* Stuart Ballard for RMI constant fixes.
+
+* Goffredo Baroncelli for ``HTTPURLConnection`` fixes.
+
+* Gary Benson for ``MessageFormat`` fixes.
+
+* Daniel Bonniot for ``Serialization`` fixes.
+
+* Chris Burdess for lots of gnu.xml and http protocol fixes, ``StAX``
+ and ``DOM xml:id`` support.
+
+* Ka-Hing Cheung for ``TreePath`` and ``TreeSelection`` fixes.
+
+* Archie Cobbs for build fixes, VM interface updates,
+ ``URLClassLoader`` updates.
+
+* Kelley Cook for build fixes.
+
+* Martin Cordova for Suggestions for better ``SocketTimeoutException``.
+
+* David Daney for ``BitSet`` bug fixes, ``HttpURLConnection``
+ rewrite and improvements.
+
+* Thomas Fitzsimmons for lots of upgrades to the gtk+ AWT and Cairo 2D
+ support. Lots of imageio framework additions, lots of AWT and Free
+ Swing bug fixes.
+
+* Jeroen Frijters for ``ClassLoader`` and nio cleanups, serialization fixes,
+ better ``Proxy`` support, bug fixes and IKVM integration.
+
+* Santiago Gala for ``AccessControlContext`` fixes.
+
+* Nicolas Geoffray for ``VMClassLoader`` and ``AccessController``
+ improvements.
+
+* David Gilbert for ``basic`` and ``metal`` icon and plaf support
+ and lots of documenting, Lots of Free Swing and metal theme
+ additions. ``MetalIconFactory`` implementation.
+
+* Anthony Green for ``MIDI`` framework, ``ALSA`` and ``DSSI``
+ providers.
+
+* Andrew Haley for ``Serialization`` and ``URLClassLoader`` fixes,
+ gcj build speedups.
+
+* Kim Ho for ``JFileChooser`` implementation.
+
+* Andrew John Hughes for ``Locale`` and net fixes, URI RFC2986
+ updates, ``Serialization`` fixes, ``Properties`` XML support and
+ generic branch work, VMIntegration guide update.
+
+* Bastiaan Huisman for ``TimeZone`` bug fixing.
+
+* Andreas Jaeger for mprec updates.
+
+* Paul Jenner for better :option:`-Werror` support.
+
+* Ito Kazumitsu for ``NetworkInterface`` implementation and updates.
+
+* Roman Kennke for ``BoxLayout``, ``GrayFilter`` and
+ ``SplitPane``, plus bug fixes all over. Lots of Free Swing work
+ including styled text.
+
+* Simon Kitching for ``String`` cleanups and optimization suggestions.
+
+* Michael Koch for configuration fixes, ``Locale`` updates, bug and
+ build fixes.
+
+* Guilhem Lavaux for configuration, thread and channel fixes and Kaffe
+ integration. JCL native ``Pointer`` updates. Logger bug fixes.
+
+* David Lichteblau for JCL support library global/local reference
+ cleanups.
+
+* Aaron Luchko for JDWP updates and documentation fixes.
+
+* Ziga Mahkovec for ``Graphics2D`` upgraded to Cairo 0.5 and new regex
+ features.
+
+* Sven de Marothy for BMP imageio support, CSS and ``TextLayout``
+ fixes. ``GtkImage`` rewrite, 2D, awt, free swing and date/time fixes and
+ implementing the Qt4 peers.
+
+* Casey Marshall for crypto algorithm fixes, ``FileChannel`` lock,
+ ``SystemLogger`` and ``FileHandler`` rotate implementations, NIO
+ ``FileChannel.map`` support, security and policy updates.
+
+* Bryce McKinlay for RMI work.
+
+* Audrius Meskauskas for lots of Free Corba, RMI and HTML work plus
+ testing and documenting.
+
+* Kalle Olavi Niemitalo for build fixes.
+
+* Rainer Orth for build fixes.
+
+* Andrew Overholt for ``File`` locking fixes.
+
+* Ingo Proetel for ``Image``, ``Logger`` and ``URLClassLoader``
+ updates.
+
+* Olga Rodimina for ``MenuSelectionManager`` implementation.
+
+* Jan Roehrich for ``BasicTreeUI`` and ``JTree`` fixes.
+
+* Julian Scheid for documentation updates and gjdoc support.
+
+* Christian Schlichtherle for zip fixes and cleanups.
+
+* Robert Schuster for documentation updates and beans fixes,
+ ``TreeNode`` enumerations and ``ActionCommand`` and various
+ fixes, XML and URL, AWT and Free Swing bug fixes.
+
+* Keith Seitz for lots of JDWP work.
+
+* Christian Thalinger for 64-bit cleanups, Configuration and VM
+ interface fixes and ``CACAO`` integration, ``fdlibm`` updates.
+
+* Gael Thomas for ``VMClassLoader`` boot packages support suggestions.
+
+* Andreas Tobler for Darwin and Solaris testing and fixing, ``Qt4``
+ support for Darwin/OS X, ``Graphics2D`` support, ``gtk+``
+ updates.
+
+* Dalibor Topic for better ``DEBUG`` support, build cleanups and
+ Kaffe integration. ``Qt4`` build infrastructure, ``SHA1PRNG``
+ and ``GdkPixbugDecoder`` updates.
+
+* Tom Tromey for Eclipse integration, generics work, lots of bug fixes
+ and gcj integration including coordinating The Big Merge.
+
+* Mark Wielaard for bug fixes, packaging and release management,
+ ``Clipboard`` implementation, system call interrupts and network
+ timeouts and ``GdkPixpufDecoder`` fixes.
+
+In addition to the above, all of which also contributed time and energy in
+testing GCC, we would like to thank the following for their contributions
+to testing:
+
+* Michael Abd-El-Malek
+
+* Thomas Arend
+
+* Bonzo Armstrong
+
+* Steven Ashe
+
+* Chris Baldwin
+
+* David Billinghurst
+
+* Jim Blandy
+
+* Stephane Bortzmeyer
+
+* Horst von Brand
+
+* Frank Braun
+
+* Rodney Brown
+
+* Sidney Cadot
+
+* Bradford Castalia
+
+* Robert Clark
+
+* Jonathan Corbet
+
+* Ralph Doncaster
+
+* Richard Emberson
+
+* Levente Farkas
+
+* Graham Fawcett
+
+* Mark Fernyhough
+
+* Robert A. French
+
+* Jörgen Freyh
+
+* Mark K. Gardner
+
+* Charles-Antoine Gauthier
+
+* Yung Shing Gene
+
+* David Gilbert
+
+* Simon Gornall
+
+* Fred Gray
+
+* John Griffin
+
+* Patrik Hagglund
+
+* Phil Hargett
+
+* Amancio Hasty
+
+* Takafumi Hayashi
+
+* Bryan W. Headley
+
+* Kevin B. Hendricks
+
+* Joep Jansen
+
+* Christian Joensson
+
+* Michel Kern
+
+* David Kidd
+
+* Tobias Kuipers
+
+* Anand Krishnaswamy
+
+* A.O.V. Le Blanc
+
+* llewelly
+
+* Damon Love
+
+* Brad Lucier
+
+* Matthias Klose
+
+* Martin Knoblauch
+
+* Rick Lutowski
+
+* Jesse Macnish
+
+* Stefan Morrell
+
+* Anon A. Mous
+
+* Matthias Mueller
+
+* Pekka Nikander
+
+* Rick Niles
+
+* Jon Olson
+
+* Magnus Persson
+
+* Chris Pollard
+
+* Richard Polton
+
+* Derk Reefman
+
+* David Rees
+
+* Paul Reilly
+
+* Tom Reilly
+
+* Torsten Rueger
+
+* Danny Sadinoff
+
+* Marc Schifer
+
+* Erik Schnetter
+
+* Wayne K. Schroll
+
+* David Schuler
+
+* Vin Shelton
+
+* Tim Souder
+
+* Adam Sulmicki
+
+* Bill Thorson
+
+* George Talbot
+
+* Pedro A. M. Vazquez
+
+* Gregory Warnes
+
+* Ian Watson
+
+* David E. Young
+
+* And many others
+
+And finally we'd like to thank everyone who uses the compiler, provides
+feedback and generally reminds us why we're doing this work in the first
+place.
\ No newline at end of file
diff --git a/doc/contribute.rst b/doc/contribute.rst
new file mode 100644
index 00000000000..35770fabb7a
--- /dev/null
+++ b/doc/contribute.rst
@@ -0,0 +1,21 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _contributing:
+
+Contributing to GCC Development
+-------------------------------
+
+If you would like to help pretest GCC releases to assure they work well,
+current development sources are available via Git (see
+https://gcc.gnu.org/git.html). Source and binary snapshots are
+also available for FTP; see https://gcc.gnu.org/snapshots.html.
+
+If you would like to work on improvements to GCC, please read the
+advice at these URLs: https://gcc.gnu.org/contribute.html, https://gcc.gnu.org/contributewhy.html.
+
+for information on how to make useful contributions and avoid
+duplication of effort. Suggested projects are listed at
+https://gcc.gnu.org/projects/.
\ No newline at end of file
diff --git a/doc/cppdiropts.rst b/doc/cppdiropts.rst
new file mode 100644
index 00000000000..51a94c55168
--- /dev/null
+++ b/doc/cppdiropts.rst
@@ -0,0 +1,217 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. option:: -I {dir}, -iquote {dir}, -isystem {dir}, -idirafter {dir}
+
+ Add the directory :samp:`{dir}` to the list of directories to be searched
+ for header files during preprocessing.
+
+ .. only:: cpp
+
+ See :ref:`search-path`.
+
+ If :samp:`{dir}` begins with :samp:`=` or ``$SYSROOT``, then the :samp:`=`
+ or ``$SYSROOT`` is replaced by the sysroot prefix; see
+ :option:`--sysroot` and :option:`-isysroot`.
+
+ Directories specified with :option:`-iquote` apply only to the quote
+ form of the directive, ``#include "file"``.
+ Directories specified with :option:`-I`, :option:`-isystem`,
+ or :option:`-idirafter` apply to lookup for both the
+ ``#include "file"`` and
+ ``#include <file>`` directives.
+
+ You can specify any number or combination of these options on the
+ command line to search for header files in several directories.
+ The lookup order is as follows:
+
+ * For the quote form of the include directive, the directory of the current
+ file is searched first.
+
+ * For the quote form of the include directive, the directories specified
+ by :option:`-iquote` options are searched in left-to-right order,
+ as they appear on the command line.
+
+ * Directories specified with :option:`-I` options are scanned in
+ left-to-right order.
+
+ * Directories specified with :option:`-isystem` options are scanned in
+ left-to-right order.
+
+ * Standard system directories are scanned.
+
+ * Directories specified with :option:`-idirafter` options are scanned in
+ left-to-right order.
+
+ You can use :option:`-I` to override a system header
+ file, substituting your own version, since these directories are
+ searched before the standard system header file directories.
+ However, you should
+ not use this option to add directories that contain vendor-supplied
+ system header files; use :option:`-isystem` for that.
+
+ The :option:`-isystem` and :option:`-idirafter` options also mark the directory
+ as a system directory, so that it gets the same special treatment that
+ is applied to the standard system directories.
+
+ .. only:: cpp
+
+ See :ref:`system-headers`.
+
+
+ If a standard system include directory, or a directory specified with
+ :option:`-isystem`, is also specified with :option:`-I`, the :option:`-I`
+ option is ignored. The directory is still searched but as a
+ system directory at its normal position in the system include chain.
+ This is to ensure that GCC's procedure to fix buggy system headers and
+ the ordering for the ``#include_next`` directive are not inadvertently
+ changed.
+ If you really need to change the search order for system directories,
+ use the :option:`-nostdinc` and/or :option:`-isystem` options.
+
+ .. only:: cpp
+
+ See :ref:`system-headers`.
+
+
+.. option:: -I-
+
+ Split the include path.
+ This option has been deprecated. Please use :option:`-iquote` instead for
+ :option:`-I` directories before the :option:`-I-` and remove the :option:`-I-`
+ option.
+
+ Any directories specified with :option:`-I`
+ options before :option:`-I-` are searched only for headers requested with
+ ``#include "file"`` ; they are not searched for
+ ``#include <file>``. If additional directories are
+ specified with :option:`-I` options after the :option:`-I-`, those
+ directories are searched for all :samp:`#include` directives.
+
+ In addition, :option:`-I-` inhibits the use of the directory of the current
+ file directory as the first search directory for ``#include
+ "file"``. There is no way to override this effect of :option:`-I-`.
+
+ .. only:: cpp
+
+ See :ref:`search-path`.
+
+
+.. option:: -iprefix {prefix}
+
+ Specify :samp:`{prefix}` as the prefix for subsequent :option:`-iwithprefix`
+ options. If the prefix represents a directory, you should include the
+ final :samp:`/`.
+
+.. option:: -iwithprefix {dir}, -iwithprefixbefore {dir}
+
+ Append :samp:`{dir}` to the prefix specified previously with
+ :option:`-iprefix`, and add the resulting directory to the include search
+ path. :option:`-iwithprefixbefore` puts it in the same place :option:`-I`
+ would; :option:`-iwithprefix` puts it where :option:`-idirafter` would.
+
+.. option:: -isysroot {dir}
+
+ This option is like the :option:`--sysroot` option, but applies only to
+ header files (except for Darwin targets, where it applies to both header
+ files and libraries). See the :option:`--sysroot` option for more
+ information.
+
+.. option:: -imultilib {dir}
+
+ Use :samp:`{dir}` as a subdirectory of the directory containing
+ target-specific C++ headers.
+
+.. option:: -nostdinc
+
+ Do not search the standard system directories for header files.
+ Only the directories explicitly specified with :option:`-I`,
+ :option:`-iquote`, :option:`-isystem`, and/or :option:`-idirafter`
+ options (and the directory of the current file, if appropriate)
+ are searched.
+
+.. option:: -nostdinc++
+
+ Do not search for header files in the C++-specific standard directories,
+ but do still search the other standard directories. (This option is
+ used when building the C++ library.)
+
+.. option:: -Wcomment, -Wcomments
+
+ Warn whenever a comment-start sequence :samp:`/*` appears in a :samp:`/*`
+ comment, or whenever a backslash-newline appears in a :samp:`//` comment.
+ This warning is enabled by :option:`-Wall`.
+
+.. option:: -Wtrigraphs
+
+.. _wtrigraphs:
+
+ Warn if any trigraphs are encountered that might change the meaning of
+ the program. Trigraphs within comments are not warned about,
+ except those that would form escaped newlines.
+
+ This option is implied by :option:`-Wall`. If :option:`-Wall` is not
+ given, this option is still enabled unless trigraphs are enabled. To
+ get trigraph conversion without warnings, but get the other
+ :option:`-Wall` warnings, use :samp:`-trigraphs -Wall -Wno-trigraphs`.
+
+.. option:: -Wundef
+
+ Warn if an undefined identifier is evaluated in an ``#if`` directive.
+ Such identifiers are replaced with zero.
+
+.. option:: -Wno-undef
+
+ Default setting; overrides :option:`-Wundef`.
+
+.. option:: -Wexpansion-to-defined
+
+ Warn whenever :samp:`defined` is encountered in the expansion of a macro
+ (including the case where the macro is expanded by an :samp:`#if` directive).
+ Such usage is not portable.
+ This warning is also enabled by :option:`-Wpedantic` and :option:`-Wextra`.
+
+.. option:: -Wunused-macros
+
+ Warn about macros defined in the main file that are unused. A macro
+ is :dfn:`used` if it is expanded or tested for existence at least once.
+ The preprocessor also warns if the macro has not been used at the
+ time it is redefined or undefined.
+
+ Built-in macros, macros defined on the command line, and macros
+ defined in include files are not warned about.
+
+ .. note::
+
+ If a macro is actually used, but only used in skipped
+ conditional blocks, then the preprocessor reports it as unused. To avoid the
+ warning in such a case, you might improve the scope of the macro's
+ definition by, for example, moving it into the first skipped block.
+ Alternatively, you could provide a dummy use with something like:
+
+ .. code-block:: c++
+
+ #if defined the_macro_causing_the_warning
+ #endif
+
+.. option:: -Wno-endif-labels
+
+ Do not warn whenever an ``#else`` or an ``#endif`` are followed by text.
+ This sometimes happens in older programs with code of the form
+
+ .. code-block:: c++
+
+ #if FOO
+ ...
+ #else FOO
+ ...
+ #endif FOO
+
+ The second and third ``FOO`` should be in comments.
+ This warning is on by default.
+
+.. option:: -Wendif-labels
+
+ Default setting; overrides :option:`-Wno-endif-labels`.
\ No newline at end of file
diff --git a/doc/cppenv.rst b/doc/cppenv.rst
new file mode 100644
index 00000000000..18bdb2dc418
--- /dev/null
+++ b/doc/cppenv.rst
@@ -0,0 +1,97 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. envvar:: CPATH, C_INCLUDE_PATH, CPLUS_INCLUDE_PATH, OBJC_INCLUDE_PATH
+
+ .. Commented out until ObjC++ is part of GCC:
+ @itemx OBJCPLUS_INCLUDE_PATH
+
+ Each variable's value is a list of directories separated by a special
+ character, much like :envvar:`PATH`, in which to look for header files.
+ The special character, ``PATH_SEPARATOR``, is target-dependent and
+ determined at GCC build time. For Microsoft Windows-based targets it is a
+ semicolon, and for almost all other targets it is a colon.
+
+ :envvar:`CPATH` specifies a list of directories to be searched as if
+ specified with :option:`-I`, but after any paths given with :option:`-I`
+ options on the command line. This environment variable is used
+ regardless of which language is being preprocessed.
+
+ The remaining environment variables apply only when preprocessing the
+ particular language indicated. Each specifies a list of directories
+ to be searched as if specified with :option:`-isystem`, but after any
+ paths given with :option:`-isystem` options on the command line.
+
+ In all these variables, an empty element instructs the compiler to
+ search its current working directory. Empty elements can appear at the
+ beginning or end of a path. For instance, if the value of
+ :envvar:`CPATH` is ``:/special/include``, that has the same
+ effect as :samp:`-I. -I/special/include`.
+
+ .. only:: cpp
+
+ See also :ref:`search-path`.
+
+.. index:: dependencies for make as output
+
+.. envvar:: DEPENDENCIES_OUTPUT
+
+ If this variable is set, its value specifies how to output
+ dependencies for Make based on the non-system header files processed
+ by the compiler. System header files are ignored in the dependency
+ output.
+
+ The value of :envvar:`DEPENDENCIES_OUTPUT` can be just a file name, in
+ which case the Make rules are written to that file, guessing the target
+ name from the source file name. Or the value can have the form
+ :samp:`{file}{target}`, in which case the rules are written to
+ file :samp:`{file}` using :samp:`{target}` as the target name.
+
+ In other words, this environment variable is equivalent to combining
+ the options :option:`-MM` and :option:`-MF`
+
+ .. only:: cpp
+
+ (see :ref:`invocation`),
+
+ .. only:: not cpp
+
+ (see :ref:`preprocessor-options`),
+
+ with an optional :option:`-MT` switch too.
+
+.. index:: dependencies for make as output
+
+.. envvar:: SUNPRO_DEPENDENCIES
+
+ This variable is the same as :envvar:`DEPENDENCIES_OUTPUT` (see above),
+ except that system header files are not ignored, so it implies
+ :option:`-M` rather than :option:`-MM`. However, the dependence on the
+ main input file is omitted.
+
+ .. only:: cpp
+
+ See :ref:`invocation`.
+
+ .. only:: not cpp
+
+ See :ref:`preprocessor-options`.
+
+.. envvar:: SOURCE_DATE_EPOCH
+
+ If this variable is set, its value specifies a UNIX timestamp to be
+ used in replacement of the current date and time in the ``__DATE__``
+ and ``__TIME__`` macros, so that the embedded timestamps become
+ reproducible.
+
+ The value of :envvar:`SOURCE_DATE_EPOCH` must be a UNIX timestamp,
+ defined as the number of seconds (excluding leap seconds) since
+ 01 Jan 1970 00:00:00 represented in ASCII; identical to the output of
+ ``date +%s`` on GNU/Linux and other systems that support the
+ ``%s`` extension in the ``date`` command.
+
+ The value should be a known timestamp such as the last modification
+ time of the source or package and it should be set by the build
+ process.
\ No newline at end of file
diff --git a/doc/cppopts.rst b/doc/cppopts.rst
new file mode 100644
index 00000000000..977dbaac331
--- /dev/null
+++ b/doc/cppopts.rst
@@ -0,0 +1,555 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. option:: -D {name}
+
+ Predefine :samp:`{name}` as a macro, with definition ``1``.
+
+.. option:: -D name=definition
+
+ The contents of :samp:`{definition}` are tokenized and processed as if
+ they appeared during translation phase three in a :samp:`#define`
+ directive. In particular, the definition is truncated by
+ embedded newline characters.
+
+ If you are invoking the preprocessor from a shell or shell-like
+ program you may need to use the shell's quoting syntax to protect
+ characters such as spaces that have a meaning in the shell syntax.
+
+ If you wish to define a function-like macro on the command line, write
+ its argument list with surrounding parentheses before the equals sign
+ (if any). Parentheses are meaningful to most shells, so you should
+ quote the option. With :command:`sh` and :command:`csh`,
+ :option:`-D'`:samp:`{name}(args...)={definition}` works.
+
+ :option:`-D` and :option:`-U` options are processed in the order they
+ are given on the command line. All :option:`-imacros` :samp:`{file}` and
+ :option:`-include` :samp:`{file}` options are processed after all
+ :option:`-D` and :option:`-U` options.
+
+.. option:: -U {name}
+
+ Cancel any previous definition of :samp:`{name}`, either built in or
+ provided with a :option:`-D` option.
+
+.. option:: -include {file}
+
+ Process :samp:`{file}` as if ``#include "file"`` appeared as the first
+ line of the primary source file. However, the first directory searched
+ for :samp:`{file}` is the preprocessor's working directory *instead of*
+ the directory containing the main source file. If not found there, it
+ is searched for in the remainder of the ``#include "..."`` search
+ chain as normal.
+
+ If multiple :option:`-include` options are given, the files are included
+ in the order they appear on the command line.
+
+.. option:: -imacros {file}
+
+ Exactly like :option:`-include`, except that any output produced by
+ scanning :samp:`{file}` is thrown away. Macros it defines remain defined.
+ This allows you to acquire all the macros from a header without also
+ processing its declarations.
+
+ All files specified by :option:`-imacros` are processed before all files
+ specified by :option:`-include`.
+
+.. option:: -undef
+
+ Do not predefine any system-specific or GCC-specific macros. The
+ standard predefined macros remain defined.
+
+ .. only:: cpp
+
+ See :ref:`standard-predefined-macros`.
+
+.. option:: -pthread
+
+ Define additional macros required for using the POSIX threads library.
+ You should use this option consistently for both compilation and linking.
+ This option is supported on GNU/Linux targets, most other Unix derivatives,
+ and also on x86 Cygwin and MinGW targets.
+
+.. index:: make, dependencies, make
+
+.. option:: -M
+
+ Instead of outputting the result of preprocessing, output a rule
+ suitable for :command:`make` describing the dependencies of the main
+ source file. The preprocessor outputs one :command:`make` rule containing
+ the object file name for that source file, a colon, and the names of all
+ the included files, including those coming from :option:`-include` or
+ :option:`-imacros` command-line options.
+
+ Unless specified explicitly (with :option:`-MT` or :option:`-MQ`), the
+ object file name consists of the name of the source file with any
+ suffix replaced with object file suffix and with any leading directory
+ parts removed. If there are many included files then the rule is
+ split into several lines using :samp:`\\` -newline. The rule has no
+ commands.
+
+ This option does not suppress the preprocessor's debug output, such as
+ :option:`-dM`. To avoid mixing such debug output with the dependency
+ rules you should explicitly specify the dependency output file with
+ :option:`-MF`, or use an environment variable like
+ :envvar:`DEPENDENCIES_OUTPUT` (see :ref:`environment-variables`). Debug output
+ is still sent to the regular output stream as normal.
+
+ Passing :option:`-M` to the driver implies :option:`-E`, and suppresses
+ warnings with an implicit :option:`-w`.
+
+.. option:: -MM
+
+ Like :option:`-M` but do not mention header files that are found in
+ system header directories, nor header files that are included,
+ directly or indirectly, from such a header.
+
+ This implies that the choice of angle brackets or double quotes in an
+ :samp:`#include` directive does not in itself determine whether that
+ header appears in :option:`-MM` dependency output.
+
+.. option:: -MF {file}
+
+ When used with :option:`-M` or :option:`-MM`, specifies a
+ file to write the dependencies to. If no :option:`-MF` switch is given
+ the preprocessor sends the rules to the same place it would send
+ preprocessed output.
+
+ When used with the driver options :option:`-MD` or :option:`-MMD`,
+ :option:`-MF` overrides the default dependency output file.
+
+ If :samp:`{file}` is :samp:`-`, then the dependencies are written to :samp:`stdout`.
+
+.. option:: -MG
+
+ In conjunction with an option such as :option:`-M` requesting
+ dependency generation, :option:`-MG` assumes missing header files are
+ generated files and adds them to the dependency list without raising
+ an error. The dependency filename is taken directly from the
+ ``#include`` directive without prepending any path. :option:`-MG`
+ also suppresses preprocessed output, as a missing header file renders
+ this useless.
+
+ This feature is used in automatic updating of makefiles.
+
+.. option:: -Mno-modules
+
+ Disable dependency generation for compiled module interfaces.
+
+.. option:: -MP
+
+ This option instructs CPP to add a phony target for each dependency
+ other than the main file, causing each to depend on nothing. These
+ dummy rules work around errors :command:`make` gives if you remove header
+ files without updating the :samp:`Makefile` to match.
+
+ This is typical output:
+
+ .. code-block:: c++
+
+ test.o: test.c test.h
+
+ test.h:
+
+.. option:: -MT {target}
+
+ Change the target of the rule emitted by dependency generation. By
+ default CPP takes the name of the main input file, deletes any
+ directory components and any file suffix such as :samp:`.c`, and
+ appends the platform's usual object suffix. The result is the target.
+
+ An :option:`-MT` option sets the target to be exactly the string you
+ specify. If you want multiple targets, you can specify them as a single
+ argument to :option:`-MT`, or use multiple :option:`-MT` options.
+
+ For example, ``-MT '$(objpfx)foo.o'`` might give
+
+ .. code-block:: c++
+
+ $(objpfx)foo.o: foo.c
+
+.. option:: -MQ {target}
+
+ Same as :option:`-MT`, but it quotes any characters which are special to
+ Make. ``-MQ '$(objpfx)foo.o'`` gives
+
+ .. code-block:: c++
+
+ $$(objpfx)foo.o: foo.c
+
+ The default target is automatically quoted, as if it were given with
+ :option:`-MQ`.
+
+.. option:: -MD
+
+ :option:`-MD` is equivalent to :option:`-M -MF` :samp:`{file}`, except that
+ :option:`-E` is not implied. The driver determines :samp:`{file}` based on
+ whether an :option:`-o` option is given. If it is, the driver uses its
+ argument but with a suffix of :samp:`.d`, otherwise it takes the name
+ of the input file, removes any directory components and suffix, and
+ applies a :samp:`.d` suffix.
+
+ If :option:`-MD` is used in conjunction with :option:`-E`, any
+ :option:`-o` switch is understood to specify the dependency output file
+ (see :option:`-MF`), but if used without :option:`-E`, each :option:`-o`
+ is understood to specify a target object file.
+
+ Since :option:`-E` is not implied, :option:`-MD` can be used to generate
+ a dependency output file as a side effect of the compilation process.
+
+.. option:: -MMD
+
+ Like :option:`-MD` except mention only user header files, not system
+ header files.
+
+.. option:: -fpreprocessed
+
+ Indicate to the preprocessor that the input file has already been
+ preprocessed. This suppresses things like macro expansion, trigraph
+ conversion, escaped newline splicing, and processing of most directives.
+ The preprocessor still recognizes and removes comments, so that you can
+ pass a file preprocessed with :option:`-C` to the compiler without
+ problems. In this mode the integrated preprocessor is little more than
+ a tokenizer for the front ends.
+
+ :option:`-fpreprocessed` is implicit if the input file has one of the
+ extensions :samp:`.i`, :samp:`.ii` or :samp:`.mi`. These are the
+ extensions that GCC uses for preprocessed files created by
+ :option:`-save-temps`.
+
+.. option:: -fdirectives-only
+
+ When preprocessing, handle directives, but do not expand macros.
+
+ The option's behavior depends on the :option:`-E` and :option:`-fpreprocessed`
+ options.
+
+ With :option:`-E`, preprocessing is limited to the handling of directives
+ such as ``#define``, ``#ifdef``, and ``#error``. Other
+ preprocessor operations, such as macro expansion and trigraph
+ conversion are not performed. In addition, the :option:`-dD` option is
+ implicitly enabled.
+
+ With :option:`-fpreprocessed`, predefinition of command line and most
+ builtin macros is disabled. Macros such as ``__LINE__``, which are
+ contextually dependent, are handled normally. This enables compilation of
+ files previously preprocessed with ``-E -fdirectives-only``.
+
+ With both :option:`-E` and :option:`-fpreprocessed`, the rules for
+ :option:`-fpreprocessed` take precedence. This enables full preprocessing of
+ files previously preprocessed with ``-E -fdirectives-only``.
+
+.. option:: -fdollars-in-identifiers
+
+ Accept :samp:`$` in identifiers.
+
+ .. only:: cpp
+
+ See :ref:`identifier-characters`.
+
+.. option:: -fextended-identifiers
+
+ Accept universal character names and extended characters in
+ identifiers. This option is enabled by default for C99 (and later C
+ standard versions) and C++.
+
+.. option:: -fno-canonical-system-headers
+
+ When preprocessing, do not shorten system header paths with canonicalization.
+
+.. option:: -fmax-include-depth={depth}
+
+ Set the maximum depth of the nested #include. The default is 200.
+
+.. option:: -ftabstop={width}
+
+ Set the distance between tab stops. This helps the preprocessor report
+ correct column numbers in warnings or errors, even if tabs appear on the
+ line. If the value is less than 1 or greater than 100, the option is
+ ignored. The default is 8.
+
+.. option:: -ftrack-macro-expansion[={level}]
+
+ Track locations of tokens across macro expansions. This allows the
+ compiler to emit diagnostic about the current macro expansion stack
+ when a compilation error occurs in a macro expansion. Using this
+ option makes the preprocessor and the compiler consume more
+ memory. The :samp:`{level}` parameter can be used to choose the level of
+ precision of token location tracking thus decreasing the memory
+ consumption if necessary. Value :samp:`0` of :samp:`{level}` de-activates
+ this option. Value :samp:`1` tracks tokens locations in a
+ degraded mode for the sake of minimal memory overhead. In this mode
+ all tokens resulting from the expansion of an argument of a
+ function-like macro have the same location. Value :samp:`2` tracks
+ tokens locations completely. This value is the most memory hungry.
+ When this option is given no argument, the default parameter value is
+ :samp:`2`.
+
+ Note that ``-ftrack-macro-expansion=2`` is activated by default.
+
+.. option:: -fmacro-prefix-map={old}={new}
+
+ When preprocessing files residing in directory :samp:`{old}`,
+ expand the ``__FILE__`` and ``__BASE_FILE__`` macros as if the
+ files resided in directory :samp:`{new}` instead. This can be used
+ to change an absolute path to a relative path by using :samp:`.` for
+ :samp:`{new}` which can result in more reproducible builds that are
+ location independent. This option also affects
+ ``__builtin_FILE()`` during compilation. See also
+ :option:`-ffile-prefix-map`.
+
+.. index:: character set, execution
+
+.. option:: -fexec-charset={charset}
+
+ Set the execution character set, used for string and character
+ constants. The default is UTF-8. :samp:`{charset}` can be any encoding
+ supported by the system's ``iconv`` library routine.
+
+.. index:: character set, wide execution
+
+.. option:: -fwide-exec-charset={charset}
+
+ Set the wide execution character set, used for wide string and
+ character constants. The default is UTF-32 or UTF-16, whichever
+ corresponds to the width of ``wchar_t``. As with
+ :option:`-fexec-charset`, :samp:`{charset}` can be any encoding supported
+ by the system's ``iconv`` library routine; however, you will have
+ problems with encodings that do not fit exactly in ``wchar_t``.
+
+.. index:: character set, input
+
+.. option:: -finput-charset={charset}
+
+ Set the input character set, used for translation from the character
+ set of the input file to the source character set used by GCC. If the
+ locale does not specify, or GCC cannot get this information from the
+ locale, the default is UTF-8. This can be overridden by either the locale
+ or this command-line option. Currently the command-line option takes
+ precedence if there's a conflict. :samp:`{charset}` can be any encoding
+ supported by the system's ``iconv`` library routine.
+
+.. only:: not cpp
+
+ .. option:: -fpch-deps
+
+ When using precompiled headers (see :ref:`precompiled-headers`), this flag
+ causes the dependency-output flags to also list the files from the
+ precompiled header's dependencies. If not specified, only the
+ precompiled header are listed and not the files that were used to
+ create it, because those files are not consulted when a precompiled
+ header is used.
+
+ .. option:: -fpch-preprocess
+
+ This option allows use of a precompiled header (see :ref:`precompiled-headers`) together with :option:`-E`. It inserts a special ``#pragma``,
+ ``#pragma GCC pch_preprocess "filename"`` in the output to mark
+ the place where the precompiled header was found, and its :samp:`{filename}`.
+ When :option:`-fpreprocessed` is in use, GCC recognizes this ``#pragma``
+ and loads the PCH.
+
+ This option is off by default, because the resulting preprocessed output
+ is only really suitable as input to GCC. It is switched on by
+ :option:`-save-temps`.
+
+ You should not write this ``#pragma`` in your own code, but it is
+ safe to edit the filename if the PCH file is available in a different
+ location. The filename may be absolute or it may be relative to GCC's
+ current directory.
+
+.. option:: -fworking-directory
+
+ Enable generation of linemarkers in the preprocessor output that
+ let the compiler know the current working directory at the time of
+ preprocessing. When this option is enabled, the preprocessor
+ emits, after the initial linemarker, a second linemarker with the
+ current working directory followed by two slashes. GCC uses this
+ directory, when it's present in the preprocessed input, as the
+ directory emitted as the current working directory in some debugging
+ information formats. This option is implicitly enabled if debugging
+ information is enabled, but this can be inhibited with the negated
+ form :option:`-fno-working-directory`. If the :option:`-P` flag is
+ present in the command line, this option has no effect, since no
+ ``#line`` directives are emitted whatsoever.
+
+.. option:: -fno-working-directory
+
+ Default setting; overrides :option:`-fworking-directory`.
+
+.. option:: -A {predicate}={answer}
+
+ Make an assertion with the predicate :samp:`{predicate}` and answer
+ :samp:`{answer}`. This form is preferred to the older form :option:`-A`
+ :samp:`{predicate}` (:samp:`{answer}`), which is still supported, because
+ it does not use shell special characters.
+
+ .. only:: cpp
+
+ See :ref:`obsolete-features`.
+
+.. option:: -A -predicate=answer
+
+ Cancel an assertion with the predicate :samp:`{predicate}` and answer
+ :samp:`{answer}`.
+
+.. option:: -C
+
+ Do not discard comments. All comments are passed through to the output
+ file, except for comments in processed directives, which are deleted
+ along with the directive.
+
+ You should be prepared for side effects when using :option:`-C` ; it
+ causes the preprocessor to treat comments as tokens in their own right.
+ For example, comments appearing at the start of what would be a
+ directive line have the effect of turning that line into an ordinary
+ source line, since the first token on the line is no longer a :samp:`#`.
+
+.. option:: -CC
+
+ Do not discard comments, including during macro expansion. This is
+ like :option:`-C`, except that comments contained within macros are
+ also passed through to the output file where the macro is expanded.
+
+ In addition to the side effects of the :option:`-C` option, the
+ :option:`-CC` option causes all C++-style comments inside a macro
+ to be converted to C-style comments. This is to prevent later use
+ of that macro from inadvertently commenting out the remainder of
+ the source line.
+
+ The :option:`-CC` option is generally used to support lint comments.
+
+.. option:: -P
+
+ Inhibit generation of linemarkers in the output from the preprocessor.
+ This might be useful when running the preprocessor on something that is
+ not C code, and will be sent to a program which might be confused by the
+ linemarkers.
+
+ .. only:: cpp
+
+ See :ref:`preprocessor-output`.
+
+ .. index:: traditional C language, C language, traditional
+
+.. option:: -traditional, -traditional-cpp
+
+ Try to imitate the behavior of pre-standard C preprocessors, as
+ opposed to ISO C preprocessors.
+
+ .. only:: cpp
+
+ See :ref:`traditional-mode`.
+
+ .. only:: not cpp
+
+ See the GNU CPP manual for details.
+
+ Note that GCC does not otherwise attempt to emulate a pre-standard
+ C compiler, and these options are only supported with the :option:`-E`
+ switch, or when invoking CPP explicitly.
+
+.. option:: -trigraphs
+
+ Support ISO C trigraphs.
+ These are three-character sequences, all starting with :samp:`??`, that
+ are defined by ISO C to stand for single characters. For example,
+ :samp:`??/` stands for :samp:`\\`, so :samp:`??/n` is a character
+ constant for a newline.
+
+ .. only:: cpp
+
+ See :ref:`initial-processing`.
+
+ .. only:: not cpp
+
+ The nine trigraphs and their replacements are
+
+ .. code-block::
+
+ Trigraph: ??( ??) ??< ??> ??= ??/ ??' ??! ??-
+ Replacement: [ ] { } # \ ^ | ~
+
+ By default, GCC ignores trigraphs, but in
+ standard-conforming modes it converts them. See the :option:`-std` and
+ :option:`-ansi` options.
+
+.. option:: -remap
+
+ Enable special code to work around file systems which only permit very
+ short file names, such as MS-DOS.
+
+.. option:: -H
+
+ Print the name of each header file used, in addition to other normal
+ activities. Each name is indented to show how deep in the
+ :samp:`#include` stack it is. Precompiled header files are also
+ printed, even if they are found to be invalid; an invalid precompiled
+ header file is printed with :samp:`...x` and a valid one with :samp:`...!` .
+
+.. option:: -dletters
+
+ Says to make debugging dumps during compilation as specified by
+ :samp:`{letters}`. The flags documented here are those relevant to the
+ preprocessor. Other :samp:`{letters}` are interpreted
+ by the compiler proper, or reserved for future versions of GCC, and so
+ are silently ignored. If you specify :samp:`{letters}` whose behavior
+ conflicts, the result is undefined.
+
+ .. only:: not cpp
+
+ See :ref:`developer-options`, for more information.
+
+ .. option:: -dM
+
+ Instead of the normal output, generate a list of :samp:`#define`
+ directives for all the macros defined during the execution of the
+ preprocessor, including predefined macros. This gives you a way of
+ finding out what is predefined in your version of the preprocessor.
+ Assuming you have no file :samp:`foo.h`, the command
+
+ .. code-block:: c++
+
+ touch foo.h; cpp -dM foo.h
+
+ shows all the predefined macros.
+
+ .. only:: cpp
+
+ If you use :option:`-dM` without the :option:`-E` option, :option:`-dM` is
+ interpreted as a synonym for :option:`-fdump-rtl-mach`.
+ See :ref:`developer-options`.
+
+ .. option:: -dD
+
+ Like :option:`-dM` except in two respects: it does *not* include the
+ predefined macros, and it outputs *both* the :samp:`#define`
+ directives and the result of preprocessing. Both kinds of output go to
+ the standard output file.
+
+ .. option:: -dN
+
+ Like :option:`-dD`, but emit only the macro names, not their expansions.
+
+ .. option:: -dI
+
+ Output :samp:`#include` directives in addition to the result of
+ preprocessing.
+
+ .. option:: -dU
+
+ Like :option:`-dD` except that only macros that are expanded, or whose
+ definedness is tested in preprocessor directives, are output; the
+ output is delayed until the use or test of the macro; and
+ :samp:`#undef` directives are also output for macros tested but
+ undefined at the time.
+
+.. option:: -fdebug-cpp
+
+ This option is only useful for debugging GCC. When used from CPP or with
+ :option:`-E`, it dumps debugging information about location maps. Every
+ token in the output is preceded by the dump of the map its location
+ belongs to.
+
+ When used from GCC without :option:`-E`, this option has no effect.
\ No newline at end of file
diff --git a/doc/cppwarnopts.rst b/doc/cppwarnopts.rst
new file mode 100644
index 00000000000..5df853db1b9
--- /dev/null
+++ b/doc/cppwarnopts.rst
@@ -0,0 +1,4 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
\ No newline at end of file
diff --git a/doc/favicon.ico b/doc/favicon.ico
new file mode 100644
index 00000000000..42e8969edc8
Binary files /dev/null and b/doc/favicon.ico differ
diff --git a/doc/funding.rst b/doc/funding.rst
new file mode 100644
index 00000000000..4d04ebc4669
--- /dev/null
+++ b/doc/funding.rst
@@ -0,0 +1,47 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+Funding Free Software
+=====================
+
+If you want to have more free software a few years from now, it makes
+sense for you to help encourage people to contribute funds for its
+development. The most effective approach known is to encourage
+commercial redistributors to donate.
+
+Users of free software systems can boost the pace of development by
+encouraging for-a-fee distributors to donate part of their selling price
+to free software developers-the Free Software Foundation, and others.
+
+The way to convince distributors to do this is to demand it and expect
+it from them. So when you compare distributors, judge them partly by
+how much they give to free software development. Show distributors
+they must compete to be the one who gives the most.
+
+To make this approach work, you must insist on numbers that you can
+compare, such as, 'We will donate ten dollars to the Frobnitz project
+for each disk sold.' Don't be satisfied with a vague promise, such as
+'A portion of the profits are donated,' since it doesn't give a basis
+for comparison.
+
+Even a precise fraction 'of the profits from this disk' is not very
+meaningful, since creative accounting and unrelated business decisions
+can greatly alter what fraction of the sales price counts as profit.
+If the price you pay is $50, ten percent of the profit is probably
+less than a dollar; it might be a few cents, or nothing at all.
+
+Some redistributors do development work themselves. This is useful too;
+but to keep everyone honest, you need to inquire how much they do, and
+what kind. Some kinds of development make much more long-term
+difference than others. For example, maintaining a separate version of
+a program contributes very little; maintaining the standard version of a
+program for the whole community contributes much. Easy new ports
+contribute little, since someone else would surely do them; difficult
+ports such as adding a new CPU to the GNU Compiler Collection contribute more;
+major new features or packages contribute the most.
+
+By establishing the idea that supporting further development is 'the
+proper thing to do' when distributing free software for a fee, we can
+assure a steady flow of resources into making more free software.
\ No newline at end of file
diff --git a/doc/gcc_sphinx.py b/doc/gcc_sphinx.py
new file mode 100644
index 00000000000..7c6629d7434
--- /dev/null
+++ b/doc/gcc_sphinx.py
@@ -0,0 +1,15 @@
+# GCC Sphinx customization
+
+__version__ = '1.0'
+
+def setup(app):
+ app.add_object_type('gcc-attr', 'gcc-attr', objname='GCC attribute',
+ indextemplate='pair: %s; attribute')
+ app.add_object_type('gcc-param', 'gcc-param', objname='GCC parameter',
+ indextemplate='pair: %s; parameter')
+
+ return dict(
+ version = __version__,
+ parallel_read_safe = True,
+ parallel_write_safe = True
+ )
diff --git a/doc/gnu.rst b/doc/gnu.rst
new file mode 100644
index 00000000000..0da8f039e9d
--- /dev/null
+++ b/doc/gnu.rst
@@ -0,0 +1,19 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _gnu-project:
+
+The GNU Project and GNU/Linux
+=============================
+
+The GNU Project was launched in 1984 to develop a complete Unix-like
+operating system which is free software: the GNU system. (GNU is a
+recursive acronym for 'GNU's Not Unix'; it is pronounced
+'guh-NEW'.) Variants of the GNU operating system, which use the
+kernel Linux, are now widely used; though these systems are often
+referred to as 'Linux', they are more accurately called GNU/Linux
+systems.
+
+For more information, see: https://www.gnu.org/ and https://www.gnu.org/gnu/linux-and-gnu.html.
\ No newline at end of file
diff --git a/doc/gnu_free_documentation_license.rst b/doc/gnu_free_documentation_license.rst
new file mode 100644
index 00000000000..c5e25f64df6
--- /dev/null
+++ b/doc/gnu_free_documentation_license.rst
@@ -0,0 +1,476 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _gnu_fdl:
+
+******************************
+GNU Free Documentation License
+******************************
+
+Version 1.3, 3 November 2008
+
+Copyright 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc
+https://fsf.org/
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+Preamble
+~~~~~~~~
+
+The purpose of this License is to make a manual, textbook, or other
+functional and useful document "free" in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it,
+with or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible
+for modifications made by others.
+
+This License is a kind of "copyleft", which means that derivative
+works of the document must themselves be free in the same sense. It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does. But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book. We recommend this License
+principally for works whose purpose is instruction or reference.
+
+1. APPLICABILITY AND DEFINITIONS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This License applies to any manual or other work, in any medium, that
+contains a notice placed by the copyright holder saying it can be
+distributed under the terms of this License. Such a notice grants a
+world-wide, royalty-free license, unlimited in duration, to use that
+work under the conditions stated herein. The **Document**, below,
+refers to any such manual or work. Any member of the public is a
+licensee, and is addressed as "**you**". You accept the license if you
+copy, modify or distribute the work in a way requiring permission
+under copyright law.
+
+A "**Modified Version**" of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+
+A "**Secondary Section**" is a named appendix or a front-matter section of
+the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document's overall subject
+(or to related matters) and contains nothing that could fall directly
+within that overall subject. (Thus, if the Document is in part a
+textbook of mathematics, a Secondary Section may not explain any
+mathematics.) The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+
+The "**Invariant Sections**" are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License. If a
+section does not fit the above definition of Secondary then it is not
+allowed to be designated as Invariant. The Document may contain zero
+Invariant Sections. If the Document does not identify any Invariant
+Sections then there are none.
+
+The "**Cover Texts**" are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License. A Front-Cover Text may
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
+
+A "**Transparent**" copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, that is suitable for revising the document
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters. A copy made in an otherwise Transparent file
+format whose markup, or absence of markup, has been arranged to thwart
+or discourage subsequent modification by readers is not Transparent.
+An image format is not Transparent if used for any substantial amount
+of text. A copy that is not "Transparent" is called **Opaque**.
+
+Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input format, SGML
+or XML using a publicly available DTD, and standard-conforming simple
+HTML, PostScript or PDF designed for human modification. Examples of
+transparent image formats include PNG, XCF and JPG. Opaque formats
+include proprietary formats that can be read and edited only by
+proprietary word processors, SGML or XML for which the DTD and/or
+processing tools are not generally available, and the
+machine-generated HTML, PostScript or PDF produced by some word
+processors for output purposes only.
+
+The "**Title Page**" means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page. For works in
+formats which do not have any title page as such, "Title Page" means
+the text near the most prominent appearance of the work's title,
+preceding the beginning of the body of the text.
+
+The "**publisher**" means any person or entity that distributes
+copies of the Document to the public.
+
+A section "**Entitled XYZ**" means a named subunit of the Document whose
+title either is precisely XYZ or contains XYZ in parentheses following
+text that translates XYZ in another language. (Here XYZ stands for a
+specific section name mentioned below, such as "**Acknowledgements**",
+"**Dedications**", "**Endorsements**", or "**History**".)
+To "**Preserve the Title**"
+of such a section when you modify the Document means that it remains a
+section "Entitled XYZ" according to this definition.
+
+The Document may include Warranty Disclaimers next to the notice which
+states that this License applies to the Document. These Warranty
+Disclaimers are considered to be included by reference in this
+License, but only as regards disclaiming warranties: any other
+implication that these Warranty Disclaimers may have is void and has
+no effect on the meaning of this License.
+
+2. VERBATIM COPYING
+~~~~~~~~~~~~~~~~~~~
+
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License. You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute. However, you may accept
+compensation in exchange for copies. If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+
+3. COPYING IN QUANTITY
+~~~~~~~~~~~~~~~~~~~~~~
+
+If you publish printed copies (or copies in media that commonly have
+printed covers) of the Document, numbering more than 100, and the
+Document's license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover. Both covers must also clearly and legibly identify
+you as the publisher of these copies. The front cover must present
+the full title with all words of the title equally prominent and
+visible. You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a computer-network location from which the general network-using
+public has access to download using public-standard network protocols
+a complete Transparent copy of the Document, free of added material.
+If you use the latter option, you must take reasonably prudent steps,
+when you begin distribution of Opaque copies in quantity, to ensure
+that this Transparent copy will remain thus accessible at the stated
+location until at least one year after the last time you distribute an
+Opaque copy (directly or through your agents or retailers) of that
+edition to the public.
+
+It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+
+4. MODIFICATIONS
+~~~~~~~~~~~~~~~~
+
+You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it. In addition, you must do these things in the Modified Version:
+
+A. Use in the Title Page (and on the covers, if any) a title distinct
+ from that of the Document, and from those of previous versions
+ (which should, if there were any, be listed in the History section
+ of the Document). You may use the same title as a previous version
+ if the original publisher of that version gives permission.
+
+B. List on the Title Page, as authors, one or more persons or entities
+ responsible for authorship of the modifications in the Modified
+ Version, together with at least five of the principal authors of the
+ Document (all of its principal authors, if it has fewer than five),
+ unless they release you from this requirement.
+
+C. State on the Title page the name of the publisher of the
+ Modified Version, as the publisher.
+
+D. Preserve all the copyright notices of the Document.
+
+E. Add an appropriate copyright notice for your modifications
+ adjacent to the other copyright notices.
+
+F. Include, immediately after the copyright notices, a license notice
+ giving the public permission to use the Modified Version under the
+ terms of this License, in the form shown in the Addendum below.
+
+G. Preserve in that license notice the full lists of Invariant Sections
+ and required Cover Texts given in the Document's license notice.
+H. Include an unaltered copy of this License.
+
+I. Preserve the section Entitled "History", Preserve its Title, and add
+ to it an item stating at least the title, year, new authors, and
+ publisher of the Modified Version as given on the Title Page. If
+ there is no section Entitled "History" in the Document, create one
+ stating the title, year, authors, and publisher of the Document as
+ given on its Title Page, then add an item describing the Modified
+ Version as stated in the previous sentence.
+
+J. Preserve the network location, if any, given in the Document for
+ public access to a Transparent copy of the Document, and likewise
+ the network locations given in the Document for previous versions
+ it was based on. These may be placed in the "History" section.
+ You may omit a network location for a work that was published at
+ least four years before the Document itself, or if the original
+ publisher of the version it refers to gives permission.
+
+K. For any section Entitled "Acknowledgements" or "Dedications",
+ Preserve the Title of the section, and preserve in the section all
+ the substance and tone of each of the contributor acknowledgements
+ and/or dedications given therein.
+
+L. Preserve all the Invariant Sections of the Document,
+ unaltered in their text and in their titles. Section numbers
+ or the equivalent are not considered part of the section titles.
+
+M. Delete any section Entitled "Endorsements". Such a section
+ may not be included in the Modified Version.
+
+N. Do not retitle any existing section to be Entitled "Endorsements"
+ or to conflict in title with any Invariant Section.
+
+O. Preserve any Warranty Disclaimers.
+
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant. To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+
+You may add a section Entitled "Endorsements", provided it contains
+nothing but endorsements of your Modified Version by various
+parties---for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version. Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity. If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+
+5. COMBINING DOCUMENTS
+~~~~~~~~~~~~~~~~~~~~~~
+
+You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice, and that you preserve all their Warranty Disclaimers.
+
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy. If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections Entitled "History"
+in the various original documents, forming one section Entitled
+"History"; likewise combine any sections Entitled "Acknowledgements",
+and any sections Entitled "Dedications". You must delete all sections
+Entitled "Endorsements".
+
+6. COLLECTIONS OF DOCUMENTS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+
+7. AGGREGATION WITH INDEPENDENT WORKS
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, is called an "aggregate" if the copyright
+resulting from the compilation is not used to limit the legal rights
+of the compilation's users beyond what the individual works permit.
+When the Document is included in an aggregate, this License does not
+apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document's Cover Texts may be placed on
+covers that bracket the Document within the aggregate, or the
+electronic equivalent of covers if the Document is in electronic form.
+Otherwise they must appear on printed covers that bracket the whole
+aggregate.
+
+8. TRANSLATION
+~~~~~~~~~~~~~~
+
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections. You may include a
+translation of this License, and all the license notices in the
+Document, and any Warranty Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers. In case of a disagreement between
+the translation and the original version of this License or a notice
+or disclaimer, the original version will prevail.
+
+If a section in the Document is Entitled "Acknowledgements",
+"Dedications", or "History", the requirement (section 4) to Preserve
+its Title (section 1) will typically require changing the actual
+title.
+
+9. TERMINATION
+~~~~~~~~~~~~~~
+
+You may not copy, modify, sublicense, or distribute the Document
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense, or distribute it is void, and
+will automatically terminate your rights under this License.
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, receipt of a copy of some or all of the same material does
+not give you any rights to use it.
+
+10. FUTURE REVISIONS OF THIS LICENSE
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns. See
+https://www.gnu.org/copyleft/.
+
+Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation. If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation. If the Document
+specifies that a proxy can decide which future versions of this
+License can be used, that proxy's public statement of acceptance of a
+version permanently authorizes you to choose that version for the
+Document.
+
+11. RELICENSING
+~~~~~~~~~~~~~~~
+
+"Massive Multiauthor Collaboration Site" (or "MMC Site") means any
+World Wide Web server that publishes copyrightable works and also
+provides prominent facilities for anybody to edit those works. A
+public wiki that anybody can edit is an example of such a server. A
+"Massive Multiauthor Collaboration" (or "MMC") contained in the
+site means any set of copyrightable works thus published on the MMC
+site.
+
+"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
+license published by Creative Commons Corporation, a not-for-profit
+corporation with a principal place of business in San Francisco,
+California, as well as future copyleft versions of that license
+published by that same organization.
+
+"Incorporate" means to publish or republish a Document, in whole or
+in part, as part of another Document.
+
+An MMC is "eligible for relicensing" if it is licensed under this
+License, and if all works that were first published under this License
+somewhere other than this MMC, and subsequently incorporated in whole
+or in part into the MMC, (1) had no cover texts or invariant sections,
+and (2) were thus incorporated prior to November 1, 2008.
+
+The operator of an MMC Site may republish an MMC contained in the site
+under CC-BY-SA on the same site at any time before August 1, 2009,
+provided the MMC is eligible for relicensing.
+
+ADDENDUM: How to use this License for your documents
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+
+ Copyright © YEAR YOUR NAME.
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License, Version 1.3
+ or any later version published by the Free Software Foundation;
+ with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ A copy of the license is included in the section entitled "GNU
+ Free Documentation License".
+
+
+If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+replace the "with ... Texts." line with this:
+
+ with the Invariant Sections being LIST THEIR TITLES, with the
+ Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+
+If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
\ No newline at end of file
diff --git a/doc/gpl-3.0.rst b/doc/gpl-3.0.rst
new file mode 100644
index 00000000000..2336693ae28
--- /dev/null
+++ b/doc/gpl-3.0.rst
@@ -0,0 +1,707 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+GNU GENERAL PUBLIC LICENSE
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Version 3, 29 June 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc. https://fsf.org/
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+Preamble
+########
+
+The GNU General Public License is a free, copyleft license for software
+and other kinds of works.
+
+The licenses for most software and other practical works are designed to
+take away your freedom to share and change the works. By contrast, the
+GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price.
+Our General Public Licenses are designed to make sure that you have the
+freedom to distribute copies of free software (and charge for them if
+you wish), that you receive source code or can get it if you want it,
+that you can change the software or use pieces of it in new free
+programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you these
+rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+For example, if you distribute copies of such a program, whether gratis
+or for a fee, you must pass on to the recipients the same freedoms that
+you received. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1)
+assert copyright on the software, and (2) offer you this License giving
+you legal permission to copy, distribute and/or modify it.
+
+For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of protecting
+users' freedom to change the software. The systematic pattern of such
+abuse occurs in the area of products for individuals to use, which is
+precisely where it is most unacceptable. Therefore, we have designed
+this version of the GPL to prohibit the practice for those products. If
+such problems arise substantially in other domains, we stand ready to
+extend this provision to those domains in future versions of the GPL, as
+needed to protect the freedom of users.
+
+Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and
+modification follow.
+
+TERMS AND CONDITIONS
+####################
+
+0. Definitions.
+^^^^^^^^^^^^^^^
+
+"This License" refers to version 3 of the GNU General Public License.
+
+"Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+"The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+A "covered work" means either the unmodified Program or a work based on
+the Program.
+
+To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+An interactive user interface displays "Appropriate Legal Notices" to
+the extent that it includes a convenient and prominently visible feature
+that (1) displays an appropriate copyright notice, and (2) tells the
+user that there is no warranty for the work (except to the extent that
+warranties are provided), that licensees may convey the work under this
+License, and how to view a copy of this License. If the interface
+presents a list of user commands or options, such as a menu, a prominent
+item in the list meets this criterion.
+
+1. Source Code.
+^^^^^^^^^^^^^^^
+
+The "source code" for a work means the preferred form of the work for
+making modifications to it. "Object code" means any non-source form of a
+work.
+
+A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that is
+widely used among developers working in that language.
+
+The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that Major
+Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A "Major
+Component", in this context, means a major essential component (kernel,
+window system, and so on) of the specific operating system (if any) on
+which the executable work runs, or a compiler used to produce the work,
+or an object code interpreter used to run it.
+
+The "Corresponding Source" for a work in object code form means all the
+source code needed to generate, install, and (for an executable work)
+run the object code and to modify the work, including scripts to control
+those activities. However, it does not include the work's System
+Libraries, or general-purpose tools or generally available free programs
+which are used unmodified in performing those activities but which are
+not part of the work. For example, Corresponding Source includes
+interface definition files associated with source files for the work,
+and the source code for shared libraries and dynamically linked
+subprograms that the work is specifically designed to require, such as
+by intimate data communication or control flow between those subprograms
+and other parts of the work.
+
+The Corresponding Source need not include anything that users can
+regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same
+work.
+
+2. Basic Permissions.
+^^^^^^^^^^^^^^^^^^^^^
+
+All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey,
+without conditions so long as your license otherwise remains in force.
+You may convey covered works to others for the sole purpose of having
+them make modifications exclusively for you, or provide you with
+facilities for running those works, provided that you comply with the
+terms of this License in conveying all material for which you do not
+control copyright. Those thus making or running the covered works for
+you must do so exclusively on your behalf, under your direction and
+control, on terms that prohibit them from making any copies of your
+copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the
+conditions stated below. Sublicensing is not allowed; section 10 makes
+it unnecessary.
+
+3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article 11
+of the WIPO copyright treaty adopted on 20 December 1996, or similar
+laws prohibiting or restricting circumvention of such measures.
+
+When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to the
+covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+4. Conveying Verbatim Copies.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice; keep
+intact all notices stating that this License and any non-permissive
+terms added in accord with section 7 apply to the code; keep intact all
+notices of the absence of any warranty; and give all recipients a copy
+of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey, and
+you may offer support or warranty protection for a fee.
+
+5. Conveying Modified Source Versions.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the terms
+of section 4, provided that you also meet all of these conditions:
+
+a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+b) The work must carry prominent notices stating that it is released
+ under this License and any conditions added under section 7. This
+ requirement modifies the requirement in section 4 to "keep intact
+ all notices".
+
+c) You must license the entire work, as a whole, under this License
+ to anyone who comes into possession of a copy. This License will
+ therefore apply, along with any applicable section 7 additional
+ terms, to the whole of the work, and all its parts, regardless of
+ how they are packaged. This License gives no permission to license
+ the work in any other way, but it does not invalidate such
+ permission if you have separately received it.
+
+d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work, and
+which are not combined with it such as to form a larger program, in or
+on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not used
+to limit the access or legal rights of the compilation's users beyond
+what the individual works permit. Inclusion of a covered work in an
+aggregate does not cause this License to apply to the other parts of the
+aggregate.
+
+6. Conveying Non-Source Forms.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You may convey a covered work in object code form under the terms of
+sections 4 and 5, provided that you also convey the machine-readable
+Corresponding Source under the terms of this License, in one of these
+ways:
+
+a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the Corresponding
+ Source from a network server at no charge.
+
+c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+d) Convey the object code by offering access from a designated place
+ (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be included
+in conveying the object code work.
+
+A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for
+incorporation into a dwelling. In determining whether a product is a
+consumer product, doubtful cases shall be resolved in favor of coverage.
+For a particular product received by a particular user, "normally used"
+refers to a typical or common use of that class of product, regardless
+of the status of the particular user or of the way in which the
+particular user actually uses, or expects or is expected to use, the
+product. A product is a consumer product regardless of whether the
+product has substantial commercial, industrial or non-consumer uses,
+unless such uses represent the only significant mode of use of the
+product.
+
+"Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product
+from a modified version of its Corresponding Source. The information
+must suffice to ensure that the continued functioning of the modified
+object code is in no case prevented or interfered with solely because
+modification has been made.
+
+If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied by
+the Installation Information. But this requirement does not apply if
+neither you nor any third party retains the ability to install modified
+object code on the User Product (for example, the work has been
+installed in ROM).
+
+The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided, in
+accord with this section must be in a format that is publicly documented
+(and with an implementation available to the public in source code
+form), and must require no special password or key for unpacking,
+reading or copying.
+
+7. Additional Terms.
+^^^^^^^^^^^^^^^^^^^^
+
+"Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by this
+License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option remove
+any additional permissions from that copy, or from any part of it.
+(Additional permissions may be written to require their own removal in
+certain cases when you modify the work.) You may place additional
+permissions on material, added by you to a covered work, for which you
+have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders
+of that material) supplement the terms of this License with terms:
+
+a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions
+ of it) with contractual assumptions of liability to the recipient,
+ for any liability that these contractual assumptions directly
+ impose on those licensors and authors.
+
+All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains a
+further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms of
+that license document, provided that the further restriction does not
+survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you must
+place, in the relevant source files, a statement of the additional terms
+that apply to those files, or a notice indicating where to find the
+applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions; the above
+requirements apply either way.
+
+8. Termination.
+^^^^^^^^^^^^^^^
+
+You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally terminates
+your license, and (b) permanently, if the copyright holder fails to
+notify you of the violation by some reasonable means prior to 60 days
+after the cessation.
+
+Moreover, your license from a particular copyright holder is reinstated
+permanently if the copyright holder notifies you of the violation by
+some reasonable means, this is the first time you have received notice
+of violation of this License (for any work) from that copyright holder,
+and you cure the violation prior to 30 days after your receipt of the
+notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+9. Acceptance Not Required for Having Copies.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You are not required to accept this License in order to receive or run a
+copy of the Program. Ancillary propagation of a covered work occurring
+solely as a consequence of using peer-to-peer transmission to receive a
+copy likewise does not require acceptance. However, nothing other than
+this License grants you permission to propagate or modify any covered
+work. These actions infringe copyright if you do not accept this
+License. Therefore, by modifying or propagating a covered work, you
+indicate your acceptance of this License to do so.
+
+10. Automatic Licensing of Downstream Recipients.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered work
+results from an entity transaction, each party to that transaction who
+receives a copy of the work also receives whatever licenses to the work
+the party's predecessor in interest had or could give under the previous
+paragraph, plus a right to possession of the Corresponding Source of the
+work from the predecessor in interest, if the predecessor has it or can
+get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may not
+impose a license fee, royalty, or other charge for exercise of rights
+granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that any
+patent claim is infringed by making, using, selling, offering for sale,
+or importing the Program or any portion of it.
+
+11. Patents.
+^^^^^^^^^^^^
+
+A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The work
+thus licensed is called the contributor's "contributor version".
+
+A contributor's "essential patent claims" are all patent claims owned or
+controlled by the contributor, whether already acquired or hereafter
+acquired, that would be infringed by some manner, permitted by this
+License, of making, using, or selling its contributor version, but do
+not include claims that would be infringed only as a consequence of
+further modification of the contributor version. For purposes of this
+definition, "control" includes the right to grant patent sublicenses in
+a manner consistent with the requirements of this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to make,
+use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license, and
+the Corresponding Source of the work is not available for anyone to
+copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify or
+convey a specific copy of the covered work, then the patent license you
+grant is automatically extended to all recipients of the covered work
+and works based on it.
+
+A patent license is "discriminatory" if it does not include within the
+scope of its coverage, prohibits the exercise of, or is conditioned on
+the non-exercise of one or more of the rights that are specifically
+granted under this License. You may not convey a covered work if you are
+a party to an arrangement with a third party that is in the business of
+distributing software, under which you make payment to the third party
+based on the extent of your activity of conveying the work, and under
+which the third party grants, to any of the parties who would receive
+the covered work from you, a discriminatory patent license (a) in
+connection with copies of the covered work conveyed by you (or copies
+made from those copies), or (b) primarily for and in connection with
+specific products or compilations that contain the covered work, unless
+you entered into that arrangement, or that patent license was granted,
+prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting any
+implied license or other defenses to infringement that may otherwise be
+available to you under applicable patent law.
+
+12. No Surrender of Others' Freedom.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not convey it at all. For example, if you agree to terms that
+obligate you to collect a royalty for further conveying from those to
+whom you convey the Program, the only way you could satisfy both those
+terms and this License would be to refrain entirely from conveying the
+Program.
+
+13. Use with the GNU Affero General Public License.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Notwithstanding any other provision of this License, you have permission
+to link or combine any covered work with a work licensed under version 3
+of the GNU Affero General Public License into a single combined work,
+and to convey the resulting work. The terms of this License will
+continue to apply to the part which is the covered work, but the special
+requirements of the GNU Affero General Public License, section 13,
+concerning interaction through a network will apply to the combination
+as such.
+
+14. Revised Versions of this License.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies that a certain numbered version of the GNU General Public
+License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that numbered version or of
+any later version published by the Free Software Foundation. If the
+Program does not specify a version number of the GNU General Public
+License, you may choose any version ever published by the Free Software
+Foundation.
+
+If the Program specifies that a proxy can decide which future versions
+of the GNU General Public License can be used, that proxy's public
+statement of acceptance of a version permanently authorizes you to
+choose that version for the Program.
+
+Later license versions may give you additional or different permissions.
+However, no additional obligations are imposed on any author or
+copyright holder as a result of your choosing to follow a later version.
+
+15. Disclaimer of Warranty.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
+WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF
+THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+16. Limitation of Liability.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR
+CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
+NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES
+SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
+WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+17. Interpretation of Sections 15 and 16.
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If the disclaimer of warranty and limitation of liability provided above
+cannot be given local legal effect according to their terms, reviewing
+courts shall apply local law that most closely approximates an absolute
+waiver of all civil liability in connection with the Program, unless a
+warranty or assumption of liability accompanies a copy of the Program in
+return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+#############################################
+
+If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these
+terms.
+
+To do so, attach the following notices to the program. It is safest to
+attach them to the start of each source file to most effectively state
+the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+::
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program does terminal interaction, make it output a short notice
+like this when it starts in an interactive mode:
+
+::
+
+ <program> Copyright (C) <year> <name of author>
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands \`show w' and \`show c' should show the
+appropriate parts of the General Public License. Of course, your
+program's commands might be different; for a GUI interface, you would
+use an "about box".
+
+You should also get your employer (if you work as a programmer) or
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. For more information on this, and how to apply and follow the
+GNU GPL, see https://www.gnu.org/licenses/.
+
+The GNU General Public License does not permit incorporating your
+program into proprietary programs. If your program is a subroutine
+library, you may consider it more useful to permit linking proprietary
+applications with the library. If this is what you want to do, use the
+GNU Lesser General Public License instead of this License. But first,
+please read https://www.gnu.org/licenses/why-not-lgpl.html.
\ No newline at end of file
diff --git a/doc/indices-and-tables.rst b/doc/indices-and-tables.rst
new file mode 100644
index 00000000000..7be52b43c0b
--- /dev/null
+++ b/doc/indices-and-tables.rst
@@ -0,0 +1,6 @@
+.. only:: html
+
+ Indexes and tables
+ ==================
+
+ :ref:`genindex`
\ No newline at end of file
diff --git a/doc/lgpl-2.1.rst b/doc/lgpl-2.1.rst
new file mode 100644
index 00000000000..144912e8c0e
--- /dev/null
+++ b/doc/lgpl-2.1.rst
@@ -0,0 +1,514 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+GNU LESSER GENERAL PUBLIC LICENSE
+---------------------------------
+
+.. index:: LGPL, Lesser General Public License
+
+Version 2.1, February 1999
+
+Copyright (C) 1991-2022 Free Software Foundation, Inc.
+51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL. It also counts
+as the successor of the GNU Library Public License, version 2, hence the
+version number 2.1.]
+
+Preamble
+^^^^^^^^
+
+The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software---to make sure the software is free for all its users.
+
+This license, the Lesser General Public License, applies to some
+specially designated software---typically libraries---of the Free
+Software Foundation and other authors who decide to use it. You can use
+it too, but we suggest you first think carefully about whether this
+license or the ordinary General Public License is the better strategy to
+use in any particular case, based on the explanations below.
+
+When we speak of free software, we are referring to freedom of use,
+not price. Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of it
+in new free programs; and that you are informed that you can do these
+things.
+
+To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights. These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you. You must make sure that they, too, receive or can get the source
+code. If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it. And you must show them these terms so they know their rights.
+
+We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+To protect each distributor, we want to make it very clear that
+there is no warranty for the free library. Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+Finally, software patents pose a constant threat to the existence of
+any free program. We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder. Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License. This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License. We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library. The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom. The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+We call this license the :dfn:`Lesser` General Public License because it
+does *Less* to protect the user's freedom than the ordinary General
+Public License. It also provides other free software developers Less
+of an advantage over competing non-free programs. These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries. However, the Lesser license provides advantages in certain
+special circumstances.
+
+For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard. To achieve this, non-free programs must be
+allowed to use the library. A more frequent case is that a free
+library does the same job as widely used non-free libraries. In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software. For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+The precise terms and conditions for copying, distribution and
+modification follow. Pay close attention to the difference between a
+'work based on the library' and a 'work that uses the library'. The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+#. This License Agreement applies to any software library or other program
+ which contains a notice placed by the copyright holder or other
+ authorized party saying it may be distributed under the terms of this
+ Lesser General Public License (also called 'this License'). Each
+ licensee is addressed as 'you'.
+
+ A 'library' means a collection of software functions and/or data
+ prepared so as to be conveniently linked with application programs
+ (which use some of those functions and data) to form executables.
+
+ The 'Library', below, refers to any such software library or work
+ which has been distributed under these terms. A 'work based on the
+ Library' means either the Library or any derivative work under
+ copyright law: that is to say, a work containing the Library or a
+ portion of it, either verbatim or with modifications and/or translated
+ straightforwardly into another language. (Hereinafter, translation is
+ included without limitation in the term 'modification'.)
+
+ 'Source code' for a work means the preferred form of the work for
+ making modifications to it. For a library, complete source code means
+ all the source code for all modules it contains, plus any associated
+ interface definition files, plus the scripts used to control compilation
+ and installation of the library.
+
+ Activities other than copying, distribution and modification are not
+ covered by this License; they are outside its scope. The act of
+ running a program using the Library is not restricted, and output from
+ such a program is covered only if its contents constitute a work based
+ on the Library (independent of the use of the Library in a tool for
+ writing it). Whether that is true depends on what the Library does
+ and what the program that uses the Library does.
+
+#. You may copy and distribute verbatim copies of the Library's
+ complete source code as you receive it, in any medium, provided that
+ you conspicuously and appropriately publish on each copy an
+ appropriate copyright notice and disclaimer of warranty; keep intact
+ all the notices that refer to this License and to the absence of any
+ warranty; and distribute a copy of this License along with the
+ Library.
+
+ You may charge a fee for the physical act of transferring a copy,
+ and you may at your option offer warranty protection in exchange for a
+ fee.
+
+#. You may modify your copy or copies of the Library or any portion
+ of it, thus forming a work based on the Library, and copy and
+ distribute such modifications or work under the terms of Section 1
+ above, provided that you also meet all of these conditions:
+
+ a* The modified work must itself be a software library.
+
+ * You must cause the files modified to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ * You must cause the whole of the work to be licensed at no
+ charge to all third parties under the terms of this License.
+
+ * If a facility in the modified Library refers to a function or a
+ table of data to be supplied by an application program that uses
+ the facility, other than as an argument passed when the facility
+ is invoked, then you must make a good faith effort to ensure that,
+ in the event an application does not supply such function or
+ table, the facility still operates, and performs whatever part of
+ its purpose remains meaningful.
+
+ (For example, a function in a library to compute square roots has
+ a purpose that is entirely well-defined independent of the
+ application. Therefore, Subsection 2d requires that any
+ application-supplied function or table used by this function must
+ be optional: if the application does not supply it, the square
+ root function must still compute square roots.)
+
+ These requirements apply to the modified work as a whole. If
+ identifiable sections of that work are not derived from the Library,
+ and can be reasonably considered independent and separate works in
+ themselves, then this License, and its terms, do not apply to those
+ sections when you distribute them as separate works. But when you
+ distribute the same sections as part of a whole which is a work based
+ on the Library, the distribution of the whole must be on the terms of
+ this License, whose permissions for other licensees extend to the
+ entire whole, and thus to each and every part regardless of who wrote
+ it.
+
+ Thus, it is not the intent of this section to claim rights or contest
+ your rights to work written entirely by you; rather, the intent is to
+ exercise the right to control the distribution of derivative or
+ collective works based on the Library.
+
+ In addition, mere aggregation of another work not based on the Library
+ with the Library (or with a work based on the Library) on a volume of
+ a storage or distribution medium does not bring the other work under
+ the scope of this License.
+
+#. You may opt to apply the terms of the ordinary GNU General Public
+ License instead of this License to a given copy of the Library. To do
+ this, you must alter all the notices that refer to this License, so
+ that they refer to the ordinary GNU General Public License, version 2,
+ instead of to this License. (If a newer version than version 2 of the
+ ordinary GNU General Public License has appeared, then you can specify
+ that version instead if you wish.) Do not make any other change in
+ these notices.
+
+ Once this change is made in a given copy, it is irreversible for
+ that copy, so the ordinary GNU General Public License applies to all
+ subsequent copies and derivative works made from that copy.
+
+ This option is useful when you wish to copy part of the code of
+ the Library into a program that is not a library.
+
+#. You may copy and distribute the Library (or a portion or
+ derivative of it, under Section 2) in object code or executable form
+ under the terms of Sections 1 and 2 above provided that you accompany
+ it with the complete corresponding machine-readable source code, which
+ must be distributed under the terms of Sections 1 and 2 above on a
+ medium customarily used for software interchange.
+
+ If distribution of object code is made by offering access to copy
+ from a designated place, then offering equivalent access to copy the
+ source code from the same place satisfies the requirement to
+ distribute the source code, even though third parties are not
+ compelled to copy the source along with the object code.
+
+#. A program that contains no derivative of any portion of the
+ Library, but is designed to work with the Library by being compiled or
+ linked with it, is called a 'work that uses the Library'. Such a
+ work, in isolation, is not a derivative work of the Library, and
+ therefore falls outside the scope of this License.
+
+ However, linking a 'work that uses the Library' with the Library
+ creates an executable that is a derivative of the Library (because it
+ contains portions of the Library), rather than a 'work that uses the
+ library'. The executable is therefore covered by this License.
+ Section 6 states terms for distribution of such executables.
+
+ When a 'work that uses the Library' uses material from a header file
+ that is part of the Library, the object code for the work may be a
+ derivative work of the Library even though the source code is not.
+ Whether this is true is especially significant if the work can be
+ linked without the Library, or if the work is itself a library. The
+ threshold for this to be true is not precisely defined by law.
+
+ If such an object file uses only numerical parameters, data
+ structure layouts and accessors, and small macros and small inline
+ functions (ten lines or less in length), then the use of the object
+ file is unrestricted, regardless of whether it is legally a derivative
+ work. (Executables containing this object code plus portions of the
+ Library will still fall under Section 6.)
+
+ Otherwise, if the work is a derivative of the Library, you may
+ distribute the object code for the work under the terms of Section 6.
+ Any executables containing that work also fall under Section 6,
+ whether or not they are linked directly with the Library itself.
+
+#. As an exception to the Sections above, you may also combine or
+ link a 'work that uses the Library' with the Library to produce a
+ work containing portions of the Library, and distribute that work
+ under terms of your choice, provided that the terms permit
+ modification of the work for the customer's own use and reverse
+ engineering for debugging such modifications.
+
+ You must give prominent notice with each copy of the work that the
+ Library is used in it and that the Library and its use are covered by
+ this License. You must supply a copy of this License. If the work
+ during execution displays copyright notices, you must include the
+ copyright notice for the Library among them, as well as a reference
+ directing the user to the copy of this License. Also, you must do one
+ of these things:
+
+ a* Accompany the work with the complete corresponding
+ machine-readable source code for the Library including whatever
+ changes were used in the work (which must be distributed under
+ Sections 1 and 2 above); and, if the work is an executable linked
+ with the Library, with the complete machine-readable 'work that
+ uses the Library', as object code and/or source code, so that the
+ user can modify the Library and then relink to produce a modified
+ executable containing the modified Library. (It is understood
+ that the user who changes the contents of definitions files in the
+ Library will not necessarily be able to recompile the application
+ to use the modified definitions.)
+
+ * Use a suitable shared library mechanism for linking with the Library. A
+ suitable mechanism is one that (1) uses at run time a copy of the
+ library already present on the user's computer system, rather than
+ copying library functions into the executable, and (2) will operate
+ properly with a modified version of the library, if the user installs
+ one, as long as the modified version is interface-compatible with the
+ version that the work was made with.
+
+ * Accompany the work with a written offer, valid for at
+ least three years, to give the same user the materials
+ specified in Subsection 6a, above, for a charge no more
+ than the cost of performing this distribution.
+
+ * If distribution of the work is made by offering access to copy
+ from a designated place, offer equivalent access to copy the above
+ specified materials from the same place.
+
+ * Verify that the user has already received a copy of these
+ materials or that you have already sent this user a copy.
+
+ For an executable, the required form of the 'work that uses the
+ Library' must include any data and utility programs needed for
+ reproducing the executable from it. However, as a special exception,
+ the materials to be distributed need not include anything that is
+ normally distributed (in either source or binary form) with the major
+ components (compiler, kernel, and so on) of the operating system on
+ which the executable runs, unless that component itself accompanies the
+ executable.
+
+ It may happen that this requirement contradicts the license
+ restrictions of other proprietary libraries that do not normally
+ accompany the operating system. Such a contradiction means you cannot
+ use both them and the Library together in an executable that you
+ distribute.
+
+#. You may place library facilities that are a work based on the
+ Library side-by-side in a single library together with other library
+ facilities not covered by this License, and distribute such a combined
+ library, provided that the separate distribution of the work based on
+ the Library and of the other library facilities is otherwise
+ permitted, and provided that you do these two things:
+
+ a* Accompany the combined library with a copy of the same work
+ based on the Library, uncombined with any other library
+ facilities. This must be distributed under the terms of the
+ Sections above.
+
+ * Give prominent notice with the combined library of the fact
+ that part of it is a work based on the Library, and explaining
+ where to find the accompanying uncombined form of the same work.
+
+#. You may not copy, modify, sublicense, link with, or distribute
+ the Library except as expressly provided under this License. Any
+ attempt otherwise to copy, modify, sublicense, link with, or
+ distribute the Library is void, and will automatically terminate your
+ rights under this License. However, parties who have received copies,
+ or rights, from you under this License will not have their licenses
+ terminated so long as such parties remain in full compliance.
+
+#. You are not required to accept this License, since you have not
+ signed it. However, nothing else grants you permission to modify or
+ distribute the Library or its derivative works. These actions are
+ prohibited by law if you do not accept this License. Therefore, by
+ modifying or distributing the Library (or any work based on the
+ Library), you indicate your acceptance of this License to do so, and
+ all its terms and conditions for copying, distributing or modifying
+ the Library or works based on it.
+
+#. Each time you redistribute the Library (or any work based on the
+ Library), the recipient automatically receives a license from the
+ original licensor to copy, distribute, link with or modify the Library
+ subject to these terms and conditions. You may not impose any further
+ restrictions on the recipients' exercise of the rights granted herein.
+ You are not responsible for enforcing compliance by third parties with
+ this License.
+
+#. If, as a consequence of a court judgment or allegation of patent
+ infringement or for any other reason (not limited to patent issues),
+ conditions are imposed on you (whether by court order, agreement or
+ otherwise) that contradict the conditions of this License, they do not
+ excuse you from the conditions of this License. If you cannot
+ distribute so as to satisfy simultaneously your obligations under this
+ License and any other pertinent obligations, then as a consequence you
+ may not distribute the Library at all. For example, if a patent
+ license would not permit royalty-free redistribution of the Library by
+ all those who receive copies directly or indirectly through you, then
+ the only way you could satisfy both it and this License would be to
+ refrain entirely from distribution of the Library.
+
+ If any portion of this section is held invalid or unenforceable under any
+ particular circumstance, the balance of the section is intended to apply,
+ and the section as a whole is intended to apply in other circumstances.
+
+ It is not the purpose of this section to induce you to infringe any
+ patents or other property right claims or to contest validity of any
+ such claims; this section has the sole purpose of protecting the
+ integrity of the free software distribution system which is
+ implemented by public license practices. Many people have made
+ generous contributions to the wide range of software distributed
+ through that system in reliance on consistent application of that
+ system; it is up to the author/donor to decide if he or she is willing
+ to distribute software through any other system and a licensee cannot
+ impose that choice.
+
+ This section is intended to make thoroughly clear what is believed to
+ be a consequence of the rest of this License.
+
+#. If the distribution and/or use of the Library is restricted in
+ certain countries either by patents or by copyrighted interfaces, the
+ original copyright holder who places the Library under this License may add
+ an explicit geographical distribution limitation excluding those countries,
+ so that distribution is permitted only in or among countries not thus
+ excluded. In such case, this License incorporates the limitation as if
+ written in the body of this License.
+
+#. The Free Software Foundation may publish revised and/or new
+ versions of the Lesser General Public License from time to time.
+ Such new versions will be similar in spirit to the present version,
+ but may differ in detail to address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the Library
+ specifies a version number of this License which applies to it and
+ 'any later version', you have the option of following the terms and
+ conditions either of that version or of any later version published by
+ the Free Software Foundation. If the Library does not specify a
+ license version number, you may choose any version ever published by
+ the Free Software Foundation.
+
+#. If you wish to incorporate parts of the Library into other free
+ programs whose distribution conditions are incompatible with these,
+ write to the author to ask for permission. For software which is
+ copyrighted by the Free Software Foundation, write to the Free
+ Software Foundation; we sometimes make exceptions for this. Our
+ decision will be guided by the two goals of preserving the free status
+ of all derivatives of our free software and of promoting the sharing
+ and reuse of software generally.
+
+ NO WARRANTY
+
+#. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+ WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+ EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+ OTHER PARTIES PROVIDE THE LIBRARY 'AS IS' WITHOUT WARRANTY OF ANY
+ KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+ LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+ THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+#. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+ WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+ AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+ FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+ CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+ LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+ RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+ FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+ SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+ DAMAGES.
+
+How to Apply These Terms to Your New Libraries
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change. You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+To apply these terms, attach the following notices to the library. It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+'copyright' line and a pointer to where the full notice is found.
+
+.. code-block::
+
+ one line to give the library's name and an idea of what it does.
+ Copyright (C) year name of author
+
+ This library is free software; you can redistribute it and/or modify it
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or (at
+ your option) any later version.
+
+ This library is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
+ USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a 'copyright disclaimer' for the library, if
+necessary. Here is a sample; alter the names:
+
+.. code-block::
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the library
+ `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+ signature of Ty Coon, 1 April 1990
+ Ty Coon, President of Vice
+
+That's all there is to it!
\ No newline at end of file
diff --git a/doc/logo.pdf b/doc/logo.pdf
new file mode 100644
index 00000000000..4ba78b166b4
Binary files /dev/null and b/doc/logo.pdf differ
diff --git a/doc/logo.svg b/doc/logo.svg
new file mode 100644
index 00000000000..0b8ed020c89
--- /dev/null
+++ b/doc/logo.svg
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ height="540"
+ width="1200"
+ version="1.0"
+ viewBox="-67.8426 -135.03825 587.9692 546.90491"
+ id="svg128"
+ sodipodi:docname="GNU_Compiler_Collection-Logo.wine.svg"
+ inkscape:version="1.1.1 (3bf5ae0d25, 2021-09-20)"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:svg="http://www.w3.org/2000/svg">
+ <defs
+ id="defs132" />
+ <sodipodi:namedview
+ id="namedview130"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageshadow="2"
+ inkscape:pageopacity="0.0"
+ inkscape:pagecheckerboard="0"
+ showgrid="false"
+ inkscape:zoom="1.0925"
+ inkscape:cx="374.82838"
+ inkscape:cy="287.41419"
+ inkscape:window-width="1920"
+ inkscape:window-height="1131"
+ inkscape:window-x="0"
+ inkscape:window-y="0"
+ inkscape:window-maximized="1"
+ inkscape:current-layer="svg128" />
+ <g
+ fill-rule="evenodd"
+ id="g116"
+ transform="translate(0,-131.66225)">
+ <path
+ d="m 303,44.525 -20.28,31.012 96.148,111.602 c 4.512,-18.463 7.814,1.677 11.502,9.483 9.878,22.334 11.416,47.222 14.496,71.119 5.83,45.229 3.909,71.701 -0.24,96.382 -13.444,79.974 -61.135,126.653 -106.685,153.529 -15.58,9.193 -30.577,15.62 -52.573,18.622 -22.665,3.092 -44.872,1.868 -67.626,-2.566 -18.784,-3.66 -37.677,-9.828 -55.026,-17.78 C 95.053,503.251 72.219,481.309 54.346,457.238 37.056,433.95 26.15,406.161 17.866,378.315 2.8,327.665 -3.57,273.727 8.448,221.622 c 7.49,-32.48 18.292,-64.643 33.064,-94.3 15.676,-31.471 37.71,-59.974 64.381,-83.609 16.017,-14.193 33.428,-27.271 53.03,-35.166 14.378,-5.791 29.598,-7.096 45.31,-6.06 15.537,1.025 30.367,2.765 45.167,8.029 20.14,7.162 39.12,18.366 53.6,34.009 z"
+ fill="#ffcfab"
+ stroke="#000000"
+ stroke-width="4.327"
+ id="path102" />
+ <path
+ d="m 153.818,179.408 -11.16,-28.33 12.019,-6.008 24.038,-3.435 44.64,-54.942 24.895,3.434 16.31,-8.585 12.02,-2.575 -18.886,41.206 -36.914,4.293 z"
+ fill="#f39105"
+ stroke="#000000"
+ stroke-width="1.041"
+ id="path104" />
+ <path
+ d="m 314.352,64.373 19.746,24.895 5.15,8.586 -37.773,-12.878 4.293,-12.018 z"
+ fill="#ffcfab"
+ stroke="#000000"
+ stroke-width="1.041"
+ id="path106" />
+ <path
+ d="m 299.759,83.26 18.886,10.301 19.744,6.01 -26.612,14.594 -19.744,-1.718 -1.718,-13.735 z"
+ fill="#f39a05"
+ stroke="#000000"
+ stroke-width="1.041"
+ id="path108" />
+ <path
+ d="m 154.677,181.125 13.736,22.32 -13.736,35.197 32.622,6.01 6.867,6.867 20.604,31.764 65.244,-34.339 19.422,5.366 20.926,-6.224 -14.594,-15.453 2.575,-4.292 6.868,-4.292 3.434,11.16 6.009,13.735 16.31,19.745 4.293,-2.575 0.859,-12.877 15.16,-2.67 5.35,-4.157 13.393,-1.623 3.44,-16.875 -9.872,-40.777 v -17.17 l 15.453,-2.576 13.735,10.302 19.744,5.151 7.727,-1.717 -23.178,-29.188 -14.248,-14.587 -8.073,-5.157 -15.453,-10.302 -31.763,1.716 -24.895,6.01 -21.463,10.302 -12.876,-1.717 -16.311,-7.727 -5.151,-7.726 -33.48,-0.858 z"
+ fill="#ab9a7e"
+ stroke="#000000"
+ stroke-width="1.041"
+ id="path110" />
+ <path
+ d="m 315.211,223.19 4.292,11.16 -2.575,6.868 -12.877,-7.727 3.434,-6.009 z m 19.745,-46.357 13.735,-12.019 7.726,-0.858 2.576,4.292 -12.018,12.877 -6.868,2.575 z m 24.844,-59.538 -42.014,10.605 -27.472,11.16 -24.037,-6.867 -8.584,-10.302 22.32,-50.65 20.913,-25.9 13.7,-5.426 15.178,2.996 15.724,23.078 16.479,11.037 -1.898,3.338 -24.296,-8.265 -21.462,-9.443 -20.601,31.764 -4.292,11.161 3.434,10.302 55.8,-9.444 5.958,4.951 z m 16.363,6.312 9.835,12.59 6.206,0.175 22.94,25.516 5.706,6.92 10.255,-6.57 12.018,-26.612 6.668,-21.158 0.91,-17.724 -5.505,-6.617 h -19.242 l -14.595,3.434 c 0,0 -12.018,6.01 -8.584,6.01 3.434,0 19.744,5.15 19.744,5.15 l 6.868,5.15 1.718,7.727 -9.444,18.886 -4.292,4.293 -19.745,-12.877 -6.009,-4.293 -6.01,-0.858 z"
+ fill="#ffffff"
+ stroke="#000000"
+ stroke-width="1.041"
+ id="path112" />
+ <path
+ d="m 368.144,223.975 c -0.266,-1.973 -13.507,0 -13.507,0 0,0 -2.314,7.892 1.063,7.892 3.376,0 12.71,-5.919 12.444,-7.892 z"
+ fill="#ffffff"
+ stroke="#9e0000"
+ stroke-width="1.041"
+ id="path114" />
+ </g>
+ <path
+ d="m 385.627,44.897838 c 1.924,-3.083004 6.639,-2.695004 14.34,2.072004 6.27,3.705008 14.536,4.468012 23.39,5.075012 14.502,0.994 13.344,-1.162004 6.537,-8.021016 l -8.202,-7.358016 c 0,0 3.018,1.747004 8.024,-2.880004 6.702,-6.195012 19.56,-34.70006626 21.84,-55.220105 2.565,-20.807021 -0.856,-23.942021 -23.087,-21.377021 -9.12,1.14 -20.103,3.82 -24.664,6.670001 0,0 -6.513,3.26 -5.515,5.112 0.998,1.853004 9.658,2.754004 9.658,2.754004 16.246,2.565004 20.695,7.940016 20.695,13.925028 0,6.2700117 -8.44,21.7020416 -12.43,21.7020416 -1.425,0 -6.555,-3.9900074 -11.4,-8.5500149 -9.691,-9.4060187 -14.907,-10.6380227 -24.283,-7.851015 -5.265,-1.4430037 -12.908,-2.2020037 -19.081,-5.7500117 -1.513,-0.870004 -0.552,-2.092004 -3.546,-5.855012 -5.412,-6.799012 -9.525,-6.196012 -15.225,-4.770008 -7.126,1.71 -7.41,1.71 -1.995,-2.281008 5.415,-3.990004 5.13,-4.560004 -6.84,-20.236005 l -11.971,-16.247 14.25,7.126 c 14.537,7.41 27.077,9.406 29.928,4.845 1.14,-1.425 -2.85,-5.13 -8.836,-7.98 -5.7,-2.85 -12.54,-9.406 -15.106,-14.251 -2.85,-5.13 -6.556,-11.116 -8.266,-13.396 -4.275,-4.846 -19.19,-7.454 -27.209,-4.421 -8.176,3.092 -13.246,11.403 -19.804,19.996 -5.537,7.254 -8.622,12.728 -11.21,17.135 -5.33,-1.259 -14.457,2.632 -18.162,6.052 -6.27,5.7 -7.695,5.986 -19.951,2.85 -12.256,-3.42 -13.681,-3.135 -20.237,2.85 -3.705,3.706 -13.966,16.532009 -22.801,28.503033 -8.55,12.256023 -16.531,22.2310416 -17.387,22.5160416 -0.855,0 -6.84,0.5699997 -13.11,1.1399997 -6.27,0.570004 -14.821,2.2800077 -19.097,3.9900077 -6.84,2.566008 -7.41,3.706008 -5.415,11.117024 1.425,4.275008 7.695,17.386036 14.25,28.787056 l 11.687,20.52104 -7.126,17.101036 c -3.99,9.406016 -6.555,18.24102 -5.7,19.38202 0.855,1.425 9.12,3.42 18.526,4.56 l 17.101,1.995 13.111,19.666 c 12.256,18.527 14.444,19.564 18.811,17.387 1.47,-0.733 8.551,-5.7 17.957,-10.261 9.405,-4.846 22.231,-11.971 28.502,-16.246 8.872,-5.856 17.855,-7.845 22.615,-6.036 2.886,1.096 4.22,3.588 3.036,7.46 -2.488,7.998 -2.374,12.975 -1.258,18.163 1.944,2.077 4.45,3.027 8.099,5.494 12.578,7.73 17.386,8.266 17.671,0 v -6.27 l 3.135,6.555 c 4.56,9.406 11.971,6.84 13.111,-4.845 0.855,-6.84 -0.855,-11.4 -5.415,-16.246 -3.42,-3.705 -5.2,-8.557 -3.776,-8.557 2.85,0 12.612,13.117 12.612,16.538 0,1.14 1.71,2.28 3.99,2.28 4.275,0 7.41,-5.986 7.41,-14.251 0,-3.15 8.505,-4.926 16.44,-7.738 2.118,-0.75 2.103,-1.813 4.13,-3.2 3.83,0.802 2.57,0.855 5.427,0.652 4.25,-0.302 6.144,-1.5 7.35,-3.395 5.986,-9.69 6.841,-21.94702 2.28,-32.77804 -2.28,-5.700012 -4.274,-17.529036 -3.99,-22.660044 0,0 0.273,-3.388008 1.526,-6.740016 m -33.163,37.666076 c 0,-5.700012 -1.14,-5.700012 -11.4,-0.285 -4.846,2.565004 -8.551,6.556012 -8.551,9.120016 0,6.556008 8.266,15.107008 14.536,15.107008 2.85,0 16.565,2.565 20.304,2.606 -0.08,1.09 -1.658,2.04 -2.698,2.373 -4.318,1.38 -11.374,0.61 -13.9,0.151 -4.561,-0.57 -5.131,0.855 -4.846,9.12 0.57,5.416 0,7.981 -1.14,5.701 -0.855,-2.28 -4.846,-7.41 -9.12,-11.4 -4.561,-4.276 -7.696,-11.116 -8.266,-17.102 C 321.301,90.86293 315.601,80.60191 304.2,70.91189 292.23,60.93587 287.67,52.955854 289.95,44.974838 c 1.14,-4.560008 3.705,-6.270012 9.12,-6.270012 9.69,-0.285 27.932,-8.551016 39.618,-18.242036 15.39,-13.3960234 10.26,-13.9660274 -7.98,-1.14 -15.107,10.54602 -19.382,12.256024 -36.483,13.111024 l -19.097,1.425004 9.406,-9.69002 c 4.845,-5.130008 9.12,-10.26102 9.12,-11.401024 0,-5.9860114 26.222,-17.1010297 45.889,-19.3820334 27.932,-3.1350079 29.357,-2.8500079 31.067,6.55601084 1.995,10.83001856 8.265,13.39602656 6.555,2.56500376 -1.14,-7.6950109 -1.14,-7.6950109 3.136,-2.56500376 2.565,3.13500776 4.56,8.83601486 4.56,12.82602256 0,3.990008 0.855,10.26002 1.71,13.680028 1.425,4.846012 0,6.271012 -7.41,7.981016 l -9.406,1.995004 1.995,16.817032 c 0.855,9.12002 3.705,21.376044 5.985,27.361056 4.276,9.97602 3.42,27.64704 -1.425,30.78304 -1.14,0.855 -8.265,0.57 -15.39,-0.285 -11.687,-1.71 -13.112,-2.566 -13.112,-9.406 M 326.432,-87.844308 c 2.565,1.14 7.125,6.84 9.976,12.826 3.135,5.985 8.55,12.826 11.97,15.106 3.495,2.483 12.566,6.022 12.045,6.512 -1.095,1.03 -17.58,-4.14 -28.006,-9.933 -7.98,-4.56 -16.246,-7.695 -18.241,-6.84 -2.28,0.57 -8.836,8.836 -15.106,18.526 -12.54,19.382001 -14.821,34.488029 -5.7,37.623033 5.415,1.710004 45.598,-7.799016 52.158,-8.836016 4.746,-0.750004 10.83,3.990008 10.83,7.410016 0,1.14 -8.55,2.851004 -18.81,3.706004 -12.256,1.140004 -23.372,4.2750076 -31.638,9.120019 -14.82,8.2660149 -23.371,8.8360146 -35.057,2.85000344 -11.686,-5.98501114 -11.116,-12.25502244 5.7,-45.88705944 18.527,-37.908 31.638,-49.024 49.879,-42.183 z m -1.425,34.487 c 12.256,18.526001 12.256,17.671001 3.705,15.391001 -12.54,-3.705001 -22.369,-9.513001 -24.73,-11.075001 2.04,-4.487 7.059,-14.862 10.479,-14.862 1.995,0 6.555,4.846 10.546,10.546 z m -54.154,4.846 c 0,0.57 -3.135,7.98 -7.126,16.816001 -6.555,13.966024 -8.265,15.676028 -17.956,17.386032 -5.7,0.855 -14.25,1.710004 -19.096,1.710004 -6.84,0 -13.396,4.5600077 -31.352,22.2320413 C 182.782,21.887794 168.531,34.713818 163.686,38.134826 l -8.836,5.985012 -5.13,-11.400024 c -6.27,-13.967028 -4.56,-16.247032 15.106,-17.957036 16.246,-1.425 17.956,-2.565004 31.067,-21.6620374 4.845,-7.1250156 13.68,-18.5260356 19.951,-25.3660476 9.69,-11.116001 11.686,-12.256001 17.101,-9.121001 9.121,4.845 19.382,3.705001 26.792,-2.565 6.27,-5.13 11.116,-7.126 11.116,-4.56 z m 51.019,13.965 12.54,3.990001 -9.69,4.846008 c -5.13,2.565008 -13.966,5.415012 -19.667,6.270016 -12.826,1.996004 -15.39,-1.995004 -9.69,-15.390024 2.352,-5.973001 3.931,-7.340001 5.25,-9.510001 1.484,0.567 14.416,7.514001 21.257,9.794 z m 126.963,6.086005 c 0.57,9.97602 -3.55,22.9870433 -9.25,36.9520693 C 430.749,30.72381 421.955,39.36683 416.824,30.24581 413.86,25.058802 406.978,14.679778 395.487,5.2477629 c -0.863,-0.709004 -1.98,-1.8550037 -4.438,-2.4200037 -3.59,-0.827004 -4.584,0.584 -5.518,-0.136004 -4.812,-6.4400112 -4.66,-9.3060146 1.61,-9.5900146 3.42,0 8.55,2.5650037 11.4,5.98501114 2.566,3.13500346 8.266,7.69501086 12.257,9.69001456 6.84,3.7060077 7.98,3.4200077 13.966,-2.8500034 4.56,-4.8450074 7.146,-11.7470226 7.599,-20.4800379 0.446,-8.592016 -2.754,-13.437028 -17.29,-16.572032 -4.275,-0.855 -12.722,-0.744 -11.582,-1.6 2.565,-2.565 27.258,-7.806001 35.524,-7.520001 6.555,0.57 9.553,-0.112 9.82,11.785005 z M 269.713,5.6417629 c 5.415,2.5650034 11.686,4.5600071 13.966,4.5600071 7.41,0 -1.425,10.54602 -13.396,15.962032 -5.985,2.565004 -10.83,5.700012 -10.83,6.840012 0,1.140004 5.7,3.135008 12.825,4.275012 11.4,1.426 12.826,2.566004 11.4,7.411012 -2.85,9.12002 3.421,20.52104 17.387,32.492064 11.116,9.12002 12.541,11.401024 9.12,14.536028 -2.85,2.850008 -7.125,3.420008 -16.53,1.710004 l -12.826,-2.280004 0.855,-14.820028 c 0.855,-16.247032 -3.42,-20.23704 -6.27,-5.986012 -4.276,21.661044 -1.71,25.652052 18.526,29.357056 5.7,0.855004 13.11,4.845004 16.53,8.550004 l 6.271,6.84 -8.265,2.851 c -4.846,1.71 -9.691,1.995 -10.831,0.57 -5.986,-5.13 -20.237,-5.13 -28.217,0 l -8.266,5.416 -11.4,-9.121 C 233.8,102.54895 231.805,99.413946 226.39,82.312914 222.4,68.631886 218.124,62.075874 215.274,64.925878 c -0.57,0.57 1.425,8.83602 4.845,18.812036 5.416,16.816036 13.111,27.077036 29.358,38.762036 3.135,2.28 5.13,4.56 4.275,5.416 -1.995,1.71 -36.483,19.096 -38.193,19.096 -0.855,0 -6.84,-8.265 -13.396,-18.526 -10.26,-15.961 -13.11,-18.526 -20.806,-18.811 -4.846,-0.286 -12.256,-1.14 -16.531,-2.28 l -7.41,-1.71 6.84,-16.532024 7.125,-16.531032 -6.27,-9.97602 c -3.706,-6.270012 -5.13,-11.686024 -3.99,-14.820028 1.995,-4.276008 2.565,-3.991008 3.99,1.710004 2.28,8.835016 6.84,8.265016 7.41,-0.856004 0,-3.990008 3.99,-10.83002 8.266,-15.106028 4.56,-4.275008 7.41,-6.270012 6.27,-4.275008 -1.995,3.990008 0.855,12.256024 4.275,12.256024 1.426,0 2.566,-4.276008 2.566,-9.40602 0,-6.555012 3.135,-12.540024 11.4,-21.946044 9.691,-11.11601826 11.116,-11.9710223 11.401,-6.5560108 0,3.7050074 1.71,6.5560108 3.705,6.5560108 2.566,0 3.42,-2.5660034 2.566,-8.2660148 l -1.14,-8.5500146 16.53,-0.856004 c 13.112,-0.5699999 17.387,0.285004 19.097,3.7060074 1.425,2.5650077 6.84,6.8400152 12.256,9.4050189 z m 80.732,89.2581751 c -0.223,1.481004 0.336,3.408008 0.966,4.551008 2.918,5.304004 11.358,3.511004 18.059,-4.027008 3.99,-4.276008 3.99,-5.416008 0.57,-6.841012 -4.01,-1.755004 -15.928,-0.137 -17.815,1.794004 -1.134,1.16 -1.557,3.046004 -1.78,4.523008 z m 55.792,-73.582144 c 3.136,3.990008 8.551,11.68602 12.256,16.817032 0,0 2.398,2.973004 5.164,5.682012 2.765,2.708004 5.899,5.152008 5.899,5.152008 0,0 -4.589,0.22 -14.483,-2.569004 -22.732,-6.408012 -24.227,-9.69002 -22.517,-16.531032 1.426,-5.415012 1.996,-5.415012 9.406,1.710004 3.99,3.990008 8.55,6.270012 9.406,5.130008 3.135,-2.850004 -12.256,-17.670032 -16.816,-15.960032 -3.99,1.424004 -7.574,-9.238016 -6.573,-14.1160274 0.27,-1.3169997 1.602,-1.3559997 3.366,-0.595 3.531,1.523004 8.456,7.2340154 14.892,15.2800314 z M 381.156,40.69983 c -1.14,0.855004 -2.85,0.855004 -3.99,0 -0.856,-1.14 0,-1.995004 1.995,-1.995004 1.995,0 2.85,0.855004 1.995,1.995004 z m -39.048,59.284116 c 0,7.410004 -3.99,9.405004 -7.126,4.275004 -2.565,-3.99 0.285,-11.400016 4.276,-11.400016 1.425,0 2.85,3.135008 2.85,7.125012 z m 23.712,-6.593012 c 0,1.568004 -9.047,6.954016 -10.242,3.605008 -1.23,-3.444008 1.287,-4.303008 4.408,-4.593008 3.269,-0.303 5.834,-0.580004 5.834,0.988 z m -49.364,6.593012 c 0,2.280004 -1.14,4.275004 -2.565,4.275004 -3.705,0 -6.27,-4.560004 -3.99,-6.840008 3.135,-3.136004 6.555,-1.710004 6.555,2.565004 z"
+ id="path118" />
+ <path
+ d="m 356.929,26.447802 c 4.275,4.276008 8.836,6.841016 9.69,5.701012 2.85,-2.850004 -7.41,-13.396028 -12.825,-13.396028 -3.135,0 -2.28,1.995004 3.135,7.696016 z m -18.526,10.831024 c -6.27,5.986008 -7.126,8.551016 -4.846,12.826024 1.71,3.136004 5.13,5.700012 7.41,5.700012 5.986,0 21.947,-16.245032 20.522,-20.806044 -2.28,-6.555012 -14.82,-5.415008 -23.086,2.280008 z m 17.956,-1.425004 c 0,1.425004 -1.995,2.850004 -4.275,2.850004 -2.28,0 -5.416,2.566008 -7.126,5.701012 -1.71,3.135008 -4.56,4.845008 -6.27,3.990008 -1.995,-1.425004 -0.57,-4.560008 4.56,-8.835016 8.266,-6.840016 13.11,-8.266016 13.11,-3.706008 z"
+ id="path120" />
+ <path
+ d="m 315.818,92.182934 c 0,0 -1.9,2.033004 -4.078,3.564004 -2.177,1.531004 -4.936,2.560008 -4.936,2.560008 0,0 10.265,13.270004 11.767,11.553004 1.503,-1.717 0.414,-4.67 -0.23,-8.533 -0.65,-3.904008 -2.523,-9.144016 -2.523,-9.144016 z"
+ fill="#ffcfab"
+ fill-rule="evenodd"
+ stroke="#000000"
+ stroke-width="1.291"
+ id="path122" />
+ <path
+ d="m 112.598,300.82495 c -13.66,0 -24.324,-3.37 -31.996,-10.111 -7.672,-6.741 -11.508,-16.32 -11.508,-28.737 0,-9.136 1.408,-17.583 4.224,-25.344 2.816,-7.76 6.907,-14.523 12.273,-20.29 5.322,-5.72 11.852,-10.2 19.59,-13.436 7.738,-3.237 16.44,-4.856 26.109,-4.856 5.81,0 11.608,0.698 17.395,2.095 5.787,1.397 11.696,3.67 17.728,6.818 l -2.993,15.034 h -1.198 c -4.922,-4.612 -10.277,-7.949 -16.065,-10.01 -5.787,-2.063 -12.007,-3.094 -18.659,-3.094 -7.317,0 -13.725,1.442 -19.224,4.324 -5.499,2.883 -10.133,6.719 -13.903,11.508 -3.68,4.7 -6.463,10.178 -8.348,16.43 -1.885,6.253 -2.827,12.55 -2.827,18.892 0,9.535 2.605,16.896 7.816,22.085 5.21,5.189 12.916,7.783 23.116,7.783 4.479,0 8.68,-0.41 12.606,-1.23 3.924,-0.821 7.616,-1.874 11.076,-3.16 l 5.588,-25.344 H 116.99 l 2.527,-11.11 h 39.646 l -9.845,42.507 a 2926.464,2926.464 0 0 1 -7.916,3.226 c -2.35,0.953 -5.3,1.94 -8.847,2.96 a 90.918,90.918 0 0 1 -9.479,2.195 c -3.26,0.577 -6.752,0.865 -10.477,0.865 z m 102.37,-0.13 c -12.55,0 -22.395,-3.249 -29.535,-9.745 -7.14,-6.497 -10.71,-15.71 -10.71,-27.64 0,-9.135 1.375,-17.65 4.124,-25.543 2.75,-7.894 6.696,-14.812 11.841,-20.754 5.1,-5.854 11.375,-10.477 18.825,-13.87 7.45,-3.392 15.765,-5.088 24.945,-5.088 5.72,0 11.131,0.698 16.231,2.095 5.1,1.397 10.333,3.603 15.7,6.619 l -2.994,14.9 h -0.998 a 75.024,75.024 0 0 0 -4.424,-4.091 c -1.485,-1.264 -3.714,-2.65 -6.685,-4.158 -2.44,-1.286 -5.344,-2.361 -8.714,-3.226 -3.37,-0.865 -7.096,-1.297 -11.175,-1.297 -6.209,0 -11.907,1.297 -17.096,3.891 -5.189,2.595 -9.69,6.22 -13.504,10.876 -3.725,4.524 -6.652,10.022 -8.78,16.497 -2.13,6.475 -3.194,13.371 -3.194,20.688 0,9.136 2.373,16.242 7.118,21.32 4.745,5.078 11.597,7.617 20.555,7.617 4.213,0 8.215,-0.477 12.007,-1.43 3.792,-0.954 7.24,-2.162 10.344,-3.626 2.882,-1.374 5.477,-2.816 7.783,-4.323 2.306,-1.508 4.28,-2.905 5.92,-4.191 h 0.931 l -3.126,15.3 c -4.657,2.35 -10.011,4.468 -16.065,6.353 -6.054,1.884 -12.495,2.827 -19.324,2.827 z m 95.26,0 c -12.55,0 -22.395,-3.249 -29.535,-9.745 -7.14,-6.497 -10.71,-15.71 -10.71,-27.64 0,-9.135 1.375,-17.65 4.124,-25.543 2.75,-7.894 6.696,-14.812 11.841,-20.754 5.1,-5.854 11.375,-10.477 18.825,-13.87 7.45,-3.392 15.765,-5.088 24.945,-5.088 5.72,0 11.131,0.698 16.231,2.095 5.1,1.397 10.333,3.603 15.7,6.619 l -2.994,14.9 h -0.998 a 75.024,75.024 0 0 0 -4.424,-4.091 c -1.485,-1.264 -3.714,-2.65 -6.685,-4.158 -2.44,-1.286 -5.344,-2.361 -8.714,-3.226 -3.37,-0.865 -7.095,-1.297 -11.175,-1.297 -6.209,0 -11.907,1.297 -17.096,3.891 -5.189,2.595 -9.69,6.22 -13.504,10.876 -3.725,4.524 -6.652,10.022 -8.78,16.497 -2.13,6.475 -3.194,13.371 -3.194,20.688 0,9.136 2.373,16.242 7.118,21.32 4.745,5.078 11.597,7.617 20.555,7.617 4.213,0 8.215,-0.477 12.007,-1.43 3.792,-0.954 7.24,-2.162 10.344,-3.626 2.883,-1.374 5.477,-2.816 7.783,-4.323 2.306,-1.508 4.28,-2.905 5.92,-4.191 h 0.931 l -3.126,15.3 c -4.657,2.35 -10.011,4.468 -16.065,6.353 -6.053,1.884 -12.495,2.827 -19.324,2.827 z"
+ font-size="32.055px"
+ font-family="Sans"
+ letter-spacing="0"
+ word-spacing="0"
+ id="path124" />
+ <path
+ d="m 343.483,91.25093 c -0.91,-4.060008 -11.913,3.490008 -12.065,7.891016 -0.151,4.401004 10.696,12.954004 11.534,9.106004 0.835,-3.832 1.435,-12.967012 0.531,-16.99702 z"
+ fill="#ffffff"
+ fill-rule="evenodd"
+ stroke="#000000"
+ stroke-width="1.041"
+ id="path126" />
+</svg>
diff --git a/doc/md.rst b/doc/md.rst
new file mode 100644
index 00000000000..faa59529b68
--- /dev/null
+++ b/doc/md.rst
@@ -0,0 +1,3179 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: simple constraints
+
+.. _simple-constraints:
+
+Simple Constraints
+^^^^^^^^^^^^^^^^^^
+
+The simplest kind of constraint is a string full of letters, each of
+which describes one kind of operand that is permitted. Here are
+the letters that are allowed:
+
+whitespace
+ Whitespace characters are ignored and can be inserted at any position
+ except the first. This enables each alternative for different operands to
+ be visually aligned in the machine description even if they have different
+ number of constraints and modifiers.
+
+ .. index:: m in constraint, memory references in constraints
+
+m
+ A memory operand is allowed, with any kind of address that the machine
+ supports in general.
+ Note that the letter used for the general memory constraint can be
+ re-defined by a back end using the ``TARGET_MEM_CONSTRAINT`` macro.
+
+ .. index:: offsettable address, o in constraint
+
+o
+ A memory operand is allowed, but only if the address is
+ :dfn:`offsettable`. This means that adding a small integer (actually,
+ the width in bytes of the operand, as determined by its machine mode)
+ may be added to the address and the result is also a valid memory
+ address.
+
+ .. index:: autoincrement/decrement addressing
+
+ For example, an address which is constant is offsettable; so is an
+ address that is the sum of a register and a constant (as long as a
+ slightly larger constant is also within the range of address-offsets
+ supported by the machine); but an autoincrement or autodecrement
+ address is not offsettable. More complicated indirect/indexed
+ addresses may or may not be offsettable depending on the other
+ addressing modes that the machine supports.
+
+ Note that in an output operand which can be matched by another
+ operand, the constraint letter :samp:`o` is valid only when accompanied
+ by both :samp:`<` (if the target machine has predecrement addressing)
+ and :samp:`>` (if the target machine has preincrement addressing).
+
+ .. index:: V in constraint
+
+V
+ A memory operand that is not offsettable. In other words, anything that
+ would fit the :samp:`m` constraint but not the :samp:`o` constraint.
+
+ .. index:: < in constraint
+
+<
+ A memory operand with autodecrement addressing (either predecrement or
+ postdecrement) is allowed. In inline ``asm`` this constraint is only
+ allowed if the operand is used exactly once in an instruction that can
+ handle the side effects. Not using an operand with :samp:`<` in constraint
+ string in the inline ``asm`` pattern at all or using it in multiple
+ instructions isn't valid, because the side effects wouldn't be performed
+ or would be performed more than once. Furthermore, on some targets
+ the operand with :samp:`<` in constraint string must be accompanied by
+ special instruction suffixes like ``%U0`` instruction suffix on PowerPC
+ or ``%P0`` on IA-64.
+
+ .. index:: > in constraint
+
+>
+ A memory operand with autoincrement addressing (either preincrement or
+ postincrement) is allowed. In inline ``asm`` the same restrictions
+ as for :samp:`<` apply.
+
+ .. index:: r in constraint, registers in constraints
+
+r
+ A register operand is allowed provided that it is in a general
+ register.
+
+ .. index:: constants in constraints, i in constraint
+
+i
+ An immediate integer operand (one with constant value) is allowed.
+ This includes symbolic constants whose values will be known only at
+ assembly time or later.
+
+ .. index:: n in constraint
+
+n
+ An immediate integer operand with a known numeric value is allowed.
+ Many systems cannot support assembly-time constants for operands less
+ than a word wide. Constraints for these operands should use :samp:`n`
+ rather than :samp:`i`.
+
+ .. index:: I in constraint
+
+:samp:`{I}, {J}, {K}, ... {P}`
+ Other letters in the range :samp:`I` through :samp:`P` may be defined in
+ a machine-dependent fashion to permit immediate integer operands with
+ explicit integer values in specified ranges. For example, on the
+ 68000, :samp:`I` is defined to stand for the range of values 1 to 8.
+ This is the range permitted as a shift count in the shift
+ instructions.
+
+ .. index:: E in constraint
+
+E
+ An immediate floating operand (expression code ``const_double``) is
+ allowed, but only if the target floating point format is the same as
+ that of the host machine (on which the compiler is running).
+
+ .. index:: F in constraint
+
+F
+ An immediate floating operand (expression code ``const_double`` or
+ ``const_vector``) is allowed.
+
+ .. index:: G in constraint, H in constraint
+
+:samp:`{G}, {H}`
+ :samp:`G` and :samp:`H` may be defined in a machine-dependent fashion to
+ permit immediate floating operands in particular ranges of values.
+
+ .. index:: s in constraint
+
+s
+ An immediate integer operand whose value is not an explicit integer is
+ allowed.
+
+ This might appear strange; if an insn allows a constant operand with a
+ value not known at compile time, it certainly must allow any known
+ value. So why use :samp:`s` instead of :samp:`i`? Sometimes it allows
+ better code to be generated.
+
+ For example, on the 68000 in a fullword instruction it is possible to
+ use an immediate operand; but if the immediate value is between -128
+ and 127, better code results from loading the value into a register and
+ using the register. This is because the load into the register can be
+ done with a :samp:`moveq` instruction. We arrange for this to happen
+ by defining the letter :samp:`K` to mean 'any integer outside the
+ range -128 to 127', and then specifying :samp:`Ks` in the operand
+ constraints.
+
+ .. index:: g in constraint
+
+g
+ Any register, memory or immediate integer operand is allowed, except for
+ registers that are not general registers.
+
+ .. index:: X in constraint
+
+X
+
+ .. only:: gccint
+
+ Any operand whatsoever is allowed, even if it does not satisfy
+ ``general_operand``. This is normally used in the constraint of
+ a ``match_scratch`` when certain alternatives will not actually
+ require a scratch register.
+
+ .. only:: not gccint
+
+ Any operand whatsoever is allowed.
+
+ .. index:: 0 in constraint, digits in constraint
+
+:samp:`{0}, {1}, {2}, ... {9}`
+ An operand that matches the specified operand number is allowed. If a
+ digit is used together with letters within the same alternative, the
+ digit should come last.
+
+ This number is allowed to be more than a single digit. If multiple
+ digits are encountered consecutively, they are interpreted as a single
+ decimal integer. There is scant chance for ambiguity, since to-date
+ it has never been desirable that :samp:`10` be interpreted as matching
+ either operand 1 *or* operand 0. Should this be desired, one
+ can use multiple alternatives instead.
+
+ .. index:: matching constraint, constraint, matching
+
+ This is called a :dfn:`matching constraint` and what it really means is
+ that the assembler has only a single operand that fills two roles
+
+ .. only:: gccint
+
+ considered separate in the RTL insn. For example, an add insn has two
+ input operands and one output operand in the RTL, but on most CISC
+
+ .. only:: not gccint
+
+ which ``asm`` distinguishes. For example, an add instruction uses
+ two input operands and an output operand, but on most CISC
+
+ machines an add instruction really has only two operands, one of them an
+ input-output operand:
+
+ .. code-block::
+
+ addl #35,r12
+
+ Matching constraints are used in these circumstances.
+ More precisely, the two operands that match must include one input-only
+ operand and one output-only operand. Moreover, the digit must be a
+ smaller number than the number of the operand that uses it in the
+ constraint.
+
+ .. only:: gccint
+
+ For operands to match in a particular case usually means that they
+ are identical-looking RTL expressions. But in a few special cases
+ specific kinds of dissimilarity are allowed. For example, ``*x``
+ as an input operand will match ``*x++`` as an output operand.
+ For proper results in such cases, the output template should always
+ use the output-operand's number when printing the operand.
+
+ .. index:: load address instruction, push address instruction, address constraints, p in constraint
+
+p
+ An operand that is a valid memory address is allowed. This is
+ for 'load address' and 'push address' instructions.
+
+ .. index:: address_operand
+
+ :samp:`p` in the constraint must be accompanied by ``address_operand``
+ as the predicate in the ``match_operand``. This predicate interprets
+ the mode specified in the ``match_operand`` as the mode of the memory
+ reference for which the address would be valid.
+
+ .. index:: other register constraints, extensible constraints
+
+other-letters
+ Other letters can be defined in machine-dependent fashion to stand for
+ particular classes of registers or other arbitrary operand types.
+ :samp:`d`, :samp:`a` and :samp:`f` are defined on the 68000/68020 to stand
+ for data, address and floating point registers.
+
+.. only:: gccint
+
+ In order to have valid assembler code, each operand must satisfy
+ its constraint. But a failure to do so does not prevent the pattern
+ from applying to an insn. Instead, it directs the compiler to modify
+ the code so that the constraint will be satisfied. Usually this is
+ done by copying an operand into a register.
+
+ Contrast, therefore, the two instruction patterns that follow:
+
+ .. code-block:: c++
+
+ (define_insn ""
+ [(set (match_operand:SI 0 "general_operand" "=r")
+ (plus:SI (match_dup 0)
+ (match_operand:SI 1 "general_operand" "r")))]
+ ""
+ "...")
+
+ which has two operands, one of which must appear in two places, and
+
+ .. code-block:: c++
+
+ (define_insn ""
+ [(set (match_operand:SI 0 "general_operand" "=r")
+ (plus:SI (match_operand:SI 1 "general_operand" "0")
+ (match_operand:SI 2 "general_operand" "r")))]
+ ""
+ "...")
+
+ which has three operands, two of which are required by a constraint to be
+ identical. If we are considering an insn of the form
+
+ .. code-block:: c++
+
+ (insn n prev next
+ (set (reg:SI 3)
+ (plus:SI (reg:SI 6) (reg:SI 109)))
+ ...)
+
+ the first pattern would not apply at all, because this insn does not
+ contain two identical subexpressions in the right place. The pattern would
+ say, 'That does not look like an add instruction; try other patterns'.
+ The second pattern would say, 'Yes, that's an add instruction, but there
+ is something wrong with it'. It would direct the reload pass of the
+ compiler to generate additional insns to make the constraint true. The
+ results might look like this:
+
+ .. code-block:: c++
+
+ (insn n2 prev n
+ (set (reg:SI 3) (reg:SI 6))
+ ...)
+
+ (insn n n2 next
+ (set (reg:SI 3)
+ (plus:SI (reg:SI 3) (reg:SI 109)))
+ ...)
+
+ It is up to you to make sure that each operand, in each pattern, has
+ constraints that can handle any RTL expression that could be present for
+ that operand. (When multiple alternatives are in use, each pattern must,
+ for each possible combination of operand expressions, have at least one
+ alternative which can handle that combination of operands.) The
+ constraints don't need to *allow* any possible operand---when this is
+ the case, they do not constrain---but they must at least point the way to
+ reloading any possible operand so that it will fit.
+
+ * If the constraint accepts whatever operands the predicate permits,
+ there is no problem: reloading is never necessary for this operand.
+
+ For example, an operand whose constraints permit everything except
+ registers is safe provided its predicate rejects registers.
+
+ An operand whose predicate accepts only constant values is safe
+ provided its constraints include the letter :samp:`i`. If any possible
+ constant value is accepted, then nothing less than :samp:`i` will do;
+ if the predicate is more selective, then the constraints may also be
+ more selective.
+
+ * Any operand expression can be reloaded by copying it into a register.
+ So if an operand's constraints allow some kind of register, it is
+ certain to be safe. It need not permit all classes of registers; the
+ compiler knows how to copy a register into another register of the
+ proper class in order to make an instruction valid.
+
+ .. index:: nonoffsettable memory reference, memory reference, nonoffsettable
+
+ * A nonoffsettable memory reference can be reloaded by copying the
+ address into a register. So if the constraint uses the letter
+ :samp:`o`, all memory references are taken care of.
+
+ * A constant operand can be reloaded by allocating space in memory to
+ hold it as preinitialized data. Then the memory reference can be used
+ in place of the constant. So if the constraint uses the letters
+ :samp:`o` or :samp:`m`, constant operands are not a problem.
+
+ * If the constraint permits a constant and a pseudo register used in an insn
+ was not allocated to a hard register and is equivalent to a constant,
+ the register will be replaced with the constant. If the predicate does
+ not permit a constant and the insn is re-recognized for some reason, the
+ compiler will crash. Thus the predicate must always recognize any
+ objects allowed by the constraint.
+
+ If the operand's predicate can recognize registers, but the constraint does
+ not permit them, it can make the compiler crash. When this operand happens
+ to be a register, the reload pass will be stymied, because it does not know
+ how to copy a register temporarily into memory.
+
+ If the predicate accepts a unary operator, the constraint applies to the
+ operand. For example, the MIPS processor at ISA level 3 supports an
+ instruction which adds two registers in ``SImode`` to produce a
+ ``DImode`` result, but only if the registers are correctly sign
+ extended. This predicate for the input operands accepts a
+ ``sign_extend`` of an ``SImode`` register. Write the constraint
+ to indicate the type of register that is required for the operand of the
+ ``sign_extend``.
+
+.. only:: not gccint
+
+ So the first alternative for the 68000's logical-or could be written as
+ ``"+m" (output) : "ir" (input)``. The second could be ``"+r"
+ (output): "irm" (input)``. However, the fact that two memory locations
+ cannot be used in a single instruction prevents simply using ``"+rm"
+ (output) : "irm" (input)``. Using multi-alternatives, this might be
+ written as ``"+m,r" (output) : "ir,irm" (input)``. This describes
+ all the available alternatives to the compiler, allowing it to choose
+ the most efficient one for the current conditions.
+
+ There is no way within the template to determine which alternative was
+ chosen. However you may be able to wrap your ``asm`` statements with
+ builtins such as ``__builtin_constant_p`` to achieve the desired results.
+
+.. index:: multiple alternative constraints
+
+.. _multi-alternative:
+
+Multiple Alternative Constraints
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Sometimes a single instruction has multiple alternative sets of possible
+operands. For example, on the 68000, a logical-or instruction can combine
+register or an immediate value into memory, or it can combine any kind of
+operand into a register; but it cannot combine one memory location into
+another.
+
+These constraints are represented as multiple alternatives. An alternative
+can be described by a series of letters for each operand. The overall
+constraint for an operand is made from the letters for this operand
+from the first alternative, a comma, the letters for this operand from
+the second alternative, a comma, and so on until the last alternative.
+All operands for a single instruction must have the same number of
+alternatives.
+
+.. only:: gccint
+
+ Here is how it is done for fullword logical-or on the 68000:
+
+ .. code-block:: c++
+
+ (define_insn "iorsi3"
+ [(set (match_operand:SI 0 "general_operand" "=m,d")
+ (ior:SI (match_operand:SI 1 "general_operand" "%0,0")
+ (match_operand:SI 2 "general_operand" "dKs,dmKs")))]
+ ...)
+
+ The first alternative has :samp:`m` (memory) for operand 0, :samp:`0` for
+ operand 1 (meaning it must match operand 0), and :samp:`dKs` for operand
+ 2. The second alternative has :samp:`d` (data register) for operand 0,
+ :samp:`0` for operand 1, and :samp:`dmKs` for operand 2. The :samp:`=` and
+ :samp:`%` in the constraints apply to all the alternatives; their
+ meaning is explained in the next section (see :ref:`class-preferences`).
+
+ If all the operands fit any one alternative, the instruction is valid.
+ Otherwise, for each alternative, the compiler counts how many instructions
+ must be added to copy the operands so that that alternative applies.
+ The alternative requiring the least copying is chosen. If two alternatives
+ need the same amount of copying, the one that comes first is chosen.
+ These choices can be altered with the :samp:`?` and :samp:`!` characters:
+
+ .. index:: ? in constraint, question mark
+
+ ``?``
+ Disparage slightly the alternative that the :samp:`?` appears in,
+ as a choice when no alternative applies exactly. The compiler regards
+ this alternative as one unit more costly for each :samp:`?` that appears
+ in it.
+
+ .. index:: ! in constraint, exclamation point
+
+ ``!``
+ Disparage severely the alternative that the :samp:`!` appears in.
+ This alternative can still be used if it fits without reloading,
+ but if reloading is needed, some other alternative will be used.
+
+ .. index:: ^ in constraint, caret
+
+ ``^``
+ This constraint is analogous to :samp:`?` but it disparages slightly
+ the alternative only if the operand with the :samp:`^` needs a reload.
+
+ .. index:: $ in constraint, dollar sign
+
+ ``$``
+ This constraint is analogous to :samp:`!` but it disparages severely
+ the alternative only if the operand with the :samp:`$` needs a reload.
+
+ When an insn pattern has multiple alternatives in its constraints, often
+ the appearance of the assembler code is determined mostly by which
+ alternative was matched. When this is so, the C code for writing the
+ assembler code can use the variable ``which_alternative``, which is
+ the ordinal number of the alternative that was actually satisfied (0 for
+ the first, 1 for the second alternative, etc.). See :ref:`output-statement`.
+
+.. _class-preferences:
+
+Register Class Preferences
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. only:: gccint
+
+ .. index:: class preference constraints, register class preference constraints, voting between constraint alternatives
+
+ The operand constraints have another function: they enable the compiler
+ to decide which kind of hardware register a pseudo register is best
+ allocated to. The compiler examines the constraints that apply to the
+ insns that use the pseudo register, looking for the machine-dependent
+ letters such as :samp:`d` and :samp:`a` that specify classes of registers.
+ The pseudo register is put in whichever class gets the most 'votes'.
+ The constraint letters :samp:`g` and :samp:`r` also vote: they vote in
+ favor of a general register. The machine description says which registers
+ are considered general.
+
+ Of course, on some machines all registers are equivalent, and no register
+ classes are defined. Then none of this complexity is relevant.
+
+.. index:: modifiers in constraints, constraint modifier characters
+
+.. _modifiers:
+
+Constraint Modifier Characters
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. prevent bad page break with this line
+
+Here are constraint modifier characters.
+
+.. index:: = in constraint
+
+:samp:`=`
+ Means that this operand is written to by this instruction:
+ the previous value is discarded and replaced by new data.
+
+ .. index:: + in constraint
+
+:samp:`+`
+ Means that this operand is both read and written by the instruction.
+
+ When the compiler fixes up the operands to satisfy the constraints,
+ it needs to know which operands are read by the instruction and
+ which are written by it. :samp:`=` identifies an operand which is only
+ written; :samp:`+` identifies an operand that is both read and written; all
+ other operands are assumed to only be read.
+
+ If you specify :samp:`=` or :samp:`+` in a constraint, you put it in the
+ first character of the constraint string.
+
+ .. index:: & in constraint, earlyclobber operand
+
+:samp:`&`
+ Means (in a particular alternative) that this operand is an
+ :dfn:`earlyclobber` operand, which is written before the instruction is
+ finished using the input operands. Therefore, this operand may not lie
+ in a register that is read by the instruction or as part of any memory
+ address.
+
+ :samp:`&` applies only to the alternative in which it is written. In
+ constraints with multiple alternatives, sometimes one alternative
+ requires :samp:`&` while others do not. See, for example, the
+ :samp:`movdf` insn of the 68000.
+
+ An operand which is read by the instruction can be tied to an earlyclobber
+ operand if its only use as an input occurs before the early result is
+ written. Adding alternatives of this form often allows GCC to produce
+ better code when only some of the read operands can be affected by the
+ earlyclobber. See, for example, the :samp:`mulsi3` insn of the ARM.
+
+ Furthermore, if the :dfn:`earlyclobber` operand is also a read/write
+ operand, then that operand is written only after it's used.
+
+ :samp:`&` does not obviate the need to write :samp:`=` or :samp:`+`. As
+ :dfn:`earlyclobber` operands are always written, a read-only
+ :dfn:`earlyclobber` operand is ill-formed and will be rejected by the
+ compiler.
+
+ .. index:: % in constraint
+
+:samp:`%`
+ Declares the instruction to be commutative for this operand and the
+ following operand. This means that the compiler may interchange the
+ two operands if that is the cheapest way to make all operands fit the
+ constraints. :samp:`%` applies to all alternatives and must appear as
+ the first character in the constraint. Only read-only operands can use
+ :samp:`%`.
+
+ .. only:: gccint
+
+ This is often used in patterns for addition instructions
+ that really have only two operands: the result must go in one of the
+ arguments. Here for example, is how the 68000 halfword-add
+ instruction is defined:
+
+ .. code-block:: c++
+
+ (define_insn "addhi3"
+ [(set (match_operand:HI 0 "general_operand" "=m,r")
+ (plus:HI (match_operand:HI 1 "general_operand" "%0,0")
+ (match_operand:HI 2 "general_operand" "di,g")))]
+ ...)
+
+ GCC can only handle one commutative pair in an asm; if you use more,
+ the compiler may fail. Note that you need not use the modifier if
+ the two alternatives are strictly identical; this would only waste
+ time in the reload pass.
+
+ .. only:: gccint
+
+ The modifier is not operational after
+ register allocation, so the result of ``define_peephole2``
+ and ``define_split`` s performed after reload cannot rely on
+ :samp:`%` to make the intended insn match.
+
+ .. index:: # in constraint
+
+ :samp:`#`
+ Says that all following characters, up to the next comma, are to be
+ ignored as a constraint. They are significant only for choosing
+ register preferences.
+
+ .. index:: * in constraint
+
+ :samp:`*`
+ Says that the following character should be ignored when choosing
+ register preferences. :samp:`*` has no effect on the meaning of the
+ constraint as a constraint, and no effect on reloading. For LRA
+ :samp:`*` additionally disparages slightly the alternative if the
+ following character matches the operand.
+
+ Here is an example: the 68000 has an instruction to sign-extend a
+ halfword in a data register, and can also sign-extend a value by
+ copying it into an address register. While either kind of register is
+ acceptable, the constraints on an address-register destination are
+ less strict, so it is best if register allocation makes an address
+ register its goal. Therefore, :samp:`*` is used so that the :samp:`d`
+ constraint letter (for data register) is ignored when computing
+ register preferences.
+
+ .. code-block:: c++
+
+ (define_insn "extendhisi2"
+ [(set (match_operand:SI 0 "general_operand" "=*d,a")
+ (sign_extend:SI
+ (match_operand:HI 1 "general_operand" "0,g")))]
+ ...)
+
+.. index:: machine specific constraints, constraints, machine specific
+
+.. _machine-constraints:
+
+Constraints for Particular Machines
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Whenever possible, you should use the general-purpose constraint letters
+in ``asm`` arguments, since they will convey meaning more readily to
+people reading your code. Failing that, use the constraint letters
+that usually have very similar meanings across architectures. The most
+commonly used constraints are :samp:`m` and :samp:`r` (for memory and
+general-purpose registers respectively; see :ref:`simple-constraints`), and
+:samp:`I`, usually the letter indicating the most common
+immediate-constant format.
+
+Each architecture defines additional constraints. These constraints
+are used by the compiler itself for instruction generation, as well as
+for ``asm`` statements; therefore, some of the constraints are not
+particularly useful for ``asm``. Here is a summary of some of the
+machine-dependent constraints available on some particular machines;
+it includes both constraints that are useful for ``asm`` and
+constraints that aren't. The compiler source file mentioned in the
+table heading for each architecture is the definitive reference for
+the meanings of that architecture's constraints.
+
+.. Please keep this table alphabetized by target!
+
+AArch64 family---:samp:`{config/aarch64/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``k``
+ The stack pointer register (``SP``)
+
+``w``
+ Floating point register, Advanced SIMD vector register or SVE vector register
+
+``x``
+ Like ``w``, but restricted to registers 0 to 15 inclusive.
+
+``y``
+ Like ``w``, but restricted to registers 0 to 7 inclusive.
+
+``Upl``
+ One of the low eight SVE predicate registers (``P0`` to ``P7``)
+
+``Upa``
+ Any of the SVE predicate registers (``P0`` to ``P15``)
+
+``I``
+ Integer constant that is valid as an immediate operand in an ``ADD``
+ instruction
+
+``J``
+ Integer constant that is valid as an immediate operand in a ``SUB``
+ instruction (once negated)
+
+``K``
+ Integer constant that can be used with a 32-bit logical instruction
+
+``L``
+ Integer constant that can be used with a 64-bit logical instruction
+
+``M``
+ Integer constant that is valid as an immediate operand in a 32-bit ``MOV``
+ pseudo instruction. The ``MOV`` may be assembled to one of several different
+ machine instructions depending on the value
+
+``N``
+ Integer constant that is valid as an immediate operand in a 64-bit ``MOV``
+ pseudo instruction
+
+``S``
+ An absolute symbolic address or a label reference
+
+``Y``
+ Floating point constant zero
+
+``Z``
+ Integer constant zero
+
+``Ush``
+ The high part (bits 12 and upwards) of the pc-relative address of a symbol
+ within 4GB of the instruction
+
+``Q``
+ A memory address which uses a single base register with no offset
+
+``Ump``
+ A memory address suitable for a load/store pair instruction in SI, DI, SF and
+ DF modes
+
+AMD GCN ---:samp:`{config/gcn/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``I``
+ Immediate integer in the range -16 to 64
+
+``J``
+ Immediate 16-bit signed integer
+
+``Kf``
+ Immediate constant -1
+
+``L``
+ Immediate 15-bit unsigned integer
+
+``A``
+ Immediate constant that can be inlined in an instruction encoding: integer
+ -16..64, or float 0.0, +/-0.5, +/-1.0, +/-2.0,
+ +/-4.0, 1.0/(2.0\*PI)
+
+``B``
+ Immediate 32-bit signed integer that can be attached to an instruction encoding
+
+``C``
+ Immediate 32-bit integer in range -16..4294967295 (i.e. 32-bit unsigned
+ integer or :samp:`A` constraint)
+
+``DA``
+ Immediate 64-bit constant that can be split into two :samp:`A` constants
+
+``DB``
+ Immediate 64-bit constant that can be split into two :samp:`B` constants
+
+``U``
+ Any ``unspec``
+
+``Y``
+ Any ``symbol_ref`` or ``label_ref``
+
+``v``
+ VGPR register
+
+``Sg``
+ SGPR register
+
+``SD``
+ SGPR registers valid for instruction destinations, including VCC, M0 and EXEC
+
+``SS``
+ SGPR registers valid for instruction sources, including VCC, M0, EXEC and SCC
+
+``Sm``
+ SGPR registers valid as a source for scalar memory instructions (excludes M0
+ and EXEC)
+
+``Sv``
+ SGPR registers valid as a source or destination for vector instructions
+ (excludes EXEC)
+
+``ca``
+ All condition registers: SCC, VCCZ, EXECZ
+
+``cs``
+ Scalar condition register: SCC
+
+``cV``
+ Vector condition register: VCC, VCC_LO, VCC_HI
+
+``e``
+ EXEC register (EXEC_LO and EXEC_HI)
+
+``RB``
+ Memory operand with address space suitable for ``buffer_*`` instructions
+
+``RF``
+ Memory operand with address space suitable for ``flat_*`` instructions
+
+``RS``
+ Memory operand with address space suitable for ``s_*`` instructions
+
+``RL``
+ Memory operand with address space suitable for ``ds_*`` LDS instructions
+
+``RG``
+ Memory operand with address space suitable for ``ds_*`` GDS instructions
+
+``RD``
+ Memory operand with address space suitable for any ``ds_*`` instructions
+
+``RM``
+ Memory operand with address space suitable for ``global_*`` instructions
+
+ARC ---:samp:`{config/arc/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``q``
+ Registers usable in ARCompact 16-bit instructions: ``r0`` - ``r3``,
+ ``r12`` - ``r15``. This constraint can only match when the :option:`-mq`
+ option is in effect.
+
+``e``
+ Registers usable as base-regs of memory addresses in ARCompact 16-bit memory
+ instructions: ``r0`` - ``r3``, ``r12`` - ``r15``, ``sp``.
+ This constraint can only match when the :option:`-mq`
+ option is in effect.
+
+``D``
+ ARC FPX (dpfp) 64-bit registers. ``D0``, ``D1``.
+
+``I``
+ A signed 12-bit integer constant.
+
+``Cal``
+ constant for arithmetic/logical operations. This might be any constant
+ that can be put into a long immediate by the assmbler or linker without
+ involving a PIC relocation.
+
+``K``
+ A 3-bit unsigned integer constant.
+
+``L``
+ A 6-bit unsigned integer constant.
+
+``CnL``
+ One's complement of a 6-bit unsigned integer constant.
+
+``CmL``
+ Two's complement of a 6-bit unsigned integer constant.
+
+``M``
+ A 5-bit unsigned integer constant.
+
+``O``
+ A 7-bit unsigned integer constant.
+
+``P``
+ A 8-bit unsigned integer constant.
+
+``H``
+ Any const_double value.
+
+ARM family---:samp:`{config/arm/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``h``
+ In Thumb state, the core registers ``r8`` - ``r15``.
+
+``k``
+ The stack pointer register.
+
+``l``
+ In Thumb State the core registers ``r0`` - ``r7``. In ARM state this
+ is an alias for the ``r`` constraint.
+
+``t``
+ VFP floating-point registers ``s0`` - ``s31``. Used for 32 bit values.
+
+``w``
+ VFP floating-point registers ``d0`` - ``d31`` and the appropriate
+ subset ``d0`` - ``d15`` based on command line options.
+ Used for 64 bit values only. Not valid for Thumb1.
+
+``y``
+ The iWMMX co-processor registers.
+
+``z``
+ The iWMMX GR registers.
+
+``G``
+ The floating-point constant 0.0
+
+``I``
+ Integer that is valid as an immediate operand in a data processing
+ instruction. That is, an integer in the range 0 to 255 rotated by a
+ multiple of 2
+
+``J``
+ Integer in the range -4095 to 4095
+
+``K``
+ Integer that satisfies constraint :samp:`I` when inverted (ones complement)
+
+``L``
+ Integer that satisfies constraint :samp:`I` when negated (twos complement)
+
+``M``
+ Integer in the range 0 to 32
+
+``Q``
+ A memory reference where the exact address is in a single register
+ (':samp:`m`' is preferable for ``asm`` statements)
+
+``R``
+ An item in the constant pool
+
+``S``
+ A symbol in the text segment of the current file
+
+``Uv``
+ A memory reference suitable for VFP load/store insns (reg+constant offset)
+
+``Uy``
+ A memory reference suitable for iWMMXt load/store instructions.
+
+``Uq``
+ A memory reference suitable for the ARMv4 ldrsb instruction.
+
+AVR family---:samp:`{config/avr/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``l``
+ Registers from r0 to r15
+
+``a``
+ Registers from r16 to r23
+
+``d``
+ Registers from r16 to r31
+
+``w``
+ Registers from r24 to r31. These registers can be used in :samp:`adiw` command
+
+``e``
+ Pointer register (r26--r31)
+
+``b``
+ Base pointer register (r28--r31)
+
+``q``
+ Stack pointer register (SPH:SPL)
+
+``t``
+ Temporary register r0
+
+``x``
+ Register pair X (r27:r26)
+
+``y``
+ Register pair Y (r29:r28)
+
+``z``
+ Register pair Z (r31:r30)
+
+``I``
+ Constant greater than -1, less than 64
+
+``J``
+ Constant greater than -64, less than 1
+
+``K``
+ Constant integer 2
+
+``L``
+ Constant integer 0
+
+``M``
+ Constant that fits in 8 bits
+
+``N``
+ Constant integer -1
+
+``O``
+ Constant integer 8, 16, or 24
+
+``P``
+ Constant integer 1
+
+``G``
+ A floating point constant 0.0
+
+``Q``
+ A memory address based on Y or Z pointer with displacement.
+
+Blackfin family---:samp:`{config/bfin/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ P register
+
+``d``
+ D register
+
+``z``
+ A call clobbered P register.
+
+:samp:`q{n}`
+ A single register. If :samp:`{n}` is in the range 0 to 7, the corresponding D
+ register. If it is ``A``, then the register P0.
+
+``D``
+ Even-numbered D register
+
+``W``
+ Odd-numbered D register
+
+``e``
+ Accumulator register.
+
+``A``
+ Even-numbered accumulator register.
+
+``B``
+ Odd-numbered accumulator register.
+
+``b``
+ I register
+
+``v``
+ B register
+
+``f``
+ M register
+
+``c``
+ Registers used for circular buffering, i.e. I, B, or L registers.
+
+``C``
+ The CC register.
+
+``t``
+ LT0 or LT1.
+
+``k``
+ LC0 or LC1.
+
+``u``
+ LB0 or LB1.
+
+``x``
+ Any D, P, B, M, I or L register.
+
+``y``
+ Additional registers typically used only in prologues and epilogues: RETS,
+ RETN, RETI, RETX, RETE, ASTAT, SEQSTAT and USP.
+
+``w``
+ Any register except accumulators or CC.
+
+``Ksh``
+ Signed 16 bit integer (in the range -32768 to 32767)
+
+``Kuh``
+ Unsigned 16 bit integer (in the range 0 to 65535)
+
+``Ks7``
+ Signed 7 bit integer (in the range -64 to 63)
+
+``Ku7``
+ Unsigned 7 bit integer (in the range 0 to 127)
+
+``Ku5``
+ Unsigned 5 bit integer (in the range 0 to 31)
+
+``Ks4``
+ Signed 4 bit integer (in the range -8 to 7)
+
+``Ks3``
+ Signed 3 bit integer (in the range -3 to 4)
+
+``Ku3``
+ Unsigned 3 bit integer (in the range 0 to 7)
+
+:samp:`P{n}`
+ Constant :samp:`{n}`, where :samp:`{n}` is a single-digit constant in the range 0 to 4.
+
+``PA``
+ An integer equal to one of the MACFLAG_XXX constants that is suitable for
+ use with either accumulator.
+
+``PB``
+ An integer equal to one of the MACFLAG_XXX constants that is suitable for
+ use only with accumulator A1.
+
+``M1``
+ Constant 255.
+
+``M2``
+ Constant 65535.
+
+``J``
+ An integer constant with exactly a single bit set.
+
+``L``
+ An integer constant with all bits set except exactly one.
+
+``H``, ``Q``
+
+ Any SYMBOL_REF.
+
+CR16 Architecture---:samp:`{config/cr16/cr16.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``b``
+ Registers from r0 to r14 (registers without stack pointer)
+
+``t``
+ Register from r0 to r11 (all 16-bit registers)
+
+``p``
+ Register from r12 to r15 (all 32-bit registers)
+
+``I``
+ Signed constant that fits in 4 bits
+
+``J``
+ Signed constant that fits in 5 bits
+
+``K``
+ Signed constant that fits in 6 bits
+
+``L``
+ Unsigned constant that fits in 4 bits
+
+``M``
+ Signed constant that fits in 32 bits
+
+``N``
+ Check for 64 bits wide constants for add/sub instructions
+
+``G``
+ Floating point constant that is legal for store immediate
+
+C-SKY---:samp:`{config/csky/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ The mini registers r0 - r7.
+
+``b``
+ The low registers r0 - r15.
+
+``c``
+ C register.
+
+``y``
+ HI and LO registers.
+
+``l``
+ LO register.
+
+``h``
+ HI register.
+
+``v``
+ Vector registers.
+
+``z``
+ Stack pointer register (SP).
+
+``Q``
+ A memory address which uses a base register with a short offset
+ or with a index register with its scale.
+
+``W``
+ A memory address which uses a base register with a index register
+ with its scale.
+
+.. only:: gccint
+
+ The C-SKY back end supports a large set of additional constraints
+ that are only useful for instruction selection or splitting rather
+ than inline asm, such as constraints representing constant integer
+ ranges accepted by particular instruction encodings.
+ Refer to the source code for details.
+
+Epiphany---:samp:`{config/epiphany/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``U16``
+ An unsigned 16-bit constant.
+
+``K``
+ An unsigned 5-bit constant.
+
+``L``
+ A signed 11-bit constant.
+
+``Cm1``
+ A signed 11-bit constant added to -1.
+ Can only match when the :option:`-m1reg-`:samp:`{reg}` option is active.
+
+``Cl1``
+ Left-shift of -1, i.e., a bit mask with a block of leading ones, the rest
+ being a block of trailing zeroes.
+ Can only match when the :option:`-m1reg-`:samp:`{reg}` option is active.
+
+``Cr1``
+ Right-shift of -1, i.e., a bit mask with a trailing block of ones, the
+ rest being zeroes. Or to put it another way, one less than a power of two.
+ Can only match when the :option:`-m1reg-`:samp:`{reg}` option is active.
+
+``Cal``
+ Constant for arithmetic/logical operations.
+ This is like ``i``, except that for position independent code,
+ no symbols / expressions needing relocations are allowed.
+
+``Csy``
+ Symbolic constant for call/jump instruction.
+
+``Rcs``
+ The register class usable in short insns. This is a register class
+ constraint, and can thus drive register allocation.
+ This constraint won't match unless :option:`-mprefer-short-insn-regs` is
+ in effect.
+
+``Rsc``
+ The the register class of registers that can be used to hold a
+ sibcall call address. I.e., a caller-saved register.
+
+``Rct``
+ Core control register class.
+
+``Rgs``
+ The register group usable in short insns.
+ This constraint does not use a register class, so that it only
+ passively matches suitable registers, and doesn't drive register allocation.
+
+.. only:: gccint
+
+ ``Car``
+ Constant suitable for the addsi3_r pattern. This is a valid offset
+ For byte, halfword, or word addressing.
+
+``Rra``
+ Matches the return address if it can be replaced with the link register.
+
+``Rcc``
+ Matches the integer condition code register.
+
+``Sra``
+ Matches the return address if it is in a stack slot.
+
+``Cfm``
+ Matches control register values to switch fp mode, which are encapsulated in
+ ``UNSPEC_FP_MODE``.
+
+FRV---:samp:`{config/frv/frv.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ Register in the class ``ACC_REGS`` (``acc0`` to ``acc7``).
+
+``b``
+ Register in the class ``EVEN_ACC_REGS`` (``acc0`` to ``acc7``).
+
+``c``
+ Register in the class ``CC_REGS`` (``fcc0`` to ``fcc3`` and
+ ``icc0`` to ``icc3``).
+
+``d``
+ Register in the class ``GPR_REGS`` (``gr0`` to ``gr63``).
+
+``e``
+ Register in the class ``EVEN_REGS`` (``gr0`` to ``gr63``).
+ Odd registers are excluded not in the class but through the use of a machine
+ mode larger than 4 bytes.
+
+``f``
+ Register in the class ``FPR_REGS`` (``fr0`` to ``fr63``).
+
+``h``
+ Register in the class ``FEVEN_REGS`` (``fr0`` to ``fr63``).
+ Odd registers are excluded not in the class but through the use of a machine
+ mode larger than 4 bytes.
+
+``l``
+ Register in the class ``LR_REG`` (the ``lr`` register).
+
+``q``
+ Register in the class ``QUAD_REGS`` (``gr2`` to ``gr63``).
+ Register numbers not divisible by 4 are excluded not in the class but through
+ the use of a machine mode larger than 8 bytes.
+
+``t``
+ Register in the class ``ICC_REGS`` (``icc0`` to ``icc3``).
+
+``u``
+ Register in the class ``FCC_REGS`` (``fcc0`` to ``fcc3``).
+
+``v``
+ Register in the class ``ICR_REGS`` (``cc4`` to ``cc7``).
+
+``w``
+ Register in the class ``FCR_REGS`` (``cc0`` to ``cc3``).
+
+``x``
+ Register in the class ``QUAD_FPR_REGS`` (``fr0`` to ``fr63``).
+ Register numbers not divisible by 4 are excluded not in the class but through
+ the use of a machine mode larger than 8 bytes.
+
+``z``
+ Register in the class ``SPR_REGS`` (``lcr`` and ``lr``).
+
+``A``
+ Register in the class ``QUAD_ACC_REGS`` (``acc0`` to ``acc7``).
+
+``B``
+ Register in the class ``ACCG_REGS`` (``accg0`` to ``accg7``).
+
+``C``
+ Register in the class ``CR_REGS`` (``cc0`` to ``cc7``).
+
+``G``
+ Floating point constant zero
+
+``I``
+ 6-bit signed integer constant
+
+``J``
+ 10-bit signed integer constant
+
+``L``
+ 16-bit signed integer constant
+
+``M``
+ 16-bit unsigned integer constant
+
+``N``
+ 12-bit signed integer constant that is negative---i.e. in the
+ range of -2048 to -1
+
+``O``
+ Constant zero
+
+``P``
+ 12-bit signed integer constant that is greater than zero---i.e. in the
+ range of 1 to 2047.
+
+FT32---:samp:`{config/ft32/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``A``
+ An absolute address
+
+``B``
+ An offset address
+
+``W``
+ A register indirect memory operand
+
+``e``
+ An offset address.
+
+``f``
+ An offset address.
+
+``O``
+ The constant zero or one
+
+``I``
+ A 16-bit signed constant (-32768 ... 32767)
+
+``w``
+ A bitfield mask suitable for bext or bins
+
+``x``
+ An inverted bitfield mask suitable for bext or bins
+
+``L``
+ A 16-bit unsigned constant, multiple of 4 (0 ... 65532)
+
+``S``
+ A 20-bit signed constant (-524288 ... 524287)
+
+``b``
+ A constant for a bitfield width (1 ... 16)
+
+``KA``
+ A 10-bit signed constant (-512 ... 511)
+
+Hewlett-Packard PA-RISC---:samp:`{config/pa/pa.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ General register 1
+
+``f``
+ Floating point register
+
+``q``
+ Shift amount register
+
+``x``
+ Floating point register (deprecated)
+
+``y``
+ Upper floating point register (32-bit), floating point register (64-bit)
+
+``Z``
+ Any register
+
+``I``
+ Signed 11-bit integer constant
+
+``J``
+ Signed 14-bit integer constant
+
+``K``
+ Integer constant that can be deposited with a ``zdepi`` instruction
+
+``L``
+ Signed 5-bit integer constant
+
+``M``
+ Integer constant 0
+
+``N``
+ Integer constant that can be loaded with a ``ldil`` instruction
+
+``O``
+ Integer constant whose value plus one is a power of 2
+
+``P``
+ Integer constant that can be used for ``and`` operations in ``depi``
+ and ``extru`` instructions
+
+``S``
+ Integer constant 31
+
+``U``
+ Integer constant 63
+
+``G``
+ Floating-point constant 0.0
+
+``A``
+ A ``lo_sum`` data-linkage-table memory operand
+
+``Q``
+ A memory operand that can be used as the destination operand of an
+ integer store instruction
+
+``R``
+ A scaled or unscaled indexed memory operand
+
+``T``
+ A memory operand for floating-point loads and stores
+
+``W``
+ A register indirect memory operand
+
+Intel IA-64---:samp:`{config/ia64/ia64.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ General register ``r0`` to ``r3`` for ``addl`` instruction
+
+``b``
+ Branch register
+
+``c``
+ Predicate register (:samp:`c` as in 'conditional')
+
+``d``
+ Application register residing in M-unit
+
+``e``
+ Application register residing in I-unit
+
+``f``
+ Floating-point register
+
+``m``
+ Memory operand. If used together with :samp:`<` or :samp:`>`,
+ the operand can have postincrement and postdecrement which
+ require printing with :samp:`%Pn` on IA-64.
+
+``G``
+ Floating-point constant 0.0 or 1.0
+
+``I``
+ 14-bit signed integer constant
+
+``J``
+ 22-bit signed integer constant
+
+``K``
+ 8-bit signed integer constant for logical instructions
+
+``L``
+ 8-bit adjusted signed integer constant for compare pseudo-ops
+
+``M``
+ 6-bit unsigned integer constant for shift counts
+
+``N``
+ 9-bit signed integer constant for load and store postincrements
+
+``O``
+ The constant zero
+
+``P``
+ 0 or -1 for ``dep`` instruction
+
+``Q``
+ Non-volatile memory for floating-point loads and stores
+
+``R``
+ Integer constant in the range 1 to 4 for ``shladd`` instruction
+
+``S``
+ Memory operand except postincrement and postdecrement. This is
+ now roughly the same as :samp:`m` when not used together with :samp:`<`
+ or :samp:`>`.
+
+M32C---:samp:`{config/m32c/m32c.cc}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Rsp`` ``Rfb`` ``Rsb``
+ :samp:`$sp`, :samp:`$fb`, :samp:`$sb`.
+
+``Rcr``
+ Any control register, when they're 16 bits wide (nothing if control
+ registers are 24 bits wide)
+
+``Rcl``
+ Any control register, when they're 24 bits wide.
+
+``R0w`` ``R1w`` ``R2w`` ``R3w``
+ $r0, $r1, $r2, $r3.
+
+``R02``
+ $r0 or $r2, or $r2r0 for 32 bit values.
+
+``R13``
+ $r1 or $r3, or $r3r1 for 32 bit values.
+
+``Rdi``
+ A register that can hold a 64 bit value.
+
+``Rhl``
+ $r0 or $r1 (registers with addressable high/low bytes)
+
+``R23``
+ $r2 or $r3
+
+``Raa``
+ Address registers
+
+``Raw``
+ Address registers when they're 16 bits wide.
+
+``Ral``
+ Address registers when they're 24 bits wide.
+
+``Rqi``
+ Registers that can hold QI values.
+
+``Rad``
+ Registers that can be used with displacements ($a0, $a1, $sb).
+
+``Rsi``
+ Registers that can hold 32 bit values.
+
+``Rhi``
+ Registers that can hold 16 bit values.
+
+``Rhc``
+ Registers chat can hold 16 bit values, including all control
+ registers.
+
+``Rra``
+ $r0 through R1, plus $a0 and $a1.
+
+``Rfl``
+ The flags register.
+
+``Rmm``
+ The memory-based pseudo-registers $mem0 through $mem15.
+
+``Rpi``
+ Registers that can hold pointers (16 bit registers for r8c, m16c; 24
+ bit registers for m32cm, m32c).
+
+``Rpa``
+ Matches multiple registers in a PARALLEL to form a larger register.
+ Used to match function return values.
+
+``Is3``
+ -8 ... 7
+
+``IS1``
+ -128 ... 127
+
+``IS2``
+ -32768 ... 32767
+
+``IU2``
+ 0 ... 65535
+
+``In4``
+ -8 ... -1 or 1 ... 8
+
+``In5``
+ -16 ... -1 or 1 ... 16
+
+``In6``
+ -32 ... -1 or 1 ... 32
+
+``IM2``
+ -65536 ... -1
+
+``Ilb``
+ An 8 bit value with exactly one bit set.
+
+``Ilw``
+ A 16 bit value with exactly one bit set.
+
+``Sd``
+ The common src/dest memory addressing modes.
+
+``Sa``
+ Memory addressed using $a0 or $a1.
+
+``Si``
+ Memory addressed with immediate addresses.
+
+``Ss``
+ Memory addressed using the stack pointer ($sp).
+
+``Sf``
+ Memory addressed using the frame base register ($fb).
+
+``Ss``
+ Memory addressed using the small base register ($sb).
+
+``S1``
+ $r1h
+
+LoongArch---:samp:`{config/loongarch/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``f``
+ A floating-point register (if available).
+
+``k``
+ A memory operand whose address is formed by a base register and
+ (optionally scaled) index register.
+
+``l``
+ A signed 16-bit constant.
+
+``m``
+ A memory operand whose address is formed by a base register and offset
+ that is suitable for use in instructions with the same addressing mode
+ as ``st.w`` and ``ld.w``.
+
+``I``
+ A signed 12-bit constant (for arithmetic instructions).
+
+``K``
+ An unsigned 12-bit constant (for logic instructions).
+
+``ZB``
+ An address that is held in a general-purpose register.
+ The offset is zero.
+
+``ZC``
+ A memory operand whose address is formed by a base register and offset
+ that is suitable for use in instructions with the same addressing mode
+ as ``ll.w`` and ``sc.w``.
+
+MicroBlaze---:samp:`{config/microblaze/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``d``
+ A general register (``r0`` to ``r31``).
+
+``z``
+ A status register (``rmsr``, ``$fcc1`` to ``$fcc7``).
+
+MIPS---:samp:`{config/mips/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``d``
+ A general-purpose register. This is equivalent to ``r`` unless
+ generating MIPS16 code, in which case the MIPS16 register set is used.
+
+``f``
+ A floating-point register (if available).
+
+``h``
+ Formerly the ``hi`` register. This constraint is no longer supported.
+
+``l``
+ The ``lo`` register. Use this register to store values that are
+ no bigger than a word.
+
+``x``
+ The concatenated ``hi`` and ``lo`` registers. Use this register
+ to store doubleword values.
+
+``c``
+ A register suitable for use in an indirect jump. This will always be
+ ``$25`` for :option:`-mabicalls`.
+
+``v``
+ Register ``$3``. Do not use this constraint in new code;
+ it is retained only for compatibility with glibc.
+
+``y``
+ Equivalent to ``r`` ; retained for backwards compatibility.
+
+``z``
+ A floating-point condition code register.
+
+``I``
+ A signed 16-bit constant (for arithmetic instructions).
+
+``J``
+ Integer zero.
+
+``K``
+ An unsigned 16-bit constant (for logic instructions).
+
+``L``
+ A signed 32-bit constant in which the lower 16 bits are zero.
+ Such constants can be loaded using ``lui``.
+
+``M``
+ A constant that cannot be loaded using ``lui``, ``addiu``
+ or ``ori``.
+
+``N``
+ A constant in the range -65535 to -1 (inclusive).
+
+``O``
+ A signed 15-bit constant.
+
+``P``
+ A constant in the range 1 to 65535 (inclusive).
+
+``G``
+ Floating-point zero.
+
+``R``
+ An address that can be used in a non-macro load or store.
+
+``ZC``
+ A memory operand whose address is formed by a base register and offset
+ that is suitable for use in instructions with the same addressing mode
+ as ``ll`` and ``sc``.
+
+``ZD``
+ An address suitable for a ``prefetch`` instruction, or for any other
+ instruction with the same addressing mode as ``prefetch``.
+
+Motorola 680x0---:samp:`{config/m68k/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ Address register
+
+``d``
+ Data register
+
+``f``
+ 68881 floating-point register, if available
+
+``I``
+ Integer in the range 1 to 8
+
+``J``
+ 16-bit signed number
+
+``K``
+ Signed number whose magnitude is greater than 0x80
+
+``L``
+ Integer in the range -8 to -1
+
+``M``
+ Signed number whose magnitude is greater than 0x100
+
+``N``
+ Range 24 to 31, rotatert:SI 8 to 1 expressed as rotate
+
+``O``
+ 16 (for rotate using swap)
+
+``P``
+ Range 8 to 15, rotatert:HI 8 to 1 expressed as rotate
+
+``R``
+ Numbers that mov3q can handle
+
+``G``
+ Floating point constant that is not a 68881 constant
+
+``S``
+ Operands that satisfy 'm' when -mpcrel is in effect
+
+``T``
+ Operands that satisfy 's' when -mpcrel is not in effect
+
+``Q``
+ Address register indirect addressing mode
+
+``U``
+ Register offset addressing
+
+``W``
+ const_call_operand
+
+``Cs``
+ symbol_ref or const
+
+``Ci``
+ const_int
+
+``C0``
+ const_int 0
+
+``Cj``
+ Range of signed numbers that don't fit in 16 bits
+
+``Cmvq``
+ Integers valid for mvq
+
+``Capsw``
+ Integers valid for a moveq followed by a swap
+
+``Cmvz``
+ Integers valid for mvz
+
+``Cmvs``
+ Integers valid for mvs
+
+``Ap``
+ push_operand
+
+``Ac``
+ Non-register operands allowed in clr
+
+Moxie---:samp:`{config/moxie/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``A``
+ An absolute address
+
+``B``
+ An offset address
+
+``W``
+ A register indirect memory operand
+
+``I``
+ A constant in the range of 0 to 255.
+
+``N``
+ A constant in the range of 0 to -255.
+
+MSP430---:samp:`{config/msp430/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``R12``
+ Register R12.
+
+``R13``
+ Register R13.
+
+``K``
+ Integer constant 1.
+
+``L``
+ Integer constant -1^20..1^19.
+
+``M``
+ Integer constant 1-4.
+
+``Ya``
+ Memory references which do not require an extended MOVX instruction.
+
+``Yl``
+ Memory reference, labels only.
+
+``Ys``
+ Memory reference, stack only.
+
+NDS32---:samp:`{config/nds32/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``w``
+ LOW register class $r0 to $r7 constraint for V3/V3M ISA.
+
+``l``
+ LOW register class $r0 to $r7.
+
+``d``
+ MIDDLE register class $r0 to $r11, $r16 to $r19.
+
+``h``
+ HIGH register class $r12 to $r14, $r20 to $r31.
+
+``t``
+ Temporary assist register $ta (i.e. $r15).
+
+``k``
+ Stack register $sp.
+
+``Iu03``
+ Unsigned immediate 3-bit value.
+
+``In03``
+ Negative immediate 3-bit value in the range of -7--0.
+
+``Iu04``
+ Unsigned immediate 4-bit value.
+
+``Is05``
+ Signed immediate 5-bit value.
+
+``Iu05``
+ Unsigned immediate 5-bit value.
+
+``In05``
+ Negative immediate 5-bit value in the range of -31--0.
+
+``Ip05``
+ Unsigned immediate 5-bit value for movpi45 instruction with range 16--47.
+
+``Iu06``
+ Unsigned immediate 6-bit value constraint for addri36.sp instruction.
+
+``Iu08``
+ Unsigned immediate 8-bit value.
+
+``Iu09``
+ Unsigned immediate 9-bit value.
+
+``Is10``
+ Signed immediate 10-bit value.
+
+``Is11``
+ Signed immediate 11-bit value.
+
+``Is15``
+ Signed immediate 15-bit value.
+
+``Iu15``
+ Unsigned immediate 15-bit value.
+
+``Ic15``
+ A constant which is not in the range of imm15u but ok for bclr instruction.
+
+``Ie15``
+ A constant which is not in the range of imm15u but ok for bset instruction.
+
+``It15``
+ A constant which is not in the range of imm15u but ok for btgl instruction.
+
+``Ii15``
+ A constant whose compliment value is in the range of imm15u
+ and ok for bitci instruction.
+
+``Is16``
+ Signed immediate 16-bit value.
+
+``Is17``
+ Signed immediate 17-bit value.
+
+``Is19``
+ Signed immediate 19-bit value.
+
+``Is20``
+ Signed immediate 20-bit value.
+
+``Ihig``
+ The immediate value that can be simply set high 20-bit.
+
+``Izeb``
+ The immediate value 0xff.
+
+``Izeh``
+ The immediate value 0xffff.
+
+``Ixls``
+ The immediate value 0x01.
+
+``Ix11``
+ The immediate value 0x7ff.
+
+``Ibms``
+ The immediate value with power of 2.
+
+``Ifex``
+ The immediate value with power of 2 minus 1.
+
+``U33``
+ Memory constraint for 333 format.
+
+``U45``
+ Memory constraint for 45 format.
+
+``U37``
+ Memory constraint for 37 format.
+
+Nios II family---:samp:`{config/nios2/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``I``
+ Integer that is valid as an immediate operand in an
+ instruction taking a signed 16-bit number. Range
+ -32768 to 32767.
+
+``J``
+ Integer that is valid as an immediate operand in an
+ instruction taking an unsigned 16-bit number. Range
+ 0 to 65535.
+
+``K``
+ Integer that is valid as an immediate operand in an
+ instruction taking only the upper 16-bits of a
+ 32-bit number. Range 32-bit numbers with the lower
+ 16-bits being 0.
+
+``L``
+ Integer that is valid as an immediate operand for a
+ shift instruction. Range 0 to 31.
+
+``M``
+ Integer that is valid as an immediate operand for
+ only the value 0. Can be used in conjunction with
+ the format modifier ``z`` to use ``r0``
+ instead of ``0`` in the assembly output.
+
+``N``
+ Integer that is valid as an immediate operand for
+ a custom instruction opcode. Range 0 to 255.
+
+``P``
+ An immediate operand for R2 andchi/andci instructions.
+
+``S``
+ Matches immediates which are addresses in the small
+ data section and therefore can be added to ``gp``
+ as a 16-bit immediate to re-create their 32-bit value.
+
+``U``
+ Matches constants suitable as an operand for the rdprs and
+ cache instructions.
+
+``v``
+ A memory operand suitable for Nios II R2 load/store
+ exclusive instructions.
+
+``w``
+ A memory operand suitable for load/store IO and cache
+ instructions.
+
+.. only:: gccint
+
+ ``T``
+ A ``const`` wrapped ``UNSPEC`` expression,
+ representing a supported PIC or TLS relocation.
+
+OpenRISC---:samp:`{config/or1k/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``I``
+ Integer that is valid as an immediate operand in an
+ instruction taking a signed 16-bit number. Range
+ -32768 to 32767.
+
+``K``
+ Integer that is valid as an immediate operand in an
+ instruction taking an unsigned 16-bit number. Range
+ 0 to 65535.
+
+``M``
+ Signed 16-bit constant shifted left 16 bits. (Used with ``l.movhi``)
+
+``O``
+ Zero
+
+.. only:: gccint
+
+ ``c``
+ Register usable for sibcalls.
+
+PDP-11---:samp:`{config/pdp11/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ Floating point registers AC0 through AC3. These can be loaded from/to
+ memory with a single instruction.
+
+``d``
+ Odd numbered general registers (R1, R3, R5). These are used for
+ 16-bit multiply operations.
+
+``D``
+ A memory reference that is encoded within the opcode, but not
+ auto-increment or auto-decrement.
+
+``f``
+ Any of the floating point registers (AC0 through AC5).
+
+``G``
+ Floating point constant 0.
+
+``h``
+ Floating point registers AC4 and AC5. These cannot be loaded from/to
+ memory with a single instruction.
+
+``I``
+ An integer constant that fits in 16 bits.
+
+``J``
+ An integer constant whose low order 16 bits are zero.
+
+``K``
+ An integer constant that does not meet the constraints for codes
+ :samp:`I` or :samp:`J`.
+
+``L``
+ The integer constant 1.
+
+``M``
+ The integer constant -1.
+
+``N``
+ The integer constant 0.
+
+``O``
+ Integer constants 0 through 3; shifts by these
+ amounts are handled as multiple single-bit shifts rather than a single
+ variable-length shift.
+
+``Q``
+ A memory reference which requires an additional word (address or
+ offset) after the opcode.
+
+``R``
+ A memory reference that is encoded within the opcode.
+
+PowerPC and IBM RS6000---:samp:`{config/rs6000/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``r``
+ A general purpose register (GPR), ``r0``... ``r31``.
+
+``b``
+ A base register. Like ``r``, but ``r0`` is not allowed, so
+ ``r1``... ``r31``.
+
+``f``
+ A floating point register (FPR), ``f0``... ``f31``.
+
+``d``
+ A floating point register. This is the same as ``f`` nowadays;
+ historically ``f`` was for single-precision and ``d`` was for
+ double-precision floating point.
+
+``v``
+ An Altivec vector register (VR), ``v0``... ``v31``.
+
+``wa``
+ A VSX register (VSR), ``vs0``... ``vs63``. This is either an
+ FPR (``vs0``... ``vs31`` are ``f0``... ``f31``) or a VR
+ (``vs32``... ``vs63`` are ``v0``... ``v31``).
+
+ When using ``wa``, you should use the ``%x`` output modifier, so that
+ the correct register number is printed. For example:
+
+ .. code-block:: c++
+
+ asm ("xvadddp %x0,%x1,%x2"
+ : "=wa" (v1)
+ : "wa" (v2), "wa" (v3));
+
+ You should not use ``%x`` for ``v`` operands:
+
+ .. code-block:: c++
+
+ asm ("xsaddqp %0,%1,%2"
+ : "=v" (v1)
+ : "v" (v2), "v" (v3));
+
+.. only:: gccint
+
+ ``h``
+ A special register (``vrsave``, ``ctr``, or ``lr``).
+
+``c``
+ The count register, ``ctr``.
+
+``l``
+ The link register, ``lr``.
+
+``x``
+ Condition register field 0, ``cr0``.
+
+``y``
+ Any condition register field, ``cr0``... ``cr7``.
+
+.. only:: gccint
+
+ ``z``
+ The carry bit, ``XER[CA]``.
+
+ ``we``
+ Like ``wa``, if :option:`-mpower9-vector` and :option:`-m64` are used;
+ otherwise, ``NO_REGS``.
+
+ ``wn``
+ No register (``NO_REGS``).
+
+ ``wr``
+ Like ``r``, if :option:`-mpowerpc64` is used; otherwise, ``NO_REGS``.
+
+ ``wx``
+ Like ``d``, if :option:`-mpowerpc-gfxopt` is used; otherwise, ``NO_REGS``.
+
+ ``wA``
+ Like ``b``, if :option:`-mpowerpc64` is used; otherwise, ``NO_REGS``.
+
+ ``wB``
+ Signed 5-bit constant integer that can be loaded into an Altivec register.
+
+ ``wD``
+ Int constant that is the element number of the 64-bit scalar in a vector.
+
+ ``wE``
+ Vector constant that can be loaded with the XXSPLTIB instruction.
+
+ ``wF``
+ Memory operand suitable for power8 GPR load fusion.
+
+ ``wL``
+ Int constant that is the element number mfvsrld accesses in a vector.
+
+ ``wM``
+ Match vector constant with all 1's if the XXLORC instruction is available.
+
+ ``wO``
+ Memory operand suitable for the ISA 3.0 vector d-form instructions.
+
+ ``wQ``
+ Memory operand suitable for the load/store quad instructions.
+
+ ``wS``
+ Vector constant that can be loaded with XXSPLTIB & sign extension.
+
+ ``wY``
+ A memory operand for a DS-form instruction.
+
+ ``wZ``
+ An indexed or indirect memory operand, ignoring the bottom 4 bits.
+
+``I``
+ A signed 16-bit constant.
+
+``J``
+ An unsigned 16-bit constant shifted left 16 bits (use ``L`` instead
+ for ``SImode`` constants).
+
+``K``
+ An unsigned 16-bit constant.
+
+``L``
+ A signed 16-bit constant shifted left 16 bits.
+
+.. only:: gccint
+
+ ``M``
+ An integer constant greater than 31.
+
+ ``N``
+ An exact power of 2.
+
+ ``O``
+ The integer constant zero.
+
+ ``P``
+ A constant whose negation is a signed 16-bit constant.
+
+``eI``
+ A signed 34-bit integer constant if prefixed instructions are supported.
+
+``eQ``
+ An IEEE 128-bit constant that can be loaded into a VSX register with
+ the ``lxvkq`` instruction.
+
+.. only:: gccint
+
+ ``G``
+ A floating point constant that can be loaded into a register with one
+ instruction per word.
+
+ ``H``
+ A floating point constant that can be loaded into a register using
+ three instructions.
+
+``m``
+ A memory operand.
+ Normally, ``m`` does not allow addresses that update the base register.
+ If the ``<`` or ``>`` constraint is also used, they are allowed and
+ therefore on PowerPC targets in that case it is only safe
+ to use ``m<>`` in an ``asm`` statement if that ``asm`` statement
+ accesses the operand exactly once. The ``asm`` statement must also
+ use ``%U<opno>`` as a placeholder for the 'update' flag in the
+ corresponding load or store instruction. For example:
+
+ .. code-block:: c++
+
+ asm ("st%U0 %1,%0" : "=m<>" (mem) : "r" (val));
+
+ is correct but:
+
+ .. code-block:: c++
+
+ asm ("st %1,%0" : "=m<>" (mem) : "r" (val));
+
+ is not.
+
+.. only:: gccint
+
+ ``es``
+ A 'stable' memory operand; that is, one which does not include any
+ automodification of the base register. This used to be useful when
+ ``m`` allowed automodification of the base register, but as those
+ are now only allowed when ``<`` or ``>`` is used, ``es`` is
+ basically the same as ``m`` without ``<`` and ``>``.
+
+``Q``
+ A memory operand addressed by just a base register.
+
+.. only:: gccint
+
+ ``Y``
+ A memory operand for a DQ-form instruction.
+
+``Z``
+ A memory operand accessed with indexed or indirect addressing.
+
+.. only:: gccint
+
+ ``R``
+ An AIX TOC entry.
+
+``a``
+ An indexed or indirect address.
+
+.. only:: gccint
+
+ ``U``
+ A V.4 small data reference.
+
+ ``W``
+ A vector constant that does not require memory.
+
+ ``j``
+ The zero vector constant.
+
+PRU---:samp:`{config/pru/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``I``
+ An unsigned 8-bit integer constant.
+
+``J``
+ An unsigned 16-bit integer constant.
+
+``L``
+ An unsigned 5-bit integer constant (for shift counts).
+
+``T``
+ A text segment (program memory) constant label.
+
+``Z``
+ Integer constant zero.
+
+RL78---:samp:`{config/rl78/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Int3``
+ An integer constant in the range 1 ... 7.
+
+``Int8``
+ An integer constant in the range 0 ... 255.
+
+``J``
+ An integer constant in the range -255 ... 0
+
+``K``
+ The integer constant 1.
+
+``L``
+ The integer constant -1.
+
+``M``
+ The integer constant 0.
+
+``N``
+ The integer constant 2.
+
+``O``
+ The integer constant -2.
+
+``P``
+ An integer constant in the range 1 ... 15.
+
+``Qbi``
+ The built-in compare types--eq, ne, gtu, ltu, geu, and leu.
+
+``Qsc``
+ The synthetic compare types--gt, lt, ge, and le.
+
+``Wab``
+ A memory reference with an absolute address.
+
+``Wbc``
+ A memory reference using ``BC`` as a base register, with an optional offset.
+
+``Wca``
+ A memory reference using ``AX``, ``BC``, ``DE``, or ``HL`` for the address, for calls.
+
+``Wcv``
+ A memory reference using any 16-bit register pair for the address, for calls.
+
+``Wd2``
+ A memory reference using ``DE`` as a base register, with an optional offset.
+
+``Wde``
+ A memory reference using ``DE`` as a base register, without any offset.
+
+``Wfr``
+ Any memory reference to an address in the far address space.
+
+``Wh1``
+ A memory reference using ``HL`` as a base register, with an optional one-byte offset.
+
+``Whb``
+ A memory reference using ``HL`` as a base register, with ``B`` or ``C`` as the index register.
+
+``Whl``
+ A memory reference using ``HL`` as a base register, without any offset.
+
+``Ws1``
+ A memory reference using ``SP`` as a base register, with an optional one-byte offset.
+
+``Y``
+ Any memory reference to an address in the near address space.
+
+``A``
+ The ``AX`` register.
+
+``B``
+ The ``BC`` register.
+
+``D``
+ The ``DE`` register.
+
+``R``
+ ``A`` through ``L`` registers.
+
+``S``
+ The ``SP`` register.
+
+``T``
+ The ``HL`` register.
+
+``Z08W``
+ The 16-bit ``R8`` register.
+
+``Z10W``
+ The 16-bit ``R10`` register.
+
+``Zint``
+ The registers reserved for interrupts (``R24`` to ``R31``).
+
+``a``
+ The ``A`` register.
+
+``b``
+ The ``B`` register.
+
+``c``
+ The ``C`` register.
+
+``d``
+ The ``D`` register.
+
+``e``
+ The ``E`` register.
+
+``h``
+ The ``H`` register.
+
+``l``
+ The ``L`` register.
+
+``v``
+ The virtual registers.
+
+``w``
+ The ``PSW`` register.
+
+``x``
+ The ``X`` register.
+
+RISC-V---:samp:`{config/riscv/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``f``
+ A floating-point register (if available).
+
+``I``
+ An I-type 12-bit signed immediate.
+
+``J``
+ Integer zero.
+
+``K``
+ A 5-bit unsigned immediate for CSR access instructions.
+
+``A``
+ An address that is held in a general-purpose register.
+
+``S``
+ A constraint that matches an absolute symbolic address.
+
+RX---:samp:`{config/rx/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Q``
+ An address which does not involve register indirect addressing or
+ pre/post increment/decrement addressing.
+
+``Symbol``
+ A symbol reference.
+
+``Int08``
+ A constant in the range -256 to 255, inclusive.
+
+``Sint08``
+ A constant in the range -128 to 127, inclusive.
+
+``Sint16``
+ A constant in the range -32768 to 32767, inclusive.
+
+``Sint24``
+ A constant in the range -8388608 to 8388607, inclusive.
+
+``Uint04``
+ A constant in the range 0 to 15, inclusive.
+
+S/390 and zSeries---:samp:`{config/s390/s390.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ Address register (general purpose register except r0)
+
+``c``
+ Condition code register
+
+``d``
+ Data register (arbitrary general purpose register)
+
+``f``
+ Floating-point register
+
+``I``
+ Unsigned 8-bit constant (0--255)
+
+``J``
+ Unsigned 12-bit constant (0--4095)
+
+``K``
+ Signed 16-bit constant (-32768--32767)
+
+``L``
+ Value appropriate as displacement.
+
+ ``(0..4095)``
+ for short displacement
+
+ ``(-524288..524287)``
+ for long displacement
+
+``M``
+ Constant integer with a value of 0x7fffffff.
+
+``N``
+ Multiple letter constraint followed by 4 parameter letters.
+
+ ``0..9:``
+ number of the part counting from most to least significant
+
+ ``H,Q:``
+ mode of the part
+
+ ``D,S,H:``
+ mode of the containing operand
+
+ ``0,F:``
+ value of the other parts (F---all bits set)
+
+ The constraint matches if the specified part of a constant
+ has a value different from its other parts.
+
+``Q``
+ Memory reference without index register and with short displacement.
+
+``R``
+ Memory reference with index register and short displacement.
+
+``S``
+ Memory reference without index register but with long displacement.
+
+``T``
+ Memory reference with index register and long displacement.
+
+``U``
+ Pointer with short displacement.
+
+``W``
+ Pointer with long displacement.
+
+``Y``
+ Shift count operand.
+
+SPARC---:samp:`{config/sparc/sparc.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``f``
+ Floating-point register on the SPARC-V8 architecture and
+ lower floating-point register on the SPARC-V9 architecture.
+
+``e``
+ Floating-point register. It is equivalent to :samp:`f` on the
+ SPARC-V8 architecture and contains both lower and upper
+ floating-point registers on the SPARC-V9 architecture.
+
+``c``
+ Floating-point condition code register.
+
+``d``
+ Lower floating-point register. It is only valid on the SPARC-V9
+ architecture when the Visual Instruction Set is available.
+
+``b``
+ Floating-point register. It is only valid on the SPARC-V9 architecture
+ when the Visual Instruction Set is available.
+
+``h``
+ 64-bit global or out register for the SPARC-V8+ architecture.
+
+``C``
+ The constant all-ones, for floating-point.
+
+``A``
+ Signed 5-bit constant
+
+``D``
+ A vector constant
+
+``I``
+ Signed 13-bit constant
+
+``J``
+ Zero
+
+``K``
+ 32-bit constant with the low 12 bits clear (a constant that can be
+ loaded with the ``sethi`` instruction)
+
+``L``
+ A constant in the range supported by ``movcc`` instructions (11-bit
+ signed immediate)
+
+``M``
+ A constant in the range supported by ``movrcc`` instructions (10-bit
+ signed immediate)
+
+``N``
+ Same as :samp:`K`, except that it verifies that bits that are not in the
+ lower 32-bit range are all zero. Must be used instead of :samp:`K` for
+ modes wider than ``SImode``
+
+``O``
+ The constant 4096
+
+``G``
+ Floating-point zero
+
+``H``
+ Signed 13-bit constant, sign-extended to 32 or 64 bits
+
+``P``
+ The constant -1
+
+``Q``
+ Floating-point constant whose integral representation can
+ be moved into an integer register using a single sethi
+ instruction
+
+``R``
+ Floating-point constant whose integral representation can
+ be moved into an integer register using a single mov
+ instruction
+
+``S``
+ Floating-point constant whose integral representation can
+ be moved into an integer register using a high/lo_sum
+ instruction sequence
+
+``T``
+ Memory address aligned to an 8-byte boundary
+
+``U``
+ Even register
+
+``W``
+ Memory address for :samp:`e` constraint registers
+
+``w``
+ Memory address with only a base register
+
+``Y``
+ Vector zero
+
+TI C6X family---:samp:`{config/c6x/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ Register file A (A0--A31).
+
+``b``
+ Register file B (B0--B31).
+
+``A``
+ Predicate registers in register file A (A0--A2 on C64X and
+ higher, A1 and A2 otherwise).
+
+``B``
+ Predicate registers in register file B (B0--B2).
+
+``C``
+ A call-used register in register file B (B0--B9, B16--B31).
+
+``Da``
+ Register file A, excluding predicate registers (A3--A31,
+ plus A0 if not C64X or higher).
+
+``Db``
+ Register file B, excluding predicate registers (B3--B31).
+
+``Iu4``
+ Integer constant in the range 0 ... 15.
+
+``Iu5``
+ Integer constant in the range 0 ... 31.
+
+``In5``
+ Integer constant in the range -31 ... 0.
+
+``Is5``
+ Integer constant in the range -16 ... 15.
+
+``I5x``
+ Integer constant that can be the operand of an ADDA or a SUBA insn.
+
+``IuB``
+ Integer constant in the range 0 ... 65535.
+
+``IsB``
+ Integer constant in the range -32768 ... 32767.
+
+``IsC``
+ Integer constant in the range -2^{20} ... 2^{20} - 1.
+
+``Jc``
+ Integer constant that is a valid mask for the clr instruction.
+
+``Js``
+ Integer constant that is a valid mask for the set instruction.
+
+``Q``
+ Memory location with A base register.
+
+``R``
+ Memory location with B base register.
+
+.. only:: gccint
+
+ ``S0``
+ On C64x+ targets, a GP-relative small data reference.
+
+ ``S1``
+ Any kind of ``SYMBOL_REF``, for use in a call address.
+
+ ``Si``
+ Any kind of immediate operand, unless it matches the S0 constraint.
+
+ ``T``
+ Memory location with B base register, but not using a long offset.
+
+ ``W``
+ A memory operand with an address that cannot be used in an unaligned access.
+
+``Z``
+ Register B14 (aka DP).
+
+Visium---:samp:`{config/visium/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``b``
+ EAM register ``mdb``
+
+``c``
+ EAM register ``mdc``
+
+``f``
+ Floating point register
+
+.. only:: gccint
+
+ ``k``
+ Register for sibcall optimization
+
+``l``
+ General register, but not ``r29``, ``r30`` and ``r31``
+
+``t``
+ Register ``r1``
+
+``u``
+ Register ``r2``
+
+``v``
+ Register ``r3``
+
+``G``
+ Floating-point constant 0.0
+
+``J``
+ Integer constant in the range 0 .. 65535 (16-bit immediate)
+
+``K``
+ Integer constant in the range 1 .. 31 (5-bit immediate)
+
+``L``
+ Integer constant in the range -65535 .. -1 (16-bit negative immediate)
+
+``M``
+ Integer constant -1
+
+``O``
+ Integer constant 0
+
+``P``
+ Integer constant 32
+
+x86 family---:samp:`{config/i386/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``R``
+ Legacy register---the eight integer registers available on all
+ i386 processors (``a``, ``b``, ``c``, ``d``,
+ ``si``, ``di``, ``bp``, ``sp``).
+
+``q``
+ Any register accessible as ``rl``. In 32-bit mode, ``a``,
+ ``b``, ``c``, and ``d`` ; in 64-bit mode, any integer register.
+
+``Q``
+ Any register accessible as ``rh`` : ``a``, ``b``,
+ ``c``, and ``d``.
+
+.. only:: gccint
+
+ ``l``
+ Any register that can be used as the index in a base+index memory
+ access: that is, any general register except the stack pointer.
+
+``a``
+ The ``a`` register.
+
+``b``
+ The ``b`` register.
+
+``c``
+ The ``c`` register.
+
+``d``
+ The ``d`` register.
+
+``S``
+ The ``si`` register.
+
+``D``
+ The ``di`` register.
+
+``A``
+ The ``a`` and ``d`` registers. This class is used for instructions
+ that return double word results in the ``ax:dx`` register pair. Single
+ word values will be allocated either in ``ax`` or ``dx``.
+ For example on i386 the following implements ``rdtsc`` :
+
+ .. code-block:: c++
+
+ unsigned long long rdtsc (void)
+ {
+ unsigned long long tick;
+ __asm__ __volatile__("rdtsc":"=A"(tick));
+ return tick;
+ }
+
+ This is not correct on x86-64 as it would allocate tick in either ``ax``
+ or ``dx``. You have to use the following variant instead:
+
+ .. code-block:: c++
+
+ unsigned long long rdtsc (void)
+ {
+ unsigned int tickl, tickh;
+ __asm__ __volatile__("rdtsc":"=a"(tickl),"=d"(tickh));
+ return ((unsigned long long)tickh << 32)|tickl;
+ }
+
+``U``
+ The call-clobbered integer registers.
+
+``f``
+ Any 80387 floating-point (stack) register.
+
+``t``
+ Top of 80387 floating-point stack (``%st(0)``).
+
+``u``
+ Second from top of 80387 floating-point stack (``%st(1)``).
+
+.. only:: gccint
+
+ ``Yk``
+ Any mask register that can be used as a predicate, i.e. ``k1-k7``.
+
+ ``k``
+ Any mask register.
+
+``y``
+ Any MMX register.
+
+``x``
+ Any SSE register.
+
+``v``
+ Any EVEX encodable SSE register (``%xmm0-%xmm31``).
+
+.. only:: gccint
+
+ ``w``
+ Any bound register.
+
+``Yz``
+ First SSE register (``%xmm0``).
+
+.. only:: gccint
+
+ ``Yi``
+ Any SSE register, when SSE2 and inter-unit moves are enabled.
+
+ ``Yj``
+ Any SSE register, when SSE2 and inter-unit moves from vector registers are enabled.
+
+ ``Ym``
+ Any MMX register, when inter-unit moves are enabled.
+
+ ``Yn``
+ Any MMX register, when inter-unit moves from vector registers are enabled.
+
+ ``Yp``
+ Any integer register when ``TARGET_PARTIAL_REG_STALL`` is disabled.
+
+ ``Ya``
+ Any integer register when zero extensions with ``AND`` are disabled.
+
+ ``Yb``
+ Any register that can be used as the GOT base when calling
+
+ ``___tls_get_addr`` : that is, any general register except ``a``
+ and ``sp`` registers, for :option:`-fno-plt` if linker supports it.
+ Otherwise, ``b`` register.
+
+ ``Yf``
+ Any x87 register when 80387 floating-point arithmetic is enabled.
+
+ ``Yr``
+ Lower SSE register when avoiding REX prefix and all SSE registers otherwise.
+
+ ``Yv``
+ For AVX512VL, any EVEX-encodable SSE register (``%xmm0-%xmm31``),
+ otherwise any SSE register.
+
+ ``Yh``
+ Any EVEX-encodable SSE register, that has number factor of four.
+
+ ``Bf``
+ Flags register operand.
+
+ ``Bg``
+ GOT memory operand.
+
+ ``Bm``
+ Vector memory operand.
+
+ ``Bc``
+ Constant memory operand.
+
+``Bn``
+ Memory operand without REX prefix.
+
+``Bs``
+ Sibcall memory operand.
+
+``Bw``
+ Call memory operand.
+
+``Bz``
+ Constant call address operand.
+
+``BC``
+ SSE constant -1 operand.
+
+``I``
+ Integer constant in the range 0 ... 31, for 32-bit shifts.
+
+``J``
+ Integer constant in the range 0 ... 63, for 64-bit shifts.
+
+``K``
+ Signed 8-bit integer constant.
+
+``L``
+ ``0xFF`` or ``0xFFFF``, for andsi as a zero-extending move.
+
+``M``
+ 0, 1, 2, or 3 (shifts for the ``lea`` instruction).
+
+``N``
+ Unsigned 8-bit integer constant (for ``in`` and ``out``
+ instructions).
+
+.. only:: gccint
+
+ ``O``
+ Integer constant in the range 0 ... 127, for 128-bit shifts.
+
+``G``
+ Standard 80387 floating point constant.
+
+``C``
+ SSE constant zero operand.
+
+``e``
+ 32-bit signed integer constant, or a symbolic reference known
+ to fit that range (for immediate operands in sign-extending x86-64
+ instructions).
+
+``We``
+ 32-bit signed integer constant, or a symbolic reference known
+ to fit that range (for sign-extending conversion operations that
+ require non- ``VOIDmode`` immediate operands).
+
+``Wz``
+ 32-bit unsigned integer constant, or a symbolic reference known
+ to fit that range (for zero-extending conversion operations that
+ require non- ``VOIDmode`` immediate operands).
+
+``Wd``
+ 128-bit integer constant where both the high and low 64-bit word
+ satisfy the ``e`` constraint.
+
+``Z``
+ 32-bit unsigned integer constant, or a symbolic reference known
+ to fit that range (for immediate operands in zero-extending x86-64
+ instructions).
+
+``Tv``
+ VSIB address operand.
+
+``Ts``
+ Address operand without segment register.
+
+Xstormy16---:samp:`{config/stormy16/stormy16.h}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ Register r0.
+
+``b``
+ Register r1.
+
+``c``
+ Register r2.
+
+``d``
+ Register r8.
+
+``e``
+ Registers r0 through r7.
+
+``t``
+ Registers r0 and r1.
+
+``y``
+ The carry register.
+
+``z``
+ Registers r8 and r9.
+
+``I``
+ A constant between 0 and 3 inclusive.
+
+``J``
+ A constant that has exactly one bit set.
+
+``K``
+ A constant that has exactly one bit clear.
+
+``L``
+ A constant between 0 and 255 inclusive.
+
+``M``
+ A constant between -255 and 0 inclusive.
+
+``N``
+ A constant between -3 and 0 inclusive.
+
+``O``
+ A constant between 1 and 4 inclusive.
+
+``P``
+ A constant between -4 and -1 inclusive.
+
+``Q``
+ A memory reference that is a stack push.
+
+``R``
+ A memory reference that is a stack pop.
+
+``S``
+ A memory reference that refers to a constant address of known value.
+
+``T``
+ The register indicated by Rx (not implemented yet).
+
+``U``
+ A constant that is not between 2 and 15 inclusive.
+
+``Z``
+ The constant 0.
+
+Xtensa---:samp:`{config/xtensa/constraints.md}`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``a``
+ General-purpose 32-bit register
+
+``b``
+ One-bit boolean register
+
+``A``
+ MAC16 40-bit accumulator register
+
+``I``
+ Signed 12-bit integer constant, for use in MOVI instructions
+
+``J``
+ Signed 8-bit integer constant, for use in ADDI instructions
+
+``K``
+ Integer constant valid for BccI instructions
+
+``L``
+ Unsigned constant valid for BccUI instructions
\ No newline at end of file
diff --git a/gcc/d/doc/conf.py b/gcc/d/doc/conf.py
new file mode 100644
index 00000000000..3957ddf822a
--- /dev/null
+++ b/gcc/d/doc/conf.py
@@ -0,0 +1,29 @@
+# Configuration file for the Sphinx documentation builder.
+
+import sys
+sys.path.append('../../..//doc')
+
+from baseconf import *
+
+project = 'The GNU D Compiler'
+copyright = '2006-2022 Free Software Foundation, Inc.'
+authors = 'David Friedman, Iain Buclaw'
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+# dir menu entry, description, category)
+latex_documents = [
+ ('index', 'gdc.tex', project, authors, 'manual'),
+]
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+ ('invoking-gdc', 'gdc', project, [authors], 1),
+]
+
+texinfo_documents = [
+ ('index', 'gdc', project, authors, None, None, None, True)
+]
+
+tags.add('gdc')
\ No newline at end of file
diff --git a/gcc/d/doc/copyright.rst b/gcc/d/doc/copyright.rst
new file mode 100644
index 00000000000..5afce611a7a
--- /dev/null
+++ b/gcc/d/doc/copyright.rst
@@ -0,0 +1,13 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+Copyright
+^^^^^^^^^
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+A copy of the license is in the :ref:`gnu_fdl`.
\ No newline at end of file
diff --git a/gcc/d/doc/general-public-license-3.rst b/gcc/d/doc/general-public-license-3.rst
new file mode 100644
index 00000000000..939da77422c
--- /dev/null
+++ b/gcc/d/doc/general-public-license-3.rst
@@ -0,0 +1,6 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. include:: ../../../doc/gpl-3.0.rst
\ No newline at end of file
diff --git a/gcc/d/doc/gnu-free-documentation-license.rst b/gcc/d/doc/gnu-free-documentation-license.rst
new file mode 100644
index 00000000000..b251002f094
--- /dev/null
+++ b/gcc/d/doc/gnu-free-documentation-license.rst
@@ -0,0 +1,6 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. include:: ../../../doc/gnu_free_documentation_license.rst
\ No newline at end of file
diff --git a/gcc/d/doc/index.rst b/gcc/d/doc/index.rst
new file mode 100644
index 00000000000..a3f6b8111df
--- /dev/null
+++ b/gcc/d/doc/index.rst
@@ -0,0 +1,22 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+The GNU D Compiler
+==================
+
+This manual describes how to use :command:`gdc`, the GNU compiler for
+the D programming language. This manual is specifically about
+:command:`gdc`. For more information about the D programming
+language in general, including language specifications and standard
+package documentation, see https://dlang.org/.
+
+.. toctree::
+
+ copyright
+ invoking-gdc
+ general-public-license-3
+ gnu-free-documentation-license
+
+ indices-and-tables
\ No newline at end of file
diff --git a/gcc/d/doc/indices-and-tables.rst b/gcc/d/doc/indices-and-tables.rst
new file mode 100644
index 00000000000..6c215a391d9
--- /dev/null
+++ b/gcc/d/doc/indices-and-tables.rst
@@ -0,0 +1 @@
+.. include:: ../../../doc/indices-and-tables.rst
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc.rst b/gcc/d/doc/invoking-gdc.rst
new file mode 100644
index 00000000000..d8f81658e9a
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc.rst
@@ -0,0 +1,48 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _invoking-gdc:
+
+Invoking gdc
+------------
+
+.. only:: man
+
+ Synopsis
+ ^^^^^^^^
+
+ gdc [ :option:`-c` | :option:`-S` ] [ :option:`-g` ] [ :option:`-pg` ]
+ [ :option:`-O`:samp:`{level}` ] [ :option:`-W`:samp:`{warn}`...]
+ [ :option:`-I`:samp:`{dir}`...] [ :option:`-L`:samp:`{dir}`...]
+ [ :option:`-f`:samp:`{option}`...] [ :option:`-m`:samp:`{machine-option}`...]
+ [ :option:`-o` :samp:`{outfile}` ] [@ :samp:`{file}` ] :samp:`{infile}`...
+
+ Only the most useful options are listed here; see below for the
+ remainder.
+
+Description
+^^^^^^^^^^^
+
+The :command:`gdc` command is the GNU compiler for the D language and
+supports many of the same options as :command:`gcc`. See :ref:`gcc:option-summary`.
+This manual only documents the options specific to :command:`gdc`.
+
+Options
+^^^^^^^
+
+.. toctree::
+ :maxdepth: 2
+
+ invoking-gdc/input-and-output-files
+ invoking-gdc/runtime-options
+ invoking-gdc/options-for-directory-search
+ invoking-gdc/code-generation
+ invoking-gdc/warnings
+ invoking-gdc/options-for-linking
+ invoking-gdc/developer-options
+
+.. only:: man
+
+ .. include:: copyright.rst
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/code-generation.rst b/gcc/d/doc/invoking-gdc/code-generation.rst
new file mode 100644
index 00000000000..7a2e5dd02a0
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/code-generation.rst
@@ -0,0 +1,170 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: options, code generation
+
+.. _code-generation:
+
+Code Generation
+***************
+
+In addition to the many :command:`gcc` options controlling code generation,
+:command:`gdc` has several options specific to itself.
+
+.. option:: -H
+
+ .. index:: -H
+
+ Generates D interface files for all modules being compiled. The compiler
+ determines the output file based on the name of the input file, removes
+ any directory components and suffix, and applies the :samp:`.di` suffix.
+
+.. option:: -Hd dir
+
+ .. index:: -Hd
+
+ Same as :option:`-H`, but writes interface files to directory :samp:`{dir}`.
+ This option can be used with :option:`-Hf `:samp:`{file}` to independently set the
+ output file and directory path.
+
+.. option:: -Hf file
+
+ .. index:: -Hf
+
+ Same as :option:`-H` but writes interface files to :samp:`{file}`. This option can
+ be used with :option:`-Hd` :samp:`{dir}` to independently set the output file and
+ directory path.
+
+.. option:: -M
+
+ .. index:: -M
+
+ Output the module dependencies of all source files being compiled in a
+ format suitable for :command:`make`. The compiler outputs one
+ :command:`make` rule containing the object file name for that source file,
+ a colon, and the names of all imported files.
+
+.. option:: -MM
+
+ .. index:: -MM
+
+ Like :option:`-M` but does not mention imported modules from the D standard
+ library package directories.
+
+.. option:: -MF file
+
+ .. index:: -MF
+
+ When used with :option:`-M` or :option:`-MM`, specifies a :samp:`{file}` to write
+ the dependencies to. When used with the driver options :option:`-MD` or
+ :option:`-MMD`, :option:`-MF` overrides the default dependency output file.
+
+.. option:: -MG
+
+ .. index:: -MG
+
+ This option is for compatibility with :command:`gcc`, and is ignored by the
+ compiler.
+
+.. option:: -MP
+
+ .. index:: -MP
+
+ Outputs a phony target for each dependency other than the modules being
+ compiled, causing each to depend on nothing.
+
+.. option:: -MT target
+
+ .. index:: -MT
+
+ Change the :samp:`{target}` of the rule emitted by dependency generation
+ to be exactly the string you specify. If you want multiple targets,
+ you can specify them as a single argument to :option:`-MT`, or use
+ multiple :option:`-MT` options.
+
+.. option:: -MQ target
+
+ .. index:: -MQ
+
+ Same as :option:`-MT`, but it quotes any characters which are special to
+ :command:`make`.
+
+.. option:: -MD
+
+ .. index:: -MD
+
+ This option is equivalent to :option:`-M -MF` :samp:`{file}`. The driver
+ determines :samp:`{file}` by removing any directory components and suffix
+ from the input file, and then adding a :samp:`.deps` suffix.
+
+.. option:: -MMD
+
+ .. index:: -MMD
+
+ Like :option:`-MD` but does not mention imported modules from the D standard
+ library package directories.
+
+.. option:: -X
+
+ .. index:: -X
+
+ Output information describing the contents of all source files being
+ compiled in JSON format to a file. The driver determines :samp:`{file}` by
+ removing any directory components and suffix from the input file, and then
+ adding a :samp:`.json` suffix.
+
+.. option:: -Xf file
+
+ .. index:: -Xf
+
+ Same as :option:`-X`, but writes all JSON contents to the specified
+ :samp:`{file}`.
+
+.. option:: -fdoc
+
+ .. index:: -fdoc
+
+ Generates ``Ddoc`` documentation and writes it to a file. The compiler
+ determines :samp:`{file}` by removing any directory components and suffix
+ from the input file, and then adding a :samp:`.html` suffix.
+
+.. option:: -fdoc-dir=dir
+
+ .. index:: -fdoc-dir
+
+ Same as :option:`-fdoc`, but writes documentation to directory :samp:`{dir}`.
+ This option can be used with :option:`-fdoc-file`:samp:`={file}` to
+ independently set the output file and directory path.
+
+.. option:: -fdoc-file=file
+
+ .. index:: -fdoc-file
+
+ Same as :option:`-fdoc`, but writes documentation to :samp:`{file}`. This
+ option can be used with :option:`-fdoc-dir`:samp:`={dir}` to independently
+ set the output file and directory path.
+
+.. option:: -fdoc-inc=file
+
+ .. index:: -fdoc-inc
+
+ Specify :samp:`{file}` as a :samp:`{Ddoc}` macro file to be read. Multiple
+ :option:`-fdoc-inc` options can be used, and files are read and processed
+ in the same order.
+
+.. option:: -fdump-c++-spec={file}
+
+ For D source files, generate corresponding C++ declarations in :samp:`{file}`.
+
+.. option:: -fdump-c++-spec-verbose
+
+ In conjunction with :option:`-fdump-c++-spec` = above, add comments for ignored
+ declarations in the generated C++ header.
+
+.. option:: -fsave-mixins={file}
+
+ Generates code expanded from D ``mixin`` statements and writes the
+ processed sources to :samp:`{file}`. This is useful to debug errors in compilation
+ and provides source for debuggers to show when requested.
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/developer-options.rst b/gcc/d/doc/invoking-gdc/developer-options.rst
new file mode 100644
index 00000000000..5f240ba5f88
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/developer-options.rst
@@ -0,0 +1,31 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: developer options, debug dump options, dump options
+
+.. _developer-options:
+
+Developer Options
+*****************
+
+This section describes command-line options that are primarily of
+interest to developers or language tooling.
+
+.. option:: -fdump-d-original
+
+ .. index:: -fdump-d-original
+
+ Output the internal front-end AST after the ``semantic3`` stage.
+ This option is only useful for debugging the GNU D compiler itself.
+
+.. option:: -v
+
+ .. index:: -v
+
+ Dump information about the compiler language processing stages as the source
+ program is being compiled. This includes listing all modules that are
+ processed through the ``parse``, ``semantic``, ``semantic2``, and
+ ``semantic3`` stages; all ``import`` modules and their file paths;
+ and all ``function`` bodies that are being compiled.
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/input-and-output-files.rst b/gcc/d/doc/invoking-gdc/input-and-output-files.rst
new file mode 100644
index 00000000000..a9f08c30dd9
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/input-and-output-files.rst
@@ -0,0 +1,45 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: suffixes for D source, D source file suffixes
+
+.. _input-and-output-files:
+
+Input and Output files
+**********************
+
+For any given input file, the file name suffix determines what kind of
+compilation is done. The following kinds of input file names are supported:
+
+:samp:`{file}.d`
+ D source files.
+
+:samp:`{file}.dd`
+ Ddoc source files.
+
+:samp:`{file}.di`
+ D interface files.
+
+You can specify more than one input file on the :command:`gdc` command line,
+each being compiled separately in the compilation process. If you specify a
+``-o file`` option, all the input files are compiled together,
+producing a single output file, named :samp:`{file}`. This is allowed even
+when using ``-S`` or ``-c``.
+
+.. index:: D interface files.
+
+A D interface file contains only what an import of the module needs,
+rather than the whole implementation of that module. They can be created
+by :command:`gdc` from a D source file by using the ``-H`` option.
+When the compiler resolves an import declaration, it searches for matching
+:samp:`.di` files first, then for :samp:`.d`.
+
+.. index:: Ddoc source files.
+
+A Ddoc source file contains code in the D macro processor language. It is
+primarily designed for use in producing user documentation from embedded
+comments, with a slight affinity towards HTML generation. If a :samp:`.d`
+source file starts with the string ``Ddoc`` then it is treated as general
+purpose documentation, not as a D source file.
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/options-for-directory-search.rst b/gcc/d/doc/invoking-gdc/options-for-directory-search.rst
new file mode 100644
index 00000000000..2dc8eafabfd
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/options-for-directory-search.rst
@@ -0,0 +1,92 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: directory options, options, directory search, search path
+
+.. _directory-options:
+
+Options for Directory Search
+****************************
+
+These options specify directories to search for files, libraries, and
+other parts of the compiler:
+
+.. option:: -Idir
+
+ .. index:: -I
+
+ Specify a directory to use when searching for imported modules at
+ compile time. Multiple :option:`-I` options can be used, and the
+ paths are searched in the same order.
+
+.. option:: -Jdir
+
+ .. index:: -J
+
+ Specify a directory to use when searching for files in string imports
+ at compile time. This switch is required in order to use
+ ``import(file)`` expressions. Multiple :option:`-J` options can be
+ used, and the paths are searched in the same order.
+
+.. option:: -Ldir
+
+ .. index:: -L
+
+ When linking, specify a library search directory, as with :command:`gcc`.
+
+.. option:: -Bdir
+
+ .. index:: -B
+
+ This option specifies where to find the executables, libraries,
+ source files, and data files of the compiler itself, as with :command:`gcc`.
+
+.. option:: -fmodule-file=module=spec
+
+ .. index:: -fmodule-file
+
+ This option manipulates file paths of imported modules, such that if an
+ imported module matches all or the leftmost part of :samp:`{module}`, the file
+ path in :samp:`{spec}` is used as the location to search for D sources.
+ This is used when the source file path and names are not the same as the
+ package and module hierarchy. Consider the following examples:
+
+ .. code-block:: c++
+
+ gdc test.d -fmodule-file=A.B=foo.d -fmodule-file=C=bar
+
+ This will tell the compiler to search in all import paths for the source
+ file :samp:`{foo.d}` when importing :samp:`{A.B}`, and the directory :samp:`{bar/}`
+ when importing :samp:`{C}`, as annotated in the following D code:
+
+ .. code-block:: c++
+
+ module test;
+ import A.B; // Matches A.B, searches for foo.d
+ import C.D.E; // Matches C, searches for bar/D/E.d
+ import A.B.C; // No match, searches for A/B/C.d
+
+.. option:: -imultilib dir
+
+ .. index:: -imultilib
+
+ Use :samp:`{dir}` as a subdirectory of the gcc directory containing
+ target-specific D sources and interfaces.
+
+.. option:: -iprefix prefix
+
+ .. index:: -iprefix
+
+ Specify :samp:`{prefix}` as the prefix for the gcc directory containing
+ target-specific D sources and interfaces. If the :samp:`{prefix}` represents
+ a directory, you should include the final ``'/'``.
+
+.. option:: -nostdinc
+
+ .. index:: -nostdinc
+
+ Do not search the standard system directories for D source and interface
+ files. Only the directories that have been specified with :option:`-I` options
+ (and the directory of the current file, if appropriate) are searched.
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/options-for-linking.rst b/gcc/d/doc/invoking-gdc/options-for-linking.rst
new file mode 100644
index 00000000000..4d6da5e1c92
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/options-for-linking.rst
@@ -0,0 +1,59 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: options, linking, linking, static
+
+.. _linking:
+
+Options for Linking
+*******************
+
+These options come into play when the compiler links object files into an
+executable output file. They are meaningless if the compiler is not doing
+a link step.
+
+.. option:: -defaultlib=libname
+
+ .. index:: -defaultlib=
+
+ Specify the library to use instead of libphobos when linking. Options
+ specifying the linkage of libphobos, such as :option:`-static-libphobos`
+ or :option:`-shared-libphobos`, are ignored.
+
+.. option:: -debuglib=libname
+
+ .. index:: -debuglib=
+
+ Specify the debug library to use instead of libphobos when linking.
+ This option has no effect unless the :option:`-g` option was also given
+ on the command line. Options specifying the linkage of libphobos, such
+ as :option:`-static-libphobos` or :option:`-shared-libphobos`, are ignored.
+
+.. option:: -nophoboslib
+
+ .. index:: -nophoboslib
+
+ Do not use the Phobos or D runtime library when linking. Options specifying
+ the linkage of libphobos, such as :option:`-static-libphobos` or
+ :option:`-shared-libphobos`, are ignored. The standard system libraries are
+ used normally, unless :option:`-nostdlib` or :option:`-nodefaultlibs` is used.
+
+.. option:: -shared-libphobos
+
+ .. index:: -shared-libphobos
+
+ On systems that provide :samp:`libgphobos` and :samp:`libgdruntime` as a
+ shared and a static library, this option forces the use of the shared
+ version. If no shared version was built when the compiler was configured,
+ this option has no effect.
+
+.. option:: -static-libphobos
+
+ .. index:: -static-libphobos
+
+ On systems that provide :samp:`libgphobos` and :samp:`libgdruntime` as a
+ shared and a static library, this option forces the use of the static
+ version. If no static version was built when the compiler was configured,
+ this option has no effect.
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/runtime-options.rst b/gcc/d/doc/invoking-gdc/runtime-options.rst
new file mode 100644
index 00000000000..492872d28b6
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/runtime-options.rst
@@ -0,0 +1,307 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: options, runtime
+
+.. _runtime-options:
+
+Runtime Options
+***************
+
+These options affect the runtime behavior of programs compiled with
+:command:`gdc`.
+
+.. option:: -fall-instantiations
+
+ .. index:: -fall-instantiations, -fno-all-instantiations
+
+ Generate code for all template instantiations. The default template emission
+ strategy is to not generate code for declarations that were either
+ instantiated speculatively, such as from ``__traits(compiles, ...)``, or
+ that come from an imported module not being compiled.
+
+.. option:: -fno-assert
+
+ .. index:: -fassert, -fno-assert
+
+ Turn off code generation for ``assert`` contracts.
+
+.. option:: -fno-bounds-check
+
+ .. index:: -fbounds-check, -fno-bounds-check
+
+ Turns off array bounds checking for all functions, which can improve
+ performance for code that uses arrays extensively. Note that this
+ can result in unpredictable behavior if the code in question actually
+ does violate array bounds constraints. It is safe to use this option
+ if you are sure that your code never throws a ``RangeError``.
+
+.. option:: -fbounds-check=value
+
+ .. index:: -fbounds-check=
+
+ An alternative to :option:`-fbounds-check` that allows more control
+ as to where bounds checking is turned on or off. The following values
+ are supported:
+
+ :samp:`on`
+ Turns on array bounds checking for all functions.
+
+ :samp:`safeonly`
+ Turns on array bounds checking only for ``@safe`` functions.
+
+ :samp:`off`
+ Turns off array bounds checking completely.
+
+.. option:: -fno-builtin
+
+ .. index:: -fbuiltin, -fno-builtin
+
+ Don't recognize built-in functions unless they begin with the prefix
+ :samp:`__builtin_`. By default, the compiler will recognize when a
+ function in the ``core.stdc`` package is a built-in function.
+
+.. option:: -fcheckaction
+
+ This option controls what code is generated on an assertion, bounds check, or
+ final switch failure. The following values are supported:
+
+ :samp:`context`
+ Throw an ``AssertError`` with extra context information.
+
+ :samp:`halt`
+ Halt the program execution.
+
+ :samp:`throw`
+ Throw an ``AssertError`` (the default).
+
+.. option:: -fdebug=value
+
+ .. index:: -fno-debug
+
+ Turn on compilation of conditional ``debug`` code into the program.
+ The :option:`-fdebug` option itself sets the debug level to ``1``,
+ while :option:`-fdebug` = enables ``debug`` code that are identified
+ by any of the following values:
+
+ :samp:`level`
+ Sets the debug level to :samp:`{level}`, any ``debug`` code <= :samp:`{level}`
+ is compiled into the program.
+
+ :samp:`ident`
+ Turns on compilation of any ``debug`` code identified by :samp:`{ident}`.
+
+.. option:: -fno-druntime
+
+ .. index:: -fdruntime, -fno-druntime
+
+ Implements https://dlang.org/spec/betterc.html. Assumes that
+ compilation targets an environment without a D runtime library.
+
+ This is equivalent to compiling with the following options:
+
+ .. code-block:: c++
+
+ gdc -nophoboslib -fno-exceptions -fno-moduleinfo -fno-rtti
+
+.. option:: -fextern-std=standard
+
+ Sets the C++ name mangling compatibility to the version identified by
+ :samp:`{standard}`. The following values are supported:
+
+ :samp:`c++98`, :samp:`c++03`
+ Sets ``__traits(getTargetInfo, "cppStd")`` to ``199711``.
+
+ :samp:`c++11`
+ Sets ``__traits(getTargetInfo, "cppStd")`` to ``201103``.
+
+ :samp:`c++14`
+ Sets ``__traits(getTargetInfo, "cppStd")`` to ``201402``.
+
+ :samp:`c++17`
+ Sets ``__traits(getTargetInfo, "cppStd")`` to ``201703``.
+ This is the default.
+
+ :samp:`c++20`
+ Sets ``__traits(getTargetInfo, "cppStd")`` to ``202002``.
+
+.. option:: -fno-invariants
+
+ .. index:: -finvariants, -fno-invariants
+
+ Turns off code generation for class ``invariant`` contracts.
+
+.. option:: -fmain
+
+ Generates a default ``main()`` function when compiling. This is useful when
+ unittesting a library, as it enables running the unittests in a library without
+ having to manually define an entry-point function. This option does nothing
+ when ``main`` is already defined in user code.
+
+.. option:: -fno-moduleinfo
+
+ Turns off generation of the ``ModuleInfo`` and related functions
+ that would become unreferenced without it, which may allow linking
+ to programs not written in D. Functions that are not be generated
+ include module constructors and destructors (``static this`` and
+ ``static ~this``), ``unittest`` code, and ``DSO`` registry
+ functions for dynamically linked code.
+
+.. option:: -fonly=filename
+
+ .. index:: -fonly
+
+ Tells the compiler to parse and run semantic analysis on all modules
+ on the command line, but only generate code for the module specified
+ by :samp:`{filename}`.
+
+.. option:: -fno-postconditions
+
+ .. index:: -fpostconditions, -fno-postconditions
+
+ Turns off code generation for postcondition ``out`` contracts.
+
+.. option:: -fno-preconditions
+
+ .. index:: -fpreconditions, -fno-preconditions
+
+ Turns off code generation for precondition ``in`` contracts.
+
+.. option:: -fpreview=id
+
+ .. index:: -fpreview
+
+ Turns on an upcoming D language change identified by :samp:`{id}`. The following
+ values are supported:
+
+ :samp:`all`
+ Turns on all upcoming D language features.
+
+ :samp:`dip1000`
+ Implements https://wiki.dlang.org/DIP1000 (Scoped pointers).
+
+ :samp:`dip1008`
+ Implements https://wiki.dlang.org/DIP1008 (Allow exceptions in
+ ``@nogc`` code).
+
+ :samp:`dip1021`
+ Implements https://wiki.dlang.org/DIP1021 (Mutable function arguments).
+
+ :samp:`dip25`
+ Implements https://wiki.dlang.org/DIP25 (Sealed references).
+
+ :samp:`dtorfields`
+ Turns on generation for destructing fields of partially constructed objects.
+
+ :samp:`fieldwise`
+ Turns on generation of struct equality to use field-wise comparisons.
+
+ :samp:`fixaliasthis`
+ Implements new lookup rules that check the current scope for ``alias this``
+ before searching in upper scopes.
+
+ :samp:`in`
+ Implements ``in`` parameters to mean ``scope const [ref]`` and accepts
+ rvalues.
+
+ :samp:`inclusiveincontracts`
+ Implements ``in`` contracts of overridden methods to be a superset of parent
+ contract.
+
+ :samp:`intpromote`
+ Implements C-style integral promotion for unary ``+``, ``-`` and ``~``
+ expressions.
+
+ :samp:`nosharedaccess`
+ Turns off and disallows all access to shared memory objects.
+
+ :samp:`rvaluerefparam`
+ Implements rvalue arguments to ``ref`` parameters.
+
+ :samp:`shortenedmethods`
+ Implements use of ``=>`` for methods and top-level functions in addition to
+ lambdas.
+
+.. option:: -frelease
+
+ .. index:: -fno-release
+
+ Turns on compiling in release mode, which means not emitting runtime
+ checks for contracts and asserts. Array bounds checking is not done
+ for ``@system`` and ``@trusted`` functions, and assertion
+ failures are undefined behavior.
+
+ This is equivalent to compiling with the following options:
+
+ .. code-block:: c++
+
+ gdc -fno-assert -fbounds-check=safe -fno-invariants \
+ -fno-postconditions -fno-preconditions -fno-switch-errors
+
+.. option:: -frevert=
+
+ .. index:: -frevert
+
+ Turns off a D language feature identified by :samp:`{id}`. The following values
+ are supported:
+
+ :samp:`all`
+ Turns off all revertable D language features.
+
+ :samp:`dip25`
+ Reverts https://wiki.dlang.org/DIP25 (Sealed references).
+
+ :samp:`dtorfields`
+ Turns off generation for destructing fields of partially constructed objects.
+
+ :samp:`markdown`
+ Turns off Markdown replacements in Ddoc comments.
+
+.. option:: -fno-rtti
+
+ .. index:: -frtti, -fno-rtti
+
+ Turns off generation of run-time type information for all user defined types.
+ Any code that uses features of the language that require access to this
+ information will result in an error.
+
+.. option:: -fno-switch-errors
+
+ .. index:: -fswitch-errors, -fno-switch-errors
+
+ This option controls what code is generated when no case is matched
+ in a ``final switch`` statement. The default run time behavior
+ is to throw a ``SwitchError``. Turning off :option:`-fswitch-errors`
+ means that instead the execution of the program is immediately halted.
+
+.. option:: -funittest
+
+ .. index:: -funittest, -fno-unittest
+
+ Turns on compilation of ``unittest`` code, and turns on the
+ ``version(unittest)`` identifier. This implies :option:`-fassert`.
+
+.. option:: -fversion=value
+
+ .. index:: -fversion
+
+ Turns on compilation of conditional ``version`` code into the program
+ identified by any of the following values:
+
+ :samp:`level`
+ Sets the version level to :samp:`{level}`, any ``version`` code >= :samp:`{level}`
+ is compiled into the program.
+
+ :samp:`ident`
+ Turns on compilation of ``version`` code identified by :samp:`{ident}`.
+
+.. option:: -fno-weak-templates
+
+ .. index:: -fweak-templates, -fno-weak-templates
+
+ Turns off emission of declarations that can be defined in multiple objects as
+ weak symbols. The default is to emit all public symbols as weak, unless the
+ target lacks support for weak symbols. Disabling this option means that common
+ symbols are instead put in COMDAT or become private.
\ No newline at end of file
diff --git a/gcc/d/doc/invoking-gdc/warnings.rst b/gcc/d/doc/invoking-gdc/warnings.rst
new file mode 100644
index 00000000000..4f3e02b926e
--- /dev/null
+++ b/gcc/d/doc/invoking-gdc/warnings.rst
@@ -0,0 +1,148 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: options to control warnings, warning messages, messages, warning, suppressing warnings
+
+.. _warnings:
+
+Warnings
+********
+
+Warnings are diagnostic messages that report constructions that
+are not inherently erroneous but that are risky or suggest there
+is likely to be a bug in the program. Unless :option:`-Werror` is
+specified, they do not prevent compilation of the program.
+
+.. option:: -Wall
+
+ .. index:: -Wall, -Wno-all
+
+ Turns on all warnings messages. Warnings are not a defined part of
+ the D language, and all constructs for which this may generate a
+ warning message are valid code.
+
+.. option:: -Walloca
+
+ .. index:: -Walloca
+
+ This option warns on all uses of "alloca" in the source.
+
+.. option:: -Walloca-larger-than=n
+
+ .. index:: -Walloca-larger-than, -Wno-alloca-larger-than
+
+ Warn on unbounded uses of alloca, and on bounded uses of alloca
+ whose bound can be larger than :samp:`{n}` bytes.
+ :option:`-Wno-alloca-larger-than` disables
+ :option:`-Walloca-larger-than` warning and is equivalent to
+ :option:`-Walloca-larger-than`:samp:`={SIZE_MAX}` or larger.
+
+.. option:: -Wcast-result
+
+ .. index:: -Wcast-result, -Wno-cast-result
+
+ Warn about casts that will produce a null or zero result. Currently
+ this is only done for casting between an imaginary and non-imaginary
+ data type, or casting between a D and C++ class.
+
+.. option:: -Wno-deprecated
+
+ .. index:: -Wdeprecated, -Wno-deprecated
+
+ Do not warn about usage of deprecated features and symbols with
+ ``deprecated`` attributes.
+
+.. option:: -Werror
+
+ .. index:: -Werror, -Wno-error
+
+ Turns all warnings into errors.
+
+.. option:: -Wspeculative
+
+ .. index:: -Wspeculative, -Wno-speculative
+
+ List all error messages from speculative compiles, such as
+ ``__traits(compiles, ...)``. This option does not report
+ messages as warnings, and these messages therefore never become
+ errors when the :option:`-Werror` option is also used.
+
+.. option:: -Wtemplates
+
+ .. index:: -Wtemplates, -Wno-templates
+
+ Warn when a template instantiation is encountered. Some coding
+ rules disallow templates, and this may be used to enforce that rule.
+
+.. option:: -Wunknown-pragmas
+
+ .. index:: -Wunknown-pragmas, -Wno-unknown-pragmas
+
+ Warn when a ``pragma()`` is encountered that is not understood by
+ :command:`gdc`. This differs from :option:`-fignore-unknown-pragmas`
+ where a pragma that is part of the D language, but not implemented by
+ the compiler, won't get reported.
+
+.. option:: -Wno-varargs
+
+ .. index:: Wvarargs, Wno-varargs
+
+ Do not warn upon questionable usage of the macros used to handle variable
+ arguments like ``va_start``.
+
+.. option:: -fignore-unknown-pragmas
+
+ .. index:: -fignore-unknown-pragmas, -fno-ignore-unknown-pragmas
+
+ Turns off errors for unsupported pragmas.
+
+.. option:: -fmax-errors=n
+
+ .. index:: -fmax-errors
+
+ Limits the maximum number of error messages to :samp:`{n}`, at which point
+ :command:`gdc` bails out rather than attempting to continue processing the
+ source code. If :samp:`{n}` is 0 (the default), there is no limit on the
+ number of error messages produced.
+
+.. option:: -fsyntax-only
+
+ .. index:: -fsyntax-only, -fno-syntax-only
+
+ Check the code for syntax errors, but do not actually compile it. This
+ can be used in conjunction with :option:`-fdoc` or :option:`-H` to generate
+ files for each module present on the command-line, but no other output
+ file.
+
+.. option:: -ftransition=id
+
+ .. index:: -ftransition
+
+ Report additional information about D language changes identified by
+ :samp:`{id}`. The following values are supported:
+
+ :samp:`all`
+ List information on all D language transitions.
+
+ :samp:`complex`
+ List all usages of complex or imaginary types.
+
+ :samp:`field`
+ List all non-mutable fields which occupy an object instance.
+
+ :samp:`in`
+ List all usages of ``in`` on parameter.
+
+ :samp:`nogc`
+ List all hidden GC allocations.
+
+ :samp:`templates`
+ List statistics on template instantiations.
+
+ :samp:`tls`
+ List all variables going into thread local storage.
+
+ :samp:`vmarkdown`
+ List instances of Markdown replacements in Ddoc.
\ No newline at end of file
diff --git a/gcc/doc/cpp/character-sets.rst b/gcc/doc/cpp/character-sets.rst
new file mode 100644
index 00000000000..8557aeb7508
--- /dev/null
+++ b/gcc/doc/cpp/character-sets.rst
@@ -0,0 +1,56 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _character-sets:
+
+Character sets
+**************
+
+Source code character set processing in C and related languages is
+rather complicated. The C standard discusses two character sets, but
+there are really at least four.
+
+The files input to CPP might be in any character set at all. CPP's
+very first action, before it even looks for line boundaries, is to
+convert the file into the character set it uses for internal
+processing. That set is what the C standard calls the :dfn:`source`
+character set. It must be isomorphic with ISO 10646, also known as
+Unicode. CPP uses the UTF-8 encoding of Unicode.
+
+The character sets of the input files are specified using the
+:option:`-finput-charset` = option.
+
+All preprocessing work (the subject of the rest of this manual) is
+carried out in the source character set. If you request textual
+output from the preprocessor with the :option:`-E` option, it will be
+in UTF-8.
+
+After preprocessing is complete, string and character constants are
+converted again, into the :dfn:`execution` character set. This
+character set is under control of the user; the default is UTF-8,
+matching the source character set. Wide string and character
+constants have their own character set, which is not called out
+specifically in the standard. Again, it is under control of the user.
+The default is UTF-16 or UTF-32, whichever fits in the target's
+``wchar_t`` type, in the target machine's byte
+order [#f1]_.
+
+Octal and hexadecimal escape sequences do not undergo
+conversion; ``'\x12'`` has the value 0x12 regardless of the currently
+selected execution character set. All other escapes are replaced by
+the character in the source character set that they represent, then
+converted to the execution character set, just like unescaped
+characters.
+
+In identifiers, characters outside the ASCII range can be specified
+with the :samp:`\\u` and :samp:`\\U` escapes or used directly in the input
+encoding. If strict ISO C90 conformance is specified with an option
+such as :option:`-std`:samp:`=c90`, or :option:`-fno-extended-identifiers` is
+used, then those constructs are not permitted in identifiers.
+
+.. [#f1] UTF-16 does not meet the requirements of the C
+ standard for a wide character set, but the choice of 16-bit
+ ``wchar_t`` is enshrined in some system ABIs so we cannot fix
+ this.
\ No newline at end of file
diff --git a/gcc/doc/cpp/conditional-syntax.rst b/gcc/doc/cpp/conditional-syntax.rst
new file mode 100644
index 00000000000..f1fdcb0f551
--- /dev/null
+++ b/gcc/doc/cpp/conditional-syntax.rst
@@ -0,0 +1,411 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: #if
+
+.. _conditional-syntax:
+
+Conditional Syntax
+******************
+
+A conditional in the C preprocessor begins with a :dfn:`conditional
+directive`: :samp:`#if`, :samp:`#ifdef` or :samp:`#ifndef`.
+
+.. toctree::
+ :maxdepth: 2
+
+
+.. index:: #ifdef, #endif
+
+.. _ifdef:
+
+Ifdef
+^^^^^
+
+The simplest sort of conditional is
+
+.. code-block:: c++
+
+ #ifdef MACRO
+
+ controlled text
+
+ #endif /* MACRO */
+
+.. index:: conditional group
+
+This block is called a :dfn:`conditional group`. :samp:`{controlled text}`
+will be included in the output of the preprocessor if and only if
+:samp:`{MACRO}` is defined. We say that the conditional :dfn:`succeeds` if
+:samp:`{MACRO}` is defined, :dfn:`fails` if it is not.
+
+The :samp:`{controlled text}` inside of a conditional can include
+preprocessing directives. They are executed only if the conditional
+succeeds. You can nest conditional groups inside other conditional
+groups, but they must be completely nested. In other words,
+:samp:`#endif` always matches the nearest :samp:`#ifdef` (or
+:samp:`#ifndef`, or :samp:`#if`). Also, you cannot start a conditional
+group in one file and end it in another.
+
+Even if a conditional fails, the :samp:`{controlled text}` inside it is
+still run through initial transformations and tokenization. Therefore,
+it must all be lexically valid C. Normally the only way this matters is
+that all comments and string literals inside a failing conditional group
+must still be properly ended.
+
+The comment following the :samp:`#endif` is not required, but it is a
+good practice if there is a lot of :samp:`{controlled text}`, because it
+helps people match the :samp:`#endif` to the corresponding :samp:`#ifdef`.
+Older programs sometimes put :samp:`{MACRO}` directly after the
+:samp:`#endif` without enclosing it in a comment. This is invalid code
+according to the C standard. CPP accepts it with a warning. It
+never affects which :samp:`#ifndef` the :samp:`#endif` matches.
+
+.. index:: #ifndef
+
+Sometimes you wish to use some code if a macro is *not* defined.
+You can do this by writing :samp:`#ifndef` instead of :samp:`#ifdef`.
+One common use of :samp:`#ifndef` is to include code only the first
+time a header file is included. See :ref:`once-only-headers`.
+
+Macro definitions can vary between compilations for several reasons.
+Here are some samples.
+
+* Some macros are predefined on each kind of machine
+ (see :ref:`system-specific-predefined-macros`). This allows you to provide
+ code specially tuned for a particular machine.
+
+* System header files define more macros, associated with the features
+ they implement. You can test these macros with conditionals to avoid
+ using a system feature on a machine where it is not implemented.
+
+* Macros can be defined or undefined with the :option:`-D` and :option:`-U`
+ command-line options when you compile the program. You can arrange to
+ compile the same source file into two different programs by choosing a
+ macro name to specify which program you want, writing conditionals to
+ test whether or how this macro is defined, and then controlling the
+ state of the macro with command-line options, perhaps set in the
+ Makefile. See :ref:`invocation`.
+
+* Your program might have a special header file (often called
+ :samp:`config.h`) that is adjusted when the program is compiled. It can
+ define or not define macros depending on the features of the system and
+ the desired capabilities of the program. The adjustment can be
+ automated by a tool such as :command:`autoconf`, or done by hand.
+
+.. _if:
+
+If
+^^
+
+The :samp:`#if` directive allows you to test the value of an arithmetic
+expression, rather than the mere existence of one macro. Its syntax is
+
+.. code-block:: c++
+
+ #if expression
+
+ controlled text
+
+ #endif /* expression */
+
+:samp:`{expression}` is a C expression of integer type, subject to stringent
+restrictions. It may contain
+
+* Integer constants.
+
+* Character constants, which are interpreted as they would be in normal
+ code.
+
+* Arithmetic operators for addition, subtraction, multiplication,
+ division, bitwise operations, shifts, comparisons, and logical
+ operations (``&&`` and ``||``). The latter two obey the usual
+ short-circuiting rules of standard C.
+
+* Macros. All macros in the expression are expanded before actual
+ computation of the expression's value begins.
+
+* Uses of the ``defined`` operator, which lets you check whether macros
+ are defined in the middle of an :samp:`#if`.
+
+* Identifiers that are not macros, which are all considered to be the
+ number zero. This allows you to write ``#if MACRO`` instead of
+ ``#ifdef MACRO``, if you know that MACRO, when defined, will
+ always have a nonzero value. Function-like macros used without their
+ function call parentheses are also treated as zero.
+
+ In some contexts this shortcut is undesirable. The :option:`-Wundef`
+ option causes GCC to warn whenever it encounters an identifier which is
+ not a macro in an :samp:`#if`.
+
+The preprocessor does not know anything about types in the language.
+Therefore, ``sizeof`` operators are not recognized in :samp:`#if`, and
+neither are ``enum`` constants. They will be taken as identifiers
+which are not macros, and replaced by zero. In the case of
+``sizeof``, this is likely to cause the expression to be invalid.
+
+The preprocessor calculates the value of :samp:`{expression}`. It carries
+out all calculations in the widest integer type known to the compiler;
+on most machines supported by GCC this is 64 bits. This is not the same
+rule as the compiler uses to calculate the value of a constant
+expression, and may give different results in some cases. If the value
+comes out to be nonzero, the :samp:`#if` succeeds and the :samp:`{controlled
+text}` is included; otherwise it is skipped.
+
+.. index:: defined
+
+.. _defined:
+
+Defined
+^^^^^^^
+
+The special operator ``defined`` is used in :samp:`#if` and
+:samp:`#elif` expressions to test whether a certain name is defined as a
+macro. ``defined name`` and ``defined (name)`` are
+both expressions whose value is 1 if :samp:`{name}` is defined as a macro at
+the current point in the program, and 0 otherwise. Thus, ``#if
+defined MACRO`` is precisely equivalent to ``#ifdef MACRO``.
+
+``defined`` is useful when you wish to test more than one macro for
+existence at once. For example,
+
+.. code-block:: c++
+
+ #if defined (__vax__) || defined (__ns16000__)
+
+would succeed if either of the names ``__vax__`` or
+``__ns16000__`` is defined as a macro.
+
+Conditionals written like this:
+
+.. code-block:: c++
+
+ #if defined BUFSIZE && BUFSIZE >= 1024
+
+can generally be simplified to just ``#if BUFSIZE >= 1024``,
+since if ``BUFSIZE`` is not defined, it will be interpreted as having
+the value zero.
+
+If the ``defined`` operator appears as a result of a macro expansion,
+the C standard says the behavior is undefined. GNU cpp treats it as a
+genuine ``defined`` operator and evaluates it normally. It will warn
+wherever your code uses this feature if you use the command-line option
+:option:`-Wpedantic`, since other compilers may handle it differently. The
+warning is also enabled by :option:`-Wextra`, and can also be enabled
+individually with :option:`-Wexpansion-to-defined`.
+
+.. index:: #else
+
+.. _else:
+
+Else
+^^^^
+
+The :samp:`#else` directive can be added to a conditional to provide
+alternative text to be used if the condition fails. This is what it
+looks like:
+
+.. code-block:: c++
+
+ #if expression
+ text-if-true
+ #else /* Not expression */
+ text-if-false
+ #endif /* Not expression */
+
+If :samp:`{expression}` is nonzero, the :samp:`{text-if-true}` is included and
+the :samp:`{text-if-false}` is skipped. If :samp:`{expression}` is zero, the
+opposite happens.
+
+You can use :samp:`#else` with :samp:`#ifdef` and :samp:`#ifndef`, too.
+
+.. index:: #elif
+
+.. _elif:
+
+Elif
+^^^^
+
+One common case of nested conditionals is used to check for more than two
+possible alternatives. For example, you might have
+
+.. code-block:: c++
+
+ #if X == 1
+ ...
+ #else /* X != 1 */
+ #if X == 2
+ ...
+ #else /* X != 2 */
+ ...
+ #endif /* X != 2 */
+ #endif /* X != 1 */
+
+Another conditional directive, :samp:`#elif`, allows this to be
+abbreviated as follows:
+
+.. code-block:: c++
+
+ #if X == 1
+ ...
+ #elif X == 2
+ ...
+ #else /* X != 2 and X != 1*/
+ ...
+ #endif /* X != 2 and X != 1*/
+
+:samp:`#elif` stands for 'else if'. Like :samp:`#else`, it goes in the
+middle of a conditional group and subdivides it; it does not require a
+matching :samp:`#endif` of its own. Like :samp:`#if`, the :samp:`#elif`
+directive includes an expression to be tested. The text following the
+:samp:`#elif` is processed only if the original :samp:`#if`-condition
+failed and the :samp:`#elif` condition succeeds.
+
+More than one :samp:`#elif` can go in the same conditional group. Then
+the text after each :samp:`#elif` is processed only if the :samp:`#elif`
+condition succeeds after the original :samp:`#if` and all previous
+:samp:`#elif` directives within it have failed.
+
+:samp:`#else` is allowed after any number of :samp:`#elif` directives, but
+:samp:`#elif` may not follow :samp:`#else`.
+
+.. index:: __has_attribute
+
+__has_attribute
+^^^^^^^^^^^^^^^
+
+The special operator ``__has_attribute (operand)`` may be used
+in :samp:`#if` and :samp:`#elif` expressions to test whether the attribute
+referenced by its :samp:`{operand}` is recognized by GCC. Using the operator
+in other contexts is not valid. In C code, if compiling for strict
+conformance to standards before C2x, :samp:`{operand}` must be
+a valid identifier. Otherwise, :samp:`{operand}` may be optionally
+introduced by the ``attribute-scope::`` prefix.
+The :samp:`{attribute-scope}` prefix identifies the 'namespace' within
+which the attribute is recognized. The scope of GCC attributes is
+:samp:`gnu` or :samp:`__gnu__`. The ``__has_attribute`` operator by
+itself, without any :samp:`{operand}` or parentheses, acts as a predefined
+macro so that support for it can be tested in portable code. Thus,
+the recommended use of the operator is as follows:
+
+.. code-block:: c++
+
+ #if defined __has_attribute
+ # if __has_attribute (nonnull)
+ # define ATTR_NONNULL __attribute__ ((nonnull))
+ # endif
+ #endif
+
+The first :samp:`#if` test succeeds only when the operator is supported
+by the version of GCC (or another compiler) being used. Only when that
+test succeeds is it valid to use ``__has_attribute`` as a preprocessor
+operator. As a result, combining the two tests into a single expression as
+shown below would only be valid with a compiler that supports the operator
+but not with others that don't.
+
+.. code-block:: c++
+
+ #if defined __has_attribute && __has_attribute (nonnull) /* not portable */
+ ...
+ #endif
+
+.. index:: __has_cpp_attribute
+
+__has_cpp_attribute
+^^^^^^^^^^^^^^^^^^^
+
+The special operator ``__has_cpp_attribute (operand)`` may be used
+in :samp:`#if` and :samp:`#elif` expressions in C++ code to test whether
+the attribute referenced by its :samp:`{operand}` is recognized by GCC.
+``__has_cpp_attribute (operand)`` is equivalent to
+``__has_attribute (operand)`` except that when :samp:`{operand}`
+designates a supported standard attribute it evaluates to an integer
+constant of the form ``YYYYMM`` indicating the year and month when
+the attribute was first introduced into the C++ standard. For additional
+information including the dates of the introduction of current standard
+attributes, see `SD-6: SG10 Feature Test Recommendations <https://isocpp.org/std/standing-documents/sd-6-sg10-feature-test-recommendations/>`_.
+
+.. index:: __has_c_attribute
+
+__has_c_attribute
+^^^^^^^^^^^^^^^^^
+
+The special operator ``__has_c_attribute (operand)`` may be
+used in :samp:`#if` and :samp:`#elif` expressions in C code to test
+whether the attribute referenced by its :samp:`{operand}` is recognized by
+GCC in attributes using the :samp:`[[]]` syntax. GNU attributes must
+be specified with the scope :samp:`gnu` or :samp:`__gnu__` with
+``__has_c_attribute``. When :samp:`{operand}` designates a supported
+standard attribute it evaluates to an integer constant of the form
+``YYYYMM`` indicating the year and month when the attribute was
+first introduced into the C standard, or when the syntax of operands
+to the attribute was extended in the C standard.
+
+.. index:: __has_builtin
+
+__has_builtin
+^^^^^^^^^^^^^
+
+The special operator ``__has_builtin (operand)`` may be used in
+constant integer contexts and in preprocessor :samp:`#if` and :samp:`#elif`
+expressions to test whether the symbol named by its :samp:`{operand}` is
+recognized as a built-in function by GCC in the current language and
+conformance mode. It evaluates to a constant integer with a nonzero
+value if the argument refers to such a function, and to zero otherwise.
+The operator may also be used in preprocessor :samp:`#if` and :samp:`#elif`
+expressions. The ``__has_builtin`` operator by itself, without any
+:samp:`{operand}` or parentheses, acts as a predefined macro so that support
+for it can be tested in portable code. Thus, the recommended use of
+the operator is as follows:
+
+.. code-block:: c++
+
+ #if defined __has_builtin
+ # if __has_builtin (__builtin_object_size)
+ # define builtin_object_size(ptr) __builtin_object_size (ptr, 2)
+ # endif
+ #endif
+ #ifndef builtin_object_size
+ # define builtin_object_size(ptr) ((size_t)-1)
+ #endif
+
+.. index:: __has_include
+
+__has_include
+^^^^^^^^^^^^^
+
+The special operator ``__has_include (operand)`` may be used in
+:samp:`#if` and :samp:`#elif` expressions to test whether the header referenced
+by its :samp:`{operand}` can be included using the :samp:`#include` directive. Using
+the operator in other contexts is not valid. The :samp:`{operand}` takes
+the same form as the file in the :samp:`#include` directive (see :ref:`include-syntax`) and evaluates to a nonzero value if the header can be included and
+to zero otherwise. Note that that the ability to include a header doesn't
+imply that the header doesn't contain invalid constructs or :samp:`#error`
+directives that would cause the preprocessor to fail.
+
+The ``__has_include`` operator by itself, without any :samp:`{operand}` or
+parentheses, acts as a predefined macro so that support for it can be tested
+in portable code. Thus, the recommended use of the operator is as follows:
+
+.. code-block:: c++
+
+ #if defined __has_include
+ # if __has_include (<stdatomic.h>)
+ # include <stdatomic.h>
+ # endif
+ #endif
+
+The first :samp:`#if` test succeeds only when the operator is supported
+by the version of GCC (or another compiler) being used. Only when that
+test succeeds is it valid to use ``__has_include`` as a preprocessor
+operator. As a result, combining the two tests into a single expression
+as shown below would only be valid with a compiler that supports the operator
+but not with others that don't.
+
+.. code-block:: c++
+
+ #if defined __has_include && __has_include ("header.h") /* not portable */
+ ...
+ #endif
\ No newline at end of file
diff --git a/gcc/doc/cpp/conditional-uses.rst b/gcc/doc/cpp/conditional-uses.rst
new file mode 100644
index 00000000000..dfd06038451
--- /dev/null
+++ b/gcc/doc/cpp/conditional-uses.rst
@@ -0,0 +1,32 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _conditional-uses:
+
+Conditional Uses
+****************
+
+There are three general reasons to use a conditional.
+
+* A program may need to use different code depending on the machine or
+ operating system it is to run on. In some cases the code for one
+ operating system may be erroneous on another operating system; for
+ example, it might refer to data types or constants that do not exist on
+ the other system. When this happens, it is not enough to avoid
+ executing the invalid code. Its mere presence will cause the compiler
+ to reject the program. With a preprocessing conditional, the offending
+ code can be effectively excised from the program when it is not valid.
+
+* You may want to be able to compile the same source file into two
+ different programs. One version might make frequent time-consuming
+ consistency checks on its intermediate data, or print the values of
+ those data for debugging, and the other not.
+
+* A conditional whose condition is always false is one way to exclude code
+ from the program but keep it as a sort of comment for future reference.
+
+Simple programs that do not need system-specific logic or complex
+debugging hooks generally will not need to use preprocessing
+conditionals.
\ No newline at end of file
diff --git a/gcc/doc/cpp/conditionals.rst b/gcc/doc/cpp/conditionals.rst
new file mode 100644
index 00000000000..a6160433d69
--- /dev/null
+++ b/gcc/doc/cpp/conditionals.rst
@@ -0,0 +1,44 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: conditionals
+
+.. _conditionals:
+
+Conditionals
+------------
+
+A :dfn:`conditional` is a directive that instructs the preprocessor to
+select whether or not to include a chunk of code in the final token
+stream passed to the compiler. Preprocessor conditionals can test
+arithmetic expressions, or whether a name is defined as a macro, or both
+simultaneously using the special ``defined`` operator.
+
+A conditional in the C preprocessor resembles in some ways an ``if``
+statement in C, but it is important to understand the difference between
+them. The condition in an ``if`` statement is tested during the
+execution of your program. Its purpose is to allow your program to
+behave differently from run to run, depending on the data it is
+operating on. The condition in a preprocessing conditional directive is
+tested when your program is compiled. Its purpose is to allow different
+code to be included in the program depending on the situation at the
+time of compilation.
+
+However, the distinction is becoming less clear. Modern compilers often
+do test ``if`` statements when a program is compiled, if their
+conditions are known not to vary at run time, and eliminate code which
+can never be executed. If you can count on your compiler to do this,
+you may find that your program is more readable if you use ``if``
+statements with constant conditions (perhaps determined by macros). Of
+course, you can only use this to exclude code, not type definitions or
+other preprocessing directives, and you can only do it if the code
+remains syntactically valid when it is not to be used.
+
+.. toctree::
+ :maxdepth: 2
+
+ conditional-uses
+ conditional-syntax
+ deleted-code
\ No newline at end of file
diff --git a/gcc/doc/cpp/conf.py b/gcc/doc/cpp/conf.py
new file mode 100644
index 00000000000..6ed723b7083
--- /dev/null
+++ b/gcc/doc/cpp/conf.py
@@ -0,0 +1,29 @@
+# Configuration file for the Sphinx documentation builder.
+
+import sys
+sys.path.append('../../..//doc')
+
+from baseconf import *
+
+project = 'The C Preprocessor'
+copyright = '1987-2022 Free Software Foundation, Inc.'
+authors = 'Richard M. Stallman, Zachary Weinberg'
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+# dir menu entry, description, category)
+latex_documents = [
+ ('index', 'cpp.tex', project, authors, 'manual'),
+]
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+ ('invocation', 'cpp', project, [authors], 1),
+]
+
+texinfo_documents = [
+ ('index', 'cpp', project, authors, None, None, None, True)
+]
+
+tags.add('cpp')
\ No newline at end of file
diff --git a/gcc/doc/cpp/copyright.rst b/gcc/doc/cpp/copyright.rst
new file mode 100644
index 00000000000..fa61190ddf7
--- /dev/null
+++ b/gcc/doc/cpp/copyright.rst
@@ -0,0 +1,24 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+Copyright
+^^^^^^^^^
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, the Front-Cover Texts being (a) (see below), and
+with the Back-Cover Texts being (b) (see below).
+A copy of the license is included in the :ref:`gnu_fdl`.
+
+(a) The FSF's Front-Cover Text is:
+
+ A GNU Manual
+
+(b) The FSF's Back-Cover Text is:
+
+ You have freedom to copy and modify this GNU Manual, like GNU
+ software. Copies published by the Free Software Foundation raise
+ funds for GNU development.
\ No newline at end of file
diff --git a/gcc/doc/cpp/deleted-code.rst b/gcc/doc/cpp/deleted-code.rst
new file mode 100644
index 00000000000..538b9b145f8
--- /dev/null
+++ b/gcc/doc/cpp/deleted-code.rst
@@ -0,0 +1,34 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: commenting out code
+
+.. _deleted-code:
+
+Deleted Code
+************
+
+If you replace or delete a part of the program but want to keep the old
+code around for future reference, you often cannot simply comment it
+out. Block comments do not nest, so the first comment inside the old
+code will end the commenting-out. The probable result is a flood of
+syntax errors.
+
+One way to avoid this problem is to use an always-false conditional
+instead. For instance, put ``#if 0`` before the deleted code and
+``#endif`` after it. This works even if the code being turned
+off contains conditionals, but they must be entire conditionals
+(balanced :samp:`#if` and :samp:`#endif`).
+
+Some people use ``#ifdef notdef`` instead. This is risky, because
+``notdef`` might be accidentally defined as a macro, and then the
+conditional would succeed. ``#if 0`` can be counted on to fail.
+
+Do not use ``#if 0`` for comments which are not C code. Use a real
+comment, instead. The interior of ``#if 0`` must consist of complete
+tokens; in particular, single-quote characters must balance. Comments
+often contain unbalanced single-quote characters (known in English as
+apostrophes). These confuse ``#if 0``. They don't confuse
+:samp:`/*`.
\ No newline at end of file
diff --git a/gcc/doc/cpp/diagnostics.rst b/gcc/doc/cpp/diagnostics.rst
new file mode 100644
index 00000000000..69cbf997038
--- /dev/null
+++ b/gcc/doc/cpp/diagnostics.rst
@@ -0,0 +1,51 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: diagnostic, reporting errors, reporting warnings, #error
+
+.. _diagnostics:
+
+Diagnostics
+-----------
+
+The directive :samp:`#error` causes the preprocessor to report a fatal
+error. The tokens forming the rest of the line following :samp:`#error`
+are used as the error message.
+
+You would use :samp:`#error` inside of a conditional that detects a
+combination of parameters which you know the program does not properly
+support. For example, if you know that the program will not run
+properly on a VAX, you might write
+
+.. code-block:: c++
+
+ #ifdef __vax__
+ #error "Won't work on VAXen. See comments at get_last_object."
+ #endif
+
+If you have several configuration parameters that must be set up by
+the installation in a consistent way, you can use conditionals to detect
+an inconsistency and report it with :samp:`#error`. For example,
+
+.. code-block:: c++
+
+ #if !defined(FOO) && defined(BAR)
+ #error "BAR requires FOO."
+ #endif
+
+.. index:: #warning
+
+The directive :samp:`#warning` is like :samp:`#error`, but causes the
+preprocessor to issue a warning and continue preprocessing. The tokens
+following :samp:`#warning` are used as the warning message.
+
+You might use :samp:`#warning` in obsolete header files, with a message
+directing the user to the header file which should be used instead.
+
+Neither :samp:`#error` nor :samp:`#warning` macro-expands its argument.
+Internal whitespace sequences are each replaced with a single space.
+The line must consist of complete tokens. It is wisest to make the
+argument of these directives be a single string constant; this avoids
+problems with apostrophes and the like.
\ No newline at end of file
diff --git a/gcc/doc/cpp/environment-variables.rst b/gcc/doc/cpp/environment-variables.rst
new file mode 100644
index 00000000000..7486a5bd5c0
--- /dev/null
+++ b/gcc/doc/cpp/environment-variables.rst
@@ -0,0 +1,23 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: environment variables
+
+.. _environment-variables:
+
+Environment Variables
+---------------------
+
+This section describes the environment variables that affect how CPP
+operates. You can use them to specify directories or prefixes to use
+when searching for include files, or to control dependency output.
+
+Note that you can also specify places to search using options such as
+:option:`-I`, and control dependency output with options like
+:option:`-M` (see :ref:`invocation`). These take precedence over
+environment variables, which in turn take precedence over the
+configuration of GCC.
+
+.. include:: ../../../doc/cppenv.rst
\ No newline at end of file
diff --git a/gcc/doc/cpp/gnu-free-documentation-license.rst b/gcc/doc/cpp/gnu-free-documentation-license.rst
new file mode 100644
index 00000000000..b251002f094
--- /dev/null
+++ b/gcc/doc/cpp/gnu-free-documentation-license.rst
@@ -0,0 +1,6 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. include:: ../../../doc/gnu_free_documentation_license.rst
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files.rst b/gcc/doc/cpp/header-files.rst
new file mode 100644
index 00000000000..7ff703a486a
--- /dev/null
+++ b/gcc/doc/cpp/header-files.rst
@@ -0,0 +1,56 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: header file
+
+.. _header-files:
+
+Header Files
+------------
+
+A header file is a file containing C declarations and macro definitions
+(see :ref:`macros`) to be shared between several source files. You request
+the use of a header file in your program by :dfn:`including` it, with the
+C preprocessing directive :samp:`#include`.
+
+Header files serve two purposes.
+
+.. index:: system header files
+
+* System header files declare the interfaces to parts of the operating
+ system. You include them in your program to supply the definitions and
+ declarations you need to invoke system calls and libraries.
+
+* Your own header files contain declarations for interfaces between the
+ source files of your program. Each time you have a group of related
+ declarations and macro definitions all or most of which are needed in
+ several different source files, it is a good idea to create a header
+ file for them.
+
+Including a header file produces the same results as copying the header
+file into each source file that needs it. Such copying would be
+time-consuming and error-prone. With a header file, the related
+declarations appear in only one place. If they need to be changed, they
+can be changed in one place, and programs that include the header file
+will automatically use the new version when next recompiled. The header
+file eliminates the labor of finding and changing all the copies as well
+as the risk that a failure to find one copy will result in
+inconsistencies within a program.
+
+In C, the usual convention is to give header files names that end with
+:samp:`.h`. It is most portable to use only letters, digits, dashes, and
+underscores in header file names, and at most one dot.
+
+.. toctree::
+ :maxdepth: 2
+
+ header-files/include-syntax
+ header-files/include-operation
+ header-files/search-path
+ header-files/once-only-headers
+ header-files/alternatives-to-wrapper-ifndef
+ header-files/computed-includes
+ header-files/wrapper-headers
+ header-files/system-headers
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/alternatives-to-wrapper-ifndef.rst b/gcc/doc/cpp/header-files/alternatives-to-wrapper-ifndef.rst
new file mode 100644
index 00000000000..175e84a5466
--- /dev/null
+++ b/gcc/doc/cpp/header-files/alternatives-to-wrapper-ifndef.rst
@@ -0,0 +1,40 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _alternatives-to-wrapper-ifndef:
+
+Alternatives to Wrapper #ifndef
+*******************************
+
+CPP supports two more ways of indicating that a header file should be
+read only once. Neither one is as portable as a wrapper :samp:`#ifndef`
+and we recommend you do not use them in new programs, with the caveat
+that :samp:`#import` is standard practice in Objective-C.
+
+.. index:: #import
+
+CPP supports a variant of :samp:`#include` called :samp:`#import` which
+includes a file, but does so at most once. If you use :samp:`#import`
+instead of :samp:`#include`, then you don't need the conditionals
+inside the header file to prevent multiple inclusion of the contents.
+:samp:`#import` is standard in Objective-C, but is considered a
+deprecated extension in C and C++.
+
+:samp:`#import` is not a well designed feature. It requires the users of
+a header file to know that it should only be included once. It is much
+better for the header file's implementor to write the file so that users
+don't need to know this. Using a wrapper :samp:`#ifndef` accomplishes
+this goal.
+
+In the present implementation, a single use of :samp:`#import` will
+prevent the file from ever being read again, by either :samp:`#import` or
+:samp:`#include`. You should not rely on this; do not use both
+:samp:`#import` and :samp:`#include` to refer to the same header file.
+
+Another way to prevent a header file from being included more than once
+is with the :samp:`#pragma once` directive (see :ref:`pragmas`).
+:samp:`#pragma once` does not have the problems that :samp:`#import` does,
+but it is not recognized by all preprocessors, so you cannot rely on it
+in a portable program.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/computed-includes.rst b/gcc/doc/cpp/header-files/computed-includes.rst
new file mode 100644
index 00000000000..94c89531560
--- /dev/null
+++ b/gcc/doc/cpp/header-files/computed-includes.rst
@@ -0,0 +1,86 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: computed includes, macros in include
+
+.. _computed-includes:
+
+Computed Includes
+*****************
+
+Sometimes it is necessary to select one of several different header
+files to be included into your program. They might specify
+configuration parameters to be used on different sorts of operating
+systems, for instance. You could do this with a series of conditionals,
+
+.. code-block:: c++
+
+ #if SYSTEM_1
+ # include "system_1.h"
+ #elif SYSTEM_2
+ # include "system_2.h"
+ #elif SYSTEM_3
+ ...
+ #endif
+
+That rapidly becomes tedious. Instead, the preprocessor offers the
+ability to use a macro for the header name. This is called a
+:dfn:`computed include`. Instead of writing a header name as the direct
+argument of :samp:`#include`, you simply put a macro name there instead:
+
+.. code-block:: c++
+
+ #define SYSTEM_H "system_1.h"
+ ...
+ #include SYSTEM_H
+
+``SYSTEM_H`` will be expanded, and the preprocessor will look for
+:samp:`system_1.h` as if the :samp:`#include` had been written that way
+originally. ``SYSTEM_H`` could be defined by your Makefile with a
+:option:`-D` option.
+
+You must be careful when you define the macro. :samp:`#define` saves
+tokens, not text. The preprocessor has no way of knowing that the macro
+will be used as the argument of :samp:`#include`, so it generates
+ordinary tokens, not a header name. This is unlikely to cause problems
+if you use double-quote includes, which are close enough to string
+constants. If you use angle brackets, however, you may have trouble.
+
+The syntax of a computed include is actually a bit more general than the
+above. If the first non-whitespace character after :samp:`#include` is
+not :samp:`"` or :samp:`<`, then the entire line is macro-expanded
+like running text would be.
+
+If the line expands to a single string constant, the contents of that
+string constant are the file to be included. CPP does not re-examine the
+string for embedded quotes, but neither does it process backslash
+escapes in the string. Therefore
+
+.. code-block:: c++
+
+ #define HEADER "a\"b"
+ #include HEADER
+
+looks for a file named :samp:`a\\"b`. CPP searches for the file according
+to the rules for double-quoted includes.
+
+If the line expands to a token stream beginning with a :samp:`<` token
+and including a :samp:`>` token, then the tokens between the :samp:`<` and
+the first :samp:`>` are combined to form the filename to be included.
+Any whitespace between tokens is reduced to a single space; then any
+space after the initial :samp:`<` is retained, but a trailing space
+before the closing :samp:`>` is ignored. CPP searches for the file
+according to the rules for angle-bracket includes.
+
+In either case, if there are any tokens on the line after the file name,
+an error occurs and the directive is not processed. It is also an error
+if the result of expansion does not match either of the two expected
+forms.
+
+These rules are implementation-defined behavior according to the C
+standard. To minimize the risk of different compilers interpreting your
+computed includes differently, we recommend you use only a single
+object-like macro which expands to a string constant. This will also
+minimize confusion for people reading your program.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/include-operation.rst b/gcc/doc/cpp/header-files/include-operation.rst
new file mode 100644
index 00000000000..5441223c44d
--- /dev/null
+++ b/gcc/doc/cpp/header-files/include-operation.rst
@@ -0,0 +1,67 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _include-operation:
+
+Include Operation
+*****************
+
+The :samp:`#include` directive works by directing the C preprocessor to
+scan the specified file as input before continuing with the rest of the
+current file. The output from the preprocessor contains the output
+already generated, followed by the output resulting from the included
+file, followed by the output that comes from the text after the
+:samp:`#include` directive. For example, if you have a header file
+:samp:`header.h` as follows,
+
+.. code-block:: c++
+
+ char *test (void);
+
+and a main program called :samp:`program.c` that uses the header file,
+like this,
+
+.. code-block:: c++
+
+ int x;
+ #include "header.h"
+
+ int
+ main (void)
+ {
+ puts (test ());
+ }
+
+the compiler will see the same token stream as it would if
+:samp:`program.c` read
+
+.. code-block:: c++
+
+ int x;
+ char *test (void);
+
+ int
+ main (void)
+ {
+ puts (test ());
+ }
+
+Included files are not limited to declarations and macro definitions;
+those are merely the typical uses. Any fragment of a C program can be
+included from another file. The include file could even contain the
+beginning of a statement that is concluded in the containing file, or
+the end of a statement that was started in the including file. However,
+an included file must consist of complete tokens. Comments and string
+literals which have not been closed by the end of an included file are
+invalid. For error recovery, they are considered to end at the end of
+the file.
+
+To avoid confusion, it is best if header files contain only complete
+syntactic units---function declarations or definitions, type
+declarations, etc.
+
+The line following the :samp:`#include` directive is always treated as a
+separate line by the C preprocessor, even if the included file lacks a
+final newline.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/include-syntax.rst b/gcc/doc/cpp/header-files/include-syntax.rst
new file mode 100644
index 00000000000..e2dd9d7772f
--- /dev/null
+++ b/gcc/doc/cpp/header-files/include-syntax.rst
@@ -0,0 +1,42 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: #include
+
+.. _include-syntax:
+
+Include Syntax
+**************
+
+Both user and system header files are included using the preprocessing
+directive :samp:`#include`. It has two variants:
+
+:samp:`#include <{file}>`
+ This variant is used for system header files. It searches for a file
+ named :samp:`{file}` in a standard list of system directories. You can prepend
+ directories to this list with the :option:`-I` option (see :ref:`invocation`).
+
+:samp:`#include "{file}"`
+ This variant is used for header files of your own program. It
+ searches for a file named :samp:`{file}` first in the directory containing
+ the current file, then in the quote directories and then the same
+ directories used for ``<file>``. You can prepend directories
+ to the list of quote directories with the :option:`-iquote` option.
+
+The argument of :samp:`#include`, whether delimited with quote marks or
+angle brackets, behaves like a string constant in that comments are not
+recognized, and macro names are not expanded. Thus, ``#include
+<x/*y>`` specifies inclusion of a system header file named :samp:`x/*y`.
+
+However, if backslashes occur within :samp:`{file}`, they are considered
+ordinary text characters, not escape characters. None of the character
+escape sequences appropriate to string constants in C are processed.
+Thus, ``#include "x\n\\y"`` specifies a filename containing three
+backslashes. (Some systems interpret :samp:`\\` as a pathname separator.
+All of these also interpret :samp:`/` the same way. It is most portable
+to use only :samp:`/`.)
+
+It is an error if there is anything (other than comments) on the line
+after the file name.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/once-only-headers.rst b/gcc/doc/cpp/header-files/once-only-headers.rst
new file mode 100644
index 00000000000..1b030eb6aef
--- /dev/null
+++ b/gcc/doc/cpp/header-files/once-only-headers.rst
@@ -0,0 +1,52 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: repeated inclusion, including just once, wrapper #ifndef
+
+.. _once-only-headers:
+
+Once-Only Headers
+*****************
+
+If a header file happens to be included twice, the compiler will process
+its contents twice. This is very likely to cause an error, e.g. when the
+compiler sees the same structure definition twice. Even if it does not,
+it will certainly waste time.
+
+The standard way to prevent this is to enclose the entire real contents
+of the file in a conditional, like this:
+
+.. code-block:: c++
+
+ /* File foo. */
+ #ifndef FILE_FOO_SEEN
+ #define FILE_FOO_SEEN
+
+ the entire file
+
+ #endif /* !FILE_FOO_SEEN */
+
+This construct is commonly known as a :dfn:`wrapper #ifndef`.
+When the header is included again, the conditional will be false,
+because ``FILE_FOO_SEEN`` is defined. The preprocessor will skip
+over the entire contents of the file, and the compiler will not see it
+twice.
+
+CPP optimizes even further. It remembers when a header file has a
+wrapper :samp:`#ifndef`. If a subsequent :samp:`#include` specifies that
+header, and the macro in the :samp:`#ifndef` is still defined, it does
+not bother to rescan the file at all.
+
+You can put comments outside the wrapper. They will not interfere with
+this optimization.
+
+.. index:: controlling macro, guard macro
+
+The macro ``FILE_FOO_SEEN`` is called the :dfn:`controlling macro` or
+:dfn:`guard macro`. In a user header file, the macro name should not
+begin with :samp:`_`. In a system header file, it should begin with
+:samp:`__` to avoid conflicts with user programs. In any kind of header
+file, the macro name should contain the name of the file and some
+additional text, to avoid conflicts with other header files.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/search-path.rst b/gcc/doc/cpp/header-files/search-path.rst
new file mode 100644
index 00000000000..879c7652c09
--- /dev/null
+++ b/gcc/doc/cpp/header-files/search-path.rst
@@ -0,0 +1,53 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _search-path:
+
+Search Path
+***********
+
+By default, the preprocessor looks for header files included by the quote
+form of the directive ``#include "file"`` first relative to
+the directory of the current file, and then in a preconfigured list
+of standard system directories.
+For example, if :samp:`/usr/include/sys/stat.h` contains
+``#include "types.h"``, GCC looks for :samp:`types.h` first in
+:samp:`/usr/include/sys`, then in its usual search path.
+
+For the angle-bracket form ``#include <file>``, the
+preprocessor's default behavior is to look only in the standard system
+directories. The exact search directory list depends on the target
+system, how GCC is configured, and where it is installed. You can
+find the default search directory list for your version of CPP by
+invoking it with the :option:`-v` option. For example,
+
+.. code-block:: c++
+
+ cpp -v /dev/null -o /dev/null
+
+There are a number of command-line options you can use to add
+additional directories to the search path.
+The most commonly-used option is :option:`-I`:samp:`{dir}`, which causes
+:samp:`{dir}` to be searched after the current directory (for the quote
+form of the directive) and ahead of the standard system directories.
+You can specify multiple :option:`-I` options on the command line,
+in which case the directories are searched in left-to-right order.
+
+If you need separate control over the search paths for the quote and
+angle-bracket forms of the :samp:`#include` directive, you can use the
+:option:`-iquote` and/or :option:`-isystem` options instead of :option:`-I`.
+See :ref:`invocation`, for a detailed description of these options, as
+well as others that are less generally useful.
+
+If you specify other options on the command line, such as :option:`-I`,
+that affect where the preprocessor searches for header files, the
+directory list printed by the :option:`-v` option reflects the actual
+search path used by the preprocessor.
+
+Note that you can also prevent the preprocessor from searching any of
+the default system header directories with the :option:`-nostdinc`
+option. This is useful when you are compiling an operating system
+kernel or some other program that does not use the standard C library
+facilities, or the standard C library itself.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/system-headers.rst b/gcc/doc/cpp/header-files/system-headers.rst
new file mode 100644
index 00000000000..6713d4c7982
--- /dev/null
+++ b/gcc/doc/cpp/header-files/system-headers.rst
@@ -0,0 +1,41 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: system header files
+
+.. _system-headers:
+
+System Headers
+**************
+
+The header files declaring interfaces to the operating system and
+runtime libraries often cannot be written in strictly conforming C.
+Therefore, GCC gives code found in :dfn:`system headers` special
+treatment. All warnings, other than those generated by :samp:`#warning`
+(see :ref:`diagnostics`), are suppressed while GCC is processing a system
+header. Macros defined in a system header are immune to a few warnings
+wherever they are expanded. This immunity is granted on an ad-hoc
+basis, when we find that a warning generates lots of false positives
+because of code in macros defined in system headers.
+
+Normally, only the headers found in specific directories are considered
+system headers. These directories are determined when GCC is compiled.
+There are, however, two ways to make normal headers into system headers:
+
+* Header files found in directories added to the search path with the
+ :option:`-isystem` and :option:`-idirafter` command-line options are
+ treated as system headers for the purposes of diagnostics.
+
+*
+ .. index:: #pragma GCC system_header
+
+ There is also a directive, ``#pragma GCC system_header``, which
+ tells GCC to consider the rest of the current include file a system
+ header, no matter where it was found. Code that comes before the
+ :samp:`#pragma` in the file is not affected. ``#pragma GCC
+ system_header`` has no effect in the primary source file.
+
+On some targets, such as RS/6000 AIX, GCC implicitly surrounds all
+system headers with an :samp:`extern "C"` block when compiling as C++.
\ No newline at end of file
diff --git a/gcc/doc/cpp/header-files/wrapper-headers.rst b/gcc/doc/cpp/header-files/wrapper-headers.rst
new file mode 100644
index 00000000000..bacd080a2a3
--- /dev/null
+++ b/gcc/doc/cpp/header-files/wrapper-headers.rst
@@ -0,0 +1,58 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: wrapper headers, overriding a header file, #include_next
+
+.. _wrapper-headers:
+
+Wrapper Headers
+***************
+
+Sometimes it is necessary to adjust the contents of a system-provided
+header file without editing it directly. GCC's :command:`fixincludes`
+operation does this, for example. One way to do that would be to create
+a new header file with the same name and insert it in the search path
+before the original header. That works fine as long as you're willing
+to replace the old header entirely. But what if you want to refer to
+the old header from the new one?
+
+You cannot simply include the old header with :samp:`#include`. That
+will start from the beginning, and find your new header again. If your
+header is not protected from multiple inclusion (see :ref:`once-only-headers`), it will recurse infinitely and cause a fatal error.
+
+You could include the old header with an absolute pathname:
+
+.. code-block:: c++
+
+ #include "/usr/include/old-header.h"
+
+This works, but is not clean; should the system headers ever move, you
+would have to edit the new headers to match.
+
+There is no way to solve this problem within the C standard, but you can
+use the GNU extension :samp:`#include_next`. It means, 'Include the
+*next* file with this name'. This directive works like
+:samp:`#include` except in searching for the specified file: it starts
+searching the list of header file directories *after* the directory
+in which the current file was found.
+
+Suppose you specify :option:`-I /usr/local/include`, and the list of
+directories to search also includes :samp:`/usr/include`; and suppose
+both directories contain :samp:`signal.h`. Ordinary ``#include
+<signal.h>`` finds the file under :samp:`/usr/local/include`. If that
+file contains ``#include_next <signal.h>``, it starts searching
+after that directory, and finds the file in :samp:`/usr/include`.
+
+:samp:`#include_next` does not distinguish between ``<file>``
+and ``"file"`` inclusion, nor does it check that the file you
+specify has the same name as the current file. It simply looks for the
+file named, starting with the directory in the search path after the one
+where the current file was found.
+
+The use of :samp:`#include_next` can lead to great confusion. We
+recommend it be used only when there is no other alternative. In
+particular, it should not be used in the headers belonging to a specific
+program; it should be used only to make global corrections along the
+lines of :command:`fixincludes`.
\ No newline at end of file
diff --git a/gcc/doc/cpp/implementation-defined-behavior.rst b/gcc/doc/cpp/implementation-defined-behavior.rst
new file mode 100644
index 00000000000..cb1cabbbace
--- /dev/null
+++ b/gcc/doc/cpp/implementation-defined-behavior.rst
@@ -0,0 +1,97 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _implementation-defined-behavior:
+
+.. _identifier-characters:
+
+Implementation-defined behavior
+*******************************
+
+This is how CPP behaves in all the cases which the C standard
+describes as :dfn:`implementation-defined`. This term means that the
+implementation is free to do what it likes, but must document its choice
+and stick to it.
+
+.. FIXME: Check the C++ standard for more implementation-defined stuff.
+
+* The mapping of physical source file multi-byte characters to the
+ execution character set.
+
+ The input character set can be specified using the
+ :option:`-finput-charset` option, while the execution character set may
+ be controlled using the :option:`-fexec-charset` and
+ :option:`-fwide-exec-charset` options.
+
+* Identifier characters.
+
+ The C and C++ standards allow identifiers to be composed of :samp:`_`
+ and the alphanumeric characters. C++ also allows universal character
+ names. C99 and later C standards permit both universal character
+ names and implementation-defined characters. In both C and C++ modes,
+ GCC accepts in identifiers exactly those extended characters that
+ correspond to universal character names permitted by the chosen
+ standard.
+
+ GCC allows the :samp:`$` character in identifiers as an extension for
+ most targets. This is true regardless of the std = switch,
+ since this extension cannot conflict with standards-conforming
+ programs. When preprocessing assembler, however, dollars are not
+ identifier characters by default.
+
+ Currently the targets that by default do not permit :samp:`$` are AVR,
+ IP2K, MMIX, MIPS Irix 3, ARM aout, and PowerPC targets for the AIX
+ operating system.
+
+ You can override the default with :option:`-fdollars-in-identifiers` or
+ :option:`-fno-dollars-in-identifiers`. See :option:`-fdollars-in-identifiers`.
+
+* Non-empty sequences of whitespace characters.
+
+ In textual output, each whitespace sequence is collapsed to a single
+ space. For aesthetic reasons, the first token on each non-directive
+ line of output is preceded with sufficient spaces that it appears in the
+ same column as it did in the original source file.
+
+* The numeric value of character constants in preprocessor expressions.
+
+ The preprocessor and compiler interpret character constants in the
+ same way; i.e. escape sequences such as :samp:`\\a` are given the
+ values they would have on the target machine.
+
+ The compiler evaluates a multi-character character constant a character
+ at a time, shifting the previous value left by the number of bits per
+ target character, and then or-ing in the bit-pattern of the new
+ character truncated to the width of a target character. The final
+ bit-pattern is given type ``int``, and is therefore signed,
+ regardless of whether single characters are signed or not.
+ If there are more
+ characters in the constant than would fit in the target ``int`` the
+ compiler issues a warning, and the excess leading characters are
+ ignored.
+
+ For example, ``'ab'`` for a target with an 8-bit ``char`` would be
+ interpreted as :samp:`(int) ((unsigned char) 'a' * 256 + (unsigned char)
+ 'b')`, and ``'\234a'`` as :samp:`(int) ((unsigned char) '\\234' *
+ 256 + (unsigned char) 'a')`.
+
+* Source file inclusion.
+
+ For a discussion on how the preprocessor locates header files,
+ :ref:`include-operation`.
+
+* Interpretation of the filename resulting from a macro-expanded
+ :samp:`#include` directive.
+
+ See :ref:`computed-includes`.
+
+* Treatment of a :samp:`#pragma` directive that after macro-expansion
+ results in a standard pragma.
+
+ No macro expansion occurs on any :samp:`#pragma` directive line, so the
+ question does not arise.
+
+ Note that GCC does not yet implement any of the standard
+ pragmas.
\ No newline at end of file
diff --git a/gcc/doc/cpp/implementation-details.rst b/gcc/doc/cpp/implementation-details.rst
new file mode 100644
index 00000000000..f589acbf9d6
--- /dev/null
+++ b/gcc/doc/cpp/implementation-details.rst
@@ -0,0 +1,23 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _implementation-details:
+
+Implementation Details
+----------------------
+
+Here we document details of how the preprocessor's implementation
+affects its user-visible behavior. You should try to avoid undue
+reliance on behavior described here, as it is possible that it will
+change subtly in future implementations.
+
+Also documented here are obsolete features still supported by CPP.
+
+.. toctree::
+ :maxdepth: 2
+
+ implementation-defined-behavior
+ implementation-limits
+ obsolete-features
\ No newline at end of file
diff --git a/gcc/doc/cpp/implementation-limits.rst b/gcc/doc/cpp/implementation-limits.rst
new file mode 100644
index 00000000000..aac5cca1162
--- /dev/null
+++ b/gcc/doc/cpp/implementation-limits.rst
@@ -0,0 +1,68 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: implementation limits
+
+.. _implementation-limits:
+
+Implementation limits
+*********************
+
+CPP has a small number of internal limits. This section lists the
+limits which the C standard requires to be no lower than some minimum,
+and all the others known. It is intended that there should be as few limits
+as possible. If you encounter an undocumented or inconvenient limit,
+please report that as a bug. See :ref:`gcc:bugs`.
+
+Where we say something is limited :dfn:`only by available memory`, that
+means that internal data structures impose no intrinsic limit, and space
+is allocated with ``malloc`` or equivalent. The actual limit will
+therefore depend on many things, such as the size of other things
+allocated by the compiler at the same time, the amount of memory
+consumed by other processes on the same computer, etc.
+
+* Nesting levels of :samp:`#include` files.
+
+ We impose an arbitrary limit of 200 levels, to avoid runaway recursion.
+ The standard requires at least 15 levels.
+
+* Nesting levels of conditional inclusion.
+
+ The C standard mandates this be at least 63. CPP is limited only by
+ available memory.
+
+* Levels of parenthesized expressions within a full expression.
+
+ The C standard requires this to be at least 63. In preprocessor
+ conditional expressions, it is limited only by available memory.
+
+* Significant initial characters in an identifier or macro name.
+
+ The preprocessor treats all characters as significant. The C standard
+ requires only that the first 63 be significant.
+
+* Number of macros simultaneously defined in a single translation unit.
+
+ The standard requires at least 4095 be possible. CPP is limited only
+ by available memory.
+
+* Number of parameters in a macro definition and arguments in a macro call.
+
+ We allow ``USHRT_MAX``, which is no smaller than 65,535. The minimum
+ required by the standard is 127.
+
+* Number of characters on a logical source line.
+
+ The C standard requires a minimum of 4096 be permitted. CPP places
+ no limits on this, but you may get incorrect column numbers reported in
+ diagnostics for lines longer than 65,535 characters.
+
+* Maximum size of a source file.
+
+ The standard does not specify any lower limit on the maximum size of a
+ source file. GNU cpp maps files into memory, so it is limited by the
+ available address space. This is generally at least two gigabytes.
+ Depending on the operating system, the size of physical memory may or
+ may not be a limitation.
\ No newline at end of file
diff --git a/gcc/doc/cpp/index.rst b/gcc/doc/cpp/index.rst
new file mode 100644
index 00000000000..cc401bb5fa5
--- /dev/null
+++ b/gcc/doc/cpp/index.rst
@@ -0,0 +1,35 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+The C Preprocessor
+==================
+
+The C preprocessor implements the macro language used to transform C,
+C++, and Objective-C programs before they are compiled. It can also be
+useful on its own.
+
+.. only:: html
+
+ Contents:
+
+.. toctree::
+
+ copyright
+ overview
+ header-files
+ macros
+ conditionals
+ diagnostics
+ line-control
+ pragmas
+ other-directives
+ preprocessor-output
+ traditional-mode
+ implementation-details
+ invocation
+ environment-variables
+ gnu-free-documentation-license
+
+ indices-and-tables
\ No newline at end of file
diff --git a/gcc/doc/cpp/indices-and-tables.rst b/gcc/doc/cpp/indices-and-tables.rst
new file mode 100644
index 00000000000..6c215a391d9
--- /dev/null
+++ b/gcc/doc/cpp/indices-and-tables.rst
@@ -0,0 +1 @@
+.. include:: ../../../doc/indices-and-tables.rst
\ No newline at end of file
diff --git a/gcc/doc/cpp/initial-processing.rst b/gcc/doc/cpp/initial-processing.rst
new file mode 100644
index 00000000000..8027f5b6f0e
--- /dev/null
+++ b/gcc/doc/cpp/initial-processing.rst
@@ -0,0 +1,164 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _initial-processing:
+
+Initial processing
+******************
+
+The preprocessor performs a series of textual transformations on its
+input. These happen before all other processing. Conceptually, they
+happen in a rigid order, and the entire file is run through each
+transformation before the next one begins. CPP actually does them
+all at once, for performance reasons. These transformations correspond
+roughly to the first three 'phases of translation' described in the C
+standard.
+
+.. index:: line endings
+
+* The input file is read into memory and broken into lines.
+
+ Different systems use different conventions to indicate the end of a
+ line. GCC accepts the ASCII control sequences LF, CR
+ LF and CR as end-of-line markers. These are the canonical
+ sequences used by Unix, DOS and VMS, and the classic Mac OS (before
+ OSX) respectively. You may therefore safely copy source code written
+ on any of those systems to a different one and use it without
+ conversion. (GCC may lose track of the current line number if a file
+ doesn't consistently use one convention, as sometimes happens when it
+ is edited on computers with different conventions that share a network
+ file system.)
+
+ If the last line of any input file lacks an end-of-line marker, the end
+ of the file is considered to implicitly supply one. The C standard says
+ that this condition provokes undefined behavior, so GCC will emit a
+ warning message.
+
+.. index:: trigraphs
+
+.. _trigraphs:
+
+* If trigraphs are enabled, they are replaced by their
+ corresponding single characters. By default GCC ignores trigraphs,
+ but if you request a strictly conforming mode with the :option:`-std`
+ option, or you specify the :option:`-trigraphs` option, then it
+ converts them.
+
+ These are nine three-character sequences, all starting with :samp:`??`,
+ that are defined by ISO C to stand for single characters. They permit
+ obsolete systems that lack some of C's punctuation to use C. For
+ example, :samp:`??/` stands for :samp:`\\`, so ``'??/n'`` is a character
+ constant for a newline.
+
+ Trigraphs are not popular and many compilers implement them
+ incorrectly. Portable code should not rely on trigraphs being either
+ converted or ignored. With :option:`-Wtrigraphs` GCC will warn you
+ when a trigraph may change the meaning of your program if it were
+ converted. See :ref:`wtrigraphs`.
+
+ In a string constant, you can prevent a sequence of question marks
+ from being confused with a trigraph by inserting a backslash between
+ the question marks, or by separating the string literal at the
+ trigraph and making use of string literal concatenation. ``"(??\?)"``
+ is the string :samp:`(???)`, not :samp:`(?]`. Traditional C compilers
+ do not recognize these idioms.
+
+ The nine trigraphs and their replacements are
+
+ .. code-block::
+
+ Trigraph: ??( ??) ??< ??> ??= ??/ ??' ??! ??-
+ Replacement: [ ] { } # \ ^ | ~
+
+.. index:: continued lines, backslash-newline
+
+* Continued lines are merged into one long line.
+
+ A continued line is a line which ends with a backslash, :samp:`\\`. The
+ backslash is removed and the following line is joined with the current
+ one. No space is inserted, so you may split a line anywhere, even in
+ the middle of a word. (It is generally more readable to split lines
+ only at white space.)
+
+ The trailing backslash on a continued line is commonly referred to as a
+ :dfn:`backslash-newline`.
+
+ If there is white space between a backslash and the end of a line, that
+ is still a continued line. However, as this is usually the result of an
+ editing mistake, and many compilers will not accept it as a continued
+ line, GCC will warn you about it.
+
+.. index:: comments, line comments, block comments
+
+* All comments are replaced with single spaces.
+
+ There are two kinds of comments. :dfn:`Block comments` begin with
+ :samp:`/*` and continue until the next :samp:`*/`. Block comments do not
+ nest:
+
+ .. code-block:: c++
+
+ /* this is /* one comment */ text outside comment
+
+ :dfn:`Line comments` begin with :samp:`//` and continue to the end of the
+ current line. Line comments do not nest either, but it does not matter,
+ because they would end in the same place anyway.
+
+ .. code-block:: c++
+
+ // this is // one comment
+ text outside comment
+
+It is safe to put line comments inside block comments, or vice versa.
+
+.. code-block:: c++
+
+ /* block comment
+ // contains line comment
+ yet more comment
+ */ outside comment
+
+ // line comment /* contains block comment */
+
+But beware of commenting out one end of a block comment with a line
+comment.
+
+.. code-block::
+
+ // l.c. /* block comment begins
+ oops! this isn't a comment anymore */
+
+Comments are not recognized within string literals.
+``"/* blah */"`` is the string constant :samp:`/\* blah \*/`, not
+an empty string.
+
+Line comments are not in the 1989 edition of the C standard, but they
+are recognized by GCC as an extension. In C++ and in the 1999 edition
+of the C standard, they are an official part of the language.
+
+Since these transformations happen before all other processing, you can
+split a line mechanically with backslash-newline anywhere. You can
+comment out the end of a line. You can continue a line comment onto the
+next line with backslash-newline. You can even split :samp:`/*`,
+:samp:`*/`, and :samp:`//` onto multiple lines with backslash-newline.
+For example:
+
+.. code-block::
+
+ /\
+ *
+ */ # /*
+ */ defi\
+ ne FO\
+ O 10\
+ 20
+
+is equivalent to ``#define FOO 1020``. All these tricks are
+extremely confusing and should not be used in code intended to be
+readable.
+
+There is no way to prevent a backslash at the end of a line from being
+interpreted as a backslash-newline. This cannot affect any correct
+program, however.
\ No newline at end of file
diff --git a/gcc/doc/cpp/invocation.rst b/gcc/doc/cpp/invocation.rst
new file mode 100644
index 00000000000..3c2d2b404ab
--- /dev/null
+++ b/gcc/doc/cpp/invocation.rst
@@ -0,0 +1,81 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: invocation, command line
+
+.. _invocation:
+
+Invocation
+----------
+
+Most often when you use the C preprocessor you do not have to invoke it
+explicitly: the C compiler does so automatically. However, the
+preprocessor is sometimes useful on its own. You can invoke the
+preprocessor either with the :command:`cpp` command, or via :command:`gcc -E`.
+In GCC, the preprocessor is actually integrated with the compiler
+rather than a separate program, and both of these commands invoke
+GCC and tell it to stop after the preprocessing phase.
+
+The :command:`cpp` options listed here are also accepted by
+:command:`gcc` and have the same meaning. Likewise the :command:`cpp`
+command accepts all the usual :command:`gcc` driver options, although those
+pertaining to compilation phases after preprocessing are ignored.
+
+Only options specific to preprocessing behavior are documented here.
+Refer to the GCC manual for full documentation of other driver options.
+
+.. only:: man
+
+ Synopsis
+ ^^^^^^^^
+
+ cpp [ :option:`-D`:samp:`{macro}` [= :samp:`{defn}` ]...] [ :option:`-U`:samp:`{macro}` ]
+ [ :option:`-I`:samp:`{dir}`...] [ :option:`-iquote`:samp:`{dir}`...]
+ [ :option:`-M` | :option:`-MM` ] [ :option:`-MG` ] [ :option:`-MF` :samp:`{filename}` ]
+ [ :option:`-MP` ] [ :option:`-MQ` :samp:`{target}`...]
+ [ :option:`-MT` :samp:`{target}`...]
+ :samp:`{infile}` [[ :option:`-o` ] :samp:`{outfile}` ]
+
+ Only the most useful options are given above; see below for a more
+ complete list of preprocessor-specific options.
+ In addition, :command:`cpp` accepts most :command:`gcc` driver options, which
+ are not listed here. Refer to the GCC documentation for details.
+
+Options
+^^^^^^^
+
+The :command:`cpp` command expects two file names as arguments, :samp:`{infile}` and
+:samp:`{outfile}`. The preprocessor reads :samp:`{infile}` together with any
+other files it specifies with :samp:`#include`. All the output generated
+by the combined input files is written in :samp:`{outfile}`.
+
+Either :samp:`{infile}` or :samp:`{outfile}` may be :option:`-`, which as
+:samp:`{infile}` means to read from standard input and as :samp:`{outfile}`
+means to write to standard output. If either file is omitted, it
+means the same as if :option:`-` had been specified for that file.
+You can also use the :option:`-o` :samp:`{outfile}` option to specify the
+output file.
+
+Unless otherwise noted, or the option ends in :samp:`=`, all options
+which take an argument may have that argument appear either immediately
+after the option, or with a space between option and argument:
+:option:`-Ifoo` and :option:`-I foo` have the same effect.
+
+.. index:: grouping options, options, grouping
+
+Many options have multi-letter names; therefore multiple single-letter
+options may *not* be grouped: :option:`-dM` is very different from
+:samp:`-d -M`.
+
+.. index:: options
+
+.. include:: ../../../doc/cppopts.rst
+
+
+.. include:: ../../../doc/cppdiropts.rst
+
+.. only:: man
+
+ .. include:: copyright.rst
\ No newline at end of file
diff --git a/gcc/doc/cpp/line-control.rst b/gcc/doc/cpp/line-control.rst
new file mode 100644
index 00000000000..447671aec96
--- /dev/null
+++ b/gcc/doc/cpp/line-control.rst
@@ -0,0 +1,55 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: line control
+
+.. _line-control:
+
+Line Control
+------------
+
+The C preprocessor informs the C compiler of the location in your source
+code where each token came from. Presently, this is just the file name
+and line number. All the tokens resulting from macro expansion are
+reported as having appeared on the line of the source file where the
+outermost macro was used. We intend to be more accurate in the future.
+
+If you write a program which generates source code, such as the
+:command:`bison` parser generator, you may want to adjust the preprocessor's
+notion of the current file name and line number by hand. Parts of the
+output from :command:`bison` are generated from scratch, other parts come
+from a standard parser file. The rest are copied verbatim from
+:command:`bison`'s input. You would like compiler error messages and
+symbolic debuggers to be able to refer to ``bison`` 's input file.
+
+.. index:: #line
+
+:command:`bison` or any such program can arrange this by writing
+:samp:`#line` directives into the output file. :samp:`#line` is a
+directive that specifies the original line number and source file name
+for subsequent input in the current preprocessor input file.
+:samp:`#line` has three variants:
+
+:samp:`#line {linenum}`
+ :samp:`{linenum}` is a non-negative decimal integer constant. It specifies
+ the line number which should be reported for the following line of
+ input. Subsequent lines are counted from :samp:`{linenum}`.
+
+:samp:`#line {linenum}{filename}`
+ :samp:`{linenum}` is the same as for the first form, and has the same
+ effect. In addition, :samp:`{filename}` is a string constant. The
+ following line and all subsequent lines are reported to come from the
+ file it specifies, until something else happens to change that.
+ :samp:`{filename}` is interpreted according to the normal rules for a string
+ constant: backslash escapes are interpreted. This is different from
+ :samp:`#include`.
+
+:samp:`#line {anything else}`
+ :samp:`{anything else}` is checked for macro calls, which are expanded.
+ The result should match one of the above two forms.
+
+:samp:`#line` directives alter the results of the ``__FILE__`` and
+``__LINE__`` predefined macros from that point on. See :ref:`standard-predefined-macros`. They do not have any effect on :samp:`#include`'s
+idea of the directory containing the current file.
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros.rst b/gcc/doc/cpp/macros.rst
new file mode 100644
index 00000000000..3fe0fffd01a
--- /dev/null
+++ b/gcc/doc/cpp/macros.rst
@@ -0,0 +1,37 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. _macros:
+
+Macros
+------
+
+A :dfn:`macro` is a fragment of code which has been given a name.
+Whenever the name is used, it is replaced by the contents of the macro.
+There are two kinds of macros. They differ mostly in what they look
+like when they are used. :dfn:`Object-like` macros resemble data objects
+when used, :dfn:`function-like` macros resemble function calls.
+
+You may define any valid identifier as a macro, even if it is a C
+keyword. The preprocessor does not know anything about keywords. This
+can be useful if you wish to hide a keyword such as ``const`` from an
+older compiler that does not understand it. However, the preprocessor
+operator ``defined`` (see :ref:`defined`) can never be defined as a
+macro, and C++'s named operators (see :ref:`c++-named-operators`) cannot be
+macros when you are compiling C++.
+
+.. toctree::
+ :maxdepth: 2
+
+ macros/object-like-macros
+ macros/function-like-macros
+ macros/macro-arguments
+ macros/stringizing
+ macros/concatenation
+ macros/variadic-macros
+ macros/predefined-macros
+ macros/undefining-and-redefining-macros
+ macros/directives-within-macro-arguments
+ macros/macro-pitfalls
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/concatenation.rst b/gcc/doc/cpp/macros/concatenation.rst
new file mode 100644
index 00000000000..71a01e62e97
--- /dev/null
+++ b/gcc/doc/cpp/macros/concatenation.rst
@@ -0,0 +1,85 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: concatenation, token pasting, token concatenation, ## operator
+
+.. _concatenation:
+
+Concatenation
+*************
+
+It is often useful to merge two tokens into one while expanding macros.
+This is called :dfn:`token pasting` or :dfn:`token concatenation`. The
+:samp:`##` preprocessing operator performs token pasting. When a macro
+is expanded, the two tokens on either side of each :samp:`##` operator
+are combined into a single token, which then replaces the :samp:`##` and
+the two original tokens in the macro expansion. Usually both will be
+identifiers, or one will be an identifier and the other a preprocessing
+number. When pasted, they make a longer identifier. This isn't the
+only valid case. It is also possible to concatenate two numbers (or a
+number and a name, such as ``1.5`` and ``e3``) into a number.
+Also, multi-character operators such as ``+=`` can be formed by
+token pasting.
+
+However, two tokens that don't together form a valid token cannot be
+pasted together. For example, you cannot concatenate ``x`` with
+``+`` in either order. If you try, the preprocessor issues a warning
+and emits the two tokens. Whether it puts white space between the
+tokens is undefined. It is common to find unnecessary uses of :samp:`##`
+in complex macros. If you get this warning, it is likely that you can
+simply remove the :samp:`##`.
+
+Both the tokens combined by :samp:`##` could come from the macro body,
+but you could just as well write them as one token in the first place.
+Token pasting is most useful when one or both of the tokens comes from a
+macro argument. If either of the tokens next to an :samp:`##` is a
+parameter name, it is replaced by its actual argument before :samp:`##`
+executes. As with stringizing, the actual argument is not
+macro-expanded first. If the argument is empty, that :samp:`##` has no
+effect.
+
+Keep in mind that the C preprocessor converts comments to whitespace
+before macros are even considered. Therefore, you cannot create a
+comment by concatenating :samp:`/` and :samp:`*`. You can put as much
+whitespace between :samp:`##` and its operands as you like, including
+comments, and you can put comments in arguments that will be
+concatenated. However, it is an error if :samp:`##` appears at either
+end of a macro body.
+
+Consider a C program that interprets named commands. There probably
+needs to be a table of commands, perhaps an array of structures declared
+as follows:
+
+.. code-block:: c++
+
+ struct command
+ {
+ char *name;
+ void (*function) (void);
+ };
+
+ struct command commands[] =
+ {
+ { "quit", quit_command },
+ { "help", help_command },
+ ...
+ };
+
+It would be cleaner not to have to give each command name twice, once in
+the string constant and once in the function name. A macro which takes the
+name of a command as an argument can make this unnecessary. The string
+constant can be created with stringizing, and the function name by
+concatenating the argument with :samp:`_command`. Here is how it is done:
+
+.. code-block:: c++
+
+ #define COMMAND(NAME) { #NAME, NAME ## _command }
+
+ struct command commands[] =
+ {
+ COMMAND (quit),
+ COMMAND (help),
+ ...
+ };
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/directives-within-macro-arguments.rst b/gcc/doc/cpp/macros/directives-within-macro-arguments.rst
new file mode 100644
index 00000000000..9a9561270d4
--- /dev/null
+++ b/gcc/doc/cpp/macros/directives-within-macro-arguments.rst
@@ -0,0 +1,39 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: macro arguments and directives
+
+.. _directives-within-macro-arguments:
+
+Directives Within Macro Arguments
+*********************************
+
+Occasionally it is convenient to use preprocessor directives within
+the arguments of a macro. The C and C++ standards declare that
+behavior in these cases is undefined. GNU CPP
+processes arbitrary directives within macro arguments in
+exactly the same way as it would have processed the directive were the
+function-like macro invocation not present.
+
+If, within a macro invocation, that macro is redefined, then the new
+definition takes effect in time for argument pre-expansion, but the
+original definition is still used for argument replacement. Here is a
+pathological example:
+
+.. code-block:: c++
+
+ #define f(x) x x
+ f (1
+ #undef f
+ #define f 2
+ f)
+
+which expands to
+
+.. code-block:: c++
+
+ 1 2 1 2
+
+with the semantics described above.
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/function-like-macros.rst b/gcc/doc/cpp/macros/function-like-macros.rst
new file mode 100644
index 00000000000..8f8287f169a
--- /dev/null
+++ b/gcc/doc/cpp/macros/function-like-macros.rst
@@ -0,0 +1,55 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: function-like macros
+
+.. _function-like-macros:
+
+Function-like Macros
+********************
+
+You can also define macros whose use looks like a function call. These
+are called :dfn:`function-like macros`. To define a function-like macro,
+you use the same :samp:`#define` directive, but you put a pair of
+parentheses immediately after the macro name. For example,
+
+.. code-block::
+
+ #define lang_init() c_init()
+ lang_init()
+ → c_init()
+
+A function-like macro is only expanded if its name appears with a pair
+of parentheses after it. If you write just the name, it is left alone.
+This can be useful when you have a function and a macro of the same
+name, and you wish to use the function sometimes.
+
+.. code-block::
+
+ extern void foo(void);
+ #define foo() /* optimized inline version */
+ ...
+ foo();
+ funcptr = foo;
+
+Here the call to ``foo()`` will use the macro, but the function
+pointer will get the address of the real function. If the macro were to
+be expanded, it would cause a syntax error.
+
+If you put spaces between the macro name and the parentheses in the
+macro definition, that does not define a function-like macro, it defines
+an object-like macro whose expansion happens to begin with a pair of
+parentheses.
+
+.. code-block::
+
+ #define lang_init () c_init()
+ lang_init()
+ → () c_init()()
+
+The first two pairs of parentheses in this expansion come from the
+macro. The third is the pair that was originally after the macro
+invocation. Since ``lang_init`` is an object-like macro, it does not
+consume those parentheses.
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/macro-arguments.rst b/gcc/doc/cpp/macros/macro-arguments.rst
new file mode 100644
index 00000000000..02cfe632c03
--- /dev/null
+++ b/gcc/doc/cpp/macros/macro-arguments.rst
@@ -0,0 +1,112 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: arguments, macros with arguments, arguments in macro definitions
+
+.. _macro-arguments:
+
+Macro Arguments
+***************
+
+Function-like macros can take :dfn:`arguments`, just like true functions.
+To define a macro that uses arguments, you insert :dfn:`parameters`
+between the pair of parentheses in the macro definition that make the
+macro function-like. The parameters must be valid C identifiers,
+separated by commas and optionally whitespace.
+
+To invoke a macro that takes arguments, you write the name of the macro
+followed by a list of :dfn:`actual arguments` in parentheses, separated
+by commas. The invocation of the macro need not be restricted to a
+single logical line---it can cross as many lines in the source file as
+you wish. The number of arguments you give must match the number of
+parameters in the macro definition. When the macro is expanded, each
+use of a parameter in its body is replaced by the tokens of the
+corresponding argument. (You need not use all of the parameters in the
+macro body.)
+
+As an example, here is a macro that computes the minimum of two numeric
+values, as it is defined in many C programs, and some uses.
+
+.. code-block::
+
+ #define min(X, Y) ((X) < (Y) ? (X) : (Y))
+ x = min(a, b); → x = ((a) < (b) ? (a) : (b));
+ y = min(1, 2); → y = ((1) < (2) ? (1) : (2));
+ z = min(a + 28, *p); → z = ((a + 28) < (*p) ? (a + 28) : (*p));
+
+(In this small example you can already see several of the dangers of
+macro arguments. See :ref:`macro-pitfalls`, for detailed explanations.)
+
+Leading and trailing whitespace in each argument is dropped, and all
+whitespace between the tokens of an argument is reduced to a single
+space. Parentheses within each argument must balance; a comma within
+such parentheses does not end the argument. However, there is no
+requirement for square brackets or braces to balance, and they do not
+prevent a comma from separating arguments. Thus,
+
+.. code-block:: c++
+
+ macro (array[x = y, x + 1])
+
+passes two arguments to ``macro`` : ``array[x = y`` and ``x +
+1]``. If you want to supply ``array[x = y, x + 1]`` as an argument,
+you can write it as ``array[(x = y, x + 1)]``, which is equivalent C
+code.
+
+All arguments to a macro are completely macro-expanded before they are
+substituted into the macro body. After substitution, the complete text
+is scanned again for macros to expand, including the arguments. This rule
+may seem strange, but it is carefully designed so you need not worry
+about whether any function call is actually a macro invocation. You can
+run into trouble if you try to be too clever, though. See :ref:`argument-prescan`, for detailed discussion.
+
+For example, ``min (min (a, b), c)`` is first expanded to
+
+.. code-block:: c++
+
+ min (((a) < (b) ? (a) : (b)), (c))
+
+and then to
+
+.. code-block:: c++
+
+ ((((a) < (b) ? (a) : (b))) < (c)
+ ? (((a) < (b) ? (a) : (b)))
+ : (c))
+
+(Line breaks shown here for clarity would not actually be generated.)
+
+.. index:: empty macro arguments
+
+You can leave macro arguments empty; this is not an error to the
+preprocessor (but many macros will then expand to invalid code).
+You cannot leave out arguments entirely; if a macro takes two arguments,
+there must be exactly one comma at the top level of its argument list.
+Here are some silly examples using ``min`` :
+
+.. code-block::
+
+ min(, b) → (( ) < (b) ? ( ) : (b))
+ min(a, ) → ((a ) < ( ) ? (a ) : ( ))
+ min(,) → (( ) < ( ) ? ( ) : ( ))
+ min((,),) → (((,)) < ( ) ? ((,)) : ( ))
+
+ min() error macro "min" requires 2 arguments, but only 1 given
+ min(,,) error macro "min" passed 3 arguments, but takes just 2
+
+Whitespace is not a preprocessing token, so if a macro ``foo`` takes
+one argument, ``foo ()`` and ``foo ( )`` both supply it an
+empty argument. Previous GNU preprocessor implementations and
+documentation were incorrect on this point, insisting that a
+function-like macro that takes a single argument be passed a space if an
+empty argument was required.
+
+Macro parameters appearing inside string literals are not replaced by
+their corresponding actual arguments.
+
+.. code-block::
+
+ #define foo(x) x, "x"
+ foo(bar) → bar, "x"
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/macro-pitfalls.rst b/gcc/doc/cpp/macros/macro-pitfalls.rst
new file mode 100644
index 00000000000..095fb11ebb5
--- /dev/null
+++ b/gcc/doc/cpp/macros/macro-pitfalls.rst
@@ -0,0 +1,449 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: problems with macros, pitfalls of macros
+
+.. _macro-pitfalls:
+
+Macro Pitfalls
+**************
+
+In this section we describe some special rules that apply to macros and
+macro expansion, and point out certain cases in which the rules have
+counter-intuitive consequences that you must watch out for.
+
+.. toctree::
+ :maxdepth: 2
+
+
+.. _misnesting:
+
+Misnesting
+^^^^^^^^^^
+
+When a macro is called with arguments, the arguments are substituted
+into the macro body and the result is checked, together with the rest of
+the input file, for more macro calls. It is possible to piece together
+a macro call coming partially from the macro body and partially from the
+arguments. For example,
+
+.. code-block::
+
+ #define twice(x) (2*(x))
+ #define call_with_1(x) x(1)
+ call_with_1 (twice)
+ → twice(1)
+ → (2*(1))
+
+Macro definitions do not have to have balanced parentheses. By writing
+an unbalanced open parenthesis in a macro body, it is possible to create
+a macro call that begins inside the macro body but ends outside of it.
+For example,
+
+.. code-block::
+
+ #define strange(file) fprintf (file, "%s %d",
+ ...
+ strange(stderr) p, 35)
+ → fprintf (stderr, "%s %d", p, 35)
+
+The ability to piece together a macro call can be useful, but the use of
+unbalanced open parentheses in a macro body is just confusing, and
+should be avoided.
+
+.. index:: parentheses in macro bodies
+
+.. _operator-precedence-problems:
+
+Operator Precedence Problems
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You may have noticed that in most of the macro definition examples shown
+above, each occurrence of a macro argument name had parentheses around
+it. In addition, another pair of parentheses usually surround the
+entire macro definition. Here is why it is best to write macros that
+way.
+
+Suppose you define a macro as follows,
+
+.. code-block:: c++
+
+ #define ceil_div(x, y) (x + y - 1) / y
+
+whose purpose is to divide, rounding up. (One use for this operation is
+to compute how many ``int`` objects are needed to hold a certain
+number of ``char`` objects.) Then suppose it is used as follows:
+
+.. code-block::
+
+ a = ceil_div (b & c, sizeof (int));
+ → a = (b & c + sizeof (int) - 1) / sizeof (int);
+
+This does not do what is intended. The operator-precedence rules of
+C make it equivalent to this:
+
+.. code-block:: c++
+
+ a = (b & (c + sizeof (int) - 1)) / sizeof (int);
+
+What we want is this:
+
+.. code-block:: c++
+
+ a = ((b & c) + sizeof (int) - 1)) / sizeof (int);
+
+Defining the macro as
+
+.. code-block:: c++
+
+ #define ceil_div(x, y) ((x) + (y) - 1) / (y)
+
+provides the desired result.
+
+Unintended grouping can result in another way. Consider ``sizeof
+ceil_div(1, 2)``. That has the appearance of a C expression that would
+compute the size of the type of ``ceil_div (1, 2)``, but in fact it
+means something very different. Here is what it expands to:
+
+.. code-block:: c++
+
+ sizeof ((1) + (2) - 1) / (2)
+
+This would take the size of an integer and divide it by two. The
+precedence rules have put the division outside the ``sizeof`` when it
+was intended to be inside.
+
+Parentheses around the entire macro definition prevent such problems.
+Here, then, is the recommended way to define ``ceil_div`` :
+
+.. code-block:: c++
+
+ #define ceil_div(x, y) (((x) + (y) - 1) / (y))
+
+.. index:: semicolons (after macro calls)
+
+.. _swallowing-the-semicolon:
+
+Swallowing the Semicolon
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Often it is desirable to define a macro that expands into a compound
+statement. Consider, for example, the following macro, that advances a
+pointer (the argument ``p`` says where to find it) across whitespace
+characters:
+
+.. code-block:: c++
+
+ #define SKIP_SPACES(p, limit) \
+ { char *lim = (limit); \
+ while (p < lim) { \
+ if (*p++ != ' ') { \
+ p--; break; }}}
+
+Here backslash-newline is used to split the macro definition, which must
+be a single logical line, so that it resembles the way such code would
+be laid out if not part of a macro definition.
+
+A call to this macro might be ``SKIP_SPACES (p, lim)``. Strictly
+speaking, the call expands to a compound statement, which is a complete
+statement with no need for a semicolon to end it. However, since it
+looks like a function call, it minimizes confusion if you can use it
+like a function call, writing a semicolon afterward, as in
+``SKIP_SPACES (p, lim);``
+
+This can cause trouble before ``else`` statements, because the
+semicolon is actually a null statement. Suppose you write
+
+.. code-block:: c++
+
+ if (*p != 0)
+ SKIP_SPACES (p, lim);
+ else ...
+
+The presence of two statements---the compound statement and a null
+statement---in between the ``if`` condition and the ``else``
+makes invalid C code.
+
+The definition of the macro ``SKIP_SPACES`` can be altered to solve
+this problem, using a ``do ... while`` statement. Here is how:
+
+.. code-block:: c++
+
+ #define SKIP_SPACES(p, limit) \
+ do { char *lim = (limit); \
+ while (p < lim) { \
+ if (*p++ != ' ') { \
+ p--; break; }}} \
+ while (0)
+
+Now ``SKIP_SPACES (p, lim);`` expands into
+
+.. code-block:: c++
+
+ do {...} while (0);
+
+which is one statement. The loop executes exactly once; most compilers
+generate no extra code for it.
+
+.. index:: side effects (in macro arguments), unsafe macros
+
+.. _duplication-of-side-effects:
+
+Duplication of Side Effects
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Many C programs define a macro ``min``, for 'minimum', like this:
+
+.. code-block:: c++
+
+ #define min(X, Y) ((X) < (Y) ? (X) : (Y))
+
+When you use this macro with an argument containing a side effect,
+as shown here,
+
+.. code-block:: c++
+
+ next = min (x + y, foo (z));
+
+it expands as follows:
+
+.. code-block:: c++
+
+ next = ((x + y) < (foo (z)) ? (x + y) : (foo (z)));
+
+where ``x + y`` has been substituted for ``X`` and ``foo (z)``
+for ``Y``.
+
+The function ``foo`` is used only once in the statement as it appears
+in the program, but the expression ``foo (z)`` has been substituted
+twice into the macro expansion. As a result, ``foo`` might be called
+two times when the statement is executed. If it has side effects or if
+it takes a long time to compute, the results might not be what you
+intended. We say that ``min`` is an :dfn:`unsafe` macro.
+
+The best solution to this problem is to define ``min`` in a way that
+computes the value of ``foo (z)`` only once. The C language offers
+no standard way to do this, but it can be done with GNU extensions as
+follows:
+
+.. code-block:: c++
+
+ #define min(X, Y) \
+ ({ typeof (X) x_ = (X); \
+ typeof (Y) y_ = (Y); \
+ (x_ < y_) ? x_ : y_; })
+
+The :samp:`({ ... })` notation produces a compound statement that
+acts as an expression. Its value is the value of its last statement.
+This permits us to define local variables and assign each argument to
+one. The local variables have underscores after their names to reduce
+the risk of conflict with an identifier of wider scope (it is impossible
+to avoid this entirely). Now each argument is evaluated exactly once.
+
+If you do not wish to use GNU C extensions, the only solution is to be
+careful when *using* the macro ``min``. For example, you can
+calculate the value of ``foo (z)``, save it in a variable, and use
+that variable in ``min`` :
+
+.. code-block:: c++
+
+ #define min(X, Y) ((X) < (Y) ? (X) : (Y))
+ ...
+ {
+ int tem = foo (z);
+ next = min (x + y, tem);
+ }
+
+(where we assume that ``foo`` returns type ``int``).
+
+.. index:: self-reference
+
+.. _self-referential-macros:
+
+Self-Referential Macros
+^^^^^^^^^^^^^^^^^^^^^^^
+
+A :dfn:`self-referential` macro is one whose name appears in its
+definition. Recall that all macro definitions are rescanned for more
+macros to replace. If the self-reference were considered a use of the
+macro, it would produce an infinitely large expansion. To prevent this,
+the self-reference is not considered a macro call. It is passed into
+the preprocessor output unchanged. Consider an example:
+
+.. code-block:: c++
+
+ #define foo (4 + foo)
+
+where ``foo`` is also a variable in your program.
+
+Following the ordinary rules, each reference to ``foo`` will expand
+into ``(4 + foo)`` ; then this will be rescanned and will expand into
+``(4 + (4 + foo))`` ; and so on until the computer runs out of memory.
+
+The self-reference rule cuts this process short after one step, at
+``(4 + foo)``. Therefore, this macro definition has the possibly
+useful effect of causing the program to add 4 to the value of ``foo``
+wherever ``foo`` is referred to.
+
+In most cases, it is a bad idea to take advantage of this feature. A
+person reading the program who sees that ``foo`` is a variable will
+not expect that it is a macro as well. The reader will come across the
+identifier ``foo`` in the program and think its value should be that
+of the variable ``foo``, whereas in fact the value is four greater.
+
+One common, useful use of self-reference is to create a macro which
+expands to itself. If you write
+
+.. code-block:: c++
+
+ #define EPERM EPERM
+
+then the macro ``EPERM`` expands to ``EPERM``. Effectively, it is
+left alone by the preprocessor whenever it's used in running text. You
+can tell that it's a macro with :samp:`#ifdef`. You might do this if you
+want to define numeric constants with an ``enum``, but have
+:samp:`#ifdef` be true for each constant.
+
+If a macro ``x`` expands to use a macro ``y``, and the expansion of
+``y`` refers to the macro ``x``, that is an :dfn:`indirect
+self-reference` of ``x``. ``x`` is not expanded in this case
+either. Thus, if we have
+
+.. code-block:: c++
+
+ #define x (4 + y)
+ #define y (2 * x)
+
+then ``x`` and ``y`` expand as follows:
+
+.. code-block::
+
+ x → (4 + y)
+ → (4 + (2 * x))
+
+ y → (2 * x)
+ → (2 * (4 + y))
+
+Each macro is expanded when it appears in the definition of the other
+macro, but not when it indirectly appears in its own definition.
+
+.. index:: expansion of arguments, macro argument expansion, prescan of macro arguments
+
+.. _argument-prescan:
+
+Argument Prescan
+^^^^^^^^^^^^^^^^
+
+Macro arguments are completely macro-expanded before they are
+substituted into a macro body, unless they are stringized or pasted
+with other tokens. After substitution, the entire macro body, including
+the substituted arguments, is scanned again for macros to be expanded.
+The result is that the arguments are scanned *twice* to expand
+macro calls in them.
+
+Most of the time, this has no effect. If the argument contained any
+macro calls, they are expanded during the first scan. The result
+therefore contains no macro calls, so the second scan does not change
+it. If the argument were substituted as given, with no prescan, the
+single remaining scan would find the same macro calls and produce the
+same results.
+
+You might expect the double scan to change the results when a
+self-referential macro is used in an argument of another macro
+(see :ref:`self-referential-macros`): the self-referential macro would be
+expanded once in the first scan, and a second time in the second scan.
+However, this is not what happens. The self-references that do not
+expand in the first scan are marked so that they will not expand in the
+second scan either.
+
+You might wonder, 'Why mention the prescan, if it makes no difference?
+And why not skip it and make the preprocessor faster?' The answer is
+that the prescan does make a difference in three special cases:
+
+* Nested calls to a macro.
+
+ We say that :dfn:`nested` calls to a macro occur when a macro's argument
+ contains a call to that very macro. For example, if ``f`` is a macro
+ that expects one argument, ``f (f (1))`` is a nested pair of calls to
+ ``f``. The desired expansion is made by expanding ``f (1)`` and
+ substituting that into the definition of ``f``. The prescan causes
+ the expected result to happen. Without the prescan, ``f (1)`` itself
+ would be substituted as an argument, and the inner use of ``f`` would
+ appear during the main scan as an indirect self-reference and would not
+ be expanded.
+
+* Macros that call other macros that stringize or concatenate.
+
+ If an argument is stringized or concatenated, the prescan does not
+ occur. If you *want* to expand a macro, then stringize or
+ concatenate its expansion, you can do that by causing one macro to call
+ another macro that does the stringizing or concatenation. For
+ instance, if you have
+
+ .. code-block:: c++
+
+ #define AFTERX(x) X_ ## x
+ #define XAFTERX(x) AFTERX(x)
+ #define TABLESIZE 1024
+ #define BUFSIZE TABLESIZE
+
+ then ``AFTERX(BUFSIZE)`` expands to ``X_BUFSIZE``, and
+ ``XAFTERX(BUFSIZE)`` expands to ``X_1024``. (Not to
+ ``X_TABLESIZE``. Prescan always does a complete expansion.)
+
+* Macros used in arguments, whose expansions contain unshielded commas.
+
+ This can cause a macro expanded on the second scan to be called with the
+ wrong number of arguments. Here is an example:
+
+ .. code-block:: c++
+
+ #define foo a,b
+ #define bar(x) lose(x)
+ #define lose(x) (1 + (x))
+
+ We would like ``bar(foo)`` to turn into ``(1 + (foo))``, which
+ would then turn into ``(1 + (a,b))``. Instead, ``bar(foo)``
+ expands into ``lose(a,b)``, and you get an error because ``lose``
+ requires a single argument. In this case, the problem is easily solved
+ by the same parentheses that ought to be used to prevent misnesting of
+ arithmetic operations:
+
+ .. code-block::
+
+ #define foo (a,b)
+ or#define bar(x) lose((x))
+
+ The extra pair of parentheses prevents the comma in ``foo`` 's
+ definition from being interpreted as an argument separator.
+
+.. index:: newlines in macro arguments
+
+.. _newlines-in-arguments:
+
+Newlines in Arguments
+^^^^^^^^^^^^^^^^^^^^^
+
+The invocation of a function-like macro can extend over many logical
+lines. However, in the present implementation, the entire expansion
+comes out on one line. Thus line numbers emitted by the compiler or
+debugger refer to the line the invocation started on, which might be
+different to the line containing the argument causing the problem.
+
+Here is an example illustrating this:
+
+.. code-block:: c++
+
+ #define ignore_second_arg(a,b,c) a; c
+
+ ignore_second_arg (foo (),
+ ignored (),
+ syntax error);
+
+The syntax error triggered by the tokens ``syntax error`` results in
+an error message citing line three---the line of ignore_second_arg---
+even though the problematic code comes from line five.
+
+We consider this a bug, and intend to fix it in the near future.
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/object-like-macros.rst b/gcc/doc/cpp/macros/object-like-macros.rst
new file mode 100644
index 00000000000..4faa9003c45
--- /dev/null
+++ b/gcc/doc/cpp/macros/object-like-macros.rst
@@ -0,0 +1,126 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: object-like macro, symbolic constants, manifest constants
+
+.. _object-like-macros:
+
+Object-like Macros
+******************
+
+An :dfn:`object-like macro` is a simple identifier which will be replaced
+by a code fragment. It is called object-like because it looks like a
+data object in code that uses it. They are most commonly used to give
+symbolic names to numeric constants.
+
+.. index:: #define
+
+You create macros with the :samp:`#define` directive. :samp:`#define` is
+followed by the name of the macro and then the token sequence it should
+be an abbreviation for, which is variously referred to as the macro's
+:dfn:`body`, :dfn:`expansion` or :dfn:`replacement list`. For example,
+
+.. code-block:: c++
+
+ #define BUFFER_SIZE 1024
+
+defines a macro named ``BUFFER_SIZE`` as an abbreviation for the
+token ``1024``. If somewhere after this :samp:`#define` directive
+there comes a C statement of the form
+
+.. code-block:: c++
+
+ foo = (char *) malloc (BUFFER_SIZE);
+
+then the C preprocessor will recognize and :dfn:`expand` the macro
+``BUFFER_SIZE``. The C compiler will see the same tokens as it would
+if you had written
+
+.. code-block:: c++
+
+ foo = (char *) malloc (1024);
+
+By convention, macro names are written in uppercase. Programs are
+easier to read when it is possible to tell at a glance which names are
+macros.
+
+The macro's body ends at the end of the :samp:`#define` line. You may
+continue the definition onto multiple lines, if necessary, using
+backslash-newline. When the macro is expanded, however, it will all
+come out on one line. For example,
+
+.. code-block::
+
+ #define NUMBERS 1, \
+ 2, \
+ 3
+ int x[] = { NUMBERS };
+ → int x[] = { 1, 2, 3 };
+
+The most common visible consequence of this is surprising line numbers
+in error messages.
+
+There is no restriction on what can go in a macro body provided it
+decomposes into valid preprocessing tokens. Parentheses need not
+balance, and the body need not resemble valid C code. (If it does not,
+you may get error messages from the C compiler when you use the macro.)
+
+The C preprocessor scans your program sequentially. Macro definitions
+take effect at the place you write them. Therefore, the following input
+to the C preprocessor
+
+.. code-block:: c++
+
+ foo = X;
+ #define X 4
+ bar = X;
+
+produces
+
+.. code-block:: c++
+
+ foo = X;
+ bar = 4;
+
+When the preprocessor expands a macro name, the macro's expansion
+replaces the macro invocation, then the expansion is examined for more
+macros to expand. For example,
+
+.. code-block::
+
+ #define TABLESIZE BUFSIZE
+ #define BUFSIZE 1024
+ TABLESIZE
+ → BUFSIZE
+ → 1024
+
+``TABLESIZE`` is expanded first to produce ``BUFSIZE``, then that
+macro is expanded to produce the final result, ``1024``.
+
+Notice that ``BUFSIZE`` was not defined when ``TABLESIZE`` was
+defined. The :samp:`#define` for ``TABLESIZE`` uses exactly the
+expansion you specify---in this case, ``BUFSIZE`` ---and does not
+check to see whether it too contains macro names. Only when you
+*use* ``TABLESIZE`` is the result of its expansion scanned for
+more macro names.
+
+This makes a difference if you change the definition of ``BUFSIZE``
+at some point in the source file. ``TABLESIZE``, defined as shown,
+will always expand using the definition of ``BUFSIZE`` that is
+currently in effect:
+
+.. code-block:: c++
+
+ #define BUFSIZE 1020
+ #define TABLESIZE BUFSIZE
+ #undef BUFSIZE
+ #define BUFSIZE 37
+
+Now ``TABLESIZE`` expands (in two stages) to ``37``.
+
+If the expansion of a macro contains its own name, either directly or
+via intermediate macros, it is not expanded again when the expansion is
+examined for more macros. This prevents infinite recursion.
+See :ref:`self-referential-macros`, for the precise details.
\ No newline at end of file
diff --git a/gcc/doc/cpp/macros/predefined-macros.rst b/gcc/doc/cpp/macros/predefined-macros.rst
new file mode 100644
index 00000000000..168eb2fd679
--- /dev/null
+++ b/gcc/doc/cpp/macros/predefined-macros.rst
@@ -0,0 +1,876 @@
+..
+ Copyright 1988-2022 Free Software Foundation, Inc.
+ This is part of the GCC manual.
+ For copying conditions, see the GPL license file
+
+.. index:: predefined macros
+
+.. _predefined-macros:
+
+Predefined Macros
+*****************
+
+Several object-like macros are predefined; you use them without
+supplying their definitions. They fall into three classes: standard,
+common, and system-specific.
+
+In C++, there is a fourth category, the named operators. They act like
+predefined macros, but you cannot undefine them.
+
+.. toctree::
+ :maxdepth: 2
+
+
+.. index:: standard predefined macros.
+
+.. _standard-predefined-macros:
+
+Standard Predefined Macros
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The standard predefined macros are specified by the relevant
+language standards, so they are available with all compilers that
+implement those standards. Older compilers may not provide all of
+them. Their names all start with double underscores.
+
+.. c:macro:: __FILE__
+
+ This macro expands to the name of the current input file, in the form of
+ a C string constant. This is the path by which the preprocessor opened
+ the file, not the short name specified in :samp:`#include` or as the
+ input file name argument. For example,
+ ``"/usr/local/include/myheader.h"`` is a possible expansion of this
+ macro.
+
+.. c:macro:: __LINE__
+
+ This macro expands to the current input line number, in the form of a
+ decimal integer constant. While we call it a predefined macro, it's
+ a pretty strange macro, since its 'definition' changes with each
+ new line of source code.
+
+ ``__FILE__`` and ``__LINE__`` are useful in generating an error
+ message to report an inconsistency detected by the program; the message
+ can state the source line at which the inconsistency was detected. For
+ example,
+
+.. code-block:: c++
+
+ fprintf (stderr, "Internal error: "
+ "negative string length "
+ "%d at %s, line %d.",
+ length, __FILE__, __LINE__);
+
+An :samp:`#include` directive changes the expansions of ``__FILE__``
+and ``__LINE__`` to correspond to the included file. At the end of
+that file, when processing resumes on the input file that contained
+the :samp:`#include` directive, the expansions of ``__FILE__`` and
+``__LINE__`` revert to the values they had before the
+:samp:`#include` (but ``__LINE__`` is then incremented by one as
+processing moves to the line after the :samp:`#include`).
+
+A :samp:`#line` directive changes ``__LINE__``, and may change
+``__FILE__`` as well. See :ref:`line-control`.
+
+C99 introduced ``__func__``, and GCC has provided ``__FUNCTION__``
+for a long time. Both of these are strings containing the name of the
+current function (there are slight semantic differences; see the GCC
+manual). Neither of them is a macro; the preprocessor does not know the
+name of the current function. They tend to be useful in conjunction
+with ``__FILE__`` and ``__LINE__``, though.
+
+.. c:macro:: __DATE__
+
+ This macro expands to a string constant that describes the date on which
+ the preprocessor is being run. The string constant contains eleven
+ characters and looks like ``"Feb 12 1996"``. If the day of the
+ month is less than 10, it is padded with a space on the left.
+
+ If GCC cannot determine the current date, it will emit a warning message
+ (once per compilation) and ``__DATE__`` will expand to
+ ``"??? ?? ????"``.
+
+.. c:macro:: __TIME__
+
+ This macro expands to a string constant that describes the time at
+ which the preprocessor is being run. The string constant contains
+ eight characters and looks like ``"23:59:01"``.
+
+ If GCC cannot determine the current time, it will emit a warning message
+ (once per compilation) and ``__TIME__`` will expand to
+ ``"??:??:??"``.
+
+.. c:macro:: __STDC__
+
+ In normal operation, this macro expands to the constant 1, to signify
+ that this compiler conforms to ISO Standard C. If GNU CPP is used with
+ a compiler other than GCC, this is not necessarily true; however, the
+ preprocessor always conforms to the standard unless the
+ :option:`-traditional-cpp` option is used.
+
+ This macro is not defined if the :option:`-traditional-cpp` option is used.
+
+ On some hosts, the system compiler uses a different convention, where
+ ``__STDC__`` is normally 0, but is 1 if the user specifies strict
+ conformance to the C Standard. CPP follows the host convention when
+ processing system header files, but when processing user files
+ ``__STDC__`` is always 1. This has been reported to cause problems;
+ for instance, some versions of Solaris provide X Windows headers that
+ expect ``__STDC__`` to be either undefined or 1. See :ref:`invocation`.
+
+.. c:macro:: __STDC_VERSION__
+
+ This macro expands to the C Standard's version number, a long integer
+ constant of the form ``yyyymmL`` where :samp:`{yyyy}` and
+ :samp:`{mm}` are the year and month of the Standard version. This signifies
+ which version of the C Standard the compiler conforms to. Like
+ ``__STDC__``, this is not necessarily accurate for the entire
+ implementation, unless GNU CPP is being used with GCC.
+
+ The value ``199409L`` signifies the 1989 C standard as amended in
+ 1994, which is the current default; the value ``199901L`` signifies
+ the 1999 revision of the C standard; the value ``201112L``
+ signifies the 2011 revision of the C standard; the value
+ ``201710L`` signifies the 2017 revision of the C standard (which is
+ otherwise identical to the 2011 version apart from correction of
+ defects). An unspecified value larger than ``201710L`` is used for
+ the experimental :option:`-std`:samp:`=c2x` and :option:`-std`:samp:`=gnu2x` modes.
+
+ This macro is not defined if the :option:`-traditional-cpp` option is
+ used, nor when compiling C++ or Objective-C.
+
+.. c:macro:: __STDC_HOSTED__
+
+ This macro is defined, with value 1, if the compiler's target is a
+ :dfn:`hosted environment`. A hosted environment has the complete
+ facilities of the standard C library available.
+
+.. c:macro:: __cplusplus
+
+ This macro is defined when the C++ compiler is in use. You can use
+ ``__cplusplus`` to test whether a header is compiled by a C compiler
+ or a C++ compiler. This macro is similar to ``__STDC_VERSION__``, in
+ that it expands to a version number. Depending on the language standard
+ selected, the value of the macro is
+ ``199711L`` for the 1998 C++ standard,
+ ``201103L`` for the 2011 C++ standard,
+ ``201402L`` for the 2014 C++ standard,
+ ``201703L`` for the 2017 C++ standard,
+ ``202002L`` for the 2020 C++ standard,
+ or an unspecified value strictly larger than ``202002L`` for the
+ experimental languages enabled by :option:`-std`:samp:`=c++23` and
+ :option:`-std`:samp:`=gnu++23`.
+
+.. c:macro:: __OBJC__
+
+ This macro is defined, with value 1, when the Objective-C compiler is in
+ use. You can use ``__OBJC__`` to test whether a header is compiled
+ by a C compiler or an Objective-C compiler.
+
+.. c:macro:: __ASSEMBLER__
+
+ This macro is defined with value 1 when preprocessing assembly
+ language.
+
+.. index:: common predefined macros
+
+.. _common-predefined-macros:
+
+Common Predefined Macros
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+The common predefined macros are GNU C extensions. They are available
+with the same meanings regardless of the machine or operating system on
+which you are using GNU C or GNU Fortran. Their names all start with
+double underscores.
+
+.. c:macro:: __COUNTER__
+
+ This macro expands to sequential integral values starting from 0. In
+ conjunction with the ``##`` operator, this provides a convenient means to
+ generate unique identifiers. Care must be taken to ensure that
+ ``__COUNTER__`` is not expanded prior to inclusion of precompiled headers
+ which use it. Otherwise, the precompiled headers will not be used.
+
+.. c:macro:: __GFORTRAN__
+
+ The GNU Fortran compiler defines this.
+
+.. c:macro:: __GNUC__
+ __GNUC_MINOR__
+ __GNUC_PATCHLEVEL__
+
+ These macros are defined by all GNU compilers that use the C
+ preprocessor: C, C++, Objective-C and Fortran. Their values are the major
+ version, minor version, and patch level of the compiler, as integer
+ constants. For example, GCC version :samp:`{x}`. :samp:`{y}`. :samp:`{z}`
+ defines ``__GNUC__`` to :samp:`{x}`, ``__GNUC_MINOR__`` to :samp:`{y}`,
+ and ``__GNUC_PATCHLEVEL__`` to :samp:`{z}`. These
+ macros are also defined if you invoke the preprocessor directly.
+
+ If all you need to know is whether or not your program is being compiled
+ by GCC, or a non-GCC compiler that claims to accept the GNU C dialects,
+ you can simply test ``__GNUC__``. If you need to write code
+ which depends on a specific version, you must be more careful. Each
+ time the minor version is increased, the patch level is reset to zero;
+ each time the major version is increased, the
+ minor version and patch level are reset. If you wish to use the
+ predefined macros directly in the conditional, you will need to write it
+ like this:
+
+ .. code-block:: c++
+
+ /* Test for GCC > 3.2.0 */
+ #if __GNUC__ > 3 || \
+ (__GNUC__ == 3 && (__GNUC_MINOR__ > 2 || \
+ (__GNUC_MINOR__ == 2 && \
+ __GNUC_PATCHLEVEL__ > 0))
+
+ Another approach is to use the predefined macros to
+ calculate a single number, then compare that against a threshold:
+
+ .. code-block:: c++
+
+ #define GCC_VERSION (__GNUC__ * 10000 \
+ + __GNUC_MINOR__ * 100 \
+ + __GNUC_PATCHLEVEL__)
+ ...
+ /* Test for GCC > 3.2.0 */
+ #if GCC_VERSION > 30200
+
+ Many people find this form easier to understand.
+
+.. c:macro:: __GNUG__
+
+ The GNU C++ compiler defines this. Testing it is equivalent to
+ testing ``(__GNUC__ && __cplusplus)``.
+
+.. c:macro:: __STRICT_ANSI__
+
+ GCC defines this macro if and only if the :option:`-ansi` switch, or a
+ :option:`-std` switch specifying strict conformance to some version of ISO C
+ or ISO C++, was specified when GCC was invoked. It is defined to :samp:`1`.
+ This macro exists primarily to direct GNU libc's header files to use only
+ definitions found in standard C.
+
+.. c:macro:: __BASE_FILE__
+
+ This macro expands to the name of the main input file, in the form
+ of a C string constant. This is the source file that was specified
+ on the command line of the preprocessor or C compiler.
+
+.. c:macro:: __FILE_NAME__
+
+ This macro expands to the basename of the current input file, in the
+ form of a C string constant. This is the last path component by which
+ the preprocessor opened the file. For example, processing
+ ``"/usr/local/include/myheader.h"`` would set this
+ macro to ``"myheader.h"``.
+
+.. c:macro:: __INCLUDE_LEVEL__
+
+ This macro expands to a decimal integer constant that represents the
+ depth of nesting in include files. The value of this macro is
+ incremented on every :samp:`#include` directive and decremented at the
+ end of every included file. It starts out at 0, its value within the
+ base file specified on the command line.
+
+.. c:macro:: __ELF__
+
+ This macro is defined if the target uses the ELF object format.
+
+.. c:macro:: __VERSION__
+
+ This macro expands to a string constant which describes the version of
+ the compiler in use. You should not rely on its contents having any
+ particular form, but it can be counted on to contain at least the
+ release number.
+
+.. c:macro:: __OPTIMIZE__
+ __OPTIMIZE_SIZE__
+ __NO_INLINE__
+
+ These macros describe the compilation mode. ``__OPTIMIZE__`` is
+ defined in all optimizing compilations. ``__OPTIMIZE_SIZE__`` is
+ defined if the compiler is optimizing for size, not speed.
+ ``__NO_INLINE__`` is defined if no functions will be inlined into
+ their callers (when not optimizing, or when inlining has been
+ specifically disabled by :option:`-fno-inline`).
+
+ These macros cause certain GNU header files to provide optimized
+ definitions, using macros or inline functions, of system library
+ functions. You should not use these macros in any way unless you make
+ sure that programs will execute with the same effect whether or not they
+ are defined. If they are defined, their value is 1.
+
+.. c:macro:: __GNUC_GNU_INLINE__
+
+ GCC defines this macro if functions declared ``inline`` will be
+ handled in GCC's traditional gnu90 mode. Object files will contain
+ externally visible definitions of all functions declared ``inline``
+ without ``extern`` or ``static``. They will not contain any
+ definitions of any functions declared ``extern inline``.
+
+.. c:macro:: __GNUC_STDC_INLINE__
+
+ GCC defines this macro if functions declared ``inline`` will be
+ handled according to the ISO C99 or later standards. Object files will contain
+ externally visible definitions of all functions declared ``extern
+ inline``. They will not contain definitions of any functions declared
+ ``inline`` without ``extern``.
+
+ If this macro is defined, GCC supports the ``gnu_inline`` function
+ attribute as a way to always get the gnu90 behavior.
+
+.. c:macro:: __CHAR_UNSIGNED__
+
+ GCC defines this macro if and only if the data type ``char`` is
+ unsigned on the target machine. It exists to cause the standard header
+ file :samp:`limits.h` to work correctly. You should not use this macro
+ yourself; instead, refer to the standard macros defined in :samp:`limits.h`.
+
+.. c:macro:: __WCHAR_UNSIGNED__
+
+ Like ``__CHAR_UNSIGNED__``, this macro is defined if and only if the
+ data type ``wchar_t`` is unsigned and the front-end is in C++ mode.
+
+.. c:macro:: __REGISTER_PREFIX__
+
+ This macro expands to a single token (not a string constant) which is
+ the prefix applied to CPU register names in assembly language for this
+ target. You can use it to write assembly that is usable in multiple
+ environments. For example, in the ``m68k-aout`` environment it
+ expands to nothing, but in the ``m68k-coff`` environment it expands
+ to a single :samp:`%`.
+
+.. c:macro:: __USER_LABEL_PREFIX__
+
+ This macro expands to a single token which is the prefix applied to
+ user labels (symbols visible to C code) in assembly. For example, in
+ the ``m68k-aout`` environment it expands to an :samp:`_`, but in the
+ ``m68k-coff`` environment it expands to nothing.
+
+ This macro will have the correct definition even if
+ :option:`-f(no-)underscores` is in use, but it will not be correct if
+ target-specific options that adjust this prefix are used (e.g. the
+ OSF/rose :option:`-mno-underscores` option).
+
+.. c:macro:: __SIZE_TYPE__
+ __PTRDIFF_TYPE__
+ __WCHAR_TYPE__
+ __WINT_TYPE__
+ __INTMAX_TYPE__
+ __UINTMAX_TYPE__
+ __SIG_ATOMIC_TYPE__
+ __INT8_TYPE__
+ __INT16_TYPE__
+ __INT32_TYPE__
+ __INT64_TYPE__
+ __UINT8_TYPE__
+ __UINT16_TYPE__
+ __UINT32_TYPE__
+ __UINT64_TYPE__
+ __INT_LEAST8_TYPE__
+ __INT_LEAST16_TYPE__
+ __INT_LEAST32_TYPE__
+ __INT_LEAST64_TYPE__
+ __UINT_LEAST8_TYPE__
+ __UINT_LEAST16_TYPE__
+ __UINT_LEAST32_TYPE__
+ __UINT_LEAST64_TYPE__
+ __INT_FAST8_TYPE__
+ __INT_FAST16_TYPE__
+ __INT_FAST32_TYPE__
+ __INT_FAST64_TYPE__
+ __UINT_FAST8_TYPE__
+ __UINT_FAST16_TYPE__
+ __UINT_FAST32_TYPE__
+ __UINT_FAST64_TYPE__
+ __INTPTR_TYPE__
+ __UINTPTR_TYPE__
+
+ These macros are defined to the correct underlying types for the
+ ``size_t``, ``ptrdiff_t``, ``wchar_t``, ``wint_t``,
+ ``intmax_t``, ``uintmax_t``, ``sig_atomic_t``, ``int8_t``,
+ ``int16_t``, ``int32_t``, ``int64_t``, ``uint8_t``,
+ ``uint16_t``, ``uint32_t``, ``uint64_t``,
+ ``int_least8_t``, ``int_least16_t``, ``int_least32_t``,
+ ``int_least64_t``, ``uint_least8_t``, ``uint_least16_t``,
+ ``uint_least32_t``, ``uint_least64_t``, ``int_fast8_t``,
+ ``int_fast16_t``, ``int_fast32_t``, ``int_fast64_t``,
+ ``uint_fast8_t``, ``uint_fast16_t``, ``uint_fast32_t``,
+ ``uint_fast64_t``, ``intptr_t``, and ``uintptr_t`` typedefs,
+ respectively. They exist to make the standard header files
+ :samp:`stddef.h`, :samp:`stdint.h`, and :samp:`wchar.h` work correctly.
+ You should not use these macros directly; instead, include the
+ appropriate headers and use the typedefs. Some of these macros may
+ not be defined on particular systems if GCC does not provide a
+ :samp:`stdint.h` header on those systems.
+
+.. c:macro:: __CHAR_BIT__
+
+ Defined to the number of bits used in the representation of the
+ ``char`` data type. It exists to make the standard header given
+ numerical limits work correctly. You should not use
+ this macro directly; instead, include the appropriate headers.
+
+.. c:macro:: __SCHAR_MAX__
+ __WCHAR_MAX__
+ __SHRT_MAX__
+ __INT_MAX__
+ __LONG_MAX__
+ __LONG_LONG_MAX__
+ __WINT_MAX__
+ __SIZE_MAX__
+ __PTRDIFF_MAX__
+ __INTMAX_MAX__
+ __UINTMAX_MAX__
+ __SIG_ATOMIC_MAX__
+ __INT8_MAX__
+ __INT16_MAX__
+ __INT32_MAX__
+ __INT64_MAX__
+ __UINT8_MAX__
+ __UINT16_MAX__
+ __UINT32_MAX__
+ __UINT64_MAX__
+ __INT_LEAST8_MAX__
+ __INT_LEAST16_MAX__
+ __INT_LEAST32_MAX__
+ __INT_LEAST64_MAX__
+ __UINT_LEAST8_MAX__
+ __UINT_LEAST16_MAX__
+ __UINT_LEAST32_MAX__
+ __UINT_LEAST64_MAX__
+ __INT_FAST8_MAX__
+ __INT_FAST16_MAX__
+ __INT_FAST32_MAX__
+ __INT_FAST64_MAX__
+ __UINT_FAST8_MAX__
+ __UINT_FAST16_MAX__
+ __UINT_FAST32_MAX__
+ __UINT_FAST64_MAX__
+ __INTPTR_MAX__
+ __UINTPTR_MAX__
+ __WCHAR_MIN__
+ __WINT_MIN__
+ __SIG_ATOMIC_MIN__
+
+ Defined to the maximum value of the ``signed char``, ``wchar_t``,
+ ``signed short``,
+ ``signed int``, ``signed long``, ``signed long long``,
+ ``wint_t``, ``size_t``, ``ptrdiff_t``,
+ ``intmax_t``, ``uintmax_t``, ``sig_atomic_t``, ``int8_t``,
+ ``int16_t``, ``int32_t``, ``int64_t``, ``uint8_t``,
+ ``uint16_t``, ``uint32_t``, ``uint64_t``,
+ ``int_least8_t``, ``int_least16_t``, ``int_least32_t``,
+ ``int_least64_t``, ``uint_least8_t``, ``uint_least16_t``,
+ ``uint_least32_t``, ``uint_least64_t``, ``int_fast8_t``,
+ ``int_fast16_t``, ``int_fast32_t``, ``int_fast64_t``,
+ ``uint_fast8_t``, ``uint_fast16_t``, ``uint_fast32_t``,
+ ``uint_fast64_t``, ``intptr_t``, and ``uintptr_t`` types and
+ to the minimum value of the ``wchar_t``, ``wint_t``, and
+ ``sig_atomic_t`` types respectively. They exist to make the
+ standard header given numerical limits work correctly. You should not
+ use these macros directly; instead, include the appropriate headers.
+ Some of these macros may not be defined on particular systems if GCC
+ does not provide a :samp:`stdint.h` header on those systems.
+
+.. c:macro:: __INT8_C
+ __INT16_C
+ __INT32_C
+ __INT64_C
+ __UINT8_C
+ __UINT16_C
+ __UINT32_C
+ __UINT64_C
+ __INTMAX_C
+ __UINTMAX_C
+
+ Defined to implementations of the standard :samp:`stdint.h` macros with
+ the same names without the leading ``__``. They exist the make the
+ implementation of that header work correctly. You should not use
+ these macros directly; instead, include the appropriate headers. Some
+ of these macros may not be defined on particular systems if GCC does
+ not provide a :samp:`stdint.h` header on those systems.
+
+.. c:macro:: __SCHAR_WIDTH__
+ __SHRT_WIDTH__
+ __INT_WIDTH__
+ __LONG_WIDTH__
+ __LONG_LONG_WIDTH__
+ __PTRDIFF_WIDTH__
+ __SIG_ATOMIC_WIDTH__
+ __SIZE_WIDTH__
+ __WCHAR_WIDTH__
+ __WINT_WIDTH__
+ __INT_LEAST8_WIDTH__
+ __INT_LEAST16_WIDTH__
+ __INT_LEAST32_WIDTH__
+ __INT_LEAST64_WIDTH__
+ __INT_FAST8_WIDTH__
+ __INT_FAST16_WIDTH__
+ __INT_FAST32_WIDTH__
+ __INT_FAST64_WIDTH__
+ __INTPTR_WIDTH__
+ __INTMAX_WIDTH__
+
+ Defined to the bit widths of the corresponding types. They exist to
+ make the implementations of :samp:`limits.h` and :samp:`stdint.h` behave
+ correctly. You should not use these macros directly; instead, include
+ the appropriate headers. Some of these macros may not be defined on
+ particular systems if GCC does not provide a :samp:`stdint.h` header on
+ those systems.
+
+.. c:macro:: __SIZEOF_INT__
+ __SIZEOF_LONG__
+ __SIZEOF_LONG_LONG__
+ __SIZEOF_SHORT__
+ __SIZEOF_POINTER__
+ __SIZEOF_FLOAT__
+ __SIZEOF_DOUBLE__
+ __SIZEOF_LONG_DOUBLE__
+ __SIZEOF_SIZE_T__
+ __SIZEOF_WCHAR_T__
+ __SIZEOF_WINT_T__
+ __SIZEOF_PTRDIFF_T__
+
+ Defined to the number of bytes of the C standard data types: ``int``,
+ ``long``, ``long long``, ``short``, ``void *``, ``float``,
+ ``double``, ``long double``, ``size_t``, ``wchar_t``, ``wint_t``
+ and ``ptrdiff_t``.
+
+.. c:macro:: __BYTE_ORDER__
+ __ORDER_LITTLE_ENDIAN__
+ __ORDER_BIG_ENDIAN__
+ __ORDER_PDP_ENDIAN__
+
+ ``__BYTE_ORDER__`` is defined to one of the values
+ ``__ORDER_LITTLE_ENDIAN__``, ``__ORDER_BIG_ENDIAN__``, or
+ ``__ORDER_PDP_ENDIAN__`` to reflect the layout of multi-byte and
+ multi-word quantities in memory. If ``__BYTE_ORDER__`` is equal to
+ ``__ORDER_LITTLE_ENDIAN__`` or ``__ORDER_BIG_ENDIAN__``, then
+ multi-byte and multi-word quantities are laid out identically: the
+ byte (word) at the lowest address is the least significant or most
+ significant byte (word) of the quantity, respectively. If
+ ``__BYTE_ORDER__`` is equal to ``__ORDER_PDP_ENDIAN__``, then
+ bytes in 16-bit words are laid out in a little-endian fashion, whereas
+ the 16-bit subwords of a 32-bit quantity are laid out in big-endian
+ fashion.
+
+ You should use these macros for testing like this:
+
+ .. code-block:: c++
+
+ /* Test for a little-endian machine */
+ #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
+
+.. c:macro:: __FLOAT_WORD_ORDER__
+
+ ``__FLOAT_WORD_ORDER__`` is defined to one of the values
+ ``__ORDER_LITTLE_ENDIAN__`` or ``__ORDER_BIG_ENDIAN__`` to reflect
+ the layout of the words of multi-word floating-point quantities.
+
+.. c:macro:: __DEPRECATED
+
+ This macro is defined, with value 1, when compiling a C++ source file
+ with warnings about deprecated constructs enabled. These warnings are
+ enabled by default, but can be disabled with :option:`-Wno-deprecated`.
+
+.. c:macro:: __EXCEPTIONS
+
+ This macro is defined, with value 1, when compiling a C++ source file
+ with exceptions enabled. If :option:`-fno-exceptions` is used when
+ compiling the file, then this macro is not defined.
+
+.. c:macro:: __GXX_RTTI
+
+ This macro is defined, with value 1, when compiling a C++ source file
+ with runtime type identification enabled. If :option:`-fno-rtti` is
+ used when compiling the file, then this macro is not defined.
+
+.. c:macro:: __USING_SJLJ_EXCEPTIONS__
+
+ This macro is defined, with value 1, if the compiler uses the old
+ mechanism based on ``setjmp`` and ``longjmp`` for exception
+ handling.
+
+.. c:macro:: __GXX_EXPERIMENTAL_CXX0X__
+
+ This macro is defined when compiling a C++ source file with C++11 features
+ enabled, i.e., for all C++ language dialects except :option:`-std`:samp:`=c++98`
+ and :option:`-std`:samp:`=gnu++98`. This macro is obsolete, but can be used to
+ detect e[...]
[diff truncated at 524288 bytes]
More information about the Gcc-cvs
mailing list