Re: [PATCH] kbuild: remove PYTHON variable

2021-02-01 Thread Jonathan Corbet
Masahiro Yamada writes: > On Tue, Feb 2, 2021 at 1:38 AM Jonathan Corbet wrote: >> So this will have the effect of making the docs build impossible for >> folks who only have Python 2. > > Is this a problem? Python 2 is EOL. > > Everybody who wants to use Python

[PATCH] Move our minimum Sphinx version to 1.7

2021-02-01 Thread Jonathan Corbet
As promised, drop support for some ancient sphinx releases, along with a lot of the cruft that was required to make that support work. Signed-off-by: Jonathan Corbet --- Gotta love the diffstat :) Documentation/conf.py | 75 ++--- Documentation/sphinx

Re: [PATCH] Documentation/submitting-patches: Add blurb about backtraces in commit messages

2021-02-04 Thread Jonathan Corbet
Borislav Petkov writes: > On Tue, Jan 05, 2021 at 11:48:05AM +0100, Borislav Petkov wrote: > Lemme ping here quick - my TODO list still has it. :-) Yeah, it's been languishing on mine as well. Nobody seems to have any objections, so I applied it, sorry for sitting on it for so long. Thanks, j

Re: [PATCH v2 1/5] docs: arm: marvell: drop some dead links

2021-02-04 Thread Jonathan Corbet
Lubomir Rintel writes: > Just remove these; there's good chance there wasn't anything useful > there anyway. > > Signed-off-by: Lubomir Rintel > > --- > Changes since v1: > - Adjust for removal of "[PATCH 1/5] docs: arm: marvell: turn the automatic > links into labels" > - Split off the hunk t

Re: [PATCH v2 5/5] docs: arm: marvell: rename marvel.rst to marvell.rst

2021-02-04 Thread Jonathan Corbet
Lubomir Rintel writes: > This company is not the superheroes you're looking for. > > Signed-off-by: Lubomir Rintel > --- > Documentation/arm/{marvel.rst => marvell.rst} | 0 > 1 file changed, 0 insertions(+), 0 deletions(-) > rename Documentation/arm/{marvel.rst => marvell.rst} (100%) > > diff

Re: [PATCH v2 0/5] docs: arm: Improvements to Marvell SoC documentation

2021-02-04 Thread Jonathan Corbet
Lubomir Rintel writes: > Hi, > > please consider applying the patches chained to this message. > > The objective is to deal with the a large amount of dead links to > material that often comes handy in marvel.rst; and improve some details > along the way. > > The most important change since v1 is

Re: [PATCH] Documentation: /proc/loadavg: add 3 more field descriptions

2021-02-04 Thread Jonathan Corbet
Randy Dunlap writes: > From: Randy Dunlap > > Update contents of /proc/loadavg: add 3 more fields. ...except that two of those fields are actually a single field with a slash in the middle. > Signed-off-by: Randy Dunlap > Cc: linux-...@vger.kernel.org > --- > Documentation/filesystems/proc.r

Re: [PATCH 01/29] coding-style.rst: Avoid comma statements

2021-02-04 Thread Jonathan Corbet
Joe Perches writes: > On Mon, 2020-08-24 at 21:55 -0700, Joe Perches wrote: >> Commas are not how statements are terminated. >> Always use semicolons and braces if necessary. > > ping? Hey, it's only been five months and some...you gotta stop rushing maintainers this way :) I guess at the time

Re: [PATCH 1/2] docs: Make syscalls' helpers naming consistent

2021-02-04 Thread Jonathan Corbet
André Almeida writes: > The documentation explains the need to create internal syscalls' helpers, > and that they should be called `kern_xyzzy()`. However, the comment at > include/linux/syscall.h says that they should be named as > `ksys_xyzzy()`, and so are all the helpers declared bellow it. C

Re: [PATCH] docs: thermal: fix spelling mistakes

2021-02-04 Thread Jonathan Corbet
Flavio Suligoi writes: > Signed-off-by: Flavio Suligoi > --- > Documentation/driver-api/thermal/sysfs-api.rst | 6 +++--- > 1 file changed, 3 insertions(+), 3 deletions(-) > > diff --git a/Documentation/driver-api/thermal/sysfs-api.rst > b/Documentation/driver-api/thermal/sysfs-api.rst > index

Re: [PATCH 0/2] docs: Add support for relative paths in automarkup

