Re: [PATCH] Documentation: Chinese translation of Documentation/arm64/perf.rst

2020-09-26 Thread Jonathan Corbet
On Sat, 26 Sep 2020 22:35:51 +0800 Alex Shi wrote: > Why your patch repeatly has encoding issue which fails on 'git am' > Could you like to check the problem before send out? > Could you please fix your editor issue by > Documentation/process/email-clients.rst > or send patch by git send-email.

Re: [PATCH v3 2/2] docs: trace: ring-buffer-design.rst: use the new SPDX tag

2020-09-24 Thread Jonathan Corbet
On Fri, 18 Sep 2020 13:19:17 -0400 Steven Rostedt wrote: > On Wed, 9 Sep 2020 07:14:33 +0200 > Mauro Carvalho Chehab wrote: > > > SPDX v3.10 gained support for GFDL-1.2 with no invariant sections: > > > > https://spdx.org/licenses/GFDL-1.2-no-invariants-only.html > > > > Let's use it, in

Re: [PATCH] Documentation: kernel-parameters: clarify "module." parameters

2020-09-24 Thread Jonathan Corbet
ction in the > help text. > > OTOH, "module.sig_enforce" is handled as a parameter of kernel/module.c > so "module." is correct for it. > > Signed-off-by: Randy Dunlap > Cc: Andrew Morton > Cc: Jessica Yu > Cc: Jonathan Corbet > Cc: linu

Re: [PATCH] Fix references to nommu-mmap.rst

2020-09-24 Thread Jonathan Corbet
On Wed, 12 Aug 2020 11:22:30 +0200 Stephen Kitt wrote: > nommu-mmap.rst was moved to Documentation/admin-guide/mm; this patch > updates the remaining stale references to Documentation/mm. > > Fixes: 800c02f5d030 ("docs: move nommu-mmap.txt to admin-guide and rename to > ReST") > Signed-off-by:

Re: [PATCH v2] docs: rewrite admin-guide/sysctl/abi.rst

2020-09-24 Thread Jonathan Corbet
On Thu, 17 Sep 2020 09:21:23 +0200 Stephen Kitt wrote: > Following the structure used in sysctl/kernel.rst, this updates > abi.rst to use ReStructured Text more fully and updates the entries to > match current kernels: > > * the list of files is now the table of contents; > * links are used

Re: [PATCH v4 0/4] docs: fb: Removed framebuffer scrollback related documentations

2020-09-24 Thread Jonathan Corbet
On Thu, 17 Sep 2020 15:56:11 +0530 Bhaskar Chowdhury wrote: > In this patch series, documentation get in sync with the code removal > of scrollback,by this commit 50145474f6ef ("fbcon: remove soft scrollback > code"), > by eliminating the information related to it. > > > Changes since V3: > >

Re: [RFC PATCH v2 0/2] Documentation/admin-guide: remove use of "rdev"

2020-09-24 Thread Jonathan Corbet
nel.org > Cc: Alexander Viro > Cc: Martin Mares > Cc: linux-vi...@atrey.karlin.mff.cuni.cz > Cc: "H. Peter Anvin" > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > > > [RFC PATCH 1/2] Documentation/admin-guide: README & svga: remove use of > &qu

Re: [PATCH] Documentation/admin-guide: kernel-parameters: capitalize Korina

2020-09-24 Thread Jonathan Corbet
On Thu, 17 Sep 2020 22:47:22 -0700 Randy Dunlap wrote: > Fix typo, capitalize Korina proper noun. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > Documentation/admin-guide/kernel-parameters.txt |2 +- > 1 file ch

Re: [PATCH] Documentation: admin-guide: kernel-parameters: reformat "lapic=" boot option

2020-09-24 Thread Jonathan Corbet
v Petkov > Cc: x...@kernel.org > Cc: "H. Peter Anvin" > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > Documentation/admin-guide/kernel-parameters.txt |3 ++- > 1 file changed, 2 insertions(+), 1 deletion(-) > > --- linux-next-20200917.o

Re: [PATCH] Documentation/admin-guide: kernel-parameters: capitalize Korina

2020-09-24 Thread Jonathan Corbet
On Thu, 17 Sep 2020 22:47:22 -0700 Randy Dunlap wrote: > Fix typo, capitalize Korina proper noun. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > Documentation/admin-guide/kernel-parameters.txt |2 +- > 1 file ch

Re: [PATCH] Documentation/admin-guide: kernel-parameters: fix "io7" parameter description

2020-09-24 Thread Jonathan Corbet
On Thu, 17 Sep 2020 22:47:51 -0700 Randy Dunlap wrote: > Fix punctuation and capitalization for the "io7" boot parameter. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > Documentation/admin-guide/kernel-parameters.

Re: [PATCH] Documentation/admin-guide: kernel-parameters: fix "disable_ddw" wording

2020-09-24 Thread Jonathan Corbet
On Thu, 17 Sep 2020 22:48:03 -0700 Randy Dunlap wrote: > Drop and extraneous word (if) in a sentence. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > Documentation/admin-guide/kernel-parameters.txt |2 +- > 1 file ch

Re: [PATCH v2] docs: admin-guide: update kdump documentation due to change of crash URL

