diff options
Diffstat (limited to 'doc')
100 files changed, 381 insertions, 60 deletions
diff --git a/doc/conf.py b/doc/conf.py index 5e2ff1c8f5..c9138a5a5d 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -228,7 +228,7 @@ highlight_language = 'none' try: import sphinx_rtd_theme html_theme = 'sphinx_rtd_theme' - html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] + extensions.append('sphinx_rtd_theme') except ImportError: sys.stderr.write('Warning: The Sphinx \'sphinx_rtd_theme\' HTML theme was not found. Make sure you have the theme installed to produce pretty HTML output. Falling back to the default theme.\n') diff --git a/doc/genindex.rst b/doc/genindex.rst new file mode 100644 index 0000000000..2e452cb8f5 --- /dev/null +++ b/doc/genindex.rst @@ -0,0 +1,4 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later + +Index +===== diff --git a/doc/index.rst b/doc/index.rst index 57b42c68e4..43398627d8 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -99,4 +99,7 @@ Chromium OS-specific doc Indices and tables ================== -* :ref:`genindex` +.. toctree:: + :maxdepth: 1 + + genindex diff --git a/doc/sphinx-static/theme_overrides.css b/doc/sphinx-static/theme_overrides.css index 522b6d4c49..02e1151815 100644 --- a/doc/sphinx-static/theme_overrides.css +++ b/doc/sphinx-static/theme_overrides.css @@ -1,9 +1,41 @@ /* -*- coding: utf-8; mode: css -*- * * Sphinx HTML theme customization: read the doc - * + * Please don't add any color definition here, as the theme should + * work for both normal and dark modes. */ +@import 'css/theme.css'; +@import 'pygments.css'; + +/* Improve contrast and increase size for easier reading. */ + +body { + font-family: sans-serif; + font-size: 100%; +} + +h1, h2, .rst-content .toctree-wrapper p.caption, h3, h4, h5, h6, legend { + font-family: sans-serif; +} + +div[class^="highlight"] pre { + font-family: monospace; + font-size: 100%; +} + +.wy-menu-vertical { + font-family: sans-serif; +} + +.c { + font-style: normal; +} + +p { + font-size: 100%; +} + /* Interim: Code-blocks with line nos - lines and line numbers don't line up. * see: https://github.com/rtfd/sphinx_rtd_theme/issues/419 */ @@ -15,6 +47,16 @@ div[class^="highlight"] pre { line-height: normal; } +/* Keep fields from being strangely far apart due to inheirited table CSS. */ +.rst-content table.field-list th.field-name { + padding-top: 1px; + padding-bottom: 1px; +} +.rst-content table.field-list td.field-body { + padding-top: 1px; + padding-bottom: 1px; +} + @media screen { /* content column @@ -56,13 +98,10 @@ div[class^="highlight"] pre { /* Menu selection and keystrokes */ span.menuselection { - color: blue; font-family: "Courier New", Courier, monospace } code.kbd, code.kbd span { - color: white; - background-color: darkblue; font-weight: bold; font-family: "Courier New", Courier, monospace } diff --git a/doc/sphinx/kerneldoc.py b/doc/sphinx/kerneldoc.py index 8189c33b9d..01a55429c5 100644 --- a/doc/sphinx/kerneldoc.py +++ b/doc/sphinx/kerneldoc.py @@ -138,7 +138,7 @@ class KernelDocDirective(Directive): lineoffset = int(match.group(1)) - 1 # we must eat our comments since the upset the markup else: - doc = env.srcdir + "/" + env.docname + ":" + str(self.lineno) + doc = str(env.srcdir) + "/" + env.docname + ":" + str(self.lineno) result.append(line, doc + ": " + filename, lineoffset) lineoffset += 1 diff --git a/doc/sphinx/kfigure.py b/doc/sphinx/kfigure.py index 788704886e..dea7f91ef5 100644 --- a/doc/sphinx/kfigure.py +++ b/doc/sphinx/kfigure.py @@ -266,7 +266,7 @@ def convert_image(img_node, translator, src_fname=None): if dst_fname: # the builder needs not to copy one more time, so pop it if exists. translator.builder.images.pop(img_node['uri'], None) - _name = dst_fname[len(translator.builder.outdir) + 1:] + _name = dst_fname[len(str(translator.builder.outdir)) + 1:] if isNewer(dst_fname, src_fname): kernellog.verbose(app, diff --git a/doc/sphinx/requirements.txt b/doc/sphinx/requirements.txt index 39ececb96c..840c6cedfd 100644 --- a/doc/sphinx/requirements.txt +++ b/doc/sphinx/requirements.txt @@ -1,26 +1,25 @@ -alabaster==0.7.12 -Babel==2.9.1 -certifi==2023.07.22 -charset-normalizer==2.0.12 -docutils==0.16 -idna==3.3 -imagesize==1.3.0 -Jinja2==3.0.3 -MarkupSafe==2.1.1 -packaging==21.3 -Pygments==2.15.1 -pyparsing==3.0.7 -pytz==2023.3 +alabaster==0.7.16 +Babel==2.14.0 +certifi==2023.11.17 +charset-normalizer==3.3.2 +docutils==0.20.1 +idna==3.6 +imagesize==1.4.1 +Jinja2==3.1.3 +MarkupSafe==2.1.3 +packaging==23.2 +Pygments==2.17.2 requests==2.31.0 six==1.16.0 snowballstemmer==2.2.0 -Sphinx==3.4.3 -sphinx-prompt==1.5.0 -sphinx-rtd-theme==1.0.0 -sphinxcontrib-applehelp==1.0.2 -sphinxcontrib-devhelp==1.0.2 -sphinxcontrib-htmlhelp==2.0.0 +Sphinx==7.2.6 +sphinx-prompt==1.8.0 +sphinx-rtd-theme==2.0.0 +sphinxcontrib-applehelp==1.0.8 +sphinxcontrib-devhelp==1.0.6 +sphinxcontrib-htmlhelp==2.0.5 +sphinxcontrib-jquery==4.1 sphinxcontrib-jsmath==1.0.1 -sphinxcontrib-qthelp==1.0.3 -sphinxcontrib-serializinghtml==1.1.5 -urllib3==2.0.7 +sphinxcontrib-qthelp==1.0.7 +sphinxcontrib-serializinghtml==1.1.10 +urllib3==2.1.0 diff --git a/doc/usage/cmd/acpi.rst b/doc/usage/cmd/acpi.rst index 6b9b8949f3..a630f1ec5e 100644 --- a/doc/usage/cmd/acpi.rst +++ b/doc/usage/cmd/acpi.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: acpi (command) + acpi command ============ diff --git a/doc/usage/cmd/addrmap.rst b/doc/usage/cmd/addrmap.rst index 472fd547f3..6d0dbceefe 100644 --- a/doc/usage/cmd/addrmap.rst +++ b/doc/usage/cmd/addrmap.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: addrmap (command) + addrmap command =============== diff --git a/doc/usage/cmd/armffa.rst b/doc/usage/cmd/armffa.rst index 13fa90c129..4f41e3393f 100644 --- a/doc/usage/cmd/armffa.rst +++ b/doc/usage/cmd/armffa.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2022-2023 Arm Limited and/or its affiliates <open-source-office@arm.com> +.. index:: + single: armffa (command) + armffa command ============== diff --git a/doc/usage/cmd/askenv.rst b/doc/usage/cmd/askenv.rst index b85ceface1..e2b3c5379a 100644 --- a/doc/usage/cmd/askenv.rst +++ b/doc/usage/cmd/askenv.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: askenv (command) + askenv command ============== diff --git a/doc/usage/cmd/base.rst b/doc/usage/cmd/base.rst index db9cd4d978..0d030a1d1e 100644 --- a/doc/usage/cmd/base.rst +++ b/doc/usage/cmd/base.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: base (command) + base command ============ diff --git a/doc/usage/cmd/bdinfo.rst b/doc/usage/cmd/bdinfo.rst index 5261085a06..a21fbc83cc 100644 --- a/doc/usage/cmd/bdinfo.rst +++ b/doc/usage/cmd/bdinfo.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2023, Heinrich Schuchardt <heinrich.schuchardt@canonical.com> +.. index:: + single: bdinfo (command) + bdinfo command ============== diff --git a/doc/usage/cmd/bind.rst b/doc/usage/cmd/bind.rst index 1a5cffcb72..2345778366 100644 --- a/doc/usage/cmd/bind.rst +++ b/doc/usage/cmd/bind.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: bind (command) + bind command ============ diff --git a/doc/usage/cmd/blkcache.rst b/doc/usage/cmd/blkcache.rst index d3b2254cfa..0329261ba9 100644 --- a/doc/usage/cmd/blkcache.rst +++ b/doc/usage/cmd/blkcache.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2023, Heinrich Schuchardt <heinrich.schuchardt@canonical.com> +.. index:: + single: blkcache (command) + blkcache command ================ diff --git a/doc/usage/cmd/bootd.rst b/doc/usage/cmd/bootd.rst index 380ef15283..619cfb601a 100644 --- a/doc/usage/cmd/bootd.rst +++ b/doc/usage/cmd/bootd.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: bootd (command) + bootd command ============= diff --git a/doc/usage/cmd/bootdev.rst b/doc/usage/cmd/bootdev.rst index fb638b5807..658020e7c7 100644 --- a/doc/usage/cmd/bootdev.rst +++ b/doc/usage/cmd/bootdev.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: bootdev (command) + bootdev command =============== diff --git a/doc/usage/cmd/bootefi.rst b/doc/usage/cmd/bootefi.rst index cb03df4e1c..3efe9e9df5 100644 --- a/doc/usage/cmd/bootefi.rst +++ b/doc/usage/cmd/bootefi.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2020, Heinrich Schuchardt <xypron.glpk@gmx.de> +.. index:: + single: bootefi (command) + bootefi command =============== diff --git a/doc/usage/cmd/bootflow.rst b/doc/usage/cmd/bootflow.rst index 27e1330ad8..16ba986dc8 100644 --- a/doc/usage/cmd/bootflow.rst +++ b/doc/usage/cmd/bootflow.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: bootflow (command) + bootflow command ================ diff --git a/doc/usage/cmd/booti.rst b/doc/usage/cmd/booti.rst index d631fb571d..313efb83cc 100644 --- a/doc/usage/cmd/booti.rst +++ b/doc/usage/cmd/booti.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: booti (command) + booti command ============= diff --git a/doc/usage/cmd/bootm.rst b/doc/usage/cmd/bootm.rst index a7e5f6ce69..e409ebc193 100644 --- a/doc/usage/cmd/bootm.rst +++ b/doc/usage/cmd/bootm.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: bootm (command) + bootm command ============= diff --git a/doc/usage/cmd/bootmenu.rst b/doc/usage/cmd/bootmenu.rst index 684a18d8e1..294cc02b17 100644 --- a/doc/usage/cmd/bootmenu.rst +++ b/doc/usage/cmd/bootmenu.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. (C) Copyright 2011-2012 Pali Rohár <pali@kernel.org> +.. index:: + single: bootmenu (command) + bootmenu command ================ diff --git a/doc/usage/cmd/bootmeth.rst b/doc/usage/cmd/bootmeth.rst index f632d74e1d..95651fdc7c 100644 --- a/doc/usage/cmd/bootmeth.rst +++ b/doc/usage/cmd/bootmeth.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: bootmeth (command) + bootmeth command ================ diff --git a/doc/usage/cmd/bootz.rst b/doc/usage/cmd/bootz.rst index 78953e9ca2..b85875adde 100644 --- a/doc/usage/cmd/bootz.rst +++ b/doc/usage/cmd/bootz.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: bootz (command) + bootz command ============= diff --git a/doc/usage/cmd/button.rst b/doc/usage/cmd/button.rst index ea41762757..6c6794f31b 100644 --- a/doc/usage/cmd/button.rst +++ b/doc/usage/cmd/button.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: button (command) + button command ============== diff --git a/doc/usage/cmd/cat.rst b/doc/usage/cmd/cat.rst index 5aaf497f27..b22dc6184a 100644 --- a/doc/usage/cmd/cat.rst +++ b/doc/usage/cmd/cat.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: cat (command) + cat command =========== diff --git a/doc/usage/cmd/cedit.rst b/doc/usage/cmd/cedit.rst index f415b48699..b39d708281 100644 --- a/doc/usage/cmd/cedit.rst +++ b/doc/usage/cmd/cedit.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: cedit (command) + cedit command ============= diff --git a/doc/usage/cmd/cli.rst b/doc/usage/cmd/cli.rst index a0cf5958fb..81487722f6 100644 --- a/doc/usage/cmd/cli.rst +++ b/doc/usage/cmd/cli.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: cli (command) + cli command =========== diff --git a/doc/usage/cmd/cls.rst b/doc/usage/cmd/cls.rst index b5c43e0a2e..828276742b 100644 --- a/doc/usage/cmd/cls.rst +++ b/doc/usage/cmd/cls.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: cls (command) + cls command =========== diff --git a/doc/usage/cmd/cmp.rst b/doc/usage/cmd/cmp.rst index 66865ebd7e..a383074736 100644 --- a/doc/usage/cmd/cmp.rst +++ b/doc/usage/cmd/cmp.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: cmp (command) + cmp command =========== diff --git a/doc/usage/cmd/coninfo.rst b/doc/usage/cmd/coninfo.rst index 76cb6c3329..a66cf90a27 100644 --- a/doc/usage/cmd/coninfo.rst +++ b/doc/usage/cmd/coninfo.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: coninfo (command) + coninfo command =============== diff --git a/doc/usage/cmd/conitrace.rst b/doc/usage/cmd/conitrace.rst index d9916c865e..38ec66ad52 100644 --- a/doc/usage/cmd/conitrace.rst +++ b/doc/usage/cmd/conitrace.rst @@ -1,3 +1,6 @@ +.. index:: + single: conitrace (command) + conitrace command ================= diff --git a/doc/usage/cmd/cp.rst b/doc/usage/cmd/cp.rst index bea379ff36..434dfedfc2 100644 --- a/doc/usage/cmd/cp.rst +++ b/doc/usage/cmd/cp.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: cp (command) + cp command ========== diff --git a/doc/usage/cmd/cyclic.rst b/doc/usage/cmd/cyclic.rst index 3085cc7204..ac1e4c663b 100644 --- a/doc/usage/cmd/cyclic.rst +++ b/doc/usage/cmd/cyclic.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: cyclic (command) + cyclic command ============== diff --git a/doc/usage/cmd/dm.rst b/doc/usage/cmd/dm.rst index 12b7edeed6..9bef2eeaed 100644 --- a/doc/usage/cmd/dm.rst +++ b/doc/usage/cmd/dm.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: dm (command) + dm command ========== diff --git a/doc/usage/cmd/ebtupdate.rst b/doc/usage/cmd/ebtupdate.rst index d90474ccec..22415ee07b 100644 --- a/doc/usage/cmd/ebtupdate.rst +++ b/doc/usage/cmd/ebtupdate.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: ebtupdate (command) + ebtupdate command ================= diff --git a/doc/usage/cmd/echo.rst b/doc/usage/cmd/echo.rst index 861abdfd1e..ebc9ff5f84 100644 --- a/doc/usage/cmd/echo.rst +++ b/doc/usage/cmd/echo.rst @@ -1,3 +1,6 @@ +.. index:: + single: echo (command) + echo command ============ diff --git a/doc/usage/cmd/efi.rst b/doc/usage/cmd/efi.rst index ef37ff2f4c..b19d36188a 100644 --- a/doc/usage/cmd/efi.rst +++ b/doc/usage/cmd/efi.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2020, Heinrich Schuchardt <xypron.glpk@gmx.de> +.. index:: + single: efi (command) + efi command =========== diff --git a/doc/usage/cmd/eficonfig.rst b/doc/usage/cmd/eficonfig.rst index 30eb72bfd0..83a3ebf4f0 100644 --- a/doc/usage/cmd/eficonfig.rst +++ b/doc/usage/cmd/eficonfig.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. (C) Copyright 2022, Masahisa Kojima <masahisa.kojima@linaro.org> +.. index:: + single: eficonfig (command) + eficonfig command ================= diff --git a/doc/usage/cmd/env.rst b/doc/usage/cmd/env.rst index 1bebfa4e71..a859e32798 100644 --- a/doc/usage/cmd/env.rst +++ b/doc/usage/cmd/env.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0-or-later: +.. index:: + single: env (command) + env command =========== diff --git a/doc/usage/cmd/event.rst b/doc/usage/cmd/event.rst index 47c900d17e..5c5e304373 100644 --- a/doc/usage/cmd/event.rst +++ b/doc/usage/cmd/event.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: event (command) + event command ============= diff --git a/doc/usage/cmd/exception.rst b/doc/usage/cmd/exception.rst index 27df88bd5c..9cb492d604 100644 --- a/doc/usage/cmd/exception.rst +++ b/doc/usage/cmd/exception.rst @@ -1,3 +1,6 @@ +.. index:: + single: exception (command) + exception command ================= diff --git a/doc/usage/cmd/exit.rst b/doc/usage/cmd/exit.rst index 3edb12809c..2f250bf4bd 100644 --- a/doc/usage/cmd/exit.rst +++ b/doc/usage/cmd/exit.rst @@ -1,3 +1,6 @@ +.. index:: + single: exit (command) + exit command ============ diff --git a/doc/usage/cmd/extension.rst b/doc/usage/cmd/extension.rst index 6366cf56e7..4c261e7495 100644 --- a/doc/usage/cmd/extension.rst +++ b/doc/usage/cmd/extension.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2021, Kory Maincent <kory.maincent@bootlin.com> +.. index:: + single: extension (command) + extension command ================= diff --git a/doc/usage/cmd/false.rst b/doc/usage/cmd/false.rst index a17fe86021..510377e22c 100644 --- a/doc/usage/cmd/false.rst +++ b/doc/usage/cmd/false.rst @@ -1,3 +1,6 @@ +.. index:: + single: false (command) + false command ============= diff --git a/doc/usage/cmd/fatinfo.rst b/doc/usage/cmd/fatinfo.rst index af2eba4344..2e05ab8bec 100644 --- a/doc/usage/cmd/fatinfo.rst +++ b/doc/usage/cmd/fatinfo.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: fatinfo (command) + fatinfo command =============== diff --git a/doc/usage/cmd/fatload.rst b/doc/usage/cmd/fatload.rst index 93acb27a53..6c048b7bda 100644 --- a/doc/usage/cmd/fatload.rst +++ b/doc/usage/cmd/fatload.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: fatload (command) + fatload command =============== diff --git a/doc/usage/cmd/fdt.rst b/doc/usage/cmd/fdt.rst index 36b8230877..3e8c32cdea 100644 --- a/doc/usage/cmd/fdt.rst +++ b/doc/usage/cmd/fdt.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: fdt (command) + fdt command =========== diff --git a/doc/usage/cmd/font.rst b/doc/usage/cmd/font.rst index 8ba149d759..adcd5126d0 100644 --- a/doc/usage/cmd/font.rst +++ b/doc/usage/cmd/font.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: font (command) + font command ============ diff --git a/doc/usage/cmd/for.rst b/doc/usage/cmd/for.rst index f9e504979c..4c98419b28 100644 --- a/doc/usage/cmd/for.rst +++ b/doc/usage/cmd/for.rst @@ -1,3 +1,6 @@ +.. index:: + single: for (command) + for command =========== diff --git a/doc/usage/cmd/fwu_mdata.rst b/doc/usage/cmd/fwu_mdata.rst index ea3c22724a..f1bf08fde1 100644 --- a/doc/usage/cmd/fwu_mdata.rst +++ b/doc/usage/cmd/fwu_mdata.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: fwu_mdata_read (command) + fwu_mdata_read command ====================== diff --git a/doc/usage/cmd/gpio.rst b/doc/usage/cmd/gpio.rst index ee902138f1..4b0dc2716e 100644 --- a/doc/usage/cmd/gpio.rst +++ b/doc/usage/cmd/gpio.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: gpio (command) + gpio command ============ diff --git a/doc/usage/cmd/gpt.rst b/doc/usage/cmd/gpt.rst index cbbe44ab58..8534f78cba 100644 --- a/doc/usage/cmd/gpt.rst +++ b/doc/usage/cmd/gpt.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: gpt (command) + gpt command =========== diff --git a/doc/usage/cmd/history.rst b/doc/usage/cmd/history.rst index 33d3fcd624..564a159665 100644 --- a/doc/usage/cmd/history.rst +++ b/doc/usage/cmd/history.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: history (command) + history command =============== diff --git a/doc/usage/cmd/host.rst b/doc/usage/cmd/host.rst index e14508986c..072497db90 100644 --- a/doc/usage/cmd/host.rst +++ b/doc/usage/cmd/host.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: host (command) + host command ============ diff --git a/doc/usage/cmd/imxtract.rst b/doc/usage/cmd/imxtract.rst index 16be60b4aa..235d15e445 100644 --- a/doc/usage/cmd/imxtract.rst +++ b/doc/usage/cmd/imxtract.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: imxtract (command) + imxtract command ================ diff --git a/doc/usage/cmd/load.rst b/doc/usage/cmd/load.rst index 2c892ee1cb..bfa45c6f36 100644 --- a/doc/usage/cmd/load.rst +++ b/doc/usage/cmd/load.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: load (command) + load command ============ diff --git a/doc/usage/cmd/loadb.rst b/doc/usage/cmd/loadb.rst index 0464b1f41c..4f9a52c793 100644 --- a/doc/usage/cmd/loadb.rst +++ b/doc/usage/cmd/loadb.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: loadb (command) + loadb command ============= diff --git a/doc/usage/cmd/loadm.rst b/doc/usage/cmd/loadm.rst index b657114043..005840a27b 100644 --- a/doc/usage/cmd/loadm.rst +++ b/doc/usage/cmd/loadm.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: loadm (command) + loadm command ============= diff --git a/doc/usage/cmd/loads.rst b/doc/usage/cmd/loads.rst index e4cb063df6..0a2ac14acf 100644 --- a/doc/usage/cmd/loads.rst +++ b/doc/usage/cmd/loads.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: loads (command) + loads command ============= diff --git a/doc/usage/cmd/loadx.rst b/doc/usage/cmd/loadx.rst index facca9b969..661b36723c 100644 --- a/doc/usage/cmd/loadx.rst +++ b/doc/usage/cmd/loadx.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: loadx (command) + loadx command ============= diff --git a/doc/usage/cmd/loady.rst b/doc/usage/cmd/loady.rst index 3f8227ecf2..8367759471 100644 --- a/doc/usage/cmd/loady.rst +++ b/doc/usage/cmd/loady.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: loady (command) + loady command ============= diff --git a/doc/usage/cmd/mbr.rst b/doc/usage/cmd/mbr.rst index bddf2f612a..925a118105 100644 --- a/doc/usage/cmd/mbr.rst +++ b/doc/usage/cmd/mbr.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: mbr (command) + mbr command =========== diff --git a/doc/usage/cmd/md.rst b/doc/usage/cmd/md.rst index 7e9944e0dc..9ea148a8dc 100644 --- a/doc/usage/cmd/md.rst +++ b/doc/usage/cmd/md.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: md (command) + md command ========== diff --git a/doc/usage/cmd/mmc.rst b/doc/usage/cmd/mmc.rst index 8394f647e8..5a64400eea 100644 --- a/doc/usage/cmd/mmc.rst +++ b/doc/usage/cmd/mmc.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: mmc (command) + mmc command =========== diff --git a/doc/usage/cmd/mtest.rst b/doc/usage/cmd/mtest.rst index 81d1f8fd1b..e01f2a6d57 100644 --- a/doc/usage/cmd/mtest.rst +++ b/doc/usage/cmd/mtest.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2022, Heinrich Schuchardt <xypron.glpk@gmx.de> +.. index:: + single: mtest (command) + mtest command ============= diff --git a/doc/usage/cmd/mtrr.rst b/doc/usage/cmd/mtrr.rst index 531153bb3e..c65618950b 100644 --- a/doc/usage/cmd/mtrr.rst +++ b/doc/usage/cmd/mtrr.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: mtrr (command) + mtrr command ============ diff --git a/doc/usage/cmd/panic.rst b/doc/usage/cmd/panic.rst index 115eba5bde..ba5ea62610 100644 --- a/doc/usage/cmd/panic.rst +++ b/doc/usage/cmd/panic.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: panic (command) + panic command ============= diff --git a/doc/usage/cmd/part.rst b/doc/usage/cmd/part.rst index eee5225cad..58be38781e 100644 --- a/doc/usage/cmd/part.rst +++ b/doc/usage/cmd/part.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: part (command) + part command ============ diff --git a/doc/usage/cmd/pause.rst b/doc/usage/cmd/pause.rst index c79e399c02..6cdd83d316 100644 --- a/doc/usage/cmd/pause.rst +++ b/doc/usage/cmd/pause.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0-or-later: +.. index:: + single: pause (command) + pause command ============= diff --git a/doc/usage/cmd/pinmux.rst b/doc/usage/cmd/pinmux.rst index 9f4392cd0d..30c5eb16a6 100644 --- a/doc/usage/cmd/pinmux.rst +++ b/doc/usage/cmd/pinmux.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: pinmux (command) + pinmux command ============== diff --git a/doc/usage/cmd/printenv.rst b/doc/usage/cmd/printenv.rst index d4184fd65e..dfdb362493 100644 --- a/doc/usage/cmd/printenv.rst +++ b/doc/usage/cmd/printenv.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: printenv (command) + printenv command ================ diff --git a/doc/usage/cmd/pstore.rst b/doc/usage/cmd/pstore.rst index 1c8374513a..63a437135e 100644 --- a/doc/usage/cmd/pstore.rst +++ b/doc/usage/cmd/pstore.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: pstore (command) + pstore command ============== diff --git a/doc/usage/cmd/qfw.rst b/doc/usage/cmd/qfw.rst index e734b26671..40770acb3c 100644 --- a/doc/usage/cmd/qfw.rst +++ b/doc/usage/cmd/qfw.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: qfw (command) + qfw command =========== diff --git a/doc/usage/cmd/reset.rst b/doc/usage/cmd/reset.rst index 384d5d60f8..126db21cdb 100644 --- a/doc/usage/cmd/reset.rst +++ b/doc/usage/cmd/reset.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: reset (command) + reset command ============= diff --git a/doc/usage/cmd/rng.rst b/doc/usage/cmd/rng.rst index 1a352da41a..274e4d88df 100644 --- a/doc/usage/cmd/rng.rst +++ b/doc/usage/cmd/rng.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: rng (command) + rng command =========== diff --git a/doc/usage/cmd/saves.rst b/doc/usage/cmd/saves.rst index 5823f88379..b380a4feb6 100644 --- a/doc/usage/cmd/saves.rst +++ b/doc/usage/cmd/saves.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: saves (command) + saves command ============= diff --git a/doc/usage/cmd/sbi.rst b/doc/usage/cmd/sbi.rst index 713e0b9c81..5492925a8b 100644 --- a/doc/usage/cmd/sbi.rst +++ b/doc/usage/cmd/sbi.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: sbi (command) + sbi command =========== diff --git a/doc/usage/cmd/scmi.rst b/doc/usage/cmd/scmi.rst index 9ea7e0e41d..9591cdc07a 100644 --- a/doc/usage/cmd/scmi.rst +++ b/doc/usage/cmd/scmi.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: scmi (command) + scmi command ============ diff --git a/doc/usage/cmd/scp03.rst b/doc/usage/cmd/scp03.rst index 7ff87ed85a..5fdddb3e81 100644 --- a/doc/usage/cmd/scp03.rst +++ b/doc/usage/cmd/scp03.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: scp03 (command) + scp03 command ============= diff --git a/doc/usage/cmd/seama.rst b/doc/usage/cmd/seama.rst index 356c00a723..17fd559f48 100644 --- a/doc/usage/cmd/seama.rst +++ b/doc/usage/cmd/seama.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: seama (command) + seama command ============= diff --git a/doc/usage/cmd/setexpr.rst b/doc/usage/cmd/setexpr.rst index 4d19fa340d..d245a13ca8 100644 --- a/doc/usage/cmd/setexpr.rst +++ b/doc/usage/cmd/setexpr.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: setexpr (command) + setexpr command =============== diff --git a/doc/usage/cmd/sf.rst b/doc/usage/cmd/sf.rst index 71bd1be517..24d5dc692d 100644 --- a/doc/usage/cmd/sf.rst +++ b/doc/usage/cmd/sf.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: sf (command) + sf command ========== diff --git a/doc/usage/cmd/size.rst b/doc/usage/cmd/size.rst index f0c35e4826..306fcba0ba 100644 --- a/doc/usage/cmd/size.rst +++ b/doc/usage/cmd/size.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: size (command) + size command ============ diff --git a/doc/usage/cmd/sleep.rst b/doc/usage/cmd/sleep.rst index d19e5b3af8..a372e4da0e 100644 --- a/doc/usage/cmd/sleep.rst +++ b/doc/usage/cmd/sleep.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2023, Heinrich Schuchardt <heinrich.schuchardt@canonical.com> +.. index:: + single: sleep (command) + sleep command ============= diff --git a/doc/usage/cmd/sm.rst b/doc/usage/cmd/sm.rst index f6524a1c2e..b767647d77 100644 --- a/doc/usage/cmd/sm.rst +++ b/doc/usage/cmd/sm.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: sm (command) + sm command ========== diff --git a/doc/usage/cmd/sound.rst b/doc/usage/cmd/sound.rst index 2cfe9b7ad1..97d610f374 100644 --- a/doc/usage/cmd/sound.rst +++ b/doc/usage/cmd/sound.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2022, Heinrich Schuchardt <xypron.glpk@gmx.de> +.. index:: + single: sound (command) + sound command ============= diff --git a/doc/usage/cmd/source.rst b/doc/usage/cmd/source.rst index 697f644745..0de5f33390 100644 --- a/doc/usage/cmd/source.rst +++ b/doc/usage/cmd/source.rst @@ -1,6 +1,9 @@ .. SPDX-License-Identifier: GPL-2.0+ .. Copyright 2022, Heinrich Schuchardt <xypron.glpk@gmx.de> +.. index:: + single: source (command) + source command ============== diff --git a/doc/usage/cmd/temperature.rst b/doc/usage/cmd/temperature.rst index a5144ec50f..945bc8204a 100644 --- a/doc/usage/cmd/temperature.rst +++ b/doc/usage/cmd/temperature.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0-or-later +.. index:: + single: temperature (command) + temperature command =================== diff --git a/doc/usage/cmd/tftpput.rst b/doc/usage/cmd/tftpput.rst index 52ba7b179a..351c9faa38 100644 --- a/doc/usage/cmd/tftpput.rst +++ b/doc/usage/cmd/tftpput.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: tftpput (command) + tftpput command =============== diff --git a/doc/usage/cmd/trace.rst b/doc/usage/cmd/trace.rst index 3bdf4f0a86..ad6db12394 100644 --- a/doc/usage/cmd/trace.rst +++ b/doc/usage/cmd/trace.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: trace (command) + trace command ============= diff --git a/doc/usage/cmd/true.rst b/doc/usage/cmd/true.rst index f9ef71b2d1..adf641386b 100644 --- a/doc/usage/cmd/true.rst +++ b/doc/usage/cmd/true.rst @@ -1,3 +1,6 @@ +.. index:: + single: true (command) + true command ============ diff --git a/doc/usage/cmd/ums.rst b/doc/usage/cmd/ums.rst index 3cde5fa1f2..9d379e3c82 100644 --- a/doc/usage/cmd/ums.rst +++ b/doc/usage/cmd/ums.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+ +.. index:: + single: ums (command) + ums command =========== diff --git a/doc/usage/cmd/unbind.rst b/doc/usage/cmd/unbind.rst index 594e4f0689..0309e90f6e 100644 --- a/doc/usage/cmd/unbind.rst +++ b/doc/usage/cmd/unbind.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: unbind (command) + unbind command ============== diff --git a/doc/usage/cmd/ut.rst b/doc/usage/cmd/ut.rst index a3039634f2..ddc48ec42d 100644 --- a/doc/usage/cmd/ut.rst +++ b/doc/usage/cmd/ut.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: ut (command) + ut command ========== diff --git a/doc/usage/cmd/wdt.rst b/doc/usage/cmd/wdt.rst index 8bb8b36178..f48b884090 100644 --- a/doc/usage/cmd/wdt.rst +++ b/doc/usage/cmd/wdt.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: wdt (command) + wdt command =========== diff --git a/doc/usage/cmd/wget.rst b/doc/usage/cmd/wget.rst index 8e7383b6c6..b8ca35bb14 100644 --- a/doc/usage/cmd/wget.rst +++ b/doc/usage/cmd/wget.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: wget (command) + wget command ============ diff --git a/doc/usage/cmd/write.rst b/doc/usage/cmd/write.rst index c16870d6dc..f42dc003dd 100644 --- a/doc/usage/cmd/write.rst +++ b/doc/usage/cmd/write.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0-or-later: +.. index:: + single: write (command) + write command ============= diff --git a/doc/usage/cmd/xxd.rst b/doc/usage/cmd/xxd.rst index 13bb4389cc..f010a9dbb4 100644 --- a/doc/usage/cmd/xxd.rst +++ b/doc/usage/cmd/xxd.rst @@ -1,5 +1,8 @@ .. SPDX-License-Identifier: GPL-2.0+: +.. index:: + single: xxd (command) + xxd command =========== diff --git a/doc/usage/dfu.rst b/doc/usage/dfu.rst index 8845a71df3..8cc09c308d 100644 --- a/doc/usage/dfu.rst +++ b/doc/usage/dfu.rst @@ -6,11 +6,11 @@ Device Firmware Upgrade (DFU) Overview -------- -The Device Firmware Upgrade (DFU) allows to download and upload firmware -to/from U-Boot connected over USB. +Device Firmware Upgrade (DFU) enables the download and upload of firmware +to/from U-Boot while connected over USB. U-Boot follows the Universal Serial Bus Device Class Specification for -Device Firmware Upgrade Version 1.1 the USB forum (DFU v1.1 in www.usb.org). +Device Firmware Upgrade Version 1.1 from the USB forum (DFU v1.1 in www.usb.org). U-Boot implements this DFU capability (CONFIG_DFU) with the command dfu (cmd/dfu.c / CONFIG_CMD_DFU) based on: @@ -43,7 +43,7 @@ target (for example OTP), only based on the weak functions: Configuration Options --------------------- -The following configuration option are relevant for device firmware upgrade: +The following configuration options are relevant to device firmware upgrade: * CONFIG_DFU * CONFIG_DFU_OVER_USB @@ -60,7 +60,7 @@ The following configuration option are relevant for device firmware upgrade: Environment variables --------------------- -The dfu command uses 3 environments variables: +The dfu command uses 3 environment variables: dfu_alt_info The DFU setting for the USB download gadget with a semicolon separated @@ -90,17 +90,17 @@ Commands -------- dfu <USB_controller> [<interface> <dev>] list - list the alternate device defined in *dfu_alt_info* + List the alternate device defined in *dfu_alt_info*. dfu <USB_controller> [<interface> <dev>] [<timeout>] - start the dfu stack on the USB instance with the selected medium + Start the dfu stack on the USB instance with the selected medium backend and use the *dfu_alt_info* variable to configure the - alternate setting and link each one with the medium - The dfu command continue until receive a ^C in console or - a DFU detach transaction from HOST. If CONFIG_DFU_TIMEOUT option - is enabled and <timeout> parameter is present in the command line, + alternate setting and link each one with the medium. + The dfu command continues until it receives a ^C in the console or + a DFU detach transaction from the HOST. If the CONFIG_DFU_TIMEOUT option + is enabled and a <timeout> parameter is present in the command line, the DFU operation will be aborted automatically after <timeout> - seconds of waiting remote to initiate DFU session. + seconds of waiting for the remote to initiate a DFU session. The possible values of <interface> are (with <USB controller> = 0 in the dfu command example) @@ -139,11 +139,11 @@ mmc u-boot raw 0x80 0x800;uImage ext4 0 2 - If don't want to flash given image file to storage, use "skip" type - entity. + If you don't want to flash the given image file to storage, use the "skip" + type entity. - - It can be used to protect flashing wrong image for the specific board. - - Especailly, this layout will be useful when thor protocol is used, + - It can be used to protect from flashing the wrong image for the specific board. + - Especially, this layout will be useful when the thor protocol is used, which performs flashing in batch mode, where more than one file is processed. @@ -153,18 +153,18 @@ mmc u-boot-<board1>.bin raw 0x80 0x800; u-boot-<board2>.bin skip 0 0 - When flashing new system image requires do some more complex things - than just writing data to the storage medium, one can use 'script' - type. Data written to such entity will be executed as a command list - in the u-boot's shell. This for example allows to re-create partition - layout and even set new *dfu_alt_info* for the newly created paritions. - Such script would look like:: + When flashing a new system image requires you to do some more complex + things than just writing data to the storage medium, one can use 'script' + type. Data written to such an entity will be executed as a command list + in the u-boot's shell. This for example allows you to re-create a partition + layout and even set a new *dfu_alt_info* for the newly created partitions. + Such a script would look like:: setenv dfu_alt_info ... setenv mbr_parts ... mbr write ... - Please note that this means that user will be able to execute any + Please note that this means the user will be able to execute any arbitrary commands just like in the u-boot's shell. nand @@ -216,8 +216,8 @@ sf each element in *dfu_alt_info* being either of: * <name> raw <offset> <size> raw access to sf device - * <name> part <dev_id> <part_id> raw acces to partition - * <name> partubi <dev_id> <part_id> raw acces to ubi partition + * <name> part <dev_id> <part_id> raw access to partition + * <name> partubi <dev_id> <part_id> raw access to ubi partition with @@ -288,17 +288,17 @@ Callbacks The weak callback functions can be implemented to manage specific behavior dfu_initiated_callback - called when the DFU transaction is started, used to initiase the device + called when the DFU transaction is started, used to initialize the device dfu_flush_callback called at the end of the DFU write after DFU manifestation, used to manage - the device when DFU transaction is closed + the device when the DFU transaction is closed Host tools ---------- When U-Boot runs the dfu stack, the DFU host tools can be used -to send/receive firmwares on each configurated alternate. +to send/receive firmware images on each configured alternate. For example dfu-util is a host side implementation of the DFU 1.1 specifications(http://dfu-util.sourceforge.net/) which works with U-Boot. @@ -409,8 +409,8 @@ Same example with MTD backend Example 3 -firmware located in SD Card (mmc) and virtual partition on OTP and PMIC not -volatile memory +firmware located in SD Card (mmc) and virtual partition on OTP and PMIC +non-volatile memory - alternate 1 (alt=1) for scard - alternate 2 (alt=2) for OTP (virtual) |