docs: Fix broken links

30 files changed, 74 insertions, 91 deletions

diff --git a/docs/markdown/Adding-arguments.md b/docs/markdown/Adding-arguments.md
index adbc23e..2aaa889 100644
--- a/docs/markdown/Adding-arguments.md
+++ b/docs/markdown/Adding-arguments.md
@@ -22,7 +22,7 @@ This makes Meson add the define to all C compilations. Usually you
 would use this setting for flags for global settings. Note that for
 setting the C/C++ language standard (the `-std=c99` argument in GCC),
 you would probably want to use a default option of the `project()`
-function. For details see the [reference manual](Reference-manual.md).
+function. For details see the [reference manual](RefMan.md).
 
 Global arguments have certain limitations. They all have to be defined
 before any build targets are specified. This ensures that the global
diff --git a/docs/markdown/Build-options.md b/docs/markdown/Build-options.md
index 4a0b178..86f1001 100644
--- a/docs/markdown/Build-options.md
+++ b/docs/markdown/Build-options.md
@@ -76,18 +76,17 @@ This type is available since version 0.44.0
 A `feature` option has three states: `enabled`, `disabled` or `auto`.
 It is intended to be passed as value for the `required` keyword
 argument of most functions. Currently supported in
-[`dependency()`](Reference-manual.md#dependency),
-[`find_library()`](Reference-manual.md#compiler-object),
-[`find_program()`](Reference-manual.md#find_program) and
-[`add_languages()`](Reference-manual.md#add_languages) functions.
+[[dependency]],
+[[compiler.find_library]],
+[[find_program]] and
+[[add_languages]] functions.
 
 - `enabled` is the same as passing `required : true`.
 - `auto` is the same as passing `required : false`.
 - `disabled` do not look for the dependency and always return 'not-found'.
 
 When getting the value of this type of option using `get_option()`, a
-special [feature option
-object](Reference-manual.md#feature-option-object) is returned instead
+special [[@feature]] object is returned instead
 of the string representation of the option's value. This object can be
 passed to `required`:
 
diff --git a/docs/markdown/Builtin-options.md b/docs/markdown/Builtin-options.md
index 0536e77..37bf715 100644
--- a/docs/markdown/Builtin-options.md
+++ b/docs/markdown/Builtin-options.md
@@ -166,7 +166,7 @@ option:
 `-Wl,-bitcode_bundle` while linking. These options are incompatible
 with `b_asneeded`, so that option will be silently disabled.
 
-[Shared modules](Reference-manual.md#shared_module) will not have
+[[shared_module]]s will not have
 bitcode embedded because `-Wl,-bitcode_bundle` is incompatible with
 both `-bundle` and `-Wl,-undefined,dynamic_lookup` which are necessary
 for shared modules to work.
diff --git a/docs/markdown/CMake-module.md b/docs/markdown/CMake-module.md
index b82227d..ed43f9d 100644
--- a/docs/markdown/CMake-module.md
+++ b/docs/markdown/CMake-module.md
@@ -115,9 +115,8 @@ See [the CMake options object](#cmake-options-object) for a complete
 reference of all supported functions.
 
 The CMake configuration options object is very similar to the
-[configuration data
-object](Reference-manual.md#configuration-data-object) object returned
-by [`configuration_data`](Reference-manual.md#configuration_data). It
+[[@cfg_data]] object] object returned
+by [[configuration_data]]. It
 is generated by the `subproject_options` function
 
 All configuration options have to be set *before* the subproject is
@@ -138,8 +137,8 @@ and supports the following methods:
  - `dependency(target)` returns a dependency object for any CMake target. The
    `include_type` kwarg *(new in 0.56.0)* controls the include type of the
    returned dependency object similar to the same kwarg in the
-   [`dependency()`](Reference-manual.md#dependency) function.
- - `include_directories(target)` returns a Meson `include_directories()`
+   [[dependency]] function.
+ - `include_directories(target)` returns a Meson [[@inc]]
    object for the specified target. Using this function is not necessary
    if the dependency object is used.
  - `target(target)` returns the raw build target.
@@ -160,7 +159,7 @@ following methods are supported:
  - `add_cmake_defines({'opt1': val1, ...})` add additional CMake commandline defines
  - `set_override_option(opt, val)` set specific [build options](Build-options.md)
    for targets. This will effectively add `opt=val` to the `override_options`
-   array of the [build target](Reference-manual.md#executable)
+   array of the [[build_target]]
  - `set_install(bool)` override wether targets should be installed or not
  - `append_compile_args(lang, arg1, ...)` append compile flags for a specific
    language to the targets
diff --git a/docs/markdown/External-Project-module.md b/docs/markdown/External-Project-module.md
index 640caaf..901b0ed 100644
--- a/docs/markdown/External-Project-module.md
+++ b/docs/markdown/External-Project-module.md
@@ -86,7 +86,7 @@ Keyword arguments:
 - `verbose`: If set to `true` the output of sub-commands ran to configure, build
   and install the project will be printed onto Meson's stdout.
 - `env` : environment variables to set, such as `['NAME1=value1', 'NAME2=value2']`,
-  a dictionary, or an [`environment()` object](Reference-manual.md#environment-object).
+  a dictionary, or an [[@env]] object.
 
 Returns an [`ExternalProject`](#ExternalProject_object) object
 
diff --git a/docs/markdown/External-commands.md b/docs/markdown/External-commands.md
index be9d171..772459b 100644
--- a/docs/markdown/External-commands.md
+++ b/docs/markdown/External-commands.md
@@ -22,8 +22,7 @@ Since 0.52.0, you can pass the command environment as a dictionary:
 run_command('command', 'arg1', 'arg2', env: {'FOO': 'bar'})
 ```
 
-Since 0.50.0, you can also pass the command
-[`environment`](Reference-manual.md#environment-object) object:
+Since 0.50.0, you can also pass the command [[@env]] object:
 
 ```meson
 env = environment()
diff --git a/docs/markdown/Generating-sources.md b/docs/markdown/Generating-sources.md
index c09819f..3cdfbc4 100644
--- a/docs/markdown/Generating-sources.md
+++ b/docs/markdown/Generating-sources.md
@@ -8,8 +8,8 @@ Sometimes source files need to be preprocessed before they are passed
 to the actual compiler. As an example you might want build an IDL
 compiler and then run some files through that to generate actual
 source files. In Meson this is done with
-[`generator()`](Reference-manual.md#generator) or
-[`custom_target()`](Reference-manual.md#custom_target).
+[[generator]] or
+[[custom_target]].
 
 ## Using custom_target()
 
@@ -120,7 +120,7 @@ idep_foo = declare_dependency(
 ```
 
 See [dependencies](Dependencies.md#declaring-your-own), and
-[reference](Reference-manual.md#declare_dependency) for more
+[[declare_dependency]] for more
 information.
 
 ## Using generator()
@@ -139,7 +139,7 @@ output will be created in a target-private directory `@BUILD_DIR@`.
 If you want to generate files for general purposes such as for
 generating headers to be used by several sources, or data that will be
 installed, and so on, use a
-[`custom_target()`](Reference-manual.md#custom_target) instead.
+[[custom_target]] instead.
 
 
 ```meson
diff --git a/docs/markdown/Gnome-module.md b/docs/markdown/Gnome-module.md
index 2b90e0c..9477b29 100644
--- a/docs/markdown/Gnome-module.md
+++ b/docs/markdown/Gnome-module.md
@@ -225,9 +225,9 @@ useful when running the application locally for example during tests.
 * `build_by_default`: causes, when set to true, to have this target be
   built by default, that is, when invoking plain `meson compile`, the default
   value is true for all built target types
-* `depend_files`: files ([`string`](Reference-manual.md#string-object),
-  [`files()`](Reference-manual.md#files), or
-  [`configure_file()`](Reference-manual.md#configure_file)) of
+* `depend_files`: files ([[@str]],
+  [[files]], or
+  [[configure_file]]) of
   schema source XML files that should trigger a re-compile if changed.
 
 ### gnome.gdbus_codegen()
diff --git a/docs/markdown/Hotdoc-module.md b/docs/markdown/Hotdoc-module.md
index 7d9fc55..d33dd3e 100644
--- a/docs/markdown/Hotdoc-module.md
+++ b/docs/markdown/Hotdoc-module.md
@@ -31,21 +31,17 @@ Generates documentation using [hotdoc] and installs it into `$prefix/share/doc/h
 
 **Keyworded arguments:**
 
-* `sitemap` (*[string] or [file]*) (**required**): The hotdoc sitemap file
-* `index` (*[string] or [file]*) (**required**): Location of the index file
-* `dependencies`(*[targets]*): Targets on which the documentation generation depends on.
+* `sitemap` ([[@str]] or [[@file]]) (**required**): The hotdoc sitemap file
+* `index` ([[@str]] or [[@file]]) (**required**): Location of the index file
+* `dependencies`([[@build_tgt]]): Targets on which the documentation generation depends on.
 * `subprojects`: A list of `HotdocTarget` that are used as subprojects for hotdoc to generate
   the documentation.
 * ... Any argument of `hotdoc` can be used replacing dashes (`-`) with underscores (`_`).
   For a full list of available parameters, just have a look at `hotdoc help`.
 
-[file]: Reference-manual.md#files
-[string]: Reference-manual.md#string-object
-[targets]: Reference-manual.md#build-target-object
-
 **Returns:**
 
-`HotdocTarget`: A [`custom_target`](Reference-manual.md#custom-target-object) with the
+`HotdocTarget`: A [[custom_target]] with the
 following extra methods:
 
 * `config_path`: Path to the generated `hotdoc` configuration file.
diff --git a/docs/markdown/IDE-integration.md b/docs/markdown/IDE-integration.md
index 848b812..cf1c5c1 100644
--- a/docs/markdown/IDE-integration.md
+++ b/docs/markdown/IDE-integration.md
@@ -79,7 +79,7 @@ project.
 
 *(New in 0.56.0)* The `extra_files` key lists all files specified via
 the `extra_files` kwarg of a build target. See
-[`executable()`](Reference-manual.md#executable).
+[[executable]].
 
 A target usually generates only one file. However, it is possible for
 custom targets to have multiple outputs.
diff --git a/docs/markdown/Keyval-module.md b/docs/markdown/Keyval-module.md
index 96d9c15..fb3513a 100644
--- a/docs/markdown/Keyval-module.md
+++ b/docs/markdown/Keyval-module.md
@@ -55,4 +55,4 @@ option](Build-options.md).
 * The first (and only) argument is the path to the configuration file to
   load (usually ".config").
 
-**Returns**: a [dictionary object](Reference-manual.md#dictionary-object).
+**Returns**: a [[@dict]] object.
diff --git a/docs/markdown/Python-3-module.md b/docs/markdown/Python-3-module.md
index b89ea3e..1631b2a 100644
--- a/docs/markdown/Python-3-module.md
+++ b/docs/markdown/Python-3-module.md
@@ -10,7 +10,7 @@ This module is deprecated and replaced by the
 
 This is a cross platform way of finding the Python 3 executable, which
 may have a different name on different operating systems. Returns an
-[external program](Reference-manual.md#external-program-object)
+[[@external_program]]
 object.
 
 *Added 0.38.0*
@@ -24,7 +24,7 @@ from `python` module.
 Creates a `shared_module` target that is named according to the naming
 conventions of the target platform. All positional and keyword
 arguments are the same as for
-[shared_module](Reference-manual.md#shared_module).
+[[shared_module]].
 
 `extension_module` does not add any dependencies to the library so user may
 need to add `dependencies : dependency('python3')`, see
diff --git a/docs/markdown/Python-module.md b/docs/markdown/Python-module.md
index 6f4120d..5d7b5ed 100644
--- a/docs/markdown/Python-module.md
+++ b/docs/markdown/Python-module.md
@@ -30,7 +30,7 @@ installation will be the one used to run Meson.
 If provided, it can be:
 
 - A simple name, eg `python-2.7`, Meson will look for an external program
-  named that way, using [find_program]
+  named that way, using [[find_program]]
 
 - A path, eg `/usr/local/bin/python3.4m`
 
@@ -49,7 +49,7 @@ Keyword arguments are the following:
   [`feature`](Build-options.md#features) option can also be passed to the
   `required` keyword argument.
 - `disabler`: if `true` and no python installation can be found, return a
-  [disabler object](Reference-manual.md#disabler-object) instead of a not-found object.
+  [[@disabler]] object instead of a not-found object.
   *Since 0.49.0*
 - `modules`: a list of module names that this python installation must have.
   *Since 0.51.0*
@@ -58,7 +58,7 @@ Keyword arguments are the following:
 
 ## `python_installation` object
 
-The `python_installation` object is an [external program], with several
+The `python_installation` object is an [[@external_program]], with several
 added methods.
 
 ### Methods
@@ -80,11 +80,11 @@ provided prior to 0.50.0 due to a bug.
 shared_module py_installation.extension_module(module_name, list_of_sources, ...)
 ```
 
-Create a `shared_module` target that is named according to the naming
+Create a [[shared_module]] target that is named according to the naming
 conventions of the target platform.
 
 All positional and keyword arguments are the same as for
-[shared_module], excluding `name_suffix` and `name_prefix`, and with
+[[shared_module]], excluding `name_suffix` and `name_prefix`, and with
 the addition of the following:
 
 - `subdir`: By default, Meson will install the extension module in
@@ -95,9 +95,9 @@ the addition of the following:
 
 `extension_module` does not add any dependencies to the library so
 user may need to add `dependencies : py_installation.dependency()`,
-see [][`dependency()`].
+see [[dependency]].
 
-**Returns**: a [buildtarget object]
+**Returns**: a [[@build_tgt]] object
 
 #### `dependency()`
 
@@ -106,7 +106,7 @@ python_dependency py_installation.dependency(...)
 ```
 
 This method accepts no positional arguments, and the same keyword
-arguments as the standard [dependency] function. It also supports the
+arguments as the standard [[dependency]] function. It also supports the
 following keyword argument:
 
 - `embed`: *(since 0.53.0)* If true, Meson will try to find a python
@@ -126,7 +126,7 @@ void py_installation.install_sources(list_of_files, ...)
 Install actual python sources (`.py`).
 
 All positional and keyword arguments are the same as for
-[install_data], with the addition of the following:
+[[install_data]], with the addition of the following:
 
 - `pure`: On some platforms, architecture independent files are
   expected to be placed in a separate directory. However, if the
@@ -149,7 +149,7 @@ string py_installation.get_install_dir(...)
 Retrieve the directory [][`install_sources()`] will install to.
 
 It can be useful in cases where `install_sources` cannot be used
-directly, for example when using [configure_file].
+directly, for example when using [[configure_file]].
 
 This function accepts no arguments, its keyword arguments are the same
 as [][`install_sources()`].
@@ -236,18 +236,9 @@ with [][`get_variable()`], false otherwise.
 
 ## `python_dependency` object
 
-This [dependency object] subclass will try various methods to obtain
+This [[@dep]] object subclass will try various methods to obtain
 the compiler and linker arguments, starting with pkg-config then
 potentially using information obtained from python's `sysconfig`
 module.
 
 It exposes the same methods as its parent class.
-
-[find_program]: Reference-manual.md#find_program
-[shared_module]: Reference-manual.md#shared_module
-[external program]: Reference-manual.md#external-program-object
-[dependency]: Reference-manual.md#dependency
-[install_data]: Reference-manual.md#install_data
-[configure_file]: Reference-manual.md#configure_file
-[dependency object]: Reference-manual.md#dependency-object
-[buildtarget object]: Reference-manual.md#build-target-object
diff --git a/docs/markdown/Release-notes-for-0.37.0.md b/docs/markdown/Release-notes-for-0.37.0.md
index 930c1d1..cb5a354 100644
--- a/docs/markdown/Release-notes-for-0.37.0.md
+++ b/docs/markdown/Release-notes-for-0.37.0.md
@@ -153,7 +153,7 @@ you don't need to add that yourself to `vala_args:`.
 ## Improvements to install scripts
 
 You can now pass arguments to install scripts added with
-[`meson.add_install_script()`](Reference-manual.md#meson-object). All
+[[meson.add_install_script]]. All
 arguments after the script name will be passed to the script.
 
 The `MESON_INSTALL_DESTDIR_PREFIX` environment variable is now set
diff --git a/docs/markdown/Release-notes-for-0.38.0.md b/docs/markdown/Release-notes-for-0.38.0.md
index 152308d..5aaca0a 100644
--- a/docs/markdown/Release-notes-for-0.38.0.md
+++ b/docs/markdown/Release-notes-for-0.38.0.md
@@ -106,7 +106,7 @@ the check is now ~40% faster.
 ## Array indexing now supports fallback values
 
 The second argument to the array
-[`.get()`](Reference-manual.md#array-object) function is now returned
+[[list.get]] function is now returned
 if the specified index could not be found
 
 ```meson
diff --git a/docs/markdown/Release-notes-for-0.42.0.md b/docs/markdown/Release-notes-for-0.42.0.md
index 585380b..ba2fe8c 100644
--- a/docs/markdown/Release-notes-for-0.42.0.md
+++ b/docs/markdown/Release-notes-for-0.42.0.md
@@ -114,7 +114,7 @@ dependency](Dependencies.md#mpi) for more information.
 
 ## Allow excluding files or directories from `install_subdir`
 
-The [`install_subdir`](Reference-manual.md#install_subdir) command
+The [[install_subdir]] command
 accepts the new `exclude_files` and `exclude_directories` keyword
 arguments that allow specified files or directories to be excluded
 from the installed subdirectory.
diff --git a/docs/markdown/Release-notes-for-0.46.0.md b/docs/markdown/Release-notes-for-0.46.0.md
index 64e237d..3de6bcd 100644
--- a/docs/markdown/Release-notes-for-0.46.0.md
+++ b/docs/markdown/Release-notes-for-0.46.0.md
@@ -132,14 +132,14 @@ meson.override_find_program('mycodegen', prog_script)
 
 ## New functions: has_link_argument() and friends
 
-A new set of methods has been added to [compiler
-objects](Reference-manual.md#compiler-object) to test if the linker
+A new set of methods has been added to [[@compiler]]
+objects to test if the linker
 supports given arguments.
 
-- `has_link_argument()`
-- `has_multi_link_arguments()`
-- `get_supported_link_arguments()`
-- `first_supported_link_argument()`
+- [[compiler.has_link_argument]]
+- [[compiler.has_multi_link_arguments]]
+- [[compiler.get_supported_link_arguments]]
+- [[compiler.first_supported_link_argument]]
 
 ## "meson help" now shows command line help
 
@@ -288,9 +288,9 @@ passed via the `libraries` keyword argument.
 
 Projects that install both a static and a shared version of a library
 should use the result of
-[`both_libraries()`](Reference-manual.md#both_libraries) to the
+[[both_libraries]] to the
 pkg-config file generator or use
-[`configure_file()`](Reference-manual.md#configure_file) for more
+[[configure_file]] for more
 complicated setups.
 
 ## Improvements to pkgconfig module
diff --git a/docs/markdown/Release-notes-for-0.47.0.md b/docs/markdown/Release-notes-for-0.47.0.md
index 175126e..f85a41b 100644
--- a/docs/markdown/Release-notes-for-0.47.0.md
+++ b/docs/markdown/Release-notes-for-0.47.0.md
@@ -81,7 +81,7 @@ should be used whenever possible.
 ## New action `copy:` for `configure_file()`
 
 In addition to the existing actions `configuration:` and `command:`,
-[`configure_file()`](Reference-manual.md#configure_file) now accepts a
+[[configure_file]] now accepts a
 keyword argument `copy:` which specifies a new action to copy the file
 specified with the `input:` keyword argument to a file in the build
 directory with the name specified with the `output:` keyword argument.
@@ -92,7 +92,7 @@ can only do one action at a time.
 ## New keyword argument `encoding:` for `configure_file()`
 
 Add a new keyword to
-[`configure_file()`](Reference-manual.md#configure_file) that allows
+[[configure_file]] that allows
 the developer to specify the input and output file encoding. The
 default value is the same as before: UTF-8.
 
diff --git a/docs/markdown/Release-notes-for-0.48.0.md b/docs/markdown/Release-notes-for-0.48.0.md
index 4b68b6d..50e8f20 100644
--- a/docs/markdown/Release-notes-for-0.48.0.md
+++ b/docs/markdown/Release-notes-for-0.48.0.md
@@ -30,7 +30,7 @@ manually changed with the new base option `b_vscrt`.
 ## Meson warns if two calls to `configure_file()` write to the same file
 
 If two calls to
-[`configure_file()`](Reference-manual.md#configure_file) write to the
+[[configure_file]] write to the
 same file Meson will print a `WARNING:` message during configuration.
 For example:
 
@@ -268,7 +268,7 @@ Now, by default `shared_library()` sets `-compatibility_version` and
 `-current_version` of a macOS dylib using the `soversion`.
 
 This can be overridden by using the `darwin_versions:` kwarg to
-[`shared_library()`](Reference-manual.md#shared_library). As usual,
+[[shared_library]]. As usual,
 you can also pass this kwarg to `library()` or `build_target()` and it
 will be used in the appropriate circumstances.
 
diff --git a/docs/markdown/Release-notes-for-0.50.0.md b/docs/markdown/Release-notes-for-0.50.0.md
index 0f7dbb8..9579c33 100644
--- a/docs/markdown/Release-notes-for-0.50.0.md
+++ b/docs/markdown/Release-notes-for-0.50.0.md
@@ -202,8 +202,8 @@ dependency tracking does not work.
 
 ## `run_command()` accepts `env` kwarg
 
-You can pass [`environment`](Reference-manual.md#environment-object)
-object to [`run_command`](Reference-manual.md#run-command), just
+You can pass [[@env]]
+object to [[run_command]], just
 like to `test`:
 
 ```meson
diff --git a/docs/markdown/Release-notes-for-0.53.0.md b/docs/markdown/Release-notes-for-0.53.0.md
index 73a71db..97b6633 100644
--- a/docs/markdown/Release-notes-for-0.53.0.md
+++ b/docs/markdown/Release-notes-for-0.53.0.md
@@ -32,7 +32,7 @@ Meson now ships with predefined project templates for `Dlang`,
 
 ## Add a new summary() function
 
-A new function [`summary()`](Reference-manual.md#summary) has been
+A new function [[summary]] has been
 added to summarize build configuration at the end of the build
 process.
 
diff --git a/docs/markdown/Release-notes-for-0.55.0.md b/docs/markdown/Release-notes-for-0.55.0.md
index 110dd1d..22c7e61 100644
--- a/docs/markdown/Release-notes-for-0.55.0.md
+++ b/docs/markdown/Release-notes-for-0.55.0.md
@@ -93,9 +93,8 @@ Meson now supports passing configuration options to CMake and
 overriding certain build details extracted from the CMake subproject.
 
 The new CMake configuration options object is very similar to the
-[configuration data
-object](Reference-manual.md#configuration-data-object) object returned
-by [`configuration_data`](Reference-manual.md#configuration_data). It
+[[@cfg_data]] object object returned
+by [[configuration_data]]. It
 is generated by the `subproject_options` function
 
 All configuration options have to be set *before* the subproject is
diff --git a/docs/markdown/Release-notes-for-0.57.0.md b/docs/markdown/Release-notes-for-0.57.0.md
index 14fa030..4892b40 100644
--- a/docs/markdown/Release-notes-for-0.57.0.md
+++ b/docs/markdown/Release-notes-for-0.57.0.md
@@ -56,8 +56,8 @@ configuration dependency on the file, and so if the `COPYING` file is modified,
 Meson will automatically reconfigure, guaranteeing the build is consistent. It
 can be used for any properly encoded text files. It supports specification of
 non utf-8 encodings too, so if you're stuck with text files in a different
-encoding, it can be passed as an argument. See the [`meson`
-object](Reference-manual.md#meson-object) documentation for details.
+encoding, it can be passed as an argument. See the [[@meson]]
+documentation for details.
 
 ## meson install --dry-run
 
diff --git a/docs/markdown/Release-notes-for-0.59.0.md b/docs/markdown/Release-notes-for-0.59.0.md
index a8fbc35..68f4451 100644
--- a/docs/markdown/Release-notes-for-0.59.0.md
+++ b/docs/markdown/Release-notes-for-0.59.0.md
@@ -195,9 +195,9 @@ executable(
 
 ## New `build target` methods
 
-The [`build target` object](Reference-manual.md#build-target-object) now supports
+The [[@build_tgt]] object now supports
 the following two functions, to ensure feature compatebility with
-[`external program` objects](Reference-manual.html#external-program-object):
+[[@external_program]] objects:
 
 - `found()`: Always returns `true`. This function is meant
   to make executables objects feature compatible with
diff --git a/docs/markdown/Rust-module.md b/docs/markdown/Rust-module.md
index b89c052..bbb2b5e 100644
--- a/docs/markdown/Rust-module.md
+++ b/docs/markdown/Rust-module.md
@@ -28,7 +28,7 @@ adding the `--test` argument to the compilation, then creates a new
 test target which calls that executable, using the rust test protocol.
 
 This accepts all of the keyword arguments as the
-[`test`](Reference-manual.md#test) function except `protocol`, it will set
+[[test]] function except `protocol`, it will set
 that automatically.
 
 Additional, test only dependencies may be passed via the dependencies
diff --git a/docs/markdown/Syntax.md b/docs/markdown/Syntax.md
index 04833e6..8f32765 100644
--- a/docs/markdown/Syntax.md
+++ b/docs/markdown/Syntax.md
@@ -159,7 +159,7 @@ joined = 'C:\\foo\\bar' / 'builddir'     # => C:/foo/bar/builddir
 joined = 'C:\\foo\\bar' / 'D:\\builddir' # => D:/builddir
 ```
 
-Note that this is equivalent to using [`join_paths()`](Reference-manual.md#join_paths),
+Note that this is equivalent to using [[join_paths]],
 which was obsoleted by this operator.
 
 ### Strings running over multiple lines
@@ -455,7 +455,7 @@ Dictionaries are immutable and do not have a guaranteed order.
 
 Dictionaries are available since 0.47.0.
 
-Visit the [Reference Manual](Reference-manual.md#dictionary-object) to read
+Visit the [[@dict]] objects page in the Reference Manual to read
 about the methods exposed by dictionaries.
 
 Since 0.49.0, you can check if a dictionary contains a key like this:
diff --git a/docs/markdown/Tutorial.md b/docs/markdown/Tutorial.md
index c1942c2..e78b8a0 100644
--- a/docs/markdown/Tutorial.md
+++ b/docs/markdown/Tutorial.md
@@ -160,7 +160,7 @@ executable('demo', 'main.c', dependencies : gtkdep)
 ```
 
 If your app needs to use multiple libraries, you need to use separate
-[`dependency()`](Reference-manual.md#dependency) calls for each, like so:
+[[dependency]] calls for each, like so:
 
 ```meson
 gtkdeps = [dependency('gtk+-3.0'), dependency('gtksourceview-3.0')]
diff --git a/docs/markdown/Unit-tests.md b/docs/markdown/Unit-tests.md
index c9856d4..c2cbc71 100644
--- a/docs/markdown/Unit-tests.md
+++ b/docs/markdown/Unit-tests.md
@@ -36,7 +36,7 @@ By default, environment variable
 [`MALLOC_PERTURB_`](http://man7.org/linux/man-pages/man3/mallopt.3.html) is
 set to a random value between 1..255. This can help find memory leaks on
 configurations using glibc, including with non-GCC compilers. This feature
-can be disabled as discussed in [test()](Reference-manual.md#test).
+can be disabled as discussed in [[test]].
 
 ## Coverage
 
diff --git a/docs/markdown/Vala.md b/docs/markdown/Vala.md
index 606cf0d..919e305 100644
--- a/docs/markdown/Vala.md
+++ b/docs/markdown/Vala.md
@@ -30,7 +30,7 @@ runtime type system.
 
 ## Using libraries
 
-Meson uses the [`dependency()`](Reference-manual.md#dependency)
+Meson uses the [[dependency]]
 function to find the relevant VAPI, C headers and linker flags when it
 encounters a Vala source file in a build target. Vala needs a VAPI
 file and a C header or headers to use a library. The VAPI file helps
@@ -39,7 +39,7 @@ map Vala code to the library's C programming interface. It is the
 tool that makes finding these installed files all work seamlessly
 behind the scenes. When a `pkg-config` file doesn't exist for the
 library then the `find_library()`
-method of the [compiler object](Reference-manual.md#compiler-object)
+method of the [[@compiler]] object
 needs to be used. Examples are given later.
 
 Note Vala uses libraries that follow the C Application Binary Interface (C ABI).
@@ -86,7 +86,7 @@ standard search path and so works just as seamlessly using the
 
 ### Targeting a version of GLib
 
-Meson's [`dependency()`](Reference-manual.md#dependency) function
+Meson's [[dependency]] function
 allows a version check of a library. This is often used to check a
 minimum version is installed. When setting a minimum version of GLib,
 Meson will also pass this to the Vala compiler using the
@@ -287,7 +287,7 @@ add_project_arguments('-DFUSE_USE_VERSION=26', language: 'c')
 
 ### Changing C header and VAPI names
 
-Meson's [`library`](Reference-manual.md#library) target automatically
+Meson's [[library]] target automatically
 outputs the C header and the VAPI. They can be renamed by setting the
 `vala_header` and `vala_vapi` arguments respectively:
 
diff --git a/docs/markdown/i18n-module.md b/docs/markdown/i18n-module.md
index 47ef88b..c0fba48 100644
--- a/docs/markdown/i18n-module.md
+++ b/docs/markdown/i18n-module.md
@@ -46,7 +46,7 @@ This function also defines targets for maintainers to use:
 ### i18n.merge_file()
 
 This merges translations into a text file using `msgfmt`. See
-[custom_target](Reference-manual.md#custom_target)
+[[@custom_tgt]]
 for normal keywords. In addition it accepts these keywords:
 
 * `data_dirs`: (*Added 0.41.0*) list of directories for its files (See