2020-09-24 Thread Jonathan Corbet
On Thu, 24 Sep 2020 09:56:02 +0800 lijiang wrote: > Since crash utility has been moved to github, the original URL is no > longer available. Let's update it accordingly. > > Suggested-by: Dave Young > Signed-off-by: Lianbo Jiang > --- > Documentation/admin-guide/kdump/kdump.rst | 7 +-- >

Re: [PATCH v2] Documentation: Chinese translation of Documentation/arm64/amu.rst

2020-09-24 Thread Jonathan Corbet
On Fri, 18 Sep 2020 02:21:36 -0700 Bailu Lin wrote: > This is a Chinese translated version of Documentation/arm64/amu.rst > > Signed-off-by: Bailu Lin > --- > Changes in v2: > - Add index to arm64 directoy. > - Fix a document format error. > - Correct email encoding format. > --- > Document

Re: [PATCH] Documentation: kernel-parameters: fix formatting of MIPS "machtype"

2020-09-24 Thread Jonathan Corbet
On Fri, 18 Sep 2020 17:52:02 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > For the "machtype" boot parameter, > fix word spacing, line wrap, and plural of "laptops". > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger

Re: [PATCH] Documentation: filesystems: mount_api: fix headings

2020-09-24 Thread Jonathan Corbet
On Fri, 18 Sep 2020 19:03:11 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Fix capitalization in two headings, correct one verb, and > demote one heading to a section heading. > > Fixes: 791a17ee1973 ("docs: filesystems: convert mount_api.txt to ReST") > Signed-off-by: Randy Dunlap > Cc:

Re: [PATCH V2] Doc: admin-guide: Add entry for kvm_cma_resv_ratio kernel param

2020-09-24 Thread Jonathan Corbet
ode PowerPC KVM guests. > > Cc: linux-kernel@vger.kernel.org > Cc: kvm-...@vger.kernel.org > Cc: linuxppc-...@lists.ozlabs.org > Cc: Paul Mackerras > Cc: Michael Ellerman > Cc: Jonathan Corbet > Reviewed-by: Randy Dunlap > Signed-off-by: Satheesh Rajendran > --- >

Re: [PATCH v3] documentation: arm: sunxi: Allwinner H2+/H3 update

2020-09-24 Thread Jonathan Corbet
On Wed, 23 Sep 2020 08:59:54 +0200 Wilken Gottwalt wrote: > Replaced the link to the datasheet by a link to the current version. > > Signed-off-by: Wilken Gottwalt > --- > Changes in v3: > - removed the description of the H2+/H3 differences > Changes in v2: > - addressed comment

Re: [PATCH v2 1/5] docs: cdomain.py: add support for two new Sphinx 3.1+ tags

2020-09-24 Thread Jonathan Corbet
On Thu, 24 Sep 2020 18:21:45 +0200 Mauro Carvalho Chehab wrote: > As part of changing the documentation subsystem to properly > build with Sphinx 3.1+, add support for two tags: > > - :c:expr:`foo` > - .. c:namespace::" So is there a reason we need :c:expr: ? What does it add for u

Re: [PATCH v2 2/5] media: docs: make CEC documents compatible with Sphinx 3.1+

2020-09-24 Thread Jonathan Corbet
On Thu, 24 Sep 2020 18:21:46 +0200 Mauro Carvalho Chehab wrote: > -:c:func:`close() ` returns 0 on success. On error, -1 is > returned, and > +:c:func:`close()` returns 0 on success. On error, -1 is returned, and So while you're at it, it seems like all the :c:func: markups could come out, righ

Re: [PATCH 1/2] docs: cdomain.py: add support for two new Sphinx 3.1+ tags

2020-09-24 Thread Jonathan Corbet
On Thu, 24 Sep 2020 18:13:54 +0200 Mauro Carvalho Chehab wrote: > > How can this possibly work without a "global namespace" declaration in > > markup_namespace()? > > ... While I'm not a python expert, the namespace variable is global > because it was defined outside the "markup_namespace"

Re: [PATCH 1/2] docs: cdomain.py: add support for two new Sphinx 3.1+ tags

2020-09-24 Thread Jonathan Corbet
So I'm just getting into this and trying to understand what's really going on, but one thing jumped at me: On Thu, 24 Sep 2020 13:22:04 +0200 Mauro Carvalho Chehab wrote: > +# Namespace to be prepended to the full name > +namespace = None > + > +# > +# Handle trivial newer c domain tags that are

Re: [PATCH 0/3] Fix Kernel-doc warnings introduced on next-20200921

2020-09-22 Thread Jonathan Corbet
On Tue, 22 Sep 2020 20:52:06 +0300 Ville Syrjälä wrote: > Mea culpa. My doc test build was foiled by the sphinx 2 vs. 3 > regression and I was too lazy to start downgrading things. > Any ETA for getting that fixed btw? There's a fix of sorts in docs-next (and thus linux-next) now, has been there

Re: [PATCH 0/3] docs: Add automatic cross-reference for documentation pages

2020-09-16 Thread Jonathan Corbet
On Fri, 11 Sep 2020 13:34:27 + Nícolas F. R. A. Prado wrote: > Cross-referencing from a documentation page to another can be done using the > :doc:`doc-file` directive from Sphinx. > This however introduces markup that could be avoided to increase readability > in > plain text. > This patch

