aboutsummaryrefslogtreecommitdiff
AgeCommit message (Collapse)AuthorFilesLines
2022-07-07docs: automarkup: do not look up symbols twiceJonathan Corbet1-31/+26
The automarkup code tries to look up symbols once as a function, and once as a macro. The Sphinx C domain code, though, totally ignores that distinction and will return the same results either way. So just look things up once and be done with it; the resulting output does not change, but htmldocs build time drops by about 5%. Tested-by: Akira Yokosawa <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07docs: automarkup: track failed cross-reference attemptsJonathan Corbet1-0/+13
The automarkup code tries to create a lot of cross-references that don't exist. Cross-reference lookups are expensive, especially in later versions of Sphinx, so there is value in avoiding unnecessary ones. Remember attempts that failed and do not retry them. This improves the htmldocs build time by 5-10% depending on the phase of the moon and other factors. Tested-by: Akira Yokosawa <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07docs: tegra194-hte.rst: don't include gpiolib.c twiceMauro Carvalho Chehab1-2/+1
All extern functions of drivers/gpio/gpiolib.c are already inside the Kernel documentation, as driver-api/gpio/index.rst already includes it. Placing a kernel-doc here will only cause mess, as the same symbol will be placed on two parts of the document, causing breakages in cross-references. So, instead, add a cross-reference there. This solves those Sphinx 3.1+ warnings: .../Documentation/driver-api/hte/tegra194-hte:28: ./drivers/gpio/gpiolib.c:2464: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2464. .../Documentation/driver-api/hte/tegra194-hte:28: ./drivers/gpio/gpiolib.c:2493: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2493. .../Documentation/driver-api/hte/tegra194-hte.rst:2464: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2464. .../Documentation/driver-api/hte/tegra194-hte.rst:2464: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2464. .../Documentation/driver-api/hte/tegra194-hte.rst:2464: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2464. .../Documentation/driver-api/hte/tegra194-hte.rst:2493: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2493. .../Documentation/driver-api/hte/tegra194-hte.rst:2493: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2493. .../Documentation/driver-api/hte/tegra194-hte.rst:2493: WARNING: Duplicate C declaration, also defined at driver-api/gpio/index:2493. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/de81b472f552bd651f140f0aa779a29652fffa62.1656759989.git.mchehab@kernel.org Acked-by: Dipen Patel <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07scripts: sphinx-pre-install: place a warning for Sphinx >= 3.0Mauro Carvalho Chehab1-0/+4
Newer versions of Sphinx have a known bug: https://github.com/sphinx-doc/sphinx/pull/8313 Those currently produces 11 false-positive warnings On Sphinx version 3.1+. While Sphinx fix is not applied, let's warn adventurers that would be using Sphinx installed via distro packages. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/085e0ada65c11da9303d07e70c510dc45f21315b.1656756450.git.mchehab@kernel.org Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07scripts: sphinx-pre-install: provide both venv and package installsMauro Carvalho Chehab1-13/+42
As it is not a consensus about installing sphinx using venv, and modern distributions are now shipping with Sphinx versions above the minimal requirements to build the docs, provide both venv and package install commands by default. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/7c99d985df204c73e3daafd5fd2f30a31269405d.1656756450.git.mchehab@kernel.org Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07scripts: sphinx-pre-install: check for PDF min version later onMauro Carvalho Chehab1-5/+10
Better to add the PDF note late for venv recommendation. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/8e117aabe6dfa1b1ec92dccd20e801393c977667.1656756450.git.mchehab@kernel.org Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07scripts: sphinx-pre-install: report broken venvMauro Carvalho Chehab1-0/+6
After distro upgrades, the directory names for python may change. On such case, the previously-created venv will be broken, and sphinx-build won't run. Add a logic to report it. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/f117f03555b0636d2be0b68f3a23b1d3f03ccf1d.1656756450.git.mchehab@kernel.org [jc: fixed typo in warning message] Signed-off-by: Jonathan Corbet <[email protected]>
2022-07-07scripts: sphinx-pre-install: fix venv version check logicMauro Carvalho Chehab1-3/+7
The logic which checks if the venv version is good enough but was not activated is broken: it is checking against the wrong val, making it to recommend to re-create a venv every time. Fix it. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Link: https://lore.kernel.org/r/afe01b7863fd655986d84ace8948f3d7aede796d.1656756450.git.mchehab@kernel.org Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-30docs/doc-guide: Mention make variable SPHINXDIRSAkira Yokosawa1-0/+7
SPHINXDIRS is useful when you want to test build only those documents affected by your changes. Mention it in the "Sphinx Build" section. Signed-off-by: Akira Yokosawa <[email protected]> Cc: Maciej W. Rozycki <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-30scripts: get_feat.pl: use /usr/bin/env to find perlDavid Reaver1-1/+1
I tried running `make pdfdocs` on NixOS, but it failed because get_feat.pl uses a shebang line with /usr/bin/perl, and that file path doesn't exist on NixOS. Using the more portable /usr/bin/env perl fixes the problem. Signed-off-by: David Reaver <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-30docs/zh_CN: Add mutex-design Chinese translationTang Yizhou2-1/+146
Translate locking/mutex-design.rst into Chinese. Signed-off-by: Tang Yizhou <[email protected]> Reviewed-by: Alex Shi <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-30docs/zh_CN: Show the Chinese translation of spinlocksTang Yizhou1-1/+2
Last time I forgot to edit locking/index.rst so the Chinese translation of spinlocks hasn't been shown on web yet. Signed-off-by: Tang Yizhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Alex Shi <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/doc-guide: Put meta title for kernel-doc HTML pageAkira Yokosawa1-0/+2
kernel-doc.rst has two 1st level section titles of "Writing kernel-doc comments" and "Including kernel-doc comments". Therefore, rather than using the first one, put a meta title of "Kernel-doc comments" for the title of the resulting HTML page by using the "title" directive. Signed-off-by: Akira Yokosawa <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/doc-guide: Add footnote on Inkscape for better images in PDF documentsAkira Yokosawa1-1/+6
With kernel releases v5.18 and later, if you have Inkscape, images embedded in PDF documents are of vector graphics, not the raster images as are the case with pre-v5.18 releases. Even with pre-5.18 releases, having Inkscape would improve images converted from some of SVG files which are not fully covered by the limited capability of rsvg-convert(1) [1]. Add a footnote mentioning the expected improvements of such images. Link: https://gitlab.gnome.org/GNOME/librsvg#non-goals-of-librsvg [1] Signed-off-by: Akira Yokosawa <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/kselftest: add more guidelines for adding new testsMuhammad Usama Anjum1-1/+26
Improve and add instructions to add new tests. Add build commands to test before sending the new test patch. Signed-off-by: Muhammad Usama Anjum <[email protected]> Reviewed-by: Shuah Khan <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: Update zh_CN/kernel-hacking/hacking.rst to 5.19-rc1Wu XiangCheng1-11/+11
* update to commit f35cf1a59e9a ("Documentation: kernel-hacking: minor edits for style") * fix a homophone typo reported by Li Feng Reported-by: Li Feng <[email protected]> Signed-off-by: Wu XiangCheng <[email protected]> Reviewed-by: Yanteng Si <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: add vm vmalloced-kernel-stacks translationYanteng Si2-1/+134
Translate .../vm/vmalloced-kernel-stacks.rst into Chinese. Signed-off-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/01de54c7ecfd1999a636ee59ac40b79917251af2.1654585011.git.siyanteng@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: add vm page_migration translationYanteng Si2-1/+229
Translate .../vm/page_migration.rst into Chinese. Signed-off-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/44bc4486e5019f689bcbec20a629a9f7800ece33.1654585011.git.siyanteng@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: riscv: Update the translation of vm-layout.rst to 5.19-rc1Binbin Zhou1-0/+37
Synchronous translation from upstream commit 9d19f2b5256e ("Documentation: riscv: Add sv48 description to VM layout") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/10cd6a241a0266d1d19ee5f0b2177d7d14d17ed2.1654685338.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: riscv: Remove the translation of pmu.rstBinbin Zhou2-236/+0
Synchronous translation from the following: [1]: commit 23b1f18326ec("Documentation: riscv: Remove the old documentation") [2]: commit 8933e7f2e375 ("Documentation: riscv: remove non-existent directory from table of contents") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/6fe45d69210300a6c065262470bce963f8dc0ec3.1654685338.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs: dev-tools: modify SPL reference URL to actual SPL doc entryDongliang Mu1-1/+1
Fix the invalid url about Semantic Patch Language Signed-off-by: Dongliang Mu <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs: filesystems: f2fs: fix description about compress ioctlChao Liu1-6/+7
Since commit c61404153eb6 ("f2fs: introduce FI_COMPRESS_RELEASED instead of using IMMUTABLE bit"), we no longer use the IMMUTABLE bit to prevent writing data for compression. Let's correct the corresponding documentation. BTW, this patch fixes some alignment issues in the compress metadata layout. Signed-off-by: Chao Liu <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: Update the translation of vm index to 5.19-rc1Yanteng Si1-6/+21
update to commit 481cc97349d6 ("mm,doc: Add new documentation structure") Note: There are some empty files that do not need to be updated for now, they are: bootmem, oom, page_allocation, page_cache, page_reclaim, page_tables, physical_memory process_addrs, shmfs, slab, vmalloc, swap. Signed-off-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Reviewed-by: Alex Shi <[email protected]> Link: https://lore.kernel.org/r/35d10864fb9b57bf288d4efa5642f93a60079029.1655362610.git.siyanteng@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: Update the translation of page_owner to 5.19-rc1Yanteng Si1-9/+70
update to commit d1ed51fcdbd6 ("docs: vm/page_owner: tweak literal block in STANDARD FORMAT SPECIFIERS") Signed-off-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Reviewed-by: Alex Shi <[email protected]> Link: https://lore.kernel.org/r/e96557b73b036c33a9fa5abdab0c541704235e92.1655362610.git.siyanteng@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-27docs/zh_CN: Update the translation of highmem to 5.19-rc1Yanteng Si1-34/+43
update to commit 110bf7a52307 ("Documentation/vm: rework "Temporary Virtual Mappings" section") Signed-off-by: Yanteng Si <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Reviewed-by: Alex Shi <[email protected]> Link: https://lore.kernel.org/r/76c418554d9b8d395f7e8331e8e3b89d1b7beff0.1655362610.git.siyanteng@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs: UML: fix typoSteven Lung1-1/+1
Replace 'absense' with 'absence'. Signed-off-by: Steven Lung <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of xarray.rst to 5.19-rc3Binbin Zhou1-1/+3
Synchronous translation from upstream commit ac23d1a96460 ("XArray: Document the locking requirement for the xa_state") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Link: https://lore.kernel.org/r/b7d5f3ca914667ec14ba35a7c0db3ec3506e670d.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of workqueue.rst to 5.19-rc3Binbin Zhou1-4/+17
Synchronous translation from upstream commit f9eaaa82b474 ("workqueue: doc: Call out the non-reentrance conditions") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Link: https://lore.kernel.org/r/d045cb5623b5ae703c2296d3caa05017d5d225bd.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of printk-format.rst to 5.19-rc3Binbin Zhou1-1/+2
Synchronous translation from upstream commit 6a7ca80f4033 ("vsprintf: Update %pGp documentation about that it prints hex value") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/2ba15ab2aa46bfdd400d1c043eecc12bc6154836.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of printk-basics.rst to 5.19-rc3Binbin Zhou1-2/+1
Synchronous translation from upstream commit 7d9e2661f268 ("printk: Move the printk() kerneldoc comment to its new home") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/56c6d212d6835029b4adf19cf78eec49c7a126d6.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of mm-api.rst to 5.19-rc3Binbin Zhou1-1/+22
Synchronous translation from the following commits(Latest in front): [1]: commit 84dacdbd5352("mm: document and polish read-ahead code") [2]: commit 2f52578f9c64("mm/util: Add folio_mapping() and folio_file_mapping()") [3]: commit 889a3747b3b7("mm/lru: Add folio LRU functions") [4]: commit c24016ac3a62("mm: Add folio reference count functions") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/0bd7b03a5d38dd1599715343360bef4289b7c0fb.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of kernel-api.rst to 5.19-rc3Binbin Zhou1-0/+3
Synchronous translation from upstream commit 640d1930bef4 ("block: Add bio_for_each_folio_all()") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Link: https://lore.kernel.org/r/9173878562404f4518fecc7c55032fe815f87fd9.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of irq/irq-domain.rst to 5.19-rc3Binbin Zhou1-4/+18
Synchronous translation from the following commits(Latest in front): [1]: commit 0953fb263714("irq: remove handle_domain_{irq,nmi}()") [2]: commit 0ddc5e55e6f1("Documentation: Fix irq-domain.rst build warning") [3]: commit 991007ba6cca("Documentation: Update irq_domain.rst with new lookup APIs") [4]: commit 405e94e9aed2("irqdomain: Kill irq_domain_add_legacy_isa") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/eb82606f323c4c25e497a01a060e1e76f18be72f.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of cpu_hotplug.rst to 5.19-rc3Binbin Zhou1-58/+377
Synchronous translation from upstream commit c9871c800f65 ("Documentation: core-api/cpuhotplug: Rewrite the API section") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/9a123a1938a09f883db0b429396954e0792c84c1.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs/zh_CN: core-api: Update the translation of cachetlb.rst to 5.19-rc3Binbin Zhou1-0/+6
Synchronous translation from upstream commit 08b0b0059bf1 ("mm: Add flush_dcache_folio()") Signed-off-by: Binbin Zhou <[email protected]> Reviewed-by: Yanteng Si<[email protected]> Reviewed-by: Wu XiangCheng <[email protected]> Link: https://lore.kernel.org/r/d1fe8dfa3cfc3fe38c7caf8b5cf3b3482b5bddf8.1655863769.git.zhoubinbin@loongson.cn Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs: driver-api: gpio: Fix some typosTom Schwindl3-5/+5
Correct some simple spelling mistakes in consumer.rst, driver.rst and using-gpio.rst. Signed-off-by: Tom Schwindl <[email protected]> Reviewed-by: Randy Dunlap <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs: Remove duplicate wordDeming Wang1-1/+1
Delete duplicate words of "the". Signed-off-by: Deming Wang <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-24docs: admin-guide/sysctl: Fix rendering errorStephen Kitt1-2/+2
Text in ``literal`` markup must be separated by word separators, so text like ``lowwater``% renders incorrectly. Add the suggested "\ " after two problematic occurrences. Signed-off-by: Stephen Kitt <[email protected]> Link: https://lore.kernel.org/r/[email protected] [jc: tweaked to use "\ "] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-13docs: Kconfig: Fix help text indentationJuerg Haefliger1-12/+11
The convention for help text indentation seems to be a single tab followed by two whitespaces. Do that. While at it, remove a stray empty line. Signed-off-by: Juerg Haefliger <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-13docs/zh_CN: Update translation of reporting-issues.rst to 5.18Wu XiangCheng1-46/+79
Update zh_CN/admin-guide/reporting-issues.rst to newest English version commit 247097e2bbff4 ("docs: reporting-issues.rst: link new document about regressions") Signed-off-by: Wu XiangCheng <[email protected]> Reviewed-by: Alex Shi <[email protected]> Link: https://lore.kernel.org/r/YoRlDOUl/eg+h/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-13docs/arm64: elf_hwcaps: Unify HWCAP lists as description listsMartin Liška1-23/+0
Add a series of blank lines to this document to get consistend rendering as an RST description list. Signed-off-by: Martin Liska <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-13scripts: kernel-doc: Always increment warnings counterNiklas Söderlund1-47/+35
Some warnings do not increment the warnings counter making the behavior of running kernel-doc with -Werror unlogical as some warnings will be generated but not treated as errors. Fix this by creating a helper function that always incrementing the warnings counter every time a warning is emitted. There is one location in get_sphinx_version() where a warning is not touched as it concerns the execution environment of the kernel-doc and not the documentation being processed. Incrementing the counter only have effect when running kernel-doc in either verbose mode (-v or environment variable KBUILD_VERBOSE) or when treating warnings as errors (-Werror or environment variable KDOC_WERROR). In both cases the number of warnings printed is printed to stderr and for the later the exit code of kernel-doc is non-zero if warnings where encountered. Simple test case to demo one of the warnings, $ cat test.c /** * foo() - Description */ int bar(); # Without this change $ ./scripts/kernel-doc -Werror -none test.c test.c:4: warning: expecting prototype for foo(). Prototype was for bar() instead # With this change $ ./scripts/kernel-doc -Werror -none test.c test.c:4: warning: expecting prototype for foo(). Prototype was for bar() instead 1 warnings as Errors Signed-off-by: Niklas Söderlund <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
2022-06-12Linux 5.19-rc2Linus Torvalds1-1/+1
2022-06-12Merge tag 'platform-drivers-x86-v5.19-2' of ↵Linus Torvalds8-14/+35
git://git.kernel.org/pub/scm/linux/kernel/git/pdx86/platform-drivers-x86 Pull x86 platform driver fixes from Hans de Goede: "Highlights: - Fix hp-wmi regression on HP Omen laptops introduced in 5.18 - Several hardware-id additions - A couple of other tiny fixes" * tag 'platform-drivers-x86-v5.19-2' of git://git.kernel.org/pub/scm/linux/kernel/git/pdx86/platform-drivers-x86: platform/x86/intel: hid: Add Surface Go to VGBS allow list platform/x86: hp-wmi: Use zero insize parameter only when supported platform/x86: hp-wmi: Resolve WMI query failures on some devices platform/x86: gigabyte-wmi: Add support for B450M DS3H-CF platform/x86: gigabyte-wmi: Add Z690M AORUS ELITE AX DDR4 support platform/x86: barco-p50-gpio: Add check for platform_driver_register platform/x86/intel: pmc: Support Intel Raptorlake P platform/x86/intel: Fix pmt_crashlog array reference platform/mellanox: Add static in struct declaration. platform/mellanox: Spelling s/platfom/platform/
2022-06-12Merge tag 'wq-for-5.19-rc1-fixes' of ↵Linus Torvalds3-17/+73
git://git.kernel.org/pub/scm/linux/kernel/git/tj/wq Pull workqueue fixes from Tejun Heo: "Tetsuo's patch to trigger build warnings if system-wide wq's are flushed along with a TP type update and trivial comment update" * tag 'wq-for-5.19-rc1-fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/wq: workqueue: Switch to new kerneldoc syntax for named variable macro argument workqueue: Fix type of cpu in trace event workqueue: Wrap flush_workqueue() using a macro
2022-06-12Merge tag 'kbuild-fixes-v5.19' of ↵Linus Torvalds5-23/+40
git://git.kernel.org/pub/scm/linux/kernel/git/masahiroy/linux-kbuild Pull Kbuild fixes from Masahiro Yamada: - Make the *.mod build rule portable for POSIX awk - Fix regression of 'make nsdeps' - Make scripts/check-local-export working for older bash versions - Fix scripts/gdb to extract the .config data from vmlinux * tag 'kbuild-fixes-v5.19' of git://git.kernel.org/pub/scm/linux/kernel/git/masahiroy/linux-kbuild: scripts/gdb: change kernel config dumping method scripts/check-local-export: avoid 'wait $!' for process substitution scripts/nsdeps: adjust to the format change of *.mod files kbuild: avoid regex RS for POSIX awk
2022-06-12Merge tag '5.19-rc1-smb3-client-fixes' of git://git.samba.org/sfrench/cifs-2.6Linus Torvalds6-14/+29
Pull cifs client fixes from Steve French: "Three reconnect fixes, all for stable as well. One of these three reconnect fixes does address a problem with multichannel reconnect, but this does not include the additional fix (still being tested) for dynamically detecting multichannel adapter changes which will improve those reconnect scenarios even more" * tag '5.19-rc1-smb3-client-fixes' of git://git.samba.org/sfrench/cifs-2.6: cifs: populate empty hostnames for extra channels cifs: return errors during session setup during reconnects cifs: fix reconnect on smb3 mount types
2022-06-12Merge tag 'random-5.19-rc2-for-linus' of ↵Linus Torvalds9-62/+71
git://git.kernel.org/pub/scm/linux/kernel/git/crng/random Pull random number generator fixes from Jason Donenfeld: - A fix for a 5.19 regression for a case in which early device tree initializes the RNG, which flips a static branch. On most plaforms, jump labels aren't initialized until much later, so this caused splats. On a few mailing list threads, we cooked up easy fixes for arm64, arm32, and risc-v. But then things looked slightly more involved for xtensa, powerpc, arc, and mips. And at that point, when we're patching 7 architectures in a place before the console is even available, it seems like the cost/risk just wasn't worth it. So random.c works around it now by checking the already exported `static_key_initialized` boolean, as though somebody already ran into this issue in the past. I'm not super jazzed about that; it'd be prettier to not have to complicate downstream code. But I suppose it's practical. - A few small code nits and adding a missing __init annotation. - A change to the default config values to use the cpu and bootloader's seeds for initializing the RNG earlier. This brings them into line with what all the distros do (Fedora/RHEL, Debian, Ubuntu, Gentoo, Arch, NixOS, Alpine, SUSE, and Void... at least), and moreover will now give us test coverage in various test beds that might have caught the above device tree bug earlier. - A change to WireGuard CI's configuration to increase test coverage around the RNG. - A documentation comment fix to unrelated maintainerless CRC code that I was asked to take, I guess because it has to do with polynomials (which the RNG thankfully no longer uses). * tag 'random-5.19-rc2-for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/crng/random: wireguard: selftests: use maximum cpu features and allow rng seeding random: remove rng_has_arch_random() random: credit cpu and bootloader seeds by default random: do not use jump labels before they are initialized random: account for arch randomness in bits random: mark bootloader randomness code as __init random: avoid checking crng_ready() twice in random_init() crc-itu-t: fix typo in CRC ITU-T polynomial comment
2022-06-12platform/x86/intel: hid: Add Surface Go to VGBS allow listDuke Lee1-0/+6
The Surface Go reports Chassis Type 9 (Laptop,) so the device needs to be added to dmi_vgbs_allow_list to enable tablet mode when an attached Type Cover is folded back. BugLink: https://github.com/linux-surface/linux-surface/issues/837 Signed-off-by: Duke Lee <[email protected]> Reviewed-by: Andy Shevchenko <[email protected]> Link: https://lore.kernel.org/r/[email protected] Reviewed-by: Hans de Goede <[email protected]> Signed-off-by: Hans de Goede <[email protected]>
2022-06-12platform/x86: hp-wmi: Use zero insize parameter only when supportedBedant Patnaik1-8/+15
commit be9d73e64957 ("platform/x86: hp-wmi: Fix 0x05 error code reported by several WMI calls") and commit 12b19f14a21a ("platform/x86: hp-wmi: Fix hp_wmi_read_int() reporting error (0x05)") cause ACPI BIOS Error (bug): Attempt to CreateField of length zero (20211217/dsopcode-133) because of the ACPI method HWMC, which unconditionally creates a Field of size (insize*8) bits: CreateField (Arg1, 0x80, (Local5 * 0x08), DAIN) In cases where args->insize = 0, the Field size is 0, resulting in an error. Fix this by using zero insize only if 0x5 error code is returned Tested on Omen 15 AMD (2020) board ID: 8786. Fixes: be9d73e64957 ("platform/x86: hp-wmi: Fix 0x05 error code reported by several WMI calls") Signed-off-by: Bedant Patnaik <[email protected]> Tested-by: Jorge Lopez <[email protected]> Link: https://lore.kernel.org/r/[email protected] Reviewed-by: Hans de Goede <[email protected]> Signed-off-by: Hans de Goede <[email protected]>
Powered by cgit, Gruvboxed by Blaster4385.