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:

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

Re: [PATCH v4 0/3] improve get_feat.pl output when all features are displayed

2020-12-04 Thread Jonathan Corbet
On Fri, 4 Dec 2020 16:32:27 +0100 Mauro Carvalho Chehab wrote: > As requested, those patches improve the output of the script, when all > features > are displayed. > > The first patch was already posted as-is at v3. > > Patch 2 is optional. IMO, it makes more sense for the admin guide to

Re: [PATCH v4 1/3] LICENSES: Add the CC-BY-4.0 license

2020-12-04 Thread Jonathan Corbet
On Fri, 4 Dec 2020 13:23:43 +0100 Greg Kroah-Hartman wrote: > On Fri, Dec 04, 2020 at 07:43:48AM +0100, Thorsten Leemhuis wrote: > > Add the full text of the CC-BY-4.0 license to the kernel tree as well as > > the required tags for reference and tooling. > > > > The license text was copied

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

2020-12-03 Thread Jonathan Corbet
On Thu, 3 Dec 2020 11:20:29 +0300 Andrew Klychkov wrote: > @@ -185,7 +185,7 @@ in a keyring called ".builtin_trusted_keys" that can be > seen by:: > [root@deneb ~]# cat /proc/keys > ... > 223c7853 I-- 1 perm 1f03 0 0 keyring > .builtin_trusted_keys: 1 >

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

2020-12-03 Thread Jonathan Corbet
On Thu, 3 Dec 2020 10:22:47 +0300 Andrew Klychkov wrote: > --- a/Documentation/admin-guide/cifs/usage.rst > +++ b/Documentation/admin-guide/cifs/usage.rst > @@ -115,7 +115,7 @@ later source tree in docs/manpages/mount.cifs.8 > Allowing User Unmounts > == > > -To permit

Re: [PATCH] scripts: kernel-doc: fix parsing function-like typedefs

2020-12-03 Thread Jonathan Corbet
On Wed, 2 Dec 2020 09:17:32 +0100 Mauro Carvalho Chehab wrote: > Changeset 6b80975c6308 ("scripts: kernel-doc: fix typedef parsing") > added support for things like: > > typedef unsigned long foo(); > > However, it caused a regression on this prototype: > > typedef bool

Re: [PATCH] Documentation: fix typos found in process, dev-tools, and doc-guide subdirectories

2020-12-03 Thread Jonathan Corbet
On Wed, 2 Dec 2020 10:54:38 +0300 Andrew Klychkov wrote: > Fix four typos in kcov.rst, sphinx.rst, clang-format.rst, and > embargoed-hardware-issues.rst > > Signed-off-by: Andrew Klychkov > --- > Documentation/dev-tools/kcov.rst| 2 +- > Documentation/doc-guide/sphinx.rst

Re: [PATCH] Documentation: fix typos in process/kernel-docs.rst

2020-12-03 Thread Jonathan Corbet
On Wed, 2 Dec 2020 10:49:38 +0300 Andrew Klychkov wrote: > Fix two typos in kernel-docs.rst > > Signed-off-by: Andrew Klychkov > --- > Documentation/process/kernel-docs.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) Applied, thanks. jon

Re: [PATCH] Updating the documentation of struct file_system_type

2020-12-03 Thread Jonathan Corbet
On Tue, 1 Dec 2020 22:05:51 +0100 i...@democraticnet.de wrote: > From: Joris Gutjahr > > In the documentation of struct file_system_type, > using the definition of the struct of the kernel v5.10-rc6. > > Signed-off-by: Joris Gutjahr So I applaud any effort to update this file, but I have a

Re: [PATCH v2] Documentation: Coccinelle: Improve command example for debugging patches

2020-12-03 Thread Jonathan Corbet
On Thu, 26 Nov 2020 13:27:30 +0530 Sumera Priyadarsini wrote: > Modify Coccinelle documentation to clarify usage of make command to > run coccicheck on a folder. > > Changes in v2: > - Give example of folder instead of file > - Add note > > Signed-off-by: Sumera Priyadarsini > --- >

Re: [PATCH 0/6] Add documentation for Documentation/features at the built docs

2020-12-03 Thread Jonathan Corbet
On Mon, 30 Nov 2020 16:36:29 +0100 Mauro Carvalho Chehab wrote: > This series got already submitted last year: > > > https://lore.kernel.org/lkml/cover.1561222784.git.mchehab+sams...@kernel.org/ > > Yet, on that time, there were too many other patches related to ReST > conversion floating

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

2020-12-03 Thread Jonathan Corbet
On Thu, 3 Dec 2020 06:52:30 +0300 Andrew Klychkov wrote: > Should i fix the patch or you’ll just exclude this part yourself? Please send a fixed version with Randy's Reviewed-by tag added as well. The right way to fix that might be "ANDed" to make it what is being said clear. Thanks, jon

Re: [PATCH v8 7/7] docs: Document Syscall User Dispatch

2020-12-01 Thread Jonathan Corbet
On Fri, 27 Nov 2020 14:32:38 -0500 Gabriel Krisman Bertazi wrote: > Explain the interface, provide some background and security notes. > > Signed-off-by: Gabriel Krisman Bertazi > Reviewed-by: Kees Cook > Acked-by: Peter Zijlstra (Intel) Nice to see documentation included...:) One nit: >