Re: [PATCH] docs: rewrite admin-guide/sysctl/abi.rst

2020-09-16 Thread Jonathan Corbet
On Fri, 11 Sep 2020 21:01:52 +0200 Stephen Kitt wrote: > Following the structure used in sysctl/kernel.rst, this updates > abi.rst to use ReStructured Text more fully and updates the entries to > match current kernels: > > * the list of files is now the table of contents; > * links are used

Re: [PATCH] mm/doc: add usage description for migrate_vma_*()

2020-09-16 Thread Jonathan Corbet
On Tue, 15 Sep 2020 11:05:10 +1000 Alistair Popple wrote: > > Ralph wrote all the in kernel tests for this API, so I think he is > > well positioned to write the documentation :) > > I have recently read through most of the code to get back up to date with > recent HMM developments and the do

Re: [PATCH] docs: stable-ABI: Document /sys/kernel/notes

2020-09-16 Thread Jonathan Corbet
On Tue, 8 Sep 2020 23:37:52 -0700 Stephen Boyd wrote: > Document the notes file in sysfs as the running vmlinux's .note section > in binary format. Hopefully this helps someone like me realize the > kernel exposes the note section in sysfs in the future. Take the date > from when the file was in

Re: [PATCH] doc: zh_CN: add translatation for ext3.rst

2020-09-14 Thread Jonathan Corbet
On Mon, 14 Sep 2020 20:08:32 +0800 Wang Qing wrote: > Translate Documentation/filesystems/ext3.rst into Chinese. > > Signed-off-by: Wang Qing > --- > .../translations/zh_CN/filesystems/ext3.rst| 24 > ++ > 1 file changed, 24 insertions(+) Thanks for your patch, I

Re: [PATCH 26/30] iio: iio.h: fix a warning at the kernel-doc markup

2020-09-11 Thread Jonathan Corbet
On Fri, 11 Sep 2020 09:32:56 +0100 Jonathan Cameron wrote: > On Wed, 9 Sep 2020 16:10:57 +0200 > Mauro Carvalho Chehab wrote: > > > There's a warning at iio.h kernel-doc markup: > > > > ./include/linux/iio/iio.h:644: WARNING: Unknown target name: "devm". > > > > Because it is using {devm

Re: [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries

2020-09-10 Thread Jonathan Corbet
On Wed, 9 Sep 2020 20:26:04 -0700 Randy Dunlap wrote: > Add qualifying build option legend [CMA] to kernel boot options > that requirce CMA support to be enabled for them to be usable. > > Also capitalize 'CMA' when it is used as an acronym. > > Signed-off-by:

Re: [PATCH] doc:it_IT: align Italian documentation

2020-09-10 Thread Jonathan Corbet
On Thu, 10 Sep 2020 00:38:39 +0200 Federico Vaga wrote: > Translation for the following patches > > commit 68e4cd17e218 ("docs: deprecated.rst: Add zero-length and one-element > arrays") > commit 5429ef62bcf3 ("compiler/gcc: Raise minimum GCC version for kernel > builds to 4.8") > commit 5b5bb

Re: [PATCH] mm/doc: add usage description for migrate_vma_*()

2020-09-10 Thread Jonathan Corbet
Ralph Campbell > --- > > There shouldn't be any merge conflict with my previous patch which > touched hmm.rst but since Jonathan Corbet took my last patch, perhaps he > would like to take this one through his tree too. I'm happy to take it, but it certainly needs an ack from someb

Re: [PATCH 01/30] .gitignore: docs: ignore sphinx_*/ directories

2020-09-10 Thread Jonathan Corbet
On Wed, 9 Sep 2020 16:10:32 +0200 Mauro Carvalho Chehab wrote: > The default way of building documentation is to use > Sphinx toolchain installed via pip, inside the > Kernel tree main directory. That's what's recommended by: > > scripts/sphinx-pre-install > > As it usually provides a be

Re: [PATCH 00/30] docs: fix documentation build parsing errors

2020-09-10 Thread Jonathan Corbet
On Wed, 9 Sep 2020 16:10:31 +0200 Mauro Carvalho Chehab wrote: > Currently, there are several warnings/errors produced when building > the documentation with "make htmldocs". > > This series fixes almost all such errors. It is produced against > linux-next, branch next-20200909. > > Some of th

Re: [PATCH v2 0/2] ubifs: Fixes around ubifs-authentication.rst

2020-09-09 Thread Jonathan Corbet
On Sat, 5 Sep 2020 22:43:24 +0200 Jonathan Neuschäfer wrote: > In these two patches, I add ubifs-authentication.rst to MAINTAINERS and > add a heading to prevent the chapter headings from being listed in > filesystems/index.html. I've applied the set, thanks. jon

Re: [PATCH] Documentation: iio: fix a typo

2020-09-09 Thread Jonathan Corbet
On Fri, 4 Sep 2020 11:19:11 +0200 poesc...@lemonage.de wrote: > Rename function name to the actual name referenced in > struct iio_sw_trigger_ops. > > Signed-off-by: Lars Poeschel > --- > Documentation/iio/iio_configfs.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH v2] mm/doc: editorial pass on page migration