2021-02-04 Thread Jonathan Corbet
Nícolas F. R. A. Prado writes: > As Jon previously noted [1], it would be nice if automarkup supported relative > paths as well when cross-referencing to other documents. This adds the support > for it, and documents it. > > Jon, after applying this, 43bc3ed73639 ("docs: dt: Use full path to enab

Re: [PATCH 0/2] docs: Add support for relative paths in automarkup

2021-02-04 Thread Jonathan Corbet
Randy Dunlap writes: > I just sent a patch for file name changes in > Documentation/input/ff.rst > (https://lore.kernel.org/linux-input/20210203050842.24190-1-rdun...@infradead.org/T/#u). > > I sent it to the INPUT maintainer because I thought that he would > want to review the changes. > > I cou

Re: [PATCH 1/2] Documentation: features: remove c6x references

2021-02-25 Thread Jonathan Corbet
Arnd Bergmann writes: > From: Arnd Bergmann > > The references to arch/c6x are obsolete now that the architecture > is gone. Remove them. > > Signed-off-by: Arnd Bergmann Both applied, thanks. jon

Re: [PATCH] Documentation: cgroup-v2: fix path to example BPF program

2021-02-25 Thread Jonathan Corbet
Antonio Terceiro writes: > This file has been moved into the "progs" subdirectory in > bd4aed0ee73ca873bef3cb3ec746dd796f03df28, together with all test BPF > programs. > > Signed-off-by: Antonio Terceiro > Cc: Tejun Heo > Cc: Zefan Li > Cc: Johannes Weiner

Re: [PATCH -next] docs: proc.rst: fix indentation warning

2021-02-25 Thread Jonathan Corbet
g") > Reported-by: Stephen Rothwell > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > shame on me. > > Documentation/filesystems/proc.rst |2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) Applied, thanks. jon

Re: [PATCH v7 0/2] checkpatch: add verbose mode

2021-02-25 Thread Jonathan Corbet
Dwaipayan Ray writes: > On Thu, Feb 25, 2021 at 11:03 PM Joe Perches wrote: >> I don't have any real objection to this patch set, but as this >> might be added to the Documentation tree and in .rst format, >> perhaps Jonathan Corbet and/or Mauro Carvalho Chehab

Re: linux-next: Fixes tag needs some work in the jc_docs tree

2021-02-25 Thread Jonathan Corbet
Stephen Rothwell writes: > Hi all, > > In commit > > 36eaf08fc283 ("docs: powerpc: Fix tables in syscall64-abi.rst") > > Fixes tag > > Fixes: 209b44c804c ("docs: powerpc: syscall64-abi.rst: fix a malformed > table") > > has these problem(s): > > - SHA1 should be at least 12 digits long > >

[GIT PULL] Documentation fixes for 5.12

2021-02-26 Thread Jonathan Corbet
The following changes since commit 3c2e0a489da6a7c48ad67a246c7a287fcb4a4607: docs: kernel-hacking: be more civil (2021-02-11 10:00:40 -0700) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.12-2 for you to fetch changes up to f37a15ea8db022373a2cb6d1a6004c65c2

Re: [PATCH] zswap: docs/vm: Fix typo accept_threshold_percent in zswap.rst

2020-06-01 Thread Jonathan Corbet
On Mon, 1 Jun 2020 02:59:11 +0200 Sedat Dilek wrote: > Recently, I switched over from swap-file to zramswap. > > When reading the Documentation/vm/zswap.rst file I fell over this typo. > > The parameter is called accept_threshold_percent not accept_threhsold_percent > in /sys/module/zswap/para

Re: [PATCH] Documentation: fixes to the maintainer-entry-profile template

2020-06-01 Thread Jonathan Corbet
igned-off-by: Randy Dunlap > Cc: Dan Williams > Cc: linux-nvd...@lists.01.org > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > Documentation/maintainer/maintainer-entry-profile.rst | 12 +- > 1 file changed, 6 insertions(+), 6 deletions(-) Applied, thanks. jon

[GIT PULL] Documentation for 5.8

2020-06-01 Thread Jonathan Corbet
docs: acpi: fix old http link and improve document format Gal Pressman (1): dma-buf: Couple of documentation typo fixes Jonathan Corbet (3): Merge branch 'mauro' into docs-next Merge branch 'mauro' into docs-next Revert "docs: sysctl/kernel: docu

Re: [PATCH] Replace HTTP links with HTTPS ones: documentation

2020-05-19 Thread Jonathan Corbet
es, you don't want to actually send a patch to such a list of recipients - it's a sign that your patch is too large. Thanks, jon Jonathan Corbet (maintainer:DOCUMENTATION,commit_signer:1/1=100%,commit_signer:1/2=50%,commit_signer:4/5=80%,authored:1/5=20%,commit_signer:2/4=50%,commit_si

Re: [PATCH] Replace HTTP links with HTTPS ones: documentation

2020-05-19 Thread Jonathan Corbet
On Tue, 19 May 2020 20:50:55 +0200 "Alexander A. Klimov" wrote: > > OK, I fed your patch to the script, waited a fair while, and got what's > > below. And yes, you don't want to actually send a patch to such a list of > > recipients - it's a sign that your patch is too large. > Please could yo

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] 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] 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] 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 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] 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] 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] 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: 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 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] 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: 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] 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] 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 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

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

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