Re: [PATCH] docs: dt: Use full path to enable cross-reference

2020-11-30 Thread Jonathan Corbet
On Mon, 23 Nov 2020 12:13:46 + Nícolas F. R. A. Prado wrote: > Use full path to reference writing-schema.rst so that it becomes a > cross-reference. > > Signed-off-by: Nícolas F. R. A. Prado > --- > > Hi Jon, > > do you think this would be the way to go, or should we instead extend >

Re: [PATCH v2] docs: automarkup.py: Allow automatic cross-reference inside C namespace

2020-11-30 Thread Jonathan Corbet
On Tue, 17 Nov 2020 02:12:01 + Nícolas F. R. A. Prado wrote: > Sphinx 3.1 introduced namespaces for C cross-references. With this, > each C domain type/function declaration is put inside the namespace that > was active at the time of its declaration. > > Add support for automatic

Re: [PATCH] Documentation/features: Update feature lists for 5.10

2020-11-30 Thread Jonathan Corbet
On Thu, 19 Nov 2020 10:27:09 +0800 Wei Li wrote: > The feature lists don't match reality as of v5.10-rc4, update them > accordingly (by features-refresh.sh). > > Fixes: aa65ff6b18e0 ("powerpc/64s: Implement queued spinlocks and rwlocks") > Fixes: e95a4f8cb985 ("csky: Add SECCOMP_FILTER

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

2020-11-30 Thread Jonathan Corbet
On Mon, 23 Nov 2020 18:38:14 -0800 Bailu Lin wrote: > This is a Chinese translated version of > Documentation/arm64/elf_hwcaps.rst > > Signed-off-by: Bailu Lin > --- > Changes in v2: > - Modify five translation issues as Alex sugguested. > --- > Documentation/arm64/elf_hwcaps.rst

Re: [PATCH v2] Documentation/admin-guide: mark memmap parameter is supported by a few architectures

2020-11-30 Thread Jonathan Corbet
On Sun, 29 Nov 2020 08:51:21 +1300 Barry Song wrote: > early_param memmap is only implemented on X86, MIPS and XTENSA. To avoid > wasting users’ time on trying this on platform like ARM, mark it clearly. > > Signed-off-by: Barry Song > Reviewed-by: Mike Rapoport > --- > -v2: > * add

Re: [PATCH v3 1/3] LICENSES: Add the CC-BY-4.0 license

2020-11-30 Thread Jonathan Corbet
On Tue, 24 Nov 2020 12:11:09 + Matthew Wilcox wrote: > > That's why I came up with the thought "make the text available under more > > liberal license in addition to the GPLv2 is a good idea here". I considered > > MIT, but from what I see CC-BY 4.0 is a way better choice for documentation >

Re: [PATCH v1] docs/vm: hwpoison: fix spelling mistakes

2020-11-25 Thread Jonathan Corbet
On Wed, 25 Nov 2020 17:52:22 +0100 Flavio Suligoi wrote: > Actions: > > - fix spelling mistake > - reduce some double spaces to a single one Please don't make changes like that last one; double spaces are not an error, and "fixing" them just adds noise to the history. Thanks, jon

Re: [RFC PATCH v2 00/26] Make reporting-bugs easier to grasp and yet more detailed & helpful

2020-11-20 Thread Jonathan Corbet
On Fri, 20 Nov 2020 11:46:07 +0100 Thorsten Leemhuis wrote: > Am 19.11.20 um 01:29 schrieb Jonathan Corbet: > > On Sun, 15 Nov 2020 11:13:52 +0100 > > Thorsten Leemhuis wrote: > > > - Collapse the whole thing down to a patch adding reporting-bugs-v2.rst > >

Re: [RFC PATCH v2 00/26] Make reporting-bugs easier to grasp and yet more detailed & helpful

2020-11-20 Thread Jonathan Corbet
On Thu, 19 Nov 2020 13:29:51 +0100 Thorsten Leemhuis wrote: > > - Dual licensed CC-SA-4.0 is fine with me. CC-BY is OK if you really > > want to do it that way. > > I'm unsure and would appreciate options from others here. > > Here are some of my thoughts about this: > > What do we

Re: [RFC PATCH v2 00/26] Make reporting-bugs easier to grasp and yet more detailed & helpful

2020-11-18 Thread Jonathan Corbet
On Sun, 15 Nov 2020 11:13:52 +0100 Thorsten Leemhuis wrote: > > So I've not had a chance to try to read through the whole thing again, > > will try to do so in the near future. > > Great, thx, looking forward to it. OK, I have made a *quick* pass through the whole thing and sent a small

Re: [RFC PATCH v2 21/26] docs: reporting-bugs: details on writing and sending the report

2020-11-18 Thread Jonathan Corbet
On Thu, 12 Nov 2020 18:58:58 +0100 Thorsten Leemhuis wrote: > That's also why this commit removes scripts/ver_linux as well: the > details it collects are only needed in some situations. And some (a > lot?) distributions do not ship it anyway; a better, more modern script > would likely resist

Re: [RFC PATCH v2 08/26] docs: reporting-bugs: make readers check the taint flag