2020-09-09 Thread Jonathan Corbet
On Wed, 2 Sep 2020 15:52:47 -0700 Ralph Campbell wrote: > Add Sphinx reference links to HMM and CPUSETS, and numerous small > editorial changes to make the page_migration.rst document more readable. > > Signed-off-by: Ralph Campbell > --- > > The patch applies cleanly to the latest linux or li

Re: [PATCH] docs: deprecated.rst: Update zero-length/one-element arrays section

2020-09-09 Thread Jonathan Corbet
On Mon, 31 Aug 2020 20:09:49 -0500 "Gustavo A. R. Silva" wrote: > Update information in the zero-length and one-element arrays section > and illustrate how to make use of the new flex_array_size() helper, > together with struct_size() and a flexible-array member. > > Signed-off-by: Gustavo A. R.

Re: [PATCH v2] Documentation: submit-checklist: add clean builds for new Documentation

2020-09-09 Thread Jonathan Corbet
On Sun, 30 Aug 2020 17:43:54 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Add to Documentation/process/submit-checklist.rst that patch > submitters should run "make htmldocs" and verify that any > Documentation/ changes (patches) are clean (no new warnings/errors). > > Signed-off-by: Ran

Re: [PATCH] docs: filesystems: replace to_dev() with kobj_to_dev()

2020-09-09 Thread Jonathan Corbet
On Sun, 30 Aug 2020 17:41:35 +0300 Denis Efremov wrote: > Commit a4232963757e ("driver-core: Move kobj_to_dev from genhd.h to device.h") > introduced kobj_to_dev() function. > > Signed-off-by: Denis Efremov > --- > Documentation/filesystems/sysfs.rst| 3 +-- > Documentation

Re: [PATCH] Documentation: remove current_security() reference

2020-09-09 Thread Jonathan Corbet
On Sun, 30 Aug 2020 17:25:09 +0300 Denis Efremov wrote: > Commit 15322a0d90b6 ("lsm: remove current_security()") removed > current_security() from the sources. > > Signed-off-by: Denis Efremov > --- > Documentation/security/credentials.rst | 1 - > 1 file changed, 1 deletion(-) > > diff --git

Re: [PATCH v4] docs: trusted-encrypted.rst: update parameters for command examples

2020-09-09 Thread Jonathan Corbet
fan Berger > Cc: Dan Williams > Cc: James Bottomley > Cc: Jason Gunthorpe > Cc: Jonathan Corbet > Cc: Mimi Zohar > Cc: Peter Huewe > --- > Changelog: > v4: update Reviewed-by list, and Cc linux-doc and linux-integrity > maintainers. > v3: update commit log w

Re: [PATCH] docs: kvm: fix referenced ioctl symbol

2020-09-09 Thread Jonathan Corbet
On Wed, 19 Aug 2020 16:19:52 -0500 Connor Kuehl wrote: > The actual symbol that is exported and usable is > 'KVM_MEMORY_ENCRYPT_OP', not 'KVM_MEM_ENCRYPT_OP' > > $ git grep -l KVM_MEM_ENCRYPT_OP > Documentation/virt/kvm/amd-memory-encryption.rst > > $ git grep -l KVM_MEMORY_ENCRYPT_OP > Documen

Re: [PATCH 0/2] docs: Add automatic cross-reference for C types

2020-09-03 Thread Jonathan Corbet
On Thu, 03 Sep 2020 00:58:09 + Nícolas F. R. A. Prado wrote: > In order to cross-reference C types in the documentation, Sphinx > requires the syntax :c:type:`type_name`, or even :c:type:`struct > type_name ` in order to have the link text different from the > target text. > This patch series

Re: [PATCH] f2fs: Documentation edits/fixes

2020-09-03 Thread Jonathan Corbet
On Wed, 2 Sep 2020 17:08:31 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Correct grammar and spelling. > > Drop duplicate section for resize.f2fs. > > Change one occurrence of F2fs to F2FS for consistency. > > Signed-off-by: Randy Dunlap > Cc: Jaegeuk Kim > Cc: Chao Yu > Cc: linux-f

Re: [PATCH] [v2] Documentation: clarify driver licensing rules

