linux-2.6-microblaze.git
3 years agoDocumentation/locking/locktypes: fix the typo
Huang Shijie [Thu, 13 Aug 2020 06:02:20 +0000 (14:02 +0800)]
Documentation/locking/locktypes: fix the typo

We have three categories locks, not two.

Signed-off-by: Huang Shijie <sjhuang@iluvatar.ai>
Acked-by: Will Deacon <will@kernel.org>
Link: https://lore.kernel.org/r/20200813060220.18199-1-sjhuang@iluvatar.ai
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc/zh_CN: resolve undefined label warning in admin-guide index
Lukas Bulwahn [Sun, 2 Aug 2020 16:19:56 +0000 (18:19 +0200)]
doc/zh_CN: resolve undefined label warning in admin-guide index

Documentation generation warns:

  Documentation/translations/zh_CN/admin-guide/index.rst:3:
  WARNING: undefined label: documentation/admin-guide/index.rst

Use doc reference for .rst files to resolve the warning.

Fixes: 37a607cf2318 ("doc/zh_CN: add admin-guide index")
Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
Link: https://lore.kernel.org/r/20200802161956.18268-1-lukas.bulwahn@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc/zh_CN: fix title heading markup in admin-guide cpu-load
Lukas Bulwahn [Sun, 2 Aug 2020 16:21:01 +0000 (18:21 +0200)]
doc/zh_CN: fix title heading markup in admin-guide cpu-load

Documentation generation warns:

  Documentation/translations/zh_CN/admin-guide/cpu-load.rst:1:
  WARNING: Title overline too short.

Extend title heading markup by one. It was just off by one.

Fixes: e210c66d567c ("doc/zh_CN: add cpu-load Chinese version")
Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
Acked-by: Tao Zhou <ouwen210@hotmail.com>
Link: https://lore.kernel.org/r/20200802162101.18875-1-lukas.bulwahn@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: remove the 2.6 "Upgrading I2C Drivers" guide
Stephen Kitt [Thu, 6 Aug 2020 16:14:56 +0000 (18:14 +0200)]
docs: remove the 2.6 "Upgrading I2C Drivers" guide

All the drivers have long since been upgraded, and all the important
information here is also included in the "Implementing I2C device
drivers" guide.

Signed-off-by: Stephen Kitt <steve@sk2.org>
Reviewed-by: Wolfram Sang <wsa@kernel.org>
Link: https://lore.kernel.org/r/20200806161456.8680-1-steve@sk2.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: Correct the release date of 5.2 stable
Billy Wilson [Thu, 6 Aug 2020 23:17:54 +0000 (17:17 -0600)]
docs: Correct the release date of 5.2 stable

A table lists the 5.2 stable release date as September 15, but it was
released on July 7. This may confuse a reader who is trying to
understand the stable update release cycle.

Signed-off-by: Billy Wilson <billy_wilson@byu.edu>
Link: https://lore.kernel.org/r/20200806231754.7735-1-billy_wilson@byu.edu
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agomailmap: Update comments for with format and more detalis
Kees Cook [Sat, 8 Aug 2020 07:14:36 +0000 (00:14 -0700)]
mailmap: Update comments for with format and more detalis

Without having first read the git-shortlog man-page, the format
of .mailmap may not be immediately obvious. Add comments with pointers
to the man-page, along with other details.

Signed-off-by: Kees Cook <keescook@chromium.org>
Link: https://lore.kernel.org/r/202008080013.58EBD83@keescook
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: cdrom: Fix a typo and rst markup
Remi Andruccioli [Sat, 8 Aug 2020 16:31:23 +0000 (18:31 +0200)]
docs: cdrom: Fix a typo and rst markup

"The capability fags" should be "The capability flags".

In rst markup, a incorrect markup expression is causing bad rendering in
Sphinx output. Replace the erroneous single quote by a backquote.

Signed-off-by: Remi Andruccioli <remi.andruccioli@gmail.com>
Link: https://lore.kernel.org/r/20200808163123.17643-1-remi.andruccioli@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDoc: admin-guide: use correct legends in kernel-parameters.txt
Randy Dunlap [Mon, 10 Aug 2020 02:49:41 +0000 (19:49 -0700)]
Doc: admin-guide: use correct legends in kernel-parameters.txt

Documentation/admin-guide/kernel-parameters.rst includes a legend
telling us what configurations or hardware platforms are relevant
for certain boot options.  For X86, it is spelled "X86" and for
x86_64, it is spelled "X86-64", so make corrections for those.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Borislav Petkov <bp@alien8.de>
Cc: x86@kernel.org
Link: https://lore.kernel.org/r/20200810024941.30231-1-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/features: refresh RISC-V arch support files
Tobias Klauser [Mon, 10 Aug 2020 09:50:00 +0000 (11:50 +0200)]
Documentation/features: refresh RISC-V arch support files

Support for these was added by the following commits:

  f2c9699f6555 ("riscv: Add STACKPROTECTOR supported")
  3c4697982982 ("riscv: Enable LOCKDEP_SUPPORT & fixup TRACE_IRQFLAGS_SUPPORT").
  ed48b297fe21 ("riscv: Enable context tracking")
  cbb3d91d3bcf ("riscv: Add kmemleak support")

Signed-off-by: Tobias Klauser <tklauser@distanz.ch>
Link: https://lore.kernel.org/r/20200810095000.32092-1-tklauser@distanz.ch
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocumentation: coccinelle: Improve command example for make C={1,2}
Sumera Priyadarsini [Tue, 11 Aug 2020 00:23:50 +0000 (05:53 +0530)]
documentation: coccinelle: Improve command example for make C={1,2}

Modify coccinelle documentation to further clarify
the usage of the makefile C variable by coccicheck.

