- 21 Feb, 2024 5 commits
-
-
Vegard Nossum authored
kerneldoc.py is mostly indented with 4 spaces (like PEP8 suggests); replace the last remaining tabs for consistency. No functional change. Cc: Jani Nikula <jani.nikula@intel.com> Cc: Mauro Carvalho Chehab <mchehab@kernel.org> Signed-off-by:
Vegard Nossum <vegard.nossum@oracle.com> Reviewed-by:
Randy Dunlap <rdunlap@infradead.org> Signed-off-by:
Jonathan Corbet <corbet@lwn.net> Link: https://lore.kernel.org/r/20240215134828.1277109-6-vegard.nossum@oracle.com
-
Vegard Nossum authored
Untangle some of the $is_macro logic and the nested conditionals. This makes it easier to see where and how the signature is actually printed. No functional change. Signed-off-by:
-
Vegard Nossum authored
Format the entire function signature and place it in a separate variable; this both makes it easier to understand what these lines of code are doing and will allow us to simplify the code further in the following patch. No functional change. Signed-off-by:
-
Vegard Nossum authored
Get rid of the $start variable, since it's really not necessary. No functional change. Signed-off-by:
-
Vegard Nossum authored
Set 'softtabstop' to 4 spaces, which will hopefully help keep the indentation in this file consistent going forwards. This mirrors the modeline in scripts such as recordmcount.pl, ktest.pl, and others. Emacs seems to use 4 spaces to indent by default, so it doesn't require anything special here. No functional change. Signed-off-by:
-
- 14 Feb, 2024 7 commits
-
-
Hunter Chasens authored
Updates the bootloader and installation instructions in admin-guide/README.rst to align with modern practices. Details of Changes: - Added guidance on using EFISTUB for UEFI/EFI systems. - Noted that LILO is no longer in active development and provides alternatives. - Kept LILO instructions but marked as Legacy LILO Instructions. Suggest removal in future patch. Signed-off-by:
Hunter Chasens <hunter.chasens18@ncf.edu> Signed-off-by:
-
Thorsten Blum authored
The script tools/net/ynl/ynl-gen-rst.py (YNL_TOOL) generates several .rst files (YNL_INDEX, YNL_RST_FILES) in Documentation/networking/netlink_spec (YNL_RST_DIR) which are not deleted by make cleandocs. Fix make cleandocs by deleting the generated .rst files. Signed-off-by:
Thorsten Blum <thorsten.blum@toblux.com> Reviewed-by:
-
Vegard Nossum authored
This file is using an ungodly mixture of 4 spaces, 2-wide tabs, 4-wide tabs, _and_ 8-wide tabs, making it really hard to find good editor settings for working with this file. Bite the bullet and reindent it by hand. I tried using both perltidy and vim, but neither of them were up to the task without changing too much or getting confused about what they were supposed to be doing. I did change a few instances of } else into } else (and same for elsif); the file is again written using both styles, and I left functions which already seemed self-consistent alone. You can verify that this commit only changes whitespace using e.g.: git diff --ignore-all-space --word-diff or to see (only) the instances where newlines were added/removed: git diff --ignore-all-space You can also see the delta from what perltidy would have wanted to do to this file (when asked to only indent it), which isn't that much in the end: perltidy -io -fnl scripts/kernel-doc git diff --no-index scripts/kernel-doc{,.tdy} Signed-off-by: -
Thorsten Blum authored
The Python module pyyaml is required to build the docs, but it is only listed in Documentation/sphinx/requirements.txt and is therefore missing when Sphinx is installed as a package and not via pip/pypi. Add pyyaml as an optional package for multiple distros to fix building the docs if you prefer to install Sphinx as a package. Signed-off-by:
-
Davide Benini authored
This patch adds the italian translation for I2C subsystem summary and protocol. Plus, a reference in the subsystem-apis page. Signed-off-by:
Davide Benini <davide.benini@gmail.com> Signed-off-by:
Federico Vaga <federico.vaga@vaga.pv.it> Signed-off-by:
-
Federico Vaga authored
The netdev-FAQ page in the italian translation was creted to avoid having broken links. With the evolution of the documentation this was not referenced anymore, but the page never removed. Reported-by:
-
Jeffrey Hugo authored
The servers for the @codeaurora domain have long been retired and any messages addressed to @codeaurora will bounce. Trilok has an entry in .mailmap, but the raw documentation files still list an old @codeaurora address. Update the address in the documentation files for anyone reading them. Signed-off-by:
Jeffrey Hugo <quic_jhugo@quicinc.com> Reviewed-by:
Carlos Bilbao <carlos.bilbao@amd.com> Reviewed-by:
Trilok Soni <quic_tsoni@quicinc.com> Signed-off-by:
-
- 12 Feb, 2024 4 commits
-
-
Thorsten Blum authored
- s/exists/exist/ - s/maybe/may be/ Signed-off-by:
-
Thorsten Blum authored
- Fix spelling/capitalization s/Restructured/ReStructured/ Signed-off-by:
-
Christoph Anton Mitterer authored
Indicate that the actual value will be one character less. Signed-off-by:
Christoph Anton Mitterer <mail@christoph.anton.mitterer.name> Link: https://lore.kernel.org/r/20240205154100.736499-1-mail@christoph.anton.mitterer.name [jc: did s/null/NUL/ ] Signed-off-by:
-
Lukas Bulwahn authored
This issue was detected with the scripts/checkkconfigsymbols.py tool. Signed-off-by:
Lukas Bulwahn <lukas.bulwahn@gmail.com> Signed-off-by:
-
- 08 Feb, 2024 1 commit
-
-
Vincenzo Mezzela authored
Resolve a spelling error in the documentation found with codespell. Signed-off-by:
Vincenzo Mezzela <vincenzo.mezzela@gmail.com> Signed-off-by:
-
- 05 Feb, 2024 7 commits
-
-
Thorsten Blum authored
- Add missing article "the" - s/above example/example above/ - Add missing comma after introductory clause to improve readability Signed-off-by:
-
Thorsten Blum authored
sphinx.rst: - Remove unnecessary newline - Fix grammar s/on/in/ - Fix grammar s/check/checks/ - Capitalize heading "The C domain" changes.rst: - Remove colon after "pahole" to be consistent with other entries howto.rst: - Fix grammar s/you will/will you/ - Hyphenate "real-world problems" Signed-off-by:
-
Thorsten Blum authored
Use c and elisp instead of none in code-blocks Signed-off-by:
-
Guilherme G. Piccoli authored
The number of possible CPUs is set be kernel in early boot time through some discovery mechanisms, like ACPI in x86. We have a parameter both in x86 and S390 to override that - there are some cases of BIOSes exposing more possible CPUs than the available ones, so this parameter is a good testing mechanism, but for some reason wasn't mentioned so far in the kernel parameters guide - let's fix that. Cc: Changwoo Min <changwoo@igalia.com> Signed-off-by:
"Guilherme G. Piccoli" <gpiccoli@igalia.com> Reviewed-by:
-
Thorsten Blum authored
- Remove spaces in C code-blocks to align error labels consistently - Replace tab characters with spaces in emacs-lisp code blocks Signed-off-by:
-
Krzysztof Kozlowski authored
Extend the list of maintainer profiles with SoC and netdev. Signed-off-by:
Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Signed-off-by:
-
Sakari Ailus authored
In a rather unusual arrangement in include/media/v4l2-vp9.h struct v4l2_vp9_frame_symbol_counts has fields that are arrays of pointers, not a pointer to an array, which is what's usually done. Add support for such arrays of pointers to kernel-doc. Signed-off-by:
Sakari Ailus <sakari.ailus@linux.intel.com> Acked-by:
Ricardo Ribalda <ribalda@chromium.org> Signed-off-by:
-
- 30 Jan, 2024 12 commits
-
-
Abhishek Pandit-Subedi authored
During review, it was suggested that drivers only emit messages when something is wrong or it is a debug message. Document this as a formal recommendation. https://lore.kernel.org/linux-usb/2024012525-alienate-frown-916b@gregkh/Signed-off-by:
Abhishek Pandit-Subedi <abhishekpandit@chromium.org> Acked-by:
Greg Kroah-Hartman <gregkh@linuxfoundation.org> Signed-off-by:
-
Michael Kelley authored
The kernel subsystem APIs front page currently has four top-level groupings with headers, and then everything else that isn't grouped. But in the table-of-contents, ungrouped subsystems are indented as if they were part of the preceding grouping (currently "Storage interfaces"), which is confusing. Fix this by adding an "Other subsystems" header for the ungrouped subsystems. Fixes: 3c591cc9 ("docs: consolidate human interface subsystems") Signed-off-by:
Michael Kelley <mhklinux@outlook.com> Signed-off-by:
-
Andrew Ballance authored
fedora 38 and later changed the directory and package name that provides NotoSansCJK-Regular.ttc. this adds the new search path and suggests the correct package if on fedora 38 or later. Signed-off-by:
Andrew Ballance <andrewjballance@gmail.com> Signed-off-by:
-
Leo Yan authored
In the Linux perf tool, the ring buffer serves not only as a medium for transferring PMU event data but also as a vital mechanism for hardware tracing using technologies like Intel PT and Arm CoreSight, etc. Consequently, the ring buffer mechanism plays a crucial role by ensuring high throughput for data transfer between the kernel and user space while avoiding excessive overhead caused by the ring buffer itself. This commit documents the ring buffer mechanism in detail. It explains the implementation of both the regular ring buffer and the AUX ring buffer. Additionally, it covers how these ring buffers support various tracing modes and explains the synchronization with memory barriers. Signed-off-by:
Leo Yan <leo.yan@linaro.org> Reviewed-by:
James Clark <james.clark@arm.com> Reviewed-by:
Namhyung Kim <namhyung@kernel.org> Signed-off-by:
-
Jonathan Corbet authored
Add some subsection headings and reorder entries so that the page makes a bit more sense. With luck, adding some ordering will also reduce merge conflicts due to everybody adding new entries at the end. Signed-off-by:
-
Jonathan Corbet authored
Add subsections in an attempt to bring a bit order to this page; also sort most subsections into alphabetical order. With luck all this will help to prevent merge conflicts on this page due to everybody adding entries at the end. Signed-off-by:
-
Federico Vaga authored
To begin with: - locking/index.rst - locking/lockdep-design.rst - locking/lockstat.rst - locking/lockturture.rst - locking/locktypes.rst And RCU/torture.rst to avoid broken references. Signed-off-by: -
Randy Dunlap authored
Since 2014 kernel-doc has supported describing object-like macros but it is not documented anywhere. I should have required some documentation for it when I merged the patch. :( There are currently only 3 uses of this (all in DRM headers, in include/drm/*.h). Add object-like macro kernel-doc documentation now so that more may know about it and use it. Fixes: cbb4d3e6 ("scripts/kernel-doc: handle object-like macros") Signed-off-by:
Daniel Vetter <daniel.vetter@ffwll.ch> Signed-off-by:
-
Randy Dunlap authored
Linux kernel does not use "MACDOC" in any documenation or any source files, so stop searching for it. Signed-off-by:
-
Vegard Nossum authored
It's good to be clear about who the intended target audience for any given piece of documentation is, as this will help us put new text in the correct place. Let's encourage submitters to state it explicitly rather than relying on where they placed it in the directory hierarchy as there isn't necessarily a one-to-one correspondence between them. Target audience: documentation contributors and reviewers. Signed-off-by:
-
Anna-Maria Behnsen authored
To prevent this, do the pre-processing only for lines which are no comments, e.g. do not start with ' *'. Suggested-by:
Matthew Wilcox <willy@infradead.org> Signed-off-by:
Anna-Maria Behnsen <anna-maria@linutronix.de> Tested-by:
-
Anna-Maria Behnsen authored
Reformat lines in kernel-doc comments, which make use of the backslash at the end to suggest it is a multi-line comment. kernel-doc is able to process e.g. the short description of a function properly, even if it is across two lines. No functional change. Signed-off-by:
Jani Nikula <jani.nikula@intel.com> Acked-by:
-
- 23 Jan, 2024 4 commits
-
-
Lukas Bulwahn authored
Commit 1db9d06aaa55 ("mm/slab: remove CONFIG_SLAB from all Kconfig and Makefile") removes the config SLAB and makes the SLUB allocator the only default allocator in the kernel. Hence, the advice on reducing OS jitter due to kworker kernel threads to build with CONFIG_SLUB instead of CONFIG_SLAB is obsolete. Remove the obsolete advice to build with SLUB instead of SLAB. Signed-off-by:Vlastimil Babka <vbabka@suse.cz> Signed-off-by:
-
Vegard Nossum authored
This comment about DRM drivers has been there since the first git commit. It simply doesn't belong in kernel-parameters; remove it. Signed-off-by:
-
Hu Haowen authored
Since the mailing archive list lkml.org is obsolete, change the links into lore.kernel.org's ones. Signed-off-by:
Hu Haowen <2023002089@link.tyut.edu.cn> Signed-off-by:
-
Gustavo Sousa authored
When on the documentation home page, there won't be any ".current" element since no entry from the TOC was selected yet. That results in a javascript error. Fix that by only trying to set the scrollTop if we have matches for current entries. Signed-off-by:
Gustavo Sousa <gustavo.sousa@intel.com> Signed-off-by:
-