Re: linux-next: build warning after merge of the f2fs tree

2021-01-10 Thread Jonathan Corbet
On Mon, 11 Jan 2021 07:33:54 +1100 Stephen Rothwell wrote: > On Thu, 7 Jan 2021 19:28:19 +0800 Chao Yu wrote: > > > > On 2021/1/7 11:11, Stephen Rothwell wrote: > > > > > > After merging the f2fs tree, today's linux-next build (htmldocs) produced > > > this warning: > > > > > > Documentation

Re: [PATCH] Documentation: kernel-hacking: change 'current()' to 'current'

2021-01-11 Thread Jonathan Corbet
On Mon, 11 Jan 2021 10:32:41 + Joe Pater <02joepate...@gmail.com> wrote: > Change 'current()' heading to 'current' to reflect usage. > > Signed-off-by: Joe Pater <02joepate...@gmail.com> > --- > Documentation/kernel-hacking/hacking.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions

Re: [PATCH] Documentation: Replace lkml.org links with lore

2021-01-11 Thread Jonathan Corbet
On Sun, 10 Jan 2021 12:41:44 -0800 Joe Perches wrote: > Replace the lkml.org links with lore to better use a single source > that's more likely to stay available long-term. Makes sense to me...applied, thanks. jon

Re: [PATCH] docs: filesystems: vfs: Correct the struct name