Signed-off-by: Sumera Priyadarsini <sylphrenadin@gmail.com>
Acked-by: Julia Lawall <julia.lawall@inria.fr>
Link: https://lore.kernel.org/r/20200811002350.5553-1-sylphrenadin@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoCore-api: Documentation: Replace deprecated :c:func: Usage
Puranjay Mohan [Mon, 10 Aug 2020 18:30:19 +0000 (00:00 +0530)]
Core-api: Documentation: Replace deprecated :c:func: Usage

Replace :c:func: with func() as the previous usage is deprecated.

Signed-off-by: Puranjay Mohan <puranjay12@gmail.com>
Reviewed-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Link: https://lore.kernel.org/r/20200810183019.22170-1-puranjay12@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDev-tools: Documentation: Replace deprecated :c:func: Usage
Puranjay Mohan [Mon, 10 Aug 2020 18:36:13 +0000 (00:06 +0530)]
Dev-tools: Documentation: Replace deprecated :c:func: Usage

Replace :c:func: with func() as the previous usage is deprecated.

Signed-off-by: Puranjay Mohan <puranjay12@gmail.com>
Link: https://lore.kernel.org/r/20200810183613.25643-1-puranjay12@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoFilesystems: Documentation: Replace deprecated :c:func: Usage
Puranjay Mohan [Mon, 10 Aug 2020 18:48:28 +0000 (00:18 +0530)]
Filesystems: Documentation: Replace deprecated :c:func: Usage

Replace :c:func: with func() as the previous usage is deprecated.

Signed-off-by: Puranjay Mohan <puranjay12@gmail.com>
Link: https://lore.kernel.org/r/20200810184828.29297-1-puranjay12@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: trace: fix a typo
Bryan Brattlof [Tue, 11 Aug 2020 16:17:12 +0000 (16:17 +0000)]
docs: trace: fix a typo

emumerated -> enumerated

Signed-off-by: Bryan Brattlof <hello@bryanbrattlof.com>
Link: https://lore.kernel.org/r/87lfili2d8.fsf@bryanbrattlof.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoscripts/kernel-doc: optionally treat warnings as errors
Pierre-Louis Bossart [Tue, 28 Jul 2020 16:20:40 +0000 (11:20 -0500)]
scripts/kernel-doc: optionally treat warnings as errors

The kbuild bot recently added the W=1 option, which triggered
documentation cleanups to squelch hundreds of kernel-doc warnings.

To make sure new kernel contributions don't add regressions to
kernel-doc descriptors, this patch suggests an option to treat
warnings as errors in CI/automated tests.

A -Werror command-line option is added to the kernel-doc script. When
this option is set, the script will return the number of warnings
found. The caller can then treat this positive return value as an
error and stop the build.

Using this command line option is however not straightforward when the
kernel-doc script is called from other scripts. To align with typical
kernel compilation or documentation generation, the Werror option is
also set by checking the KCFLAGS environment variable, or if
KDOC_WERROR is defined, as in the following examples:

KCFLAGS="-Wall -Werror" make W=1 sound/
KCFLAGS="-Wall -Werror" make W=1 drivers/soundwire/
KDOC_WERROR=1 make htmldocs

Note that in the last example the documentation build does not stop,
only an additional log is provided.

Credits to Randy Dunlap for suggesting the use of environment variables.

Suggested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
Link: https://lore.kernel.org/r/20200728162040.92467-1-pierre-louis.bossart@linux.intel.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: ia64: correct typo
Julia Lawall [Thu, 30 Jul 2020 10:17:30 +0000 (12:17 +0200)]
docs: ia64: correct typo

Replace RTC_WKLAM_RD with RTC_WKALM_RD.

Signed-off-by: Julia Lawall <Julia.Lawall@inria.fr>
Link: https://lore.kernel.org/r/1596104250-32673-1-git-send-email-Julia.Lawall@inria.fr
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agomailmap: add entry for <alobakin@marvell.com>
Alexander Lobakin [Thu, 30 Jul 2020 16:59:45 +0000 (16:59 +0000)]
mailmap: add entry for <alobakin@marvell.com>

My Marvell account has been suspended, map the address to my private mail.

Signed-off-by: Alexander Lobakin <alobakin@pm.me>
Link: https://lore.kernel.org/r/9xzFiqHAFGYuKfUycRaCQSIgsqmeL9E9SA3lSoqOMUPhFVaAgSgvukCUWO7iRbjtiUrFjK46fhu7dJ5TaCv1EjaNFm5yF_H3y5S1s_QALCA=@pm.me
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc/zh_CN: add cpu-load Chinese version
Tao Zhou [Fri, 24 Jul 2020 02:47:42 +0000 (10:47 +0800)]
doc/zh_CN: add cpu-load Chinese version

Add cpu-load Chinese version and link it into admin-guide.
Based on Alex's recent thread:

  https://lkml.kernel.org/r/20200713115807.56362-1-alex.shi@linux.alibaba.com

Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
Signed-off-by: Tao Zhou <ouwen210@hotmail.com>
Link: https://lore.kernel.org/r/BL0PR14MB37798BBF2307910DE73EF6D49A770@BL0PR14MB3779.namprd14.prod.outlook.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/admin-guide: tainted-kernels: fix spelling mistake
Yue Hu [Sat, 25 Jul 2020 02:24:44 +0000 (10:24 +0800)]
Documentation/admin-guide: tainted-kernels: fix spelling mistake

Fix typo "tis" -> "this".

Signed-off-by: Yue Hu <huyue2@yulong.com>
Link: https://lore.kernel.org/r/20200725022444.10976-1-zbestahu@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoMAINTAINERS: adjust kprobes.rst entry to new location
Lukas Bulwahn [Sun, 26 Jul 2020 05:58:43 +0000 (07:58 +0200)]
MAINTAINERS: adjust kprobes.rst entry to new location

