Remove 'The' from subheadings

Author: mpilgrem

doc/environment_variables.md

@@ -74,7 +74,7 @@ Related command: all commands that make use of Stack's global YAML configuration
 file (`config.yaml`).
 
 Overridden by: Stack's global
-[`--stack-root`](global_flags.md#the---stack-root-option) option.
+[`--stack-root`](global_flags.md#stack-root-option) option.
 
 The environment variable `STACK_ROOT` can be used to specify the Stack root
 directory.
@@ -85,7 +85,7 @@ Related command: all commands that make use of Stack's work directories.
 
 Overridden by: Stack's [`work-dir`](yaml_configuration.md#work-dir) non-project
 specific configuration option, or global
-[`--work-dir`](global_flags.md#the---work-dir-option) option.
+[`--work-dir`](global_flags.md#work-dir-option) option.
 
 The environment variable `STACK_WORK` can be used to specify the path of Stack's
 work directory, within a local project or package directory, and override
@@ -100,7 +100,7 @@ YAML configuration file (`config.yaml`).
 
 Overridden by: the use of Stack's `STACK_ROOT` environment variable, or the use
 of Stack's global
-[`--stack-root`](global_flags.md#the---stack-root-option) option.
+[`--stack-root`](global_flags.md#stack-root-option) option.
 
 On Unix-like operating systems and Windows, Stack can be configured to follow
 the XDG Base Directory Specification if the environment variable `STACK_XDG` is
@@ -112,7 +112,7 @@ Related command: all commands that make use of Stack's project-level YAML
 configuration file.
 
 Overridden by: Stack's global
-[`--stack-yaml`](global_flags.md#the---stack-yaml-option) option.
+[`--stack-yaml`](global_flags.md#stack-yaml-option) option.
 
 The environment variable `STACK_YAML` can be used to specify Stack's
 project-level YAML configuration file.

doc/global_flags.md

@@ -7,7 +7,7 @@ flags and options apply to all of Stack's commands. In addition, all of Stack's
 commands accept the `--setup-info-yaml` and `--snapshot-location-base` options
 and the `--help` flag.
 
-## The `--allow-different-user` flag
+## `--allow-different-user` flag
 
 Restrictions: POSIX systems only
 
@@ -18,109 +18,109 @@ to use a Stack installation. For further information, see the documentation for
 the corresponding non-project specific configuration
 [option](yaml_configuration.md#allow-different-user).
 
-## The `--arch` option
+## `--arch` option
 
 Pass the option `--arch <architecture>` to specify the relevant machine
 architecture. For further information, see the documentation for the
 corresponding non-project specific configuration
 [option](yaml_configuration.md#arch).
 
-## The `--color` or `-colour` options
+## `--color` or `-colour` options
 
 Pass the option `stack --color <when>` to specify when to use color in output.
 For further information, see the documentation for the corresponding non-project
 specific configuration [option](yaml_configuration.md#color).
 
-## The `--compiler` option
+## `--compiler` option
 
 Pass the option `--compiler <compiler>` to specify the compiler. For further
 information, see the [YAML configuration](yaml_configuration.md#compiler)
 documentation.
 
-## The `--custom-preprocessor-extensions` option
+## `--custom-preprocessor-extensions` option
 
 Pass the option `--custom-preprocessor-extensions <extension>` to specify an
 extension used for a custom preprocessor. For further information, see the
 documentation for the corresponding non-project specific configuration
 [option](yaml_configuration.md#custom-preprocessor-extensions).
 
-## The `--docker*` flags and options
+## `--docker*` flags and options
 
 Stack supports automatically performing builds inside a Docker container. For
 further information see `stack --docker-help` or the
 [Docker integratiom](docker_integration.md) documentation.
 
-## The `--[no-]dump-logs` flag
+## `--[no-]dump-logs` flag
 
 Default: Dump warning logs
 
 Enables/disables the dumping of the build output logs for local packages to the
 console. For further information, see the documentation for the corresponding
 non-project specific configuration [option](yaml_configuration.md#dump-logs).
 
-## The `--extra-include-dirs` option
+## `--extra-include-dirs` option
 
 Pass the option `--extra-include-dirs <director>` to specify an extra directory
 to check for C header files. The option can be specified multiple times. For
 further information, see the documentation for the corresponding non-project
 specific configuration [option](yaml_configuration.md#extra-include-dirs).
 
-## The `--extra-lib-dirs` option
+## `--extra-lib-dirs` option
 
 Pass the option `--extra-lib-dirs <director>` to specify an extra directory
 to check for libraries. The option can be specified multiple times. For further
 information, see the documentation for the corresponding non-project specific
 configuration [option](yaml_configuration.md#extra-lib-dirs).
 
-## The `--ghc-build` option
+## `--ghc-build` option
 
 Pass the option `--ghc-build <build>` to specify the relevant specialised GHC
 build. For further information, see the documentation for the corresponding
 non-project specific configuration [option](yaml_configuration.md#ghc-build).
 
-## The `--ghc-variant` option
+## `--ghc-variant` option
 
 Pass the option `--ghc-variant <variant>` to specify the relevant GHC variant.
 For further information, see the documentation for the corresponding non-project
 specific configuration [option](yaml_configuration.md#ghc-variant).
 
-## The `--hpack-numeric-version` flag
+## `--hpack-numeric-version` flag
 
 Pass the flag `--hpack-numeric-version` to cause Stack to report the numeric
 version of its built-in Hpack library to standard output (e.g. `0.35.0`) and
 quit.
 
-## The `--[no-]install-ghc` flag
+## `--[no-]install-ghc` flag
 
 Default: Enabled
 
 Enables/disables the download and instalation of GHC if necessary. For further
 information, see the documentation for the corresponding non-project specific
 configuration [option](yaml_configuration.md#install-ghc).
 
-## The `--jobs` or `-j` option
+## `--jobs` or `-j` option
 
 Pass the option `--jobs <number_of_jobs>` to specify the number of concurrent
 jobs to run. For further information, see the documentation for the
 corresponding non-project specific configuration
 [option](yaml_configuration.md#jobs).
 
-## The `--local-bin-path` option
+## `--local-bin-path` option
 
 Pass the option `--local-bin-path <directory>` to specify the directory in which
 Stack installs executables. For further information, see the documentation for
 the corresponding non-project specific configuration
 [option](yaml_configuration.md#local-bin-path).
 
-## The `--lock-file` option
+## `--lock-file` option
 
 Default: `read-write`, if snapshot specified in YAML configuration file;
 `read-only`, if a different snapshot is specified on the command line.
 
 Pass the option `--lock-file <mode>` to specify how Stack interacts with lock
 files. Valid modes are `error-on-write`, `ignore`, `read-only` and `read-write`.
 
-## The `--[no-]modify-code-page` flag
+## `--[no-]modify-code-page` flag
 
 Restrictions: Windows systems only
 
@@ -130,23 +130,23 @@ Enables/disables setting the codepage to support UTF-8. For further information,
 see the documentation for the corresponding non-project specific configuration
 [option](yaml_configuration.md#modify-code-page).
 
-## The `--nix*` flags and options
+## `--nix*` flags and options
 
 Stack can be configured to integrate with Nix. For further information, see
 `stack --nix-help` or the [Nix integration](nix_integration.md) documentation.
 
-## The `--numeric-version` flag
+## `--numeric-version` flag
 
 Pass the flag `--numeric-version` to cause Stack to report its numeric version
 to standard output (e.g. `2.9.1`) and quit.
 
-## The `--resolver` option
+## `--resolver` option
 
 Pass the option `--resolver <snapshot>` to specify the snapshot. For further
 information, see the
 [YAML configuration](yaml_configuration.md#resolver-or-snapshot) documentation.
 
-## The `--[no-]rsl-in-log` flag
+## `--[no-]rsl-in-log` flag
 
 [:octicons-tag-24: 2.9.1](https://github.com/commercialhaskell/stack/releases/tag/v2.9.1)
 
@@ -156,26 +156,26 @@ Enables/disables the logging of the raw snapshot layer (rsl) in debug output.
 Information about the raw snapshot layer can be lengthy. If you do not need it,
 it is best omitted from the debug output.
 
-## The `--[no-]script-no-run-compile` flag
+## `--[no-]script-no-run-compile` flag
 
 Default: Disabled
 
 Enables/disables the use of options `--no-run --compile` with the
 [`stack script` command](script_command.md).
 
-## The `--silent` flag
+## `--silent` flag
 
 Equivalent to the `--verbosity silent` option.
 
-## The `--[no-]skip-ghc-check` option
+## `--[no-]skip-ghc-check` option
 
 Default: Disabled
 
 Enables/disables the skipping of checking the GHC version and architecture. For
 further information, see the documentation for the corresponding non-project
 specific configuration [option](yaml_configuration.md#skip-ghc-check).
 
-## The `--[no-]skip-msys` option
+## `--[no-]skip-msys` option
 
 Restrictions: Windows systems only
 
@@ -185,20 +185,20 @@ Enables/disables the skipping of installing MSYS2. For further information, see
 the documentation for the corresponding non-project specific configuration
 [option](yaml_configuration.md#skip-msys).
 
-## The `--stack-colors` or `--stack-colours` options
+## `--stack-colors` or `--stack-colours` options
 
 Pass the option `--stack-colors <styles>` to specify Stack's output styles. For
 further information, see the documentation for the corresponding non-project
 specific configuration [option](yaml_configuration.md#stack-colors).
 
-## The `--stack-root` option
+## `--stack-root` option
 
 Overrides: `STACK_ROOT` environment variable
 
 Pass the option `--stack-root <absolute_path_to_the_Stack_root>` to specify the
 path to the Stack root directory. The path must be an absolute one.
 
-## The `--stack-yaml` option
+## `--stack-yaml` option
 
 Default: `stack.yaml`
 
@@ -207,64 +207,64 @@ Overrides: `STACK_YAML` enviroment variable
 Pass the option `--stack-yaml <file>` to specify Stack's project-level YAML
 configuration file.
 
-## The `--[no-]system-ghc` flag
+## `--[no-]system-ghc` flag
 
 Default: Disabled
 
 Enables/disables the use of a GHC executable on the PATH, if one is available
 and its version matches.
 
-## The `--[no-]terminal` flag
+## `--[no-]terminal` flag
 
 Default: Stack is running in a terminal (as detected)
 
 Enables/disables whether Stack is running in a terminal.
 
-## The `--terminal-width` option
+## `--terminal-width` option
 
 Default: the terminal width (if detected); otherwise `100`
 
 Pass the option `--terminal-width <width>` to specify the width of the terminal,
 used by Stack's pretty printed messages.
 
-## The `--[no-]time-in-logs` flag
+## `--[no-]time-in-logs` flag
 
 Default: Enabled
 
 Enables/disables the inclusion of time stamps against logging entries when the
 verbosity level is 'debug'.
 
-## The `--verbose` or `-v` flags
+## `--verbose` or `-v` flags
 
 Equivalent to the `--verbosity debug` option.
 
-## The `--verbosity` option
+## `--verbosity` option
 
 Default: `info`
 
 Pass the option `--verbosity <log_level>` to specify the level for logging.
 Possible levels are `silent`, `error`, `warn`, `info` and `debug`, in order of
 increasing amounts of information provided by logging.
 
-## The `--version` flag
+## `--version` flag
 
 Pass the flag `--version` to cause Stack to report its version to standard
 output and quit. For versions that are release candidates, the report will list
 the dependencies that Stack has been compiled with.
 
-## The `--with-gcc` option
+## `--with-gcc` option
 
 Pass the option `--with-gcc <path_to_gcc>` to specify use of a GCC executable.
 For further information, see the documentation for the corresponding non-project
 specific configuration [option](yaml_configuration.md#with-gcc).
 
-## The `--with-hpack` option
+## `--with-hpack` option
 
 Pass the option `--with-hpack <hpack>` to specify use of an Hpack executable.
 For further information, see the documentation for the corresponding
 non-project specific configuration [option](yaml_configuration.md#with-hpack).
 
-## The `--work-dir` option
+## `--work-dir` option
 
 Default: `.stack-work`
 
@@ -278,21 +278,21 @@ path must be a relative one, relative to the the root directory of the project
 or package. The relative path cannot include a `..` (parent directory)
 component.
 
-## The `--setup-info-yaml` command option
+## `--setup-info-yaml` command option
 
 Default: `https://raw.githubusercontent.com/commercialhaskell/stackage-content/master/stack/stack-setup-2.yaml`
 
 The `--setup-info-yaml <url>` command option specifies the location of a
 `setup-info` dictionary. The option can be specified multiple times.
 
-## The `--snapshot-location-base` command option
+## `--snapshot-location-base` command option
 
 Default: `https://raw.githubusercontent.com/commercialhaskell/stackage-snapshots/master`
 
 The `--snapshot-location-base <url>` command option specifies the base location
 of snapshots.
 
-## The `--help` command flag
+## `--help` command flag
 
 If Stack is passed the `--help` command flag, it will output help for the
 command.

doc/yaml_configuration.md

@@ -1566,7 +1566,7 @@ with-hpack: /usr/local/bin/hpack
 Default: `.stack-work`
 
 Command line equivalent (takes precedence):
-[`--work-dir`](global_flags.md#the---work-dir-option) option
+[`--work-dir`](global_flags.md#work-dir-option) option
 
 Environment variable alternative (lowest precedence):
 [`STACK_WORK`](environment_variables.md#stack_work)