2021-01-11 Thread Jonathan Corbet
On Sun, 10 Jan 2021 15:59:59 +0800 winnd...@163.com wrote: > From: Liao Pingfang > > The struct name should be file_system_type instead of > file_system_operations. > > Signed-off-by: Liao Pingfang > --- > Documentation/filesystems/vfs.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(

Re: [PATCH] Documentation: Fix typos found in cgroup-v2.rst

2021-01-11 Thread Jonathan Corbet
On Thu, 7 Jan 2021 22:11:18 +0800 Jiang Biao wrote: > Fix typos found in Documentation/admin-guide/cgroup-v2.rst. > > Signed-off-by: Jiang Biao > --- > Documentation/admin-guide/cgroup-v2.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/admin-gui

Re: [PATCH v2] Documentation/dax: Update description of DAX policy changing

2021-01-11 Thread Jonathan Corbet
On Tue, 5 Jan 2021 21:45:41 -0800 Ira Weiny wrote: > On Wed, Jan 06, 2021 at 09:50:00AM +0800, Hao Li wrote: > > After commit 77573fa310d9 ("fs: Kill DCACHE_DONTCACHE dentry even if > > DCACHE_REFERENCED is set"), changes to DAX policy will take effect > > as soon as all references to this file a

Re: [PATCH] docs: ALSA: Fix reference to mixart.rst

2021-01-11 Thread Jonathan Corbet
On Fri, 1 Jan 2021 23:19:42 +0100 Jonathan Neuschäfer wrote: > MIXART.txt has been converted to ReST and renamed. Fix the reference > in alsa-configuration.rst. > > Fixes: 3d8e81862ce4 ("ALSA: doc: ReSTize MIXART.txt") > Signed-off-by: Jonathan Neuschäfer > --- > Documentation/sound/alsa-conf

Re: [PATCH] docs: Include ext4 documentation via filesystems/

2021-01-11 Thread Jonathan Corbet
On Fri, 1 Jan 2021 22:52:13 +0100 Jonathan Neuschäfer wrote: > The documentation for other filesystems is already included via > filesystems/index.rst. Include ext4 in the same way and remove it > from the top-level table of contents. > > Signed-off-by: Jonathan Neuschäfer > --- > Documentati

Re: [PATCH] Documentation: document dma device use for mcb

2021-01-11 Thread Jonathan Corbet
On Mon, 11 Jan 2021 10:19:55 + Johannes Thumshirn wrote: > On 18/12/2020 16:35, Johannes Thumshirn wrote: > > Hannes reported a problem with setting up dma transfers on a mcb device. > > The problem boiled down to the use of a wrong 'device' for the dma > > functions. > > > > Document how to

Re: [PATCH] docs: driver-model: bus.rst: Clean up the formatting, expound, modernize

2021-01-11 Thread Jonathan Corbet
On Mon, 21 Dec 2020 07:52:00 - Michael Witten wrote: > * The reStructuredText had some indentation issues. > > * The HTML output was not properly formatted in places. > > * Some of the details were lacking or needed clarification (especially > with regard to how a `struct bus_type` object

Re: [PATCH RFC v2] docs: experimental: build PDF with rst2pdf

2020-12-11 Thread Jonathan Corbet
On Fri, 11 Dec 2020 09:33:32 +0100 Mauro Carvalho Chehab wrote: > Add an experimental PDF builder using rst2pdf > > Signed-off-by: Mauro Carvalho Chehab > --- > > Please notice that 18 documents (of a total of 71) won't build with > rst2pdf. There's an opened issue about that at: > > htt

Re: [PATCH RFC v2] docs: experimental: build PDF with rst2pdf

2020-12-11 Thread Jonathan Corbet
On Sat, 12 Dec 2020 00:54:35 +0100 Mauro Carvalho Chehab wrote: > I'm not an usual python programmer, so, don't know much about its > specifics... Yet, I would be expecting that something like this: > > try: > extensions.append("rst2pdf.pdfbuilder") > except: > s

Re: [PATCH 1/1] docs: submitting-patches: Trivial - fix grammatical error

2020-12-21 Thread Jonathan Corbet
On Wed, 16 Dec 2020 13:46:54 + Lee Jones wrote: > "it is a used" does not make sense. Should be "it is used". > > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > Signed-off-by: Lee Jones > --- > Documentation/process/submitting-patches.

Re: [PATCH v2] Documentation: process: Correct numbering

2020-12-21 Thread Jonathan Corbet
On Tue, 15 Dec 2020 20:42:36 + Milan Lakhani wrote: > Renumber the steps in submit-checklist.rst as some numbers were skipped. > > Fixes: 72deb455b5ec ("block: remove CONFIG_LBDAF") > Signed-off-by: Milan Lakhani > --- > Documentation/process/submit-checklist.rst | 24 -

Re: [PATCH] Documentation/submitting-patches: Document the SoB chain

2020-12-21 Thread Jonathan Corbet
On Thu, 17 Dec 2020 19:37:56 +0100 Borislav Petkov wrote: > ok, let's start slow and with something that should not need a whole lot > of bikeshedding. We have been repeating that a lot of times in the past > which means that, especially new submitters, do not know it. So here it > goes. > > Btw

Re: [PATCH] Documentation: x86: update the thread_info's position

2020-12-21 Thread Jonathan Corbet
On Sat, 5 Dec 2020 13:01:36 +0800 Mingzhe Yang wrote: > Prior to kernel 4.9 the thread_info structure was at the bottom of > the kernel stack. kernel 4.9 moved it into the task_struct. > > See commits c65eacb ("sched/core: Allow putting thread_info into > task_struct"), 15f4eae ("x86: Move thre

Re: [PATCH] docs: admin-guide: Fix default value of max_map_count in sysctl/vm.rst

2020-12-21 Thread Jonathan Corbet
On Thu, 10 Dec 2020 16:21:34 +0800 Fengfei Xi wrote: > Since the default value of sysctl_max_map_count is defined as > DEFAULT_MAX_MAP_COUNT from mm/util.c > > int sysctl_max_map_count __read_mostly = DEFAULT_MAX_MAP_COUNT; > > DEFAULT_MAX_MAP_COUNT is defined as 65530 (65535-5) in include/

Re: linux-next: build warning after merge of the rcu tree

2020-12-07 Thread Jonathan Corbet
On Mon, 7 Dec 2020 08:47:04 -0800 "Paul E. McKenney" wrote: > I freely confess that I have absolutely no idea what it doesn't like. > It is complaining about this header comment, correct? > > /** > * kmem_last_alloc_stack - Get return address and stack for last allocation > * @object: object f

Re: [PATCH] docs: nios2: add missing ReST file

2020-12-07 Thread Jonathan Corbet
On Mon, 7 Dec 2020 09:56:20 +0100 Mauro Carvalho Chehab wrote: > changeset ed13a92d0fde ("docs: archis: add a per-architecture features list") > besides having a typo on its title, it was missing the feature file. > > Add it. > > Reported-by: Stephen Rothwell > Fixes: ed13a92d0fde ("docs: arc

Re: [PATCH v2] docs/zh_CN: Improve Cinese transolation quality.

2020-12-08 Thread Jonathan Corbet
On Tue, 8 Dec 2020 21:16:04 +0800 Ran Wang wrote: > Signed-off-by: Ran Wang > --- > Change in v2: > - For 'cn_development_coding' part, change back to '是关于编码过程的' > > .../translations/zh_CN/process/1.Intro.rst| 61 ++- > 1 file changed, 32 insertions(+), 29 deletions(-)

Re: [PATCH] docs: trace: fix event state structure name

2020-12-08 Thread Jonathan Corbet
On Mon, 7 Dec 2020 18:19:14 -0500 Steven Rostedt wrote: > On Fri, 06 Nov 2020 14:47:46 -0600 > Tom Zanussi wrote: > > > Hi Artem, > > > > On Wed, 2020-11-04 at 14:21 +0200, Artem Bityutskiy wrote: > > > From: Artem Bityutskiy > > > > > > The documentation refers to a non-existent 'struct s

Re: [PATCH] docs: clean up sysctl/kernel: titles, version

2020-12-08 Thread Jonathan Corbet
On Tue, 8 Dec 2020 08:49:22 +0100 Stephen Kitt wrote: > This cleans up a few titles with extra colons, and removes the > reference to kernel 2.2. The docs don't yet cover *all* of 5.10 or > 5.11, but I think they're close enough. Most entries are documented, > and have been checked against curre

Re: [PATCH] kernel-doc: Fix example in Nested structs/unions

2020-12-08 Thread Jonathan Corbet
On Mon, 7 Dec 2020 13:00:27 -0800 Ben Widawsky wrote: > Add missing ';' as well as fixes the indent for the first struct. > > Signed-off-by: Ben Widawsky > --- > Documentation/doc-guide/kernel-doc.rst | 6 +++--- > 1 file changed, 3 insertions(+), 3 deletions(-) Applied, thanks. jon

Re: [PATCH] (fixed after review) Documentation: fix typos found in admin-guide subdirectory

2020-12-08 Thread Jonathan Corbet
On Fri, 4 Dec 2020 10:02:35 +0300 Andrew Klychkov wrote: > Fixed twelve typos in cppc_sysfs.rst, binderfs.rst, paride.rst, > zram.rst, bug-hunting.rst, introduction.rst, usage.rst, dm-crypt.rst > > Reviewed-by: Jonathan Corbet > Reviewed-by: Randy Dunlap > Signed-off-b

Re: [PATCH] Documentation: fix multiple typos found in the admin-guide subdirectory

2020-12-08 Thread Jonathan Corbet
ntroller.rst, mm/index.rst, numaperf.rst, userfaultfd.rst, > module-signing.rst, imx-ddr.rst, intel-speed-select.rst, > intel_pstate.rst, ramoops.rst, abi.rst, kernel.rst, vm.rst I've applied this patch, but made one important change: > Reviewed-by: Jonathan Corbet > Reviewed-b

Re: [PATCH v4 0/3] New documentation text describing how to report issues (aka "reporting-bugs rewritten")

2020-12-08 Thread Jonathan Corbet
On Fri, 4 Dec 2020 07:43:47 +0100 Thorsten Leemhuis wrote: > This series adds a new and mostly finished document describing how to report > issues with the Linux kernel to its developers. OK, I have applied this series. Thanks to Thorsten for doing all of this work and sticking with it, and th

Re: [PATCH v2] docs: add a reset controller chapter to the driver API docs

2020-12-08 Thread Jonathan Corbet
On Tue, 1 Dec 2020 12:57:54 +0100 Philipp Zabel wrote: > Add initial reset controller API documentation. This is mostly intended > to describe the concepts to users of the consumer API, and to tie the > kerneldoc comments we already have into the driver API documentation. > > Signed-off-by: Phi

Re: [PATCH] Update documentation to reflect what TAINT_CPU_OUT_OF_SPEC means nowadays

2020-12-08 Thread Jonathan Corbet
On Wed, 2 Dec 2020 16:32:43 +0100 Mathieu Chouquet-Stringer wrote: > Hello Jonathan, > > Here's a patch updating the meaning of TAINT_CPU_OUT_OF_SPEC after > Borislav introduced changes in a7e1f67ed29f and upcoming patches in tip. > > TAINT_CPU_OUT_OF_SPEC now means a bit more what it im

Re: [PATCH bpf-next] docs: bpf: Fixup atomics documentation

2021-01-18 Thread Jonathan Corbet
On Mon, 18 Jan 2021 11:36:43 + Brendan Jackman wrote: > This fixues up the markup to fix a warning, be more consistent with > use of monospace, and use the correct .rst syntax for (* instead > of _). It also clarifies the explanation of Clang's -mcpu > requirements for this feature, Alexei p

Re: [PATCH] docs: process/howto.rst: make sections on bug reporting match practice

2021-01-18 Thread Jonathan Corbet
On Sat, 16 Jan 2021 15:35:42 +0100 Thorsten Leemhuis wrote: > The file Documentation/process/howto.rst points to bugzilla.kernel.org > as the primary place to report kernel bugs to. For most of the kernel > that's the wrong place, as the MAINTAINERS file shows. Adjust those > sections to make the

Re: [PATCH 0/3] docs: Update Korean translation

2021-01-18 Thread Jonathan Corbet
On Sun, 17 Jan 2021 11:09:28 +0100 SeongJae Park wrote: > This patchset updates Korean translation of 'howto.rst' and links > the 'memory-barriers.txt' translation in the index rst file. > > SeongJae Park (3): > Documentation/kokr/howto: Replace HTTP links with HTTPS ones: > Documentation/

Re: [PATCH v2 1/1] docs: submitting-patches: Emphasise the requirement to Cc: stable when using Fixes: tag

2021-01-18 Thread Jonathan Corbet
On Wed, 13 Jan 2021 16:33:15 + Lee Jones wrote: > Clear-up any confusion surrounding the Fixes: tag with regards to the > need to Cc: the stable mailing list when submitting stable patch > candidates. > > Cc: Greg Kroah-Hartman > Cc: Jonathan Corbet > Cc: linu

Re: [PATCH v2] docs: driver-model: bus.rst: Clean up the formatting, expound, modernize

2021-01-18 Thread Jonathan Corbet
On Wed, 13 Jan 2021 05:35:00 - Michael Witten wrote: We're getting closer... > Thanks for your guidance. > > * Save this patch to: > > /path/to/email > > Then apply it with: > > git am --scissors /path/to/email Folks in the kernel community don't need to be taught how

Re: [PATCH] docs: Remove make headers_check from checklist

2021-01-18 Thread Jonathan Corbet
On Tue, 12 Jan 2021 13:41:01 + Milan Lakhani wrote: > Remove the make headers_check step from submit-checklist.rst as this is > no longer functional. > > Signed-off-by: Milan Lakhani > --- > Documentation/process/submit-checklist.rst | 14 ++ > 1 file changed, 6 insertions(+),

Re: [PATCH] Documentation: fix typos in split page table lock description

2021-01-18 Thread Jonathan Corbet
On Tue, 12 Jan 2021 14:19:36 +0100 Rolf Eike Beer wrote: > Signed-off-by: Rolf Eike Beer > --- > Documentation/vm/split_page_table_lock.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/vm/split_page_table_lock.rst > b/Documentation/vm/split_page_table

Re: [PATCH v6 11/16] scripts: kernel-doc: validate kernel-doc markup with the actual names

2021-01-18 Thread Jonathan Corbet
On Thu, 14 Jan 2021 09:04:47 +0100 Mauro Carvalho Chehab wrote: > Kernel-doc currently expects that the kernel-doc markup to come > just before the function/enum/struct/union/typedef prototype. > > Yet, if it find things like: > > /** >* refcount_add - add a value to a refcount >

Re: [PATCH] docs: Change reference that was to removed file

2021-01-19 Thread Jonathan Corbet
Milan Lakhani writes: [CC += Rob] > There were two references to > Documentation/devicetree/booting-without-of.rst for dtb format > information. This file has been removed, so I have changed the links to > Documentation/devicetree/usage-model.rst for this information, which > itself points to ht

Re: [PATCH] docs: binfmt-misc: Fix .rst formatting

2021-01-07 Thread Jonathan Corbet
On Fri, 1 Jan 2021 22:14:47 +0100 Jonathan Neuschäfer wrote: > "name below" is not part of the /proc path and should not be formatted > in monospace. > > "doesn``t" is rendered in HTML with a double backtick. Revert it back to > "doesn't". > > Signed-off-by: Jonathan Neuschäfer > --- > Docum

Re: [PATCH v2] Documentation/admin-guide: kernel-parameters: hyphenate comma-separated

2021-01-07 Thread Jonathan Corbet
On Thu, 31 Dec 2020 20:08:31 -0800 Randy Dunlap wrote: > Hyphenate "comma separated" when it is used as a compound adjective. > hyphenated. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- > v2: rebase & resend

Re: [PATCH] docs: admin-guide: bootconfig: Fix feils to fails

2021-01-07 Thread Jonathan Corbet
On Thu, 7 Jan 2021 18:26:10 +0530 Bhaskar Chowdhury wrote: > s/feils/fails/p > > Signed-off-by: Bhaskar Chowdhury > --- > Documentation/admin-guide/bootconfig.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/admin-guide/bootconfig.rst > b/Documentat

[GIT PULL] Documentation fixes

2021-01-08 Thread Jonathan Corbet
The following changes since commit 5c8fe583cce542aa0b84adc939ce85293de36e5e: Linux 5.11-rc1 (2020-12-27 15:30:22 -0800) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.11-3 for you to fetch changes up to 9d54ee78aef62c29b15ae2f58a70b1d1cd63a8f0: docs: admi

Re: linux-next: build warning after merge of the jc_docs tree

2021-01-13 Thread Jonathan Corbet
On Wed, 13 Jan 2021 15:07:48 +1100 Stephen Rothwell wrote: > After merging the jc_docs tree, today's linux-next build (htmldocs) > produced this warning: > > Documentation/translations/zh_CN/mips/ingenic-tcu.rst:61: WARNING: Malformed > table. > Text in column margin in table line 6. > > =

Re: [PATCH for doc-next] doc/zh_CN: mips: use doc references instead

2021-01-13 Thread Jonathan Corbet
On Wed, 13 Jan 2021 08:05:57 +0100 Lukas Bulwahn wrote: > The Chinese mips translations refer to non-existing labels in the original > documentation. Hence, make htmldocs warns about those undefined labels on > all files in ./Documentation/translations/zh_CN/mips/. > > Replace the references to

Re: [PATCH for doc-next] doc/zh_CN: adjust table markup in mips/ingenic-tcu.rst

2021-01-13 Thread Jonathan Corbet
On Wed, 13 Jan 2021 08:00:23 +0100 Lukas Bulwahn wrote: > Commit 419b1d4ed1cb ("doc/zh_CN: add mips ingenic-tcu.rst translation") > introduces a warning with make htmldocs: > > ./Documentation/translations/zh_CN/mips/ingenic-tcu.rst: > 61: WARNING: Malformed table. Text in column margin in

Re: [PATCH] Documentation/llvm: Add a section about supported architectures

2021-01-14 Thread Jonathan Corbet
On Wed, 13 Jan 2021 17:19:59 -0800 Nick Desaulniers wrote: > Patch looks fine, but `make -j htmldocs` seems to be taking forever > for me so I can't render it. Is this a known issue? > > $ make -j htmldocs > SPHINX htmldocs --> file:///android0/linux-next/Documentation/output > make[2]: Nothi

Re: [PATCH 01/10] doc/zh_CN: fix Sphinx errors

2021-01-14 Thread Jonathan Corbet
On Thu, 14 Jan 2021 08:53:36 +0100 Mauro Carvalho Chehab wrote: > The whitespacing with some translations are weird, > which causes errors like this one: > > > devel/v4l/docs/Documentation/translations/zh_CN/mips/ingenic-tcu.rst:61: > WARNING: Malformed table. > Text in column marg

[GIT PULL] A few documentation fixes

2020-12-23 Thread Jonathan Corbet
The following changes since commit 47e44ed01434e51e2e42b188482d837c01e5d16e: docs: fix broken cross reference in translations/zh_CN (2020-12-14 13:14:22 -0700) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.11-2 for you to fetch changes up to c635b0cea6b812

Re: [PATCH] script: get_abi.pl: escape "<" and ">" characters

2021-03-24 Thread Jonathan Corbet
Mauro Carvalho Chehab writes: > After merging the akpm-current tree, today's linux-next build (htmldocs) > produced this warning: > > Documentation/ABI/testing/sysfs-kernel-mm-cma:2: WARNING: Inline > interpreted text or phrase reference start-string without end-string. > > Introduced by c

Re: [PATCH] docs: livepatch: Fix a typo

2021-03-25 Thread Jonathan Corbet
Bhaskar Chowdhury writes: > On 10:05 Thu 25 Mar 2021, Miroslav Benes wrote: >>you sent the same fix a couple of weeks ago and Jon applied it. >> > Ah..difficult to rememberthanks for reminding ..it seems I need to keep > track ...which I don't do at this moment ...so the patch get duplicated

Re: [PATCH] docs: rbtree.rst: Fix a typo

2021-03-25 Thread Jonathan Corbet
Bhaskar Chowdhury writes: > s/maintanence/maintenance/ > > Signed-off-by: Bhaskar Chowdhury > --- > Documentation/core-api/rbtree.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) Applied, thanks. jon

Re: [PATCH] Documentation: gpio: chip should be plural

2021-03-25 Thread Jonathan Corbet
Bryan Brattlof writes: > Signed-off-by: Bryan Brattlof > --- > Documentation/driver-api/gpio/intro.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/driver-api/gpio/intro.rst > b/Documentation/driver-api/gpio/intro.rst > index 94dd7185e76e..2e924fb5b3d5

Re: [PATCH] docs/kokr: make sections on bug reporting match practice

2021-03-25 Thread Jonathan Corbet
SeongJae Park writes: > From: SeongJae Park > > Translate this commit to Korean: > > cf6d6fc27936 ("docs: process/howto.rst: make sections on bug reporting > match practice") > > Signed-off-by: SeongJae Park > --- > Documentation/translations/ko_KR/howto.rst | 18 +- > 1 f

Re: [PATCH -next v4] docs: document all error message types in checkpatch

2021-03-25 Thread Jonathan Corbet
Dwaipayan Ray writes: > All the error message types now have a verbose description. > > Also there are two new groups of message types: > > - Macros, Attributes and Symbols > - Functions and Variables > > Rearrange the message types to fit these new groups as needed. > > Reviewed-by: Lukas Bulwah

Re: [PATCH] docs: powerpc: Fix a typo

2021-03-25 Thread Jonathan Corbet
Bhaskar Chowdhury writes: > s/struture/structure/ > > Signed-off-by: Bhaskar Chowdhury > --- > Documentation/powerpc/firmware-assisted-dump.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/powerpc/firmware-assisted-dump.rst > b/Documentation/powerpc/fi

Re: [PATCH] docs: filesystems: Fix a mundane typo

2021-03-25 Thread Jonathan Corbet
Bhaskar Chowdhury writes: > s/provisoned/provisioned/ > > Signed-off-by: Bhaskar Chowdhury > --- > Documentation/filesystems/vfat.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/filesystems/vfat.rst > b/Documentation/filesystems/vfat.rst > index e85d7

Re: [PATCH] docs: sphinx: Trivial fix of a typo in the file rstFlatTable.py

2021-03-25 Thread Jonathan Corbet
Bhaskar Chowdhury writes: > s/buidler/builder/ > > Signed-off-by: Bhaskar Chowdhury > --- > Documentation/sphinx/rstFlatTable.py | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/sphinx/rstFlatTable.py > b/Documentation/sphinx/rstFlatTable.py > index a3eea0

Re: [PATCH v3 0/5] docs: reporting-issues: streamline process and solve a FIXME

2021-03-25 Thread Jonathan Corbet
Thorsten Leemhuis writes: > That's why I'd like to speed things up a little. But for that it would > be good to have something from you: a kind of "I like the direction > where this patch set is heading and I'm optimistic that we get it merged > for 5.13-rc1" message from you. With something like

Re: [PATCH] kernel-doc: better handle '::' sequences

2021-03-25 Thread Jonathan Corbet
Mauro Carvalho Chehab writes: > Right now, if one of the following headers end with a '::', the > kernel-doc script will do the wrong thing: > > description|context|returns?|notes?|examples? > > The real issue is with examples, as people could try to write > something like: > > exampl

Re: [PATCH v2 0/7] Fix some issues at get_abi.pl script

2021-03-25 Thread Jonathan Corbet
Mauro Carvalho Chehab writes: > This series replace this patch: > https://lore.kernel.org/linux-doc/20210324191722.08d35...@coco.lan/T/#t > > It turns that there were multiple bugs at the get_abi.pl code that > create cross-references. > > Patches 1 to 6 fix those issues, and should apply c

Re: [PATCH v3 0/5] docs: reporting-issues: streamline process and solve a FIXME

2021-03-25 Thread Jonathan Corbet
Thorsten Leemhuis writes: > BTW, I wondered it it would make sense to add a entry to the MAINTAINERS > file for the text so I can keep and eye on things and help with fine > tuning. Let me known if you think that idea is overblown, otherwise I'll > likely add one with the patch that I'll send soo

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