Commit 2165b82fde82 ("docs: Move kprobes.rst from staging/ to trace/")
moved kprobes.rst, but missed to adjust the MAINTAINERS entry.

Hence, ./scripts/get_maintainer.pl --self-test=patterns complains:

  warning: no file matches    F:    Documentation/staging/kprobes.rst

Adjust the entry to the new file location.

Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
Acked-by: Naveen N. Rao <naveen.n.rao@linux.vnet.ibm.com>
Link: https://lore.kernel.org/r/20200726055843.10783-1-lukas.bulwahn@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodevices.txt: document rfkill allocation
Pavel Machek [Sun, 26 Jul 2020 07:53:27 +0000 (09:53 +0200)]
devices.txt: document rfkill allocation

Document rfkill allocation.

Signed-off-by: Pavel Machek (CIP) <pavel@denx.de>
Link: https://lore.kernel.org/r/20200726075327.GA25647@duo.ucw.cz
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoPCI: correct flag name
Julia Lawall [Sun, 26 Jul 2020 15:47:35 +0000 (17:47 +0200)]
PCI: correct flag name

RESOURCE_IO does not exist.  Rename to IORESOURCE_IO.

Signed-off-by: Julia Lawall <Julia.Lawall@inria.fr>
Link: https://lore.kernel.org/r/1595778455-12132-1-git-send-email-Julia.Lawall@inria.fr
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: filesystems: vfs: correct flag name
Julia Lawall [Sun, 26 Jul 2020 18:43:40 +0000 (20:43 +0200)]
docs: filesystems: vfs: correct flag name

There is no flag REMAP_CAN_SHORTEN.  Commit eca3654e3cc7 ("vfs: enable
remap callers that can handle short operations") that introduces this
text also introduces the flag REMAP_FILE_CAN_SHORTEN.  Change the name
in the documentation accordingly.

Signed-off-by: Julia Lawall <Julia.Lawall@inria.fr>
Fixes: eca3654e3cc7 ("vfs: enable remap callers that can handle short operations")
Link: https://lore.kernel.org/r/1595789020-12941-1-git-send-email-Julia.Lawall@inria.fr
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: filesystems: vfs: correct sync_mode flag names
Julia Lawall [Sun, 26 Jul 2020 19:22:21 +0000 (21:22 +0200)]
docs: filesystems: vfs: correct sync_mode flag names

Change the nonexistent flag names WBC_SYNC_ALL and WBC_SYNC_NONE to
WB_SYNC_ALL and WB_SYNC_NONE, respectively, as used in the code with
wbc->sync_mode.

Signed-off-by: Julia Lawall <Julia.Lawall@inria.fr>
Link: https://lore.kernel.org/r/1595791341-13209-1-git-send-email-Julia.Lawall@inria.fr
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: path-lookup: markup fixes for emphasis
Vegard Nossum [Mon, 27 Jul 2020 12:15:25 +0000 (14:15 +0200)]
docs: path-lookup: markup fixes for emphasis

Underscores were being used for emphasis, but these are rendered verbatim
in HTML output. reStructuredText uses asterisks for emphasis. I *think* I
caught all of them.

Signed-off-by: Vegard Nossum <vegard.nossum@oracle.com>
Link: https://lore.kernel.org/r/20200727121525.28103-2-vegard.nossum@oracle.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: path-lookup: more markup fixes
Vegard Nossum [Mon, 27 Jul 2020 12:15:24 +0000 (14:15 +0200)]
docs: path-lookup: more markup fixes

"xxx``at``" makes the `` appear verbatim in the HTML output. I've opted
for changing this into ``*at()`` to harmonise this with the use of * seen
later in the same document (and add the parentheses to clarify that this
is a system/function call).

``path_``* also makes `` appear in the HTML output, but we can fix it by
moving the * into the ``. Also add the parantheses here.

Signed-off-by: Vegard Nossum <vegard.nossum@oracle.com>
Link: https://lore.kernel.org/r/20200727121525.28103-1-vegard.nossum@oracle.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: path-lookup: fix HTML entity mojibake
Vegard Nossum [Mon, 27 Jul 2020 11:45:27 +0000 (13:45 +0200)]
docs: path-lookup: fix HTML entity mojibake

Two cases of "<" somehow turned into "&lt;". I noticed it on
<https://www.kernel.org/doc/html/latest/filesystems/path-lookup.html>.

I've verified that the HTML output is correct with this patch.

Signed-off-by: Vegard Nossum <vegard.nossum@oracle.com>
Link: https://lore.kernel.org/r/20200727114527.23944-1-vegard.nossum@oracle.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoCREDITS: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Tue, 14 Jul 2020 17:55:28 +0000 (19:55 +0200)]
CREDITS: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
          If both the HTTP and HTTPS versions
          return 200 OK and serve the same content:
            Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200714175528.46712-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: process: Add an example for creating a fixes tag
Tom Rix [Fri, 10 Jul 2020 20:01:15 +0000 (13:01 -0700)]
docs: process: Add an example for creating a fixes tag

To make it a little clearer how to create a fixes tag,
add an example based on the preceeding gitconfig setup.

Signed-off-by: Tom Rix <trix@redhat.com>
Link: https://lore.kernel.org/r/20200710200115.21176-1-trix@redhat.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc/zh_CN: add Chinese translation prefer section
Alex Shi [Mon, 13 Jul 2020 11:58:07 +0000 (19:58 +0800)]
doc/zh_CN: add Chinese translation prefer section

The add words is:

Tranlation plan:
Welcome for any part of kernel doc Chinese translation, expecially for
admin-guide part.

Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Harry Wei <harryxiyou@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Link: https://lore.kernel.org/r/20200713115807.56362-3-alex.shi@linux.alibaba.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc/zh_CN: add clearing-warn-once Chinese version
Alex Shi [Mon, 13 Jul 2020 11:58:06 +0000 (19:58 +0800)]
doc/zh_CN: add clearing-warn-once Chinese version

and link it into admin-guide.

Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Harry Wei <harryxiyou@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Link: https://lore.kernel.org/r/20200713115807.56362-2-alex.shi@linux.alibaba.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc/zh_CN: add admin-guide index
Alex Shi [Mon, 13 Jul 2020 11:58:05 +0000 (19:58 +0800)]
doc/zh_CN: add admin-guide index

Translate the admin-guide index.rst file into Chinese. and link it into
Chinese top index file.

Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Harry Wei <harryxiyou@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Link: https://lore.kernel.org/r/20200713115807.56362-1-alex.shi@linux.alibaba.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc:it_IT: process: coding-style.rst: Correct __maybe_unused compiler label
Lee Jones [Wed, 15 Jul 2020 12:23:28 +0000 (13:23 +0100)]
doc:it_IT: process: coding-style.rst: Correct __maybe_unused compiler label

Flag is __maybe_unused, not __maybe_used.

Cc: Federico Vaga <federico.vaga@vaga.pv.it>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: clang-built-linux@googlegroups.com
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20200715122328.3882187-1-lee.jones@linaro.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agofutex: MAINTAINERS: Re-add selftests directory
André Almeida [Wed, 15 Jul 2020 13:10:36 +0000 (10:10 -0300)]
futex: MAINTAINERS: Re-add selftests directory

Commit 95ca6d73a8a97 ("docs: move locking-specific documents to
locking/") accidentally replaced the selftests line for a duplicated
documentation one. Revert this change.

Signed-off-by: André Almeida <andrealmeid@collabora.com>
Fixes: 95ca6d73a8a97 ("docs: move locking-specific documents to locking/")
Link: https://lore.kernel.org/r/20200715131036.9692-1-andrealmeid@collabora.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: timers: drop documentation about LB_BIAS
Julia Lawall [Sat, 18 Jul 2020 16:08:38 +0000 (18:08 +0200)]
docs: timers: drop documentation about LB_BIAS

The LB_BIAS feature was removed in commit 1c1b8a7b03ef ("sched/fair:
Replace source_load() & target_load() with weighted_cpuload()"), so drop
the mention that it is disabled in the no_hz case.

Signed-off-by: Julia Lawall <Julia.Lawall@inria.fr>
Link: https://lore.kernel.org/r/1595088518-28116-1-git-send-email-Julia.Lawall@inria.fr
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: core-api/printk-formats.rst: use literal block syntax
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:51:02 +0000 (13:51 -0300)]
docs: core-api/printk-formats.rst: use literal block syntax

Fix the following warning:

WARNING: Definition list ends without a blank line;
unexpected unindent.

By switching to the literal block syntax.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-8-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: bpf/bpf_devel_QA.rst: fix reference to nonexistent document
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:51:00 +0000 (13:51 -0300)]
docs: bpf/bpf_devel_QA.rst: fix reference to nonexistent document

Fix the following sphinx warning:

bpf_devel_QA.rst:444: WARNING: Unknown target name:
"documentation/bpf/btf.rst"

No target was defined for 'btf.rst' in the document. Fix it.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-6-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: process/index.rst: Fix reference to nonexistent document
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:50:59 +0000 (13:50 -0300)]
docs: process/index.rst: Fix reference to nonexistent document