2020-11-18 Thread Jonathan Corbet
On Thu, 12 Nov 2020 18:58:45 +0100 Thorsten Leemhuis wrote: > +If your kernel is tainted, study > +:ref:`Documentation/admin-guide/tainted-kernels.rst ` to find > +out why. Try to eliminate the reason. Often it's caused by one these three > +things: One little detail that jumped at me just now:

Re: [RESEND][PATCH] docs/mm: concepts.rst: Correct the threshold to low watermark

2020-11-18 Thread Jonathan Corbet
On Sat, 14 Nov 2020 11:17:12 +0800 Yi Wang wrote: > From: Liao Pingfang > > Actually it should be "low watermark" where we wake up kswapd > daemon. > > Signed-off-by: Liao Pingfang > Signed-off-by: Yi Wang > --- > Documentation/admin-guide/mm/concepts.rst | 2 +- > 1 file changed, 1

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

2020-11-18 Thread Jonathan Corbet
On Sat, 14 Nov 2020 09:33:42 +0100 Federico Vaga wrote: > Translation for the following patches > > commit 0aa78b105f57 ("Documentation/changes: Raise minimum supported binutils > version to 2.23") > commit 7d7178873560 ("Documentation: include sign off for reverts") > commit 905705a8fd43

Re: [PATCH] Documentation: kgdb: Fix a typo

2020-11-18 Thread Jonathan Corbet
On Mon, 16 Nov 2020 17:42:47 +0800 Tiezhu Yang wrote: > "to into" -> "into" > > Reported-by: Sergei Shtylyov > Signed-off-by: Tiezhu Yang > --- > Documentation/dev-tools/kgdb.rst | 7 +++ > 1 file changed, 3 insertions(+), 4 deletions(-) > > diff --git a/Documentation/dev-tools/kgdb.rst

Re: [PATCH doc] doc: zh_CN: add tmpfs to index tree

2020-11-18 Thread Jonathan Corbet
On Mon, 16 Nov 2020 14:47:50 +0800 Wang Qing wrote: > Add temfs to the index tree while adding tempfs translation. > > Signed-off-by: Wang Qing > --- > Documentation/translations/zh_CN/filesystems/index.rst | 1 + > 1 file changed, 1 insertion(+) > > diff --git

Re: [PATCH] docs/vm: remove unused 3 items explanation for /proc/vmstat

2020-11-18 Thread Jonathan Corbet
On Mon, 16 Nov 2020 17:51:22 +0800 Alex Shi wrote: > Commit 5647bc293ab1 ("mm: compaction: Move migration fail/success > stats to migrate.c"), removed 3 items in /proc/vmstat. but the docs > still has their explanation. let's remove them. > > "compact_blocks_moved", > "compact_pages_moved", >

Re: [PATCH v2] docs: automarkup.py: Allow automatic cross-reference inside C namespace

2020-11-18 Thread Jonathan Corbet
On Tue, 17 Nov 2020 12:30:13 + Nícolas F. R. A. Prado wrote: > > Hmm... do we still need to skip syscalls? > > Yeah, I see what you mean. Since you moved the syscalls in the docs inside > namespaces, there shouldn't be any syscall definitions in the global scope > anymore and therefore we

Re: [PATCH v2] docs: automarkup.py: Allow automatic cross-reference inside C namespace

2020-11-18 Thread Jonathan Corbet
On Tue, 17 Nov 2020 02:12:01 + Nícolas F. R. A. Prado wrote: > Sphinx 3.1 introduced namespaces for C cross-references. With this, > each C domain type/function declaration is put inside the namespace that > was active at the time of its declaration. > > Add support for automatic

Re: [PATCH] ftrace/documentation: Fix RST C code blocks

2020-11-18 Thread Jonathan Corbet
On Wed, 18 Nov 2020 11:26:51 -0500 Steven Rostedt wrote: > OK, I'll take it, but can you give an ack? Acked-by: Jonathan Corbet jon

Re: [RFC] Add kernel-doc test script

2020-11-18 Thread Jonathan Corbet
On Tue, 17 Nov 2020 17:36:12 -0500 Eduardo Habkost wrote: > Add a kernel-doc test script to tools/testing/kernel-doc. > > radix_tree_lookup_slot test case provided by Matthew Wilcox. > > Signed-off-by: Eduardo Habkost > --- > tools/testing/kernel-doc/test-case.h | 111 ++ >

Re: [PATCH] ftrace/documentation: Fix RST C code blocks

2020-11-18 Thread Jonathan Corbet
On Wed, 18 Nov 2020 10:51:27 -0500 Steven Rostedt wrote: > On Wed, 18 Nov 2020 10:35:02 -0500 > Steven Rostedt wrote: > > > From: "Steven Rostedt (VMware)" > > > > Some C code in the ftrace-users.rst document is missing RST C block > > annotation, which has to be added. > > > > Link:

Re: [PATCH v2 2/4] Documentation/powercap/dtpm: Add documentation for dtpm

2020-11-17 Thread Jonathan Corbet
On Mon, 16 Nov 2020 16:26:47 +0100 Daniel Lezcano wrote: > The dynamic thermal and power management is a technique to dynamically > adjust the power consumption of different devices in order to ensure a > global thermal constraint. > > An userspace daemon is usually monitoring the temperature

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