2020-08-31 Thread Jonathan Corbet
On Fri, 14 Aug 2020 07:56:25 -0700 Dave Hansen wrote: > Greg has challenged some recent driver submitters on their license > choices. He was correct to do so, as the choices in these instances > did not always advance the aims of the submitters. > > But, this left submitters (and the folks who h

Re: [PATCH] deprecated.rst: Remove now removed uninitialized_var

2020-08-31 Thread Jonathan Corbet
On Wed, 26 Aug 2020 20:12:01 -0700 Joe Perches wrote: > It's now gone from the kernel so remove it from the deprecated API text. > > Signed-off-by: Joe Perches > --- > Documentation/process/deprecated.rst | 18 -- > 1 file changed, 18 deletions(-) Applied, thanks. jon

Re: [PATCH v2] Documentation: add minimum clang/llvm version

2020-08-31 Thread Jonathan Corbet
On Wed, 26 Aug 2020 12:15:55 -0700 Nick Desaulniers wrote: > Based on a vote at the LLVM BoF at Plumbers 2020, we decided to start > small, supporting just one formal upstream release of LLVM for now. > > We can probably widen the support window of supported versions over > time. Also, note tha

Re: [PATCH 1/2] docs: process: Add cross-link to security-bugs

2020-08-31 Thread Jonathan Corbet
On Thu, 27 Aug 2020 12:53:18 +0200 Krzysztof Kozlowski wrote: > The submitting patches mentions criteria for a fix to be called > "security fix". Add a link to document explaining the entire process > of handling security bugs. > > Cc: Greg KH > Cc: Marek Szyprowski > Cc: Linus Torvalds > Cc

Re: [PATCH] docs/ia64: Drop obsolete Xen documentation

2020-08-31 Thread Jonathan Corbet
On Thu, 27 Aug 2020 18:54:05 +0100 Andrew Cooper wrote: > While the xensource.com URLs referenced still exist, neither the Xen or Linux > 2.6.18 fork have been touched since 2009, 11 years ago. Other URLs are dead. > > IA64 support was removed in Xen 4.2, in 2012. Relegate this piece of > docu

Re: [PATCH v2 0/3] docs/memory-barriers: Apply missed changes

2020-08-31 Thread Jonathan Corbet
On Sat, 29 Aug 2020 10:26:04 +0200 SeongJae Park wrote: > This patchset applies missed changes that should land in the > memory-barriers.txt and its Korean translation. > > The patches are based on v5.9-rc2. > > Changes from v1 > - Fix mismatch between author and Signed-off-by: > > SeongJae P

Re: [PATCH v2 0/2] docs/howto.rst: Sync with original

2020-08-31 Thread Jonathan Corbet
On Sat, 29 Aug 2020 10:23:41 +0200 SeongJae Park wrote: > This patchset syncs howto.rst for recent changes to the original doc and > fix some trivial nits in the translation itself. > > The patches are based on v5.9-rc2. > > Changes from v1 > - Fix mismatch between author and Signed-off-by: >

[GIT PULL] Documentation fixes

2020-08-31 Thread Jonathan Corbet
The following changes since commit 9123e3a74ec7b934a4a099e98af6a61c2f80bbf5: Linux 5.9-rc1 (2020-08-16 13:04:57 -0700) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.9-3 for you to fetch changes up to 92001bc0365a144783f8f3108be94e74baf61011: Documentatio

Re: linux-next: build failure after upgrading sphinx

2020-08-31 Thread Jonathan Corbet
On Thu, 27 Aug 2020 14:50:17 +1000 Stephen Rothwell wrote: > Today I upgraded ot sphinx v3.2.1 and got the following error from > "make htmldocs": > > Running Sphinx v3.2.1 > enabling CJK for LaTeX builder > > Extension error: > Could not import extension cdomain (exception: cannot import name

Results from the 2020 Linux Foundation Technical Advisory Board election

2020-08-27 Thread Jonathan Corbet
This year's election for the Linux Foundation Technical Advisory Board had 955 authorized voters; 235 of them cast ballots. The results were: 1: Laura Abbott 2: Kees Cook 3: Dan Williams 4: Christian Brauner 5: Chris Mason 6: Olof Johan

Re: [PATCH] docs: fb: Correcting the location of FRAMEBUFFER_CONSOLE option.

2020-08-26 Thread Jonathan Corbet
On Wed, 26 Aug 2020 23:47:31 +0500 Bilal Wasim wrote: > On Mon, 24 Aug 2020 19:51:55 +0500 > Bilal Wasim wrote: [...] > > Can this simple patch be merged? You sent it two days ago. During a major community conference. Please be patient, somebody will get to it when they have a chance. jonv

Re: [PATCH] docs: trace: ring-buffer-design.rst: use the new SPDX tag

2020-08-26 Thread Jonathan Corbet
On Wed, 26 Aug 2020 09:28:24 +0200 Mauro Carvalho Chehab wrote: > SPDX v3.10 gained support for GFDL-1.2 with no invariant sections: > > https://spdx.org/licenses/GFDL-1.2-invariants-only.html > > Let's use it, instead of keeping a license text for this file. > > Signed-off-by: Mauro Car

Re: [PATCH] Documentation: add minimum clang/llvm version

2020-08-25 Thread Jonathan Corbet
On Tue, 25 Aug 2020 15:51:31 -0700 Nathan Chancellor wrote: > > +Clang/LLVM (optional) 10.0.1 clang --version > > Maybe it is worth making the "(optional)" a footnote like Sphinx? Seems > to just kind of stick out to me but I do not have a strong opinion > unless others do. Let's n

Re: linux-next: Signed-off-by missing for commit in the jc_docs tree

2020-08-24 Thread Jonathan Corbet
On Tue, 25 Aug 2020 09:13:46 +1000 Stephen Rothwell wrote: > Commit > > 09824ed3a906 ("Documentation/locking/locktypes: fix local_locks > documentation") > > is missing a Signed-off-by from its committer. *That* is weird...it was applied with the same "git am" script as all the rest... Tha

Re: [PATCH] Documentation: laptops: thinkpad-acpi: fix underline length build warning

2020-08-24 Thread Jonathan Corbet
On Sun, 23 Aug 2020 15:55:16 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Fix underline length build warning in thinkpad-acpi.rst documentation: > > Documentation/admin-guide/laptops/thinkpad-acpi.rst:1437: WARNING: Title > underline too short. > DYTC Lapmode sensor > --

Re: [PATCH] Documentation: add riscv entry in list of existing profiles

2020-08-24 Thread Jonathan Corbet
On Sat, 15 Aug 2020 13:57:28 +0200 Lukas Bulwahn wrote: > As long as there are only a few maintainer entry profiles, i.e., three > in v5.8, continue to maintain a complete a list of entries in the > maintainer handbook. > > Complete the list by adding the RISC-V ARCHITECTURE maintainer entry > p

Re: [PATCH] MAINTAINERS: mention documentation maintainer entry profile

2020-08-24 Thread Jonathan Corbet
On Sat, 15 Aug 2020 12:26:58 +0200 Lukas Bulwahn wrote: > Since commit 53b7f3aa411b ("Add a maintainer entry profile for > documentation"), the documentation "subsystem" has a maintainer entry > profile, and it deserves to be mentioned in MAINTAINERS with a suitable > P: entry. > > Signed-off-by

Re: [PATCH] Fpga: Documentation: Replace deprecated :c:func: Usage

2020-08-24 Thread Jonathan Corbet
On Wed, 12 Aug 2020 23:32:24 +0530 Puranjay Mohan wrote: > Replace :c:func: with func() as the previous usage is deprecated. > > Signed-off-by: Puranjay Mohan > --- > Documentation/driver-api/fpga/fpga-bridge.rst | 6 +++--- > Documentation/driver-api/fpga/fpga-mgr.rst | 6 +++--- > ...

Re: [PATCH] IIO: Documentation: Replace deprecated :c:func: Usage

2020-08-24 Thread Jonathan Corbet
On Wed, 12 Aug 2020 23:16:11 +0530 Puranjay Mohan wrote: > Replace :c:func: with func() as the previous usage is deprecated. > > Signed-off-by: Puranjay Mohan > --- > Documentation/driver-api/iio/core.rst | 16 > 1 file changed, 8 insertions(+), 8 deletions(-) Applied, thanks

Re: [PATCH] Documentation/locking/locktypes: fix local_locks documentation

2020-08-24 Thread Jonathan Corbet
On Sun, 26 Jul 2020 20:54:40 +0200 Marta Rybczynska wrote: > Fix issues with local_locks documentation: > - fix function names, local_lock.h has local_unlock_irqrestore(), > not local_lock_irqrestore() > - fix mapping table, local_unlock_irqrestore() maps to local_irq_restore(), > not _save() >

LAST CALL: Linux Foundation Technical Advisory Board election 2020

2020-08-19 Thread Jonathan Corbet
Greg Kroah-Hartman Jonathan Corbet Sasha Levin Steven Rostedt Ted Ts'o Anyone is eligible to stand for election; simply send your nomination to: tech-board-disc...@lists.linux-foundation.org With your nomination, please include a shor

[GIT PULL] Documentation fixes for 5.9

2020-08-13 Thread Jonathan Corbet
The following changes since commit 2c12c8103d8f15790cf880f1545dafa36acb004a: scripts/kernel-doc: optionally treat warnings as errors (2020-07-31 11:11:17 -0600) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.9-2 for you to fetch changes up to 1edcd4675e44dc

Re: [PATCH] Documentation/locking/locktypes: fix the typo

2020-08-13 Thread Jonathan Corbet
On Thu, 13 Aug 2020 14:02:20 +0800 Huang Shijie wrote: > We have three categories locks, not two. > > Signed-off-by: Huang Shijie > --- > Documentation/locking/locktypes.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/locking/locktypes.rst > b/Docum

Re: Documentation: build failure with sphinx >= 3.0.0: exception: cannot import name 'c_funcptr_sig_re' from 'sphinx.domains.c'

2020-08-12 Thread Jonathan Corbet
On Wed, 12 Aug 2020 10:21:40 +0200 Markus Heiser wrote: > @jon, do you have time to implement a patch? > .. sorry, I'am in a hurry :o This is on my list ... but life is busy at the moment. I would not be distressed if somebody beat me to it. jon

Re: [PATCH] doc/zh_CN: resolve undefined label warning in admin-guide index

2020-08-11 Thread Jonathan Corbet
On Sun, 2 Aug 2020 18:19:56 +0200 Lukas Bulwahn wrote: > 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: 37

Re: [PATCH v2] docs: remove the 2.6 "Upgrading I2C Drivers" guide

2020-08-11 Thread Jonathan Corbet
On Thu, 6 Aug 2020 18:14:56 +0200 Stephen Kitt wrote: > 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 > --- > Documentation/i2c/index.rst |

Re: [PATCH] docs: Fix function name trailing double-()s

2020-08-11 Thread Jonathan Corbet
On Fri, 7 Aug 2020 23:49:59 -0700 Kees Cook wrote: > I noticed a double-() after a function name in deprecated.rst today. Fix > that one and two others in the Documentation/ tree. > > Signed-off-by: Kees Cook > --- > Documentation/RCU/lockdep.rst | 2 +- > Documentati

Re: [PATCH] mailmap: Update comments for with format and more detalis

2020-08-11 Thread Jonathan Corbet
On Sat, 8 Aug 2020 00:14:36 -0700 Kees Cook wrote: > Without having first read the git-shortlog man-page first, 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 Applied, thanks. I did

Re: [PATCH] docs: cdrom: Fix a typo and rst markup

2020-08-11 Thread Jonathan Corbet
On Sat, 8 Aug 2020 18:31:23 +0200 Remi Andruccioli wrote: > "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 Andruccio

Re: [PATCH] Doc: admin-guide: use correct legends in kernel-parameters.txt

2020-08-11 Thread Jonathan Corbet
s spelled "X86-64", so make corrections for those. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > Cc: Thomas Gleixner > Cc: Ingo Molnar > Cc: Borislav Petkov > Cc: x...@kernel.org > --- > Documentation/admin-guide

Re: [PATCH v4] documentation: coccinelle: Improve command example for make C={1,2}

2020-08-11 Thread Jonathan Corbet
On Tue, 11 Aug 2020 05:53:50 +0530 Sumera Priyadarsini wrote: > Modify coccinelle documentation to further clarify > the usage of the makefile C variable by coccicheck. > > Signed-off-by: Sumera Priyadarsini > > --- > Changes in v4: > - Modify commit message to clarify C is a variable

Re: [PATCH] Driver-API: Documentation: Replace deprecated :c:func: Usage

2020-08-11 Thread Jonathan Corbet
On Mon, 10 Aug 2020 23:51:07 +0530 Puranjay Mohan wrote: > Replace :c:func: with func() as the previous usage is deprecated. > > Signed-off-by: Puranjay Mohan > --- > Documentation/driver-api/device-io.rst | 22 +++--- > 1 file changed, 11 insertions(+), 11 deletions(-) I appl

Re: [PATCH] Core-api: Documentation: Replace deprecated :c:func: Usage

2020-08-11 Thread Jonathan Corbet
On Tue, 11 Aug 2020 00:00:19 +0530 Puranjay Mohan wrote: > Replace :c:func: with func() as the previous usage is deprecated. > > Signed-off-by: Puranjay Mohan > --- > Documentation/core-api/idr.rst | 32 > 1 file changed, 16 insertions(+), 16 deletions(-) Appl

Re: [PATCH] Dev-tools: Documentation: Replace deprecated :c:func: Usage

2020-08-11 Thread Jonathan Corbet
On Tue, 11 Aug 2020 00:06:13 +0530 Puranjay Mohan wrote: > Replace :c:func: with func() as the previous usage is deprecated. > > Signed-off-by: Puranjay Mohan > --- > Documentation/dev-tools/kgdb.rst | 16 > 1 file changed, 8 insertions(+), 8 deletions(-) Applied, thanks. jo

Re: [PATCH] Filesystems: Documentation: Replace deprecated :c:func: Usage

2020-08-11 Thread Jonathan Corbet
On Tue, 11 Aug 2020 00:18:28 +0530 Puranjay Mohan wrote: > Replace :c:func: with func() as the previous usage is deprecated. > > Signed-off-by: Puranjay Mohan > --- > Documentation/filesystems/journalling.rst | 66 +++ > 1 file changed, 33 insertions(+), 33 deletions(-) Ap

Re: [PATCH v2] documentation: coccinelle: Improve command example for make C={1, 2}

2020-08-10 Thread Jonathan Corbet
On Mon, 10 Aug 2020 09:30:18 +0200 Markus Elfring wrote: > > Modify coccinelle documentation to further clarify > > the usage of the makefile C variable flag by coccicheck. > > How do you think about a wording variant like the following > for the change description? > >Clarify the usage o

Linux Foundation 2020 Technical Advisory Board election: call for nominations

2020-08-03 Thread Jonathan Corbet
) Dan Williams Kees Cook Laura Abbott Olof Johansson The remaining members' terms will expire in 2021: Greg Kroah-Hartman Jonathan Corbet Sasha Levin Steven Rostedt Ted Ts'o Anyone is eligible to stand for electi

[GIT PULL] Documentation for 5.9

2020-08-03 Thread Jonathan Corbet
s Documentation: fb, fix path to modedb.c Jonathan Corbet (5): docs: Don't push Sphinx upgrades quite so readily docs: f2fs: fix a broken table Merge branch 'docs-fixes' into docs-next Merge branch 'mauro' into docs-next docs: CIFS: re

Re: [PATCH v2] scripts/kernel-doc: optionally treat warnings as errors

2020-07-31 Thread Jonathan Corbet
On Tue, 28 Jul 2020 11:20:40 -0500 Pierre-Louis Bossart wrote: > he 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 pat

Re: [PATCH] docs: ia64: correct typo

2020-07-31 Thread Jonathan Corbet
On Thu, 30 Jul 2020 12:17:30 +0200 Julia Lawall wrote: > Replace RTC_WKLAM_RD with RTC_WKALM_RD. > > Signed-off-by: Julia Lawall > > --- > Documentation/ia64/efirtc.rst |2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/ia64/efirtc.rst b/Documentation/i

Re: [PATCH] mailmap: add entry for

2020-07-31 Thread Jonathan Corbet
On Thu, 30 Jul 2020 16:59:45 + Alexander Lobakin wrote: > My Marvell account has been suspended, map the address to my private mail. > > Signed-off-by: Alexander Lobakin > --- > .mailmap | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/.mailmap b/.mailmap > index e662fdac632b..a96

Re: [PATCH] scripts/kernel-doc: optionally treat warnings as errors

2020-07-27 Thread Jonathan Corbet
On Mon, 27 Jul 2020 18:09:21 -0500 Pierre-Louis Bossart wrote: > Both points were covered by the sentence "A command-line option is > provided to the kernel-doc script, as well as a check on environment > variables to turn this optional behavior on". Making that more prominent would be good, bu

Re: [PATCH] Input: fix typo in function name documentation

2020-07-27 Thread Jonathan Corbet
On Fri, 24 Jul 2020 10:40:25 +0200 Pavel Machek wrote: > Fix non-existing constant in documentation. > > Signed-off-by: Pavel Machek (CIP) > > diff --git a/Documentation/input/uinput.rst b/Documentation/input/uinput.rst > index b8e90b6a126c..10c62e62a0a6 100644 > --- a/Documentation/input/uinp

Re: [PATCH] scripts/kernel-doc: optionally treat warnings as errors

2020-07-27 Thread Jonathan Corbet
On Fri, 24 Jul 2020 18:01:38 -0500 Pierre-Louis Bossart wrote: > 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 pa

Re: [PATCH] MAINTAINERS: adjust kprobes.rst entry to new location

2020-07-27 Thread Jonathan Corbet
On Sun, 26 Jul 2020 07:58:43 +0200 Lukas Bulwahn wrote: > 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

Re: [PATCH] devices.txt: document rfkill allocation

2020-07-27 Thread Jonathan Corbet
On Sun, 26 Jul 2020 09:53:27 +0200 Pavel Machek wrote: > Document rfkill allocation. > > Signed-off-by: Pavel Machek (CIP) > > diff --git a/Documentation/admin-guide/devices.txt > b/Documentation/admin-guide/devices.txt > index 2a97aaec8b12..763fedd94d7d 100644 > --- a/Documentation/admin-gui

Re: [PATCH] PCI: correct flag name

2020-07-27 Thread Jonathan Corbet
On Sun, 26 Jul 2020 17:47:35 +0200 Julia Lawall wrote: > RESOURCE_IO does not exist. Rename to IORESOURCE_IO. > > Signed-off-by: Julia Lawall > > --- > Just a guess based on the most similar name... > > Documentation/filesystems/sysfs-pci.rst |2 +- > 1 file changed, 1 insertion(+), 1 d

Re: [PATCH] docs: filesystems: vfs: correct flag name

2020-07-27 Thread Jonathan Corbet
On Sun, 26 Jul 2020 20:43:40 +0200 Julia Lawall wrote: > 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 a

Re: [PATCH] docs: filesystems: vfs: correct sync_mode flag names

2020-07-27 Thread Jonathan Corbet
On Sun, 26 Jul 2020 21:22:21 +0200 Julia Lawall wrote: > 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 > > --- > Documentation/filesystems/vfs.rst |

Re: Minor RST rant

2020-07-24 Thread Jonathan Corbet
On Fri, 24 Jul 2020 13:22:00 -0400 Steven Rostedt wrote: > > It is tempting to describe the second kind as starting with a > > component, but that isn't always accurate: a pathname can lack both > > slashes and components, it can be empty, in other words. This is > > generally forbidden in POSIX

Re: [PATCH v2] CREDITS: Replace HTTP links with HTTPS ones

2020-07-23 Thread Jonathan Corbet
On Tue, 14 Jul 2020 19:55:28 +0200 "Alexander A. Klimov" wrote: > ationale: > 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 c

Re: [PATCH] docs: process: Add an example for creating a fixes tag

2020-07-23 Thread Jonathan Corbet
On Fri, 10 Jul 2020 13:01:15 -0700 t...@redhat.com wrote: > 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 > --- > Documentation/process/submitting-patches.rst | 5 + > 1 file changed, 5 insertions(

Re: [PATCH v2 1/3] doc/zh_CN: add admin-guide index

2020-07-23 Thread Jonathan Corbet
On Mon, 13 Jul 2020 19:58:05 +0800 Alex Shi wrote: > Translate the admin-guide index.rst file into Chinese. and link it into > Chinese top index file. > > Signed-off-by: Alex Shi > Cc: Harry Wei > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > Cc: linu

Re: [PATCH v2] ia64: Replace HTTP links with HTTPS ones

2020-07-23 Thread Jonathan Corbet
On Mon, 13 Jul 2020 23:55:06 +0200 "Alexander A. Klimov" wrote: > Documentation/ia64/xen.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/ia64/xen.rst b/Documentation/ia64/xen.rst > index 831339c74441..9da6abb02a2c 100644 > --- a/Documentation/ia64/xen.

Re: [PATCH 1/1] doc:it_IT: process: coding-style.rst: Correct __maybe_unused compiler label

2020-07-23 Thread Jonathan Corbet
On Wed, 15 Jul 2020 13:23:28 +0100 Lee Jones wrote: > Flag is __maybe_unused, not __maybe_used. > > Cc: Federico Vaga > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > Cc: clang-built-li...@googlegroups.com > Signed-off-by: Lee Jones > --- > Documentation

<    1   2   3   4   5   6   7   8   9   10   >