Fix the following warning:

WARNING: toctree contains reference to nonexistent document
'process/unaligned-memory-access'

The path to the document was wrong.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-5-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: staging/tee.rst: convert into definition list
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:50:58 +0000 (13:50 -0300)]
docs: staging/tee.rst: convert into definition list

Fix the following warnings:

tee.rst:65: WARNING: Unexpected indentation.

tee.rst:69: WARNING: Block quote ends without a
blank line; unexpected unindent.

By switching to the 'definition list' syntax.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-4-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: admin-guide/mm/index: Fix reference to nonexistent document
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:50:55 +0000 (13:50 -0300)]
docs: admin-guide/mm/index: Fix reference to nonexistent document

Fix the following warning:

WARNING: toctree contains reference to nonexistent document
'admin-guide/mm/nommu-map'

This was due to a typo.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-1-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: admin-guide/index.rst: Add pstore-blk.rst
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:51:03 +0000 (13:51 -0300)]
docs: admin-guide/index.rst: Add pstore-blk.rst

Fix the following warning:

Documentation/admin-guide/pstore-blk.rst:
WARNING: document isn't included in any toctree

By adding 'pstore-blk.rst' to the index

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-9-dwlsalmeida@gmail.com
Acked-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: bpf/index.rst: Add ringbuf.rst
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:51:04 +0000 (13:51 -0300)]
docs: bpf/index.rst: Add ringbuf.rst

Fix the following warning

Documentation/bpf/ringbuf.rst: WARNING: document isn't
included in any toctree

By adding it to the index.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-10-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: trace/index.rst: add histogram-design.rst
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:51:06 +0000 (13:51 -0300)]
docs: trace/index.rst: add histogram-design.rst

Fix the following warning:

Documentation/trace/histogram-design.rst:
WARNING: document isn't included in any toctree

By adding 'histogram-design.rst' to the index.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-12-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: index.rst: Add watch_queue
Daniel W. S. Almeida [Sat, 18 Jul 2020 16:51:07 +0000 (13:51 -0300)]
docs: index.rst: Add watch_queue

Fix the following sphinx warning:

Documentation/watch_queue.rst:
WARNING: document isn't included in any toctree

By adding watch_queue.rst to the index.

Signed-off-by: Daniel W. S. Almeida <dwlsalmeida@gmail.com>
Link: https://lore.kernel.org/r/20200718165107.625847-13-dwlsalmeida@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs/core-api: memory-allocation: describe reclaim behaviour
Mike Rapoport [Sun, 19 Jul 2020 15:36:41 +0000 (18:36 +0300)]
docs/core-api: memory-allocation: describe reclaim behaviour

Changelog of commit dcda9b04713c ("mm, tree wide: replace __GFP_REPEAT by
__GFP_RETRY_MAYFAIL with more useful semantic") has very nice description
of GFP flags that affect reclaim behaviour of the page allocator.

It would be pity to keep this description buried in the log so let's expose
it in the Documentation/ as well.

Cc: Michal Hocko <mhocko@suse.com>
Acked-by: Michal Hocko <mhocko@suse.com>
Signed-off-by: Mike Rapoport <rppt@linux.ibm.com>
Link: https://lore.kernel.org/r/20200719153641.231131-1-rppt@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: driver-api: update kernel connector
Wang Long [Mon, 20 Jul 2020 07:24:12 +0000 (15:24 +0800)]
Documentation: driver-api: update kernel connector

This patch changes:
1) Fix typo in kernel connector documentation.
s/cn_netlink_send_multi/cn_netlink_send_mult/
2) update definition of struct cn_msg

Signed-off-by: Wang Long <w@laoqinren.net>
Link: https://lore.kernel.org/r/1595229852-114071-1-git-send-email-w@laoqinren.net
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoarm64: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Mon, 20 Jul 2020 21:12:31 +0000 (23:12 +0200)]
arm64: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200720211231.63831-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs/mm: concepts.rst: remove unnecessary word
Bhaskar Chowdhury [Tue, 21 Jul 2020 11:22:51 +0000 (16:52 +0530)]
docs/mm: concepts.rst: remove unnecessary word

Signed-off-by: Bhaskar Chowdhury <unixbhaskar@gmail.com>
Acked-by: Mike Rapoport <rppt@linux.ibm.com>
Link: https://lore.kernel.org/r/20200721112251.6100-1-unixbhaskar@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: Move kprobes.rst from staging/ to trace/
Naveen N. Rao [Tue, 21 Jul 2020 11:48:22 +0000 (17:18 +0530)]
docs: Move kprobes.rst from staging/ to trace/

Kprobes contitutes a dynamic tracing technology and as such can be
moved alongside documentation of other tracing technologies.

Signed-off-by: Naveen N. Rao <naveen.n.rao@linux.vnet.ibm.com>
Acked-by: Masami Hiramatsu <mhiramat@kernel.org>
Link: https://lore.kernel.org/r/8a09c01c64b2e003d5486c4f0c89740618f1bae4.1595331824.git.naveen.n.rao@linux.vnet.ibm.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: staging/kprobes.rst: Move references to a separate appendix
Naveen N. Rao [Tue, 21 Jul 2020 11:48:21 +0000 (17:18 +0530)]
docs: staging/kprobes.rst: Move references to a separate appendix

Kprobes references are currently listed right after kretprobes example,
and appears to be part of the same section. Move this out to a separate
appendix for clarity.

Signed-off-by: Naveen N. Rao <naveen.n.rao@linux.vnet.ibm.com>
Acked-by: Masami Hiramatsu <mhiramat@kernel.org>
Link: https://lore.kernel.org/r/2bba61cd60eec87fbcca3e4343b7f95afa1178cd.1595331824.git.naveen.n.rao@linux.vnet.ibm.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: staging/kprobes.rst: Update some of the references
Naveen N. Rao [Tue, 21 Jul 2020 11:48:20 +0000 (17:18 +0530)]
docs: staging/kprobes.rst: Update some of the references

Some of the kprobes references are not valid anymore. Update the URLs to
point to their changed locations, where appropriate. Drop two URLs which
do not exist anymore.

Reported-by: Masami Hiramatsu <mhiramat@kernel.org>
Signed-off-by: Naveen N. Rao <naveen.n.rao@linux.vnet.ibm.com>
Acked-by: Masami Hiramatsu <mhiramat@kernel.org>
Link: https://lore.kernel.org/r/ae96223716e61185870244d8f9dff6678de12fa1.1595331824.git.naveen.n.rao@linux.vnet.ibm.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: fix typo for core-api/cpu_hotplug documentation
Yaohui Wang [Wed, 22 Jul 2020 07:38:18 +0000 (15:38 +0800)]
Documentation: fix typo for core-api/cpu_hotplug documentation

fix typo for core-api/cpu_hotplug documentation

Signed-off-by: Yaohui Wang <dillionmango@gmail.com>
Link: https://lore.kernel.org/r/20200722073818.20605-1-dillionmango@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: fb, fix path to modedb.c
Jiri Slaby [Thu, 23 Jul 2020 10:34:54 +0000 (12:34 +0200)]
Documentation: fb, fix path to modedb.c

modedb.c was moved twice since the modedb documentation was written.
Update the path to the current one.