2020-11-16 Thread Jonathan Corbet
On Mon, 16 Nov 2020 15:25:52 -0500 Steven Rostedt wrote: > On Mon, 16 Nov 2020 12:24:32 -0700 > Jonathan Corbet wrote: > > > The problem is those literal blocks. The easiest fix will be to just use > > the double-colon notation to indicate a literal block, so the paragrap

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

2020-11-16 Thread Jonathan Corbet
On Mon, 16 Nov 2020 12:43:38 -0500 Steven Rostedt wrote: > > After merging the ftrace tree, today's linux-next build (htmldocs) > > produced this warning: > > > > Documentation/trace/ftrace-uses.rst:123: WARNING: Unexpected indentation. > > > > Introduced by commit > > > > a25d036d939a

Re: [RFC PATCH v2 00/26] Make reporting-bugs easier to grasp and yet more detailed & helpful

2020-11-13 Thread Jonathan Corbet
On Thu, 12 Nov 2020 18:58:37 +0100 Thorsten Leemhuis wrote: > This series rewrites the "how to report bugs to the Linux kernel > maintainers" document to make it more straight forward and its essence > easier to grasp. At the same time make the text provide a lot more details > about the process

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

2020-11-13 Thread Jonathan Corbet
On Thu, 29 Oct 2020 21:05:41 -0700 Bailu Lin wrote: > This is a Chinese translated version of > Documentation/arm64/perf.rst > > Signed-off-by: Bailu Lin > --- > Changes in v2: > - Modify a translation of 'guest/host/blackout window' as Alex sugguested. > --- > Documentation/arm64/perf.rst

Re: [PATCH 2/2] kernel-doc: Handle function typedefs without asterisks

2020-11-13 Thread Jonathan Corbet
On Fri, 30 Oct 2020 15:47:13 +0100 Paolo Bonzini wrote: > From: Eduardo Habkost > > Example of typedef that was not parsed by kernel-doc: > > typedef void (ObjectUnparent)(Object *obj); > > Signed-off-by: Eduardo Habkost > Signed-off-by: Paolo Bonzini So as you've undoubtedly noticed,

Re: [PATCH] docs/mm: concepts.rst: Correct the threshold to low watermark

2020-11-13 Thread Jonathan Corbet
On Mon, 2 Nov 2020 11:22:20 +0800 Yi Wang wrote: > From: Liao Pingfang > > Actually it should be "low watermark" where we wake up kswapd > daemon. > > Signed-off-by: Liao Pingfang > Signed-off-by: Yi Wang > --- > Documentation/admin-guide/mm/concepts.rst | 2 +- > 1 file changed, 1

Re: [PATCH] docs: mtd: spi-nor: Fix formatting of text vs. diagrams

2020-11-13 Thread Jonathan Corbet
On Sat, 7 Nov 2020 19:39:01 +0100 Jonathan Neuschäfer wrote: > Corrently, all diagrams below "Before this framework, the layer is like" > and the text in between are rendered as one monospace text block. > Instead, each individual diagram should be a monospace text block. > > Signed-off-by:

Re: [PATCH] docs: filesystems: link ubifs-authentication.rst without .rst extension

2020-11-13 Thread Jonathan Corbet
On Sun, 8 Nov 2020 14:24:14 +0100 Jonathan Neuschäfer wrote: > Specifying the .rst extension doesn't cause any problems AFAICT, but > it's uncommon. > > Fixes: 688f118e3139f ("docs: filesystems: convert > ubifs-authentication.rst.txt to ReST") > Signed-off-by: Jonathan Neuschäfer > --- >

Re: [PATCH] documentation: arm: sunxi: add Allwinner H616 documents

2020-11-13 Thread Jonathan Corbet
On Sun, 8 Nov 2020 16:01:04 +0100 Wilken Gottwalt wrote: > Add the current and cleaned Allwinner H616 datasheet and user manual. > > Signed-off-by: Wilken Gottwalt > --- > Documentation/arm/sunxi.rst | 10 ++ > 1 file changed, 10 insertions(+) Applied, thanks. jon

Re: [PATCH] docs: driver-api: mtd: intel-spi: Improve formatting of shell commands

2020-11-13 Thread Jonathan Corbet
On Sun, 8 Nov 2020 16:10:04 +0100 Jonathan Neuschäfer wrote: > Format the shell commands and output in steps 6 and 8 as code blocks, > for consistency with the rest of the document. > > Signed-off-by: Jonathan Neuschäfer > --- > Documentation/driver-api/mtd/intel-spi.rst | 4 ++-- > 1 file

Re: [PATCH V4 DOC] doc: zh_CN: add translatation for tmpfs

2020-11-13 Thread Jonathan Corbet
On Mon, 9 Nov 2020 09:57:47 +0800 Wang Qing wrote: > Translate Documentation/filesystems/tmpfs.rst into Chinese. > > Signed-off-by: Wang Qing > > Changes in v4: > - Modify as Alex required. > > Changes in v3: > - Fix patch format issue. > --- >

Re: [PATCH] docs: core-api/printk-formats.rst: Clarify formatting {cpu,node}mask

2020-11-13 Thread Jonathan Corbet
On Tue, 10 Nov 2020 15:41:21 +0100 Geert Uytterhoeven wrote: > Clarify how to pass the field width for bitmaps, and mention the helper > macros that are available to ease printing cpumask and nodemask. > > Signed-off-by: Geert Uytterhoeven > --- > Documentation/core-api/printk-formats.rst | 4

