diff --git a/documentation/dev-manual/new-recipe.rst b/documentation/dev-manual/new-recipe.rst index 5f42dd4df..6888bb46a 100644 --- a/documentation/dev-manual/new-recipe.rst +++ b/documentation/dev-manual/new-recipe.rst @@ -837,7 +837,7 @@ different ways: - *systemd:* System Management Daemon (systemd) was designed to replace SysVinit and to provide enhanced management of services. For more information on systemd, see the systemd homepage at - https://freedesktop.org/wiki/Software/systemd/. + https://systemd.io/. To enable a service using systemd, your recipe needs to inherit the :ref:`ref-classes-systemd` class. See the ``systemd.bbclass`` file diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst index 4ea27fceb..8fa7f8f38 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst @@ -367,7 +367,7 @@ as your Yocto Project build host: Depending on your build host, you might have to install different software to support Docker containers. Go to the Docker installation page and read about the platform requirements in "`Supported - Platforms `__" + Platforms `__" your build host needs to run containers. #. *Choose What To Install:* Depending on whether or not your build host diff --git a/documentation/dev-manual/x32-psabi.rst b/documentation/dev-manual/x32-psabi.rst index 92b1f96fa..0a19d2823 100644 --- a/documentation/dev-manual/x32-psabi.rst +++ b/documentation/dev-manual/x32-psabi.rst @@ -3,8 +3,8 @@ Using x32 psABI *************** -x32 processor-specific Application Binary Interface (`x32 -psABI `__) is a native +x32 processor-specific Application Binary Interface (:wikipedia:`x32 +psABI `) is a native 32-bit processor-specific ABI for Intel 64 (x86-64) architectures. An ABI defines the calling conventions between functions in a processing environment. The interface determines what registers are used and what diff --git a/documentation/migration-guides/release-notes-5.3.rst b/documentation/migration-guides/release-notes-5.3.rst index 1655ca90f..fdc092e51 100644 --- a/documentation/migration-guides/release-notes-5.3.rst +++ b/documentation/migration-guides/release-notes-5.3.rst @@ -561,7 +561,7 @@ New Features / Enhancements in |yocto-ver| :term:`IMAGE_EXTRA_PARTITION_FILES` variable for more information. - The ``--diskid`` option was added to allow passing a :wikipedia:`MS-DOS - ` or :wikipedia:`GPT `-formatted + ` or :wikipedia:`GPT `-formatted disk IDs for a partition (for example: ``deadbeef-cafe-babe-f00d-cec2ea4eface``). - SDK-related changes: diff --git a/documentation/overview-manual/development-environment.rst b/documentation/overview-manual/development-environment.rst index e1bb8b15d..0daaf1c1a 100644 --- a/documentation/overview-manual/development-environment.rst +++ b/documentation/overview-manual/development-environment.rst @@ -350,7 +350,7 @@ commands. .. note:: - For more information on Git, see - https://git-scm.com/documentation. + https://git-scm.com/docs. - If you need to download Git, it is recommended that you add Git to your system through your distribution's "software store" (e.g. for @@ -474,7 +474,7 @@ you can manage with a small set of basic operations and workflows once you understand the basic philosophy behind Git. You do not have to be an expert in Git to be functional. A good place to look for instruction on a minimal set of Git commands is -`here `__. +`here `__. The following list of Git commands briefly describes some basic Git operations as a way to get started. As with any set of commands, this diff --git a/documentation/profile-manual/usage.rst b/documentation/profile-manual/usage.rst index d17b256d0..f8de6848e 100644 --- a/documentation/profile-manual/usage.rst +++ b/documentation/profile-manual/usage.rst @@ -39,7 +39,7 @@ other tools when it seems useful to do so. The coverage below details some of the most common ways you'll likely want to apply the tool; full documentation can be found either within the tool itself or in the manual pages at -`perf(1) `__. +:manpage:`perf(1)`. perf Setup ---------- @@ -869,8 +869,8 @@ goes a little way to support the idea mentioned previously that given the right kind of trace data, higher-level profiling-type summaries can be derived from it. -Documentation on using the `'perf script' Python -binding `__. +Documentation on using the :manpage:`'perf script' Python +binding `. System-Wide Tracing and Profiling ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1150,23 +1150,19 @@ perf Documentation Online versions of the manual pages for the commands discussed in this section can be found here: -- The `'perf stat' manual page `__. +- The :manpage:`'perf stat' manual page `. -- The `'perf record' - manual page `__. +- The :manpage:`'perf record' manual page `. -- The `'perf report' - manual page `__. +- The :manpage:`'perf report' manual page `. -- The `'perf probe' manual page `__. +- The :manpage:`'perf probe' manual page `. -- The `'perf script' - manual page `__. +- The :manpage:`'perf script' manual page `. -- Documentation on using the `'perf script' Python - binding `__. +- Documentation on using the :manpage:`'perf script' Python binding `. -- The top-level `perf(1) manual page `__. +- The top-level :manpage:`perf(1) manual page `. Normally, you should be able to open the manual pages via perf itself e.g. ``perf help`` or ``perf help record``. @@ -1781,7 +1777,7 @@ gather / print / aggregate data extracted from the context they end up being called under. For example, this probe from the `SystemTap -tutorial `__ just prints a +tutorial `__ just prints a line every time any process on the system runs ``open()`` on a file. For each line, it prints the executable name of the program that opened the file, along with its PID, and the name of the file it opened (or tried to open), which it @@ -1957,7 +1953,7 @@ SystemTap Documentation ----------------------- The SystemTap language reference can be found here: `SystemTap Language -Reference `__ +Reference `__ Links to other SystemTap documents, tutorials, and examples can be found here: `SystemTap documentation @@ -2388,7 +2384,7 @@ first part of the filenames:: The report shows each event that was found in the blktrace data, along with a summary of the overall block I/O traffic during the run. You can look at the -`blkparse `__ manual page to learn the +:manpage:`blkparse(1)` manual page to learn the meaning of each field displayed in the trace listing. Live Mode @@ -2588,14 +2584,14 @@ blktrace Documentation Online versions of the manual pages for the commands discussed in this section can be found here: -- https://linux.die.net/man/8/blktrace +- :manpage:`blktrace(8)` -- https://linux.die.net/man/1/blkparse +- :manpage:`blkparse(1)` -- https://linux.die.net/man/8/btrace +- :manpage:`btrace(8)` The above manual pages, along with manuals for the other blktrace utilities (``btt``, ``blkiomon``, etc) can be found in the ``/doc`` directory of the blktrace tools git repository:: - $ git clone git://git.kernel.dk/blktrace.git + $ git clone https://git.kernel.org/pub/scm/linux/kernel/git/axboe/blktrace.git diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 02ff36178..2622be14f 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -2844,7 +2844,7 @@ Python version 3.x extensions that use build systems based on ``setuptools`` ``pyproject.toml`` format). Unlike :ref:`ref-classes-setuptools3`, this uses the traditional ``setup.py`` ``build`` and ``install`` commands and not wheels. This use of ``setuptools`` like this is -`deprecated `__ +`deprecated `__ but still relatively common. .. _ref-classes-setuptools3-base: @@ -3100,7 +3100,7 @@ the :term:`SYSTEMD_BOOT_CFG`, :term:`SYSTEMD_BOOT_TIMEOUT` variables. You can also see the `Systemd-boot -documentation `__ +documentation `__ for more information. .. _ref-classes-terminal: diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 12d2e335c..c1abd8693 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -3786,7 +3786,7 @@ system and gives an overview of their function and contents. source $loadaddr#bootscr-boot.cmd More information can be found in the official U-Boot documentation: - `U-Boot source command `__ + `U-Boot source command `__ :term:`FONT_EXTRA_RDEPENDS` When inheriting the :ref:`ref-classes-fontcache` class, @@ -3953,7 +3953,7 @@ system and gives an overview of their function and contents. GROUPADD_PARAM:${PN} = "-g 880 group1; -g 890 group2" For information on the standard Linux shell command - ``groupadd``, see https://linux.die.net/man/8/groupadd. + ``groupadd``, see :manpage:`groupadd(8)`. :term:`GROUPMEMS_PARAM` Deprecated in favor of :term:`USERMOD_PARAMS`. See @@ -6436,7 +6436,7 @@ system and gives an overview of their function and contents. See the :term:`KERNEL_MODULE_AUTOLOAD` variable for more information. :term:`module_conf` - Specifies `modprobe.d `__ + Specifies :manpage:`modprobe.d(5)` syntax lines for inclusion in the ``/etc/modprobe.d/modname.conf`` file. @@ -12333,7 +12333,7 @@ system and gives an overview of their function and contents. For information on the standard Linux shell command ``useradd``, see - https://linux.die.net/man/8/useradd. + :manpage:`useradd(8)`. :term:`USERADD_UID_TABLES` Specifies a password file to use for obtaining static user diff --git a/documentation/ref-manual/yocto-project-supported-features.rst b/documentation/ref-manual/yocto-project-supported-features.rst index 021fca36b..d7229f1c2 100644 --- a/documentation/ref-manual/yocto-project-supported-features.rst +++ b/documentation/ref-manual/yocto-project-supported-features.rst @@ -72,7 +72,7 @@ Below is a list of primary tested features, their maintainer(s) and builder(s): - Buildtools generation - Collective effort - buildtools - * - `meta-agl-core `__ + * - `meta-agl-core `__ - meta-agl-core layer testing - TBD - meta-agl-core