Signed-off-by: Jiri Slaby <jslaby@suse.cz>
Link: https://lore.kernel.org/r/20200723103454.26167-1-jslaby@suse.cz
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: openrisc: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Fri, 10 Jul 2020 06:20:19 +0000 (08:20 +0200)]
docs: openrisc: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200710062019.28755-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoS390: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Thu, 9 Jul 2020 18:27:42 +0000 (20:27 +0200)]
S390: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200709182742.24724-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: ipmi: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Wed, 8 Jul 2020 20:24:17 +0000 (22:24 +0200)]
docs: ipmi: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200708202417.22375-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: gcov: replace links with HTTPS
Alexander A. Klimov [Wed, 8 Jul 2020 16:18:39 +0000 (18:18 +0200)]
docs: gcov: replace links with HTTPS

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200708161839.15170-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoReplace HTTP links with HTTPS ones: 9P FILE SYSTEM
Alexander A. Klimov [Wed, 8 Jul 2020 14:58:04 +0000 (16:58 +0200)]
Replace HTTP links with HTTPS ones: 9P FILE SYSTEM

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200708145804.14887-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: hid: Convert link to https
Alexander A. Klimov [Wed, 8 Jul 2020 12:36:13 +0000 (14:36 +0200)]
docs: hid: Convert link to https

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200708123613.14368-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoReplace HTTP links with HTTPS ones: AFS FILESYSTEM
Alexander A. Klimov [Wed, 8 Jul 2020 08:14:03 +0000 (10:14 +0200)]
Replace HTTP links with HTTPS ones: AFS FILESYSTEM

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200708081403.13323-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoReplace HTTP links with HTTPS ones: OMFS
Alexander A. Klimov [Wed, 8 Jul 2020 06:28:42 +0000 (08:28 +0200)]
Replace HTTP links with HTTPS ones: OMFS

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
          If both the HTTP and HTTPS versions
          return 200 OK and serve the same content:
            Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200708062842.12214-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/filesystems/proc.rst: copy-editing cleanup
Randy Dunlap [Tue, 7 Jul 2020 06:49:57 +0000 (23:49 -0700)]
Documentation/filesystems/proc.rst: copy-editing cleanup

Clean up Documentation/filesystems/proc.rst.

This is basically fixing lots of spelling, grammar, punctuation,
typos, spacing, consistency, section numbering, and headings.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://lore.kernel.org/r/a5f126e6-d67a-154a-1c87-d8f07542a21c@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/driver-api: nvdimm: drop doubled word
Randy Dunlap [Sat, 4 Jul 2020 03:44:58 +0000 (20:44 -0700)]
Documentation/driver-api: nvdimm: drop doubled word

Drop the doubled word "to".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Ira Weiny <ira.weiny@intel.com>
Link: https://lore.kernel.org/r/20200704034502.17199-14-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/driver-api: ntb: drop doubled word
Randy Dunlap [Sat, 4 Jul 2020 03:44:57 +0000 (20:44 -0700)]
Documentation/driver-api: ntb: drop doubled word

Drop the doubled word "with".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Jon Mason <jdmason@kudzu.us>
Cc: Dave Jiang <dave.jiang@intel.com>
Cc: Allen Hubbe <allenbh@gmail.com>
Cc: linux-ntb@googlegroups.com
Link: https://lore.kernel.org/r/20200704034502.17199-13-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: coda: annotate duplicated words
Randy Dunlap [Tue, 7 Jul 2020 18:49:31 +0000 (11:49 -0700)]
Documentation: coda: annotate duplicated words

At first glance it appears that the coda.rst file contains doubled
words "name name" in two places. Turns out it is just confusing
(at least to me), so try to make it clear that the second 'name'
is just the name of a struct field/member.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Jan Harkes <jaharkes@cs.cmu.edu>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Jan Harkes <jaharkes@cs.cmu.edu>
Cc: coda@cs.cmu.edu
Cc: codalist@coda.cs.cmu.edu
Link: https://lore.kernel.org/r/d7c2d274-de28-193f-5a98-9e3e16c6c9d5@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/features: Remove unicore32 from kcov and kmemleak
Tobias Klauser [Tue, 7 Jul 2020 09:09:22 +0000 (11:09 +0200)]
Documentation/features: Remove unicore32 from kcov and kmemleak

Commit 3839a7460721 ("Documentation/features: Add kcov") and
commit 4641961cff2f ("Documentation/features: Add kmemleak") were added
shortly after the unicore32 port was removed in commit fb37409a01b0
("arch: remove unicore32 port"). Remove the unicore32 feature lines from
kcov and kmemleak as well.

Signed-off-by: Tobias Klauser <tklauser@distanz.ch>
Link: https://lore.kernel.org/r/20200707090922.4746-1-tklauser@distanz.ch
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDriver-API: Documentation: Replace deprecated :c:func: Usage
Puranjay Mohan [Tue, 7 Jul 2020 05:32:52 +0000 (11:02 +0530)]
Driver-API: Documentation: Replace deprecated :c:func: Usage

Replace :c:func: with func() as the previous usage is deprecated.

Signed-off-by: Puranjay Mohan <puranjay12@gmail.com>
Link: https://lore.kernel.org/r/20200707053252.32703-1-puranjay12@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: locking: ww-mutex-design: drop duplicated word
Randy Dunlap [Fri, 3 Jul 2020 21:36:49 +0000 (14:36 -0700)]
Documentation: locking: ww-mutex-design: drop duplicated word

Drop the doubled word "up".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Will Deacon <will@kernel.org>
Link: https://lore.kernel.org/r/20200703213649.30948-3-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: locking: mutex-design: fix duplicated word
Randy Dunlap [Fri, 3 Jul 2020 21:36:48 +0000 (14:36 -0700)]
Documentation: locking: mutex-design: fix duplicated word

Change the phrase "at at least" to "to at least" to be more
readable.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Will Deacon <will@kernel.org>
Link: https://lore.kernel.org/r/20200703213649.30948-2-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: x86: earlyprintk: drop doubled words
Randy Dunlap [Fri, 3 Jul 2020 21:31:06 +0000 (14:31 -0700)]
Documentation: x86: earlyprintk: drop doubled words