Re: [PATCH] docs: ABI: Drop trailing whitespace

2020-11-13 Thread Jonathan Corbet
On Tue, 10 Nov 2020 15:40:33 +0100 Geert Uytterhoeven wrote: > Remove all trailing whitespace from the ABI documentation. > Most of it was introduced during recent updates. > > Signed-off-by: Geert Uytterhoeven > --- > Fixes: 0ea6e61122196509 ("Documentation: update broken web addresses.") >

Re: [PATCH v3] Documentation: include sign off for reverts

2020-11-13 Thread Jonathan Corbet
On Tue, 10 Nov 2020 23:17:49 +0530 Aditya Srivastava wrote: > Currently, we do not have any documentation on commit reverts regarding > the requirement of Signed-off-by tag for it. This may be misleading to > the users. > > Evaluating MISSING_SIGN_OFF checkpatch warnings on v4.13..v5.8 showed >

Re: [PATCH] Documentation: admin-guide: LSM: improve the title underline

2020-11-13 Thread Jonathan Corbet
On Thu, 12 Nov 2020 14:43:53 +0530 Siddhant Gupta wrote: > Fix warning of title underline too short > > Signed-off-by: Siddhant Gupta > --- > Documentation/admin-guide/LSM/SafeSetID.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

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

2020-11-13 Thread Jonathan Corbet
On Fri, 13 Nov 2020 14:36:38 +0100 Federico Vaga wrote: > Translation for the following patches > > commit 905705a8fd43 ("docs: programming-languages: refresh blurb on clang > support") > commit 5ff4aa70bf34 ("docs: submitting-patches: use :doc: for references") > commit 030f066f677f ("docs:

Re: [RFC PATCH v1 00/26] Make reporting-bugs easier to grasp and yet more detailed

2020-11-09 Thread Jonathan Corbet
On Mon, 9 Nov 2020 12:01:56 +0100 Thorsten Leemhuis wrote: > @Jon: I'd be really appreciate to hear your thoughts on this. Seems like it's time to post a new version with all of your feedback so far reflected, and we'll go from there? Thanks, jon

Re: [PATCH v3 56/56] scrpits: kernel-doc: validate kernel-doc markup with the actual names

2020-11-05 Thread Jonathan Corbet
On Thu, 5 Nov 2020 15:00:17 + Matthew Wilcox wrote: > I wonder if we could change kernel-doc to be (optionally) less verbose. > If we allowed people to write: > > /** > * Add a value to a refcount. > * @i: The value to add to the refcount > * @r: The refcount > */ > > and had the

Re: [GIT PULL] Docs-build warning fixes for 5.10-rc3

2020-11-04 Thread Jonathan Corbet
On Thu, 5 Nov 2020 09:06:52 +1100 Stephen Rothwell wrote: > There is currently one message produced in your tree (after I add all > the "pending fixes") and I have reported that this morning. So things > are looking pretty good now - a lot of good work over the past couple > of releases. The

[GIT PULL] Docs-build warning fixes for 5.10-rc3

2020-11-03 Thread Jonathan Corbet
been in linux-next since last week. Jonathan Corbet (1): Merge branch 'mauro-warnings' into docs-next Mauro Carvalho Chehab (24): scripts: kernel-doc: use :c:union when needed sphinx: conf.py: properly handle Sphinx

[GIT PULL] Documentation fixes for 5.10-rc3

2020-11-03 Thread Jonathan Corbet
automarkup regression on Python 2 (2020-11-03 08:22:00 -0700) A small number of fixes, plus a build tweak to respect the desire for silence in V=0 builds. Jonathan

Re: Python 2.7 support and automarkup.py - Was: Re: [PATCH v2 1/5] docs: automarkup.py: Use new C roles in Sphinx 3

2020-10-30 Thread Jonathan Corbet
On Fri, 30 Oct 2020 15:10:26 +0100 Mauro Carvalho Chehab wrote: > I see a few alternatives: > > 1) fix automarkup.py for it to work again with python 2.7; > > 2) conf.py could gain some logic to disable automarkup with >Python < 3; > > 3) scripts/sphinx-pre-install already detects Python

Re: [PATCH v2 1/5] docs: automarkup.py: Use new C roles in Sphinx 3

2020-10-30 Thread Jonathan Corbet
On Fri, 30 Oct 2020 14:33:52 +0100 Dafna Hirschfeld wrote: > > +RE_struct = re.compile(r'\b(struct)\s+([a-zA-Z_]\w+)', flags=re.ASCII) > > +RE_union = re.compile(r'\b(union)\s+([a-zA-Z_]\w+)', flags=re.ASCII) > > +RE_enum = re.compile(r'\b(enum)\s+([a-zA-Z_]\w+)', flags=re.ASCII) > > +RE_typedef

Re: [PATCH] docs: Makefile: honor V=0 for docs building

2020-10-28 Thread Jonathan Corbet
On Tue, 27 Oct 2020 11:56:15 +0100 Mauro Carvalho Chehab wrote: > Reduce the number of displayed mesages when building the > docs with V=0. > > Suggested-by: Stephen Rothwell > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/Makefile | 4 > 1 file changed, 4 insertions(+) >

Re: [PATCH 12/33] docs: kernel_abi.py: add a script to parse ABI documentation

2020-10-28 Thread Jonathan Corbet
So this is separate from the patch series itself in a way, but it brings a question to mind: On Wed, 28 Oct 2020 15:23:10 +0100 Mauro Carvalho Chehab wrote: > +# We can't assume that six is installed > +PY3 = sys.version_info[0] == 3 > +PY2 = sys.version_info[0] == 2 > +if PY3: > +# pylint:

Re: [PATCH v3 00/32] Documentation build fixes against v5.10-rc1

2020-10-28 Thread Jonathan Corbet
On Tue, 27 Oct 2020 10:51:04 +0100 Mauro Carvalho Chehab wrote: > This series contain the patches from a previous series I sent: > > [PATCH v2 00/24] Documentation build fixes against next-20201013 > > Plus other patches I sent later, against other versions of linux-next between >

Re: [PATCH v2] documentation: arm: sunxi: add Allwinner H6 documents

2020-10-28 Thread Jonathan Corbet
On Tue, 27 Oct 2020 07:24:08 +0100 Wilken Gottwalt wrote: > Add the current Allwinner H6 datasheet and user manual. > > Signed-off-by: Wilken Gottwalt > --- > Changes in v2: > - changed email because of serious problems between my old email > provider and the lkml > --- >

Re: [PATCH v4 0/2] kernel-doc: fix typedef function parser

2020-10-28 Thread Jonathan Corbet
On Tue, 27 Oct 2020 11:20:35 +0100 Mauro Carvalho Chehab wrote: > This small series contain the latest version of the typedef parsing > fixes that we've been discussing as: > > [PATCH v3 01/56] scripts: kernel-doc: fix typedef parsing > > As I said there, at least while discussing it, I

Re: [PATCH 00/33] ABI: add it to the documentation build system