Drop the doubled word "and".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Borislav Petkov <bp@alien8.de>
Cc: x86@kernel.org
Cc: "H. Peter Anvin" <hpa@zytor.com>
Link: https://lore.kernel.org/r/20200703213107.30758-2-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: x86: machinecheck: drop doubled words
Randy Dunlap [Fri, 3 Jul 2020 21:31:07 +0000 (14:31 -0700)]
Documentation: x86: machinecheck: drop doubled words

Drop the doubled word "see".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Ingo Molnar <mingo@redhat.com>
Cc: Borislav Petkov <bp@alien8.de>
Cc: x86@kernel.org
Cc: "H. Peter Anvin" <hpa@zytor.com>
Link: https://lore.kernel.org/r/20200703213107.30758-3-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: vm/memory-model: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:13 +0000 (11:04 -0700)]
Documentation: vm/memory-model: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Mike Rapoport <rppt@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-mm@kvack.org
Link: https://lore.kernel.org/r/20200707180414.10467-20-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: virt/kvm/api: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:14 +0000 (11:04 -0700)]
Documentation: virt/kvm/api: eliminate duplicated word

Drop the duplicated word "struct".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Paolo Bonzini <pbonzini@redhat.com>
Cc: kvm@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-21-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: security/keys: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:12 +0000 (11:04 -0700)]
Documentation: security/keys: eliminate duplicated word

Drop the doubled word "in".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Jarkko Sakkinen <jarkko.sakkinen@linux.intel.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: James Bottomley <jejb@linux.ibm.com>
Cc: Jarkko Sakkinen <jarkko.sakkinen@linux.intel.com>
Cc: Mimi Zohar <zohar@linux.ibm.com>
Cc: linux-integrity@vger.kernel.org
Cc: keyrings@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-19-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: s390/vfio-ap: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:10 +0000 (11:04 -0700)]
Documentation: s390/vfio-ap: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Pierre Morel <pmorel@linux.ibm.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Tony Krowiak <akrowiak@linux.ibm.com>
Cc: Pierre Morel <pmorel@linux.ibm.com>
Cc: Halil Pasic <pasic@linux.ibm.com>
Cc: linux-s390@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-17-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: powerpc/vas-api: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:09 +0000 (11:04 -0700)]
Documentation: powerpc/vas-api: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Michael Ellerman <mpe@ellerman.id.au>
Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org>
Cc: Paul Mackerras <paulus@samba.org>
Cc: linuxppc-dev@lists.ozlabs.org
Link: https://lore.kernel.org/r/20200707180414.10467-16-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: misc/xilinx_sdfec: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:08 +0000 (11:04 -0700)]
Documentation: misc/xilinx_sdfec: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Dragan Cvetic <dragan.cvetic@xilinx.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Derek Kiernan <derek.kiernan@xilinx.com>
Cc: Dragan Cvetic <dragan.cvetic@xilinx.com>
Link: https://lore.kernel.org/r/20200707180414.10467-15-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: mips/ingenic-tcu: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:07 +0000 (11:04 -0700)]
Documentation: mips/ingenic-tcu: eliminate duplicated word

Drop the doubled word "to".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Paul Cercueil <paul@crapouillou.net>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Paul Cercueil <paul@crapouillou.net>
Cc: Thomas Bogendoerfer <tsbogend@alpha.franken.de>
Cc: linux-mips@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-14-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: maintainer-entry-profile: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:06 +0000 (11:04 -0700)]
Documentation: maintainer-entry-profile: eliminate duplicated word

Drop the doubled word "have".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Dan Williams <dan.j.williams@intel.com>
Link: https://lore.kernel.org/r/20200707180414.10467-13-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: leds/ledtrig-transient: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:05 +0000 (11:04 -0700)]
Documentation: leds/ledtrig-transient: eliminate duplicated word

Drop the doubled word "for".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Jacek Anaszewski <jacek.anaszewski@gmail.com>
Acked-by: Pavel Machek <pavel@ucw.cz>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Jacek Anaszewski <jacek.anaszewski@gmail.com>
Cc: Pavel Machek <pavel@ucw.cz>
Cc: Dan Murphy <dmurphy@ti.com>
Cc: linux-leds@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-12-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: kbuild/kconfig-language: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:04 +0000 (11:04 -0700)]
Documentation: kbuild/kconfig-language: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Masahiro Yamada <masahiroy@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Masahiro Yamada <masahiroy@kernel.org>
Cc: Michal Marek <michal.lkml@markovi.net>
Cc: linux-kbuild@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-11-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: i2c: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:03 +0000 (11:04 -0700)]
Documentation: i2c: eliminate duplicated word

Drop doubled word "new".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Wolfram Sang <wsa@kernel.org>
Cc: linux-i2c@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-10-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: hid/intel-ish-hid: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:02 +0000 (11:04 -0700)]
Documentation: hid/intel-ish-hid: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Srinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
Cc: Jiri Kosina <jikos@kernel.org>
Cc: linux-input@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-9-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: gpu/drm-uapi: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:01 +0000 (11:04 -0700)]
Documentation: gpu/drm-uapi: eliminate duplicated word

Drop the doubled word "when".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: David Airlie <airlied@linux.ie>
Cc: Daniel Vetter <daniel@ffwll.ch>
Cc: dri-devel@lists.freedesktop.org
Link: https://lore.kernel.org/r/20200707180414.10467-8-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: gpu/komeda-kms: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:04:00 +0000 (11:04 -0700)]
Documentation: gpu/komeda-kms: eliminate duplicated word

Drop the doubled word "and".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: James Qian Wang <james.qian.wang@arm.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: James (Qian) Wang <james.qian.wang@arm.com>
Cc: Liviu Dudau <liviu.dudau@arm.com>
Cc: Mihail Atanassov <mihail.atanassov@arm.com>
Cc: Mali DP Maintainers <malidp@foss.arm.com>
Link: https://lore.kernel.org/r/20200707180414.10467-7-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: fpga: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:03:59 +0000 (11:03 -0700)]
Documentation: fpga: eliminate duplicated word

Drop the doubled word "this".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Wu Hao <hao.wu@intel.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Wu Hao <hao.wu@intel.com>
Cc: linux-fpga@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-6-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: kgdb: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:03:58 +0000 (11:03 -0700)]
Documentation: kgdb: eliminate duplicated word

Drop the doubled word "driver".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Douglas Anderson <dianders@chromium.org>
Acked-by: Daniel Thompson <daniel.thompson@linaro.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Jason Wessel <jason.wessel@windriver.com>
Cc: Daniel Thompson <daniel.thompson@linaro.org>
Cc: Douglas Anderson <dianders@chromium.org>
Cc: kgdb-bugreport@lists.sourceforge.net
Link: https://lore.kernel.org/r/20200707180414.10467-5-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: printk-basics: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:03:57 +0000 (11:03 -0700)]
Documentation: printk-basics: eliminate duplicated word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-4-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: block: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:03:56 +0000 (11:03 -0700)]
Documentation: block: eliminate duplicated word

Change the doubled word "the" to "to the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Jens Axboe <axboe@kernel.dk>
Cc: linux-block@vger.kernel.org
Link: https://lore.kernel.org/r/20200707180414.10467-3-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: numaperf: eliminate duplicated word
Randy Dunlap [Tue, 7 Jul 2020 18:03:55 +0000 (11:03 -0700)]
Documentation: numaperf: eliminate duplicated word

Drop the duplicated word "not".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: linux-mm@vger.kernel.org
Cc: Mike Rapoport <rppt@kernel.org>
Link: https://lore.kernel.org/r/20200707180414.10467-2-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodoc: yama: Swap HTTP for HTTPS and replace dead link
Kees Cook [Thu, 9 Jul 2020 18:51:35 +0000 (11:51 -0700)]
doc: yama: Swap HTTP for HTTPS and replace dead link

Replace one dead link for the same person's original presentation on the
topic and swap an HTTP URL with HTTPS. While here, linkify the text to
make it more readable when rendered.

Link: https://lore.kernel.org/lkml/20200708073346.13177-1-grandmaster@al2klimov.de/
Co-developed-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Signed-off-by: Kees Cook <keescook@chromium.org>
Link: https://lore.kernel.org/r/202007091141.C008B89EC@keescook
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation/security-bugs: Explain why plain text is preferred
Kees Cook [Thu, 9 Jul 2020 18:11:30 +0000 (11:11 -0700)]
Documentation/security-bugs: Explain why plain text is preferred

The security contact list gets regular reports contained in archive
attachments. This tends to add some back-and-forth delay in dealing with
security reports since we have to ask for plain text, etc.

Signed-off-by: Kees Cook <keescook@chromium.org>
Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Acked-by: Jiri Kosina <jkosina@suse.cz>
Acked-by: Gustavo A. R. Silva <gustavoars@kernel.org>
Acked-by: Will Deacon <will@kernel.org>
Acked-by: Willy Tarreau <w@1wt.eu>
Link: https://lore.kernel.org/r/202007091110.205DC6A9@keescook
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: locking: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Mon, 13 Jul 2020 11:57:28 +0000 (13:57 +0200)]
docs: locking: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200713115728.33905-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: kvm: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Mon, 13 Jul 2020 11:47:19 +0000 (13:47 +0200)]
docs: kvm: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200713114719.33839-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: filesystems: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Mon, 13 Jul 2020 11:37:05 +0000 (13:37 +0200)]
docs: filesystems: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200713113705.33773-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agodocs: driver-api: i3c: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Mon, 13 Jul 2020 11:26:57 +0000 (13:26 +0200)]
docs: driver-api: i3c: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200713112657.33694-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agokobject: documentation: Replace HTTP links with HTTPS ones
Alexander A. Klimov [Mon, 13 Jul 2020 14:41:03 +0000 (16:41 +0200)]
kobject: documentation: Replace HTTP links with HTTPS ones

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
  If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`:
            If both the HTTP and HTTPS versions
            return 200 OK and serve the same content:
              Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov <grandmaster@al2klimov.de>
Link: https://lore.kernel.org/r/20200713144103.35049-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoSecurity: Documentation: Replace deprecated :c:func: Usage
Puranjay Mohan [Mon, 6 Jul 2020 18:49:56 +0000 (00:19 +0530)]
Security: Documentation: Replace deprecated :c:func: Usage

Replace :c:func: with ``func()`` as the previous usage is deprecated.
Remove an extra ')' to fix broken cross reference.

Signed-off-by: Puranjay Mohan <puranjay12@gmail.com>
Link: https://lore.kernel.org/r/20200706184956.6928-1-puranjay12@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: filesystems: vfs: drop doubled words
Randy Dunlap [Fri, 3 Jul 2020 21:43:25 +0000 (14:43 -0700)]
Documentation: filesystems: vfs: drop doubled words

Drop the doubled words "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
Cc: linux-fsdevel@vger.kernel.org
Link: https://lore.kernel.org/r/20200703214325.31036-11-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
3 years agoDocumentation: filesystems: sysfs-tagging: drop doubled word
Randy Dunlap [Fri, 3 Jul 2020 21:43:24 +0000 (14:43 -0700)]
Documentation: filesystems: sysfs-tagging: drop doubled word

Drop the doubled word "the".

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
Cc: Alexander Viro <viro@zeniv.linux.org.uk>
Cc: linux-fsdevel@vger.kernel.org
Link: https://lore.kernel.org/r/20200703214325.31036-10-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>