2020-10-28 Thread Jonathan Corbet
> should be. And make merging easier with other trees over time. No complaints here, even if you want to take the whole set. Feel free to add: Acked-by: Jonathan Corbet ...if you like. Thanks, jon

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-23 Thread Jonathan Corbet
On Fri, 23 Oct 2020 21:39:07 +0200 Peter Zijlstra wrote: > > > /** > > > - * struct refcount_t - variant of atomic_t specialized for reference > > > counts > > > + * struct refcount_struct - variant of atomic_t specialized for > > > reference counts > > > > Hm, this is a weird one. Yes,

[GIT PULL] Documentation fixes for 5.10

2020-10-23 Thread Jonathan Corbet
The following changes since commit 4fb220da0dd03d3699776220d86ac84b38941c0c: gpiolib: Update indentation in driver.rst for code excerpts (2020-10-12 13:15:34 -0600) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.10-2 for you to fetch changes up to

Re: [PATCH v3 01/56] scripts: kernel-doc: fix typedef parsing

2020-10-23 Thread Jonathan Corbet
On Fri, 23 Oct 2020 18:32:48 +0200 Mauro Carvalho Chehab wrote: > The include/linux/genalloc.h file defined this typedef: > > typedef unsigned long (*genpool_algo_t)(unsigned long *map,unsigned > long size,unsigned long start,unsigned int nr,void *data, struct gen_pool > *pool, unsigned

Re: [PATCH][next] docs/vm: trivial fixes to several spelling mistakes

2020-10-22 Thread Jonathan Corbet
On Thu, 22 Oct 2020 15:26:53 +0100 Colin King wrote: > From: Colin Ian King > > Fix several spelling mistakes in vm documentation. > > Signed-off-by: Colin Ian King > --- > Documentation/vm/mmu_notifier.rst | 2 +- > Documentation/vm/page_migration.rst | 2 +- >

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

2020-10-21 Thread Jonathan Corbet
On Thu, 22 Oct 2020 08:55:42 +1100 Stephen Rothwell wrote: > Commit > > 9467739c239d ("docs: Add two missing entries in vm sysctl index") > > is missing a Signed-off-by from its author. Argh, I should have caught that. I'd blame wildfires, but that would be lame. Offending commit removed;

Re: [PATCH] docs: Add two missing entries in vm sysctl index

2020-10-21 Thread Jonathan Corbet
On Tue, 13 Oct 2020 10:14:04 +0100 f...@euphon.net wrote: > From: Fam Zheng > > Both seem overlooked while adding the section in the main content. > --- > Documentation/admin-guide/sysctl/vm.rst | 2 ++ > 1 file changed, 2 insertions(+) Applied, thanks. The right way to fix this, though, is

Re: [PATCH v2] docs: submitting-patches: describe preserving review/test tags

2020-10-21 Thread Jonathan Corbet
On Tue, 13 Oct 2020 18:27:25 +0200 Krzysztof Kozlowski wrote: > From time to time, the novice kernel contributors do not add Reviewed-by > or Tested-by tags to the next versions of the patches. Mostly because > they are unaware that responsibility of adding these tags in next > version is on

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

2020-10-21 Thread Jonathan Corbet
On Tue, 13 Oct 2020 19:20:03 -0700 Bailu Lin wrote: > This is a Chinese translated version of > Documentation/arm64/hugetlbpage.rst > > Signed-off-by: Bailu Lin > --- > Changes in v3: > - Modify a translation as Alex sugguested. > Changes in v2: > - Fix Sphinx 2.4.4's waring by increasing

Re: [PATCH] Documentation: x86: fix a missing word in x86_64/mm.rst.

2020-10-21 Thread Jonathan Corbet
On Thu, 15 Oct 2020 14:22:42 +0800 Wei Lin Chang wrote: > This patch adds a missing word in x86/x86_64/mm.rst, without which > the note reads awkwardly. > > Signed-off-by: Wei Lin Chang > --- > Documentation/x86/x86_64/mm.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff

Re: [PATCH] docs: driver-api: remove a duplicated index entry

2020-10-21 Thread Jonathan Corbet
ro Carvalho Chehab > Commit: Jonathan Corbet > > docs: ipmb: place it at driver-api and convert to ReST > > commit ac499fba98c3c65078fd84fa0a62cd6f6d5837ed > Author: Mauro Carvalho Chehab > Commit: Corey Minyard > > d

Re: [PATCH] docs: lkdtm: Modernize and improve details

2020-10-21 Thread Jonathan Corbet
On Thu, 15 Oct 2020 15:45:59 -0700 Kees Cook wrote: > The details on using LKDTM were overly obscure. Modernize the details > and expand examples to better illustrate how to use the interfaces. > Additionally add missing SPDX header. > > Signed-off-by: Kees Cook > --- >

Re: [PATCH] docs: deprecated.rst: Expand str*cpy() replacement notes

2020-10-21 Thread Jonathan Corbet
On Thu, 15 Oct 2020 16:17:31 -0700 Kees Cook wrote: > The notes on replacing the deprecated str*cpy() functions didn't call > enough attention to the change in return type. Add these details and > clean up the language a bit more. > > Signed-off-by: Kees Cook > --- >

Re: [PATCH] docs/cpu-load: format the example code.

2020-10-21 Thread Jonathan Corbet
On Mon, 19 Oct 2020 01:05:57 +0800 Hui Su wrote: > format the example code. > > Signed-off-by: Hui Su > --- > Documentation/admin-guide/cpu-load.rst | 63 ++ > 1 file changed, 33 insertions(+), 30 deletions(-) Hmm...this document wasn't always that way; it looks like

Re: [PATCH v6 35/80] docs: fs: fscrypt.rst: get rid of :c:type: tags

2020-10-15 Thread Jonathan Corbet
On Thu, 15 Oct 2020 07:32:07 +0200 Mauro Carvalho Chehab wrote: > > That will apply to most (maybe all) of the structures mentioned in this > > file. > > I expected that if the documentation system now automatically recognizes > > 'struct foo', then it would render it in code font even when

Re: [PATCH v2 2/5] docs: automarkup.py: Fix regexes to solve sphinx 3 warnings

2020-10-14 Thread Jonathan Corbet
On Wed, 14 Oct 2020 20:09:10 + Nícolas F. R. A. Prado wrote: > One I had noted down was: > > WARNING: Unparseable C cross-reference: '调用debugfs_rename' > > which I believe occurred in the chinese translation. > > I think the problem is that in chinese there normally isn't space between

Re: [PATCH v2 5/5] docs: automarkup.py: Allow automatic cross-reference inside C namespace

2020-10-14 Thread Jonathan Corbet
On Wed, 14 Oct 2020 11:56:44 +0200 Mauro Carvalho Chehab wrote: > > To make the first step possible, disable the parallel_read_safe option > > in Sphinx, since the dictionary that maps the files to the C namespaces > > can't be concurrently updated. This unfortunately increases the build > >

Re: [PATCH v2 2/5] docs: automarkup.py: Fix regexes to solve sphinx 3 warnings

2020-10-14 Thread Jonathan Corbet
On Tue, 13 Oct 2020 23:13:17 + Nícolas F. R. A. Prado wrote: > The warnings were caused by the expressions matching words in the > translated versions of the documentation, since any unicode character > was matched. > > Fix the regular expression by making the C regexes use ASCII I don't

[GIT PULL] Documentation for 5.10

2020-10-12 Thread Jonathan Corbet
now removed uninitialized_var John Hubbard (1): Documentation: better locations for sysfs-pci, sysfs-tagging Jonathan Cameron (1): kernel-doc: add support for cacheline_aligned attribute Jonathan Corbet (1): Make the docs build "work" with Sphinx 3.x Jonathan Neu

Re: [PATCH] Documentation/admin-guide: tainted-kernels: Fix typo occured

2020-10-12 Thread Jonathan Corbet
On Mon, 12 Oct 2020 17:24:41 +0900 Naoki Hayama wrote: > Fix typo. > s/occured/occurred/ > > Signed-off-by: Naoki Hayama > --- > Documentation/admin-guide/tainted-kernels.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH] docs: submitting-patches: describe preserving review/test tags

2020-10-09 Thread Jonathan Corbet
On Wed, 7 Oct 2020 10:43:06 +0200 Krzysztof Kozlowski wrote: > From time to time, the novice kernel contributors do not add Reviewed-by > or Tested-by tags to the next versions of the patches. Mostly because > they are unaware that responsibility of adding these tags in next > version is on

Re: [PATCH v2] Documentation: better locations for sysfs-pci, sysfs-tagging

2020-10-09 Thread Jonathan Corbet
tagging to networking. (Thanks to > Jonathan Corbet for coming up with the final locations.) > > Signed-off-by: John Hubbard Applied, thanks. jon

Re: [PATCH] Documentation: filesystems: better locations for sysfs-pci, sysfs-tagging

2020-10-08 Thread Jonathan Corbet
On Wed, 7 Oct 2020 16:31:51 -0700 John Hubbard wrote: > sysfs-pci and sysfs-tagging were mis-filed: their locations with > Documentation/ implied that they were related to file systems. Actually, > each topic is about a very specific *use* of sysfs, and sysfs *happens* > to be a (virtual)

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-06 Thread Jonathan Corbet
On Tue, 6 Oct 2020 08:42:07 +0200 Mauro Carvalho Chehab wrote: > As right now we don't support Sphinx version 3.0[1], we're actually using just > $sphinx_major. So, I'm wonder if it would make sense to also make > optional. Maybe...someday we may need it, knowing how the Sphinx folks approach

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

2020-10-05 Thread Jonathan Corbet
As kernel-doc can also be manually called, keep the auto-detection > logic if the parameter was not specified. On such case, emit > a warning if sphinx-build can't be found at PATH. > > Suggested-by: Jonathan Corbet > Signed-off-by: Mauro Carvalho Chehab > --- >

Re: [PATCH] docs: programming-languages: refresh blurb on clang support

2020-10-05 Thread Jonathan Corbet
On Tue, 29 Sep 2020 14:19:35 -0700 Nick Desaulniers wrote: > Building the kernel with Clang doesn't rely on third party patches, and > has not for a few years now. > > Signed-off-by: Nick Desaulniers > --- > Documentation/process/programming-language.rst | 9 + > 1 file changed, 5

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

2020-10-05 Thread Jonathan Corbet
On Fri, 2 Oct 2020 08:04:22 -0700 Li Qiang wrote: > Fixes: 9824c83f92bc8 ("Documentation: kvm: document CPUID bit for > MSR_KVM_POLL_CONTROL") > Signed-off-by: Li Qiang > --- > Documentation/virt/kvm/cpuid.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH] mm: optionally disable brk()

2020-10-05 Thread Jonathan Corbet
On Mon, 5 Oct 2020 11:11:35 +0300 Topi Miettinen wrote: > The point is not to shrink the kernel (it will shrink by one small > function) or get rid of complexity. The point is to disable an inferior > interface. Memory returned by mmap() is at a random location but with > brk() it is located

Re: [PATCH v4 04/52] scripts: kernel-doc: make it more compatible with Sphinx 3.x

2020-10-01 Thread Jonathan Corbet
On Thu, 1 Oct 2020 15:41:00 -0600 Jonathan Corbet wrote: > On Wed, 30 Sep 2020 15:24:27 +0200 > Mauro Carvalho Chehab wrote: > > > With Sphinx 3.x, the ".. c:type:" tag was changed to accept either: > > > > .. c:type:: typedef-like declaration &g

Re: [PATCH v4 00/52] Fix html build with Sphinx 3.1 and above

2020-10-01 Thread Jonathan Corbet
On Wed, 30 Sep 2020 15:24:23 +0200 Mauro Carvalho Chehab wrote: > This series add proper support for Sphinx 3.1 and above for building the html > docs. > > This series comes after the one I wrote fixing the warnings. > > With this series applied on the top of next-20200922, there are just 12

Re: [PATCH v4 04/52] scripts: kernel-doc: make it more compatible with Sphinx 3.x

2020-10-01 Thread Jonathan Corbet
On Wed, 30 Sep 2020 15:24:27 +0200 Mauro Carvalho Chehab wrote: > With Sphinx 3.x, the ".. c:type:" tag was changed to accept either: > > .. c:type:: typedef-like declaration > .. c:type:: name > > Using it for other types (including functions) don't work anymore. > > So, there

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

2020-09-28 Thread Jonathan Corbet
On Fri, 25 Sep 2020 08:17:58 -0700 Bailu Lin wrote: > This is a Chinese translated version of Documentation/arm64/amu.rst > > Signed-off-by: Bailu Lin > --- > Changes in v3: > - Remove Documentation/arm64/amu.rst's inappropriate License claim. > Changes in v2: > - Add index to arm64

Re: [PATCH v5] doc: zh_CN: index files in arm64 subdirectory

2020-09-28 Thread Jonathan Corbet
On Fri, 25 Sep 2020 19:25:58 -0700 Bailu Lin wrote: > Add arm64 subdirectory into the table of Contents for zh_CN, > then add other translations in arm64 conveniently. > > Signed-off-by: Bailu Lin > --- > Changes in v5: > - Remove zh_CN/arm64/index.rst's inappropriate License claim. > Changes

Re: [PATCH] mailmap: add entry for

2020-09-28 Thread Jonathan Corbet
On Mon, 28 Sep 2020 18:39:59 + Mark Starovoytov wrote: > Map the address to my private mail, because my Marvell account has been > suspended. > > Signed-off-by: Mark Starovoytov > --- > .mailmap | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/.mailmap b/.mailmap > index

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.

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