Re: [PATCH 1/1] [PATCH] Documentation/translations: Translate sound/hd-audio/controls.rst into Chinese

2021-02-19 Thread Jonathan Corbet
hjh writes: > Signed-off-by: hjh > --- > .../zh_CN/sound/hd-audio/controls.txt | 117 ++ > 1 file changed, 117 insertions(+) > create mode 100644 > Documentation/translations/zh_CN/sound/hd-audio/controls.txt Thanks for working to improve the documentation. When you

Re: anonymous enums in kernel doc

2021-02-16 Thread Jonathan Corbet
Andy Shevchenko writes: > On Tue, Feb 16, 2021 at 6:51 PM Jonathan Corbet wrote: >> >> > Mauro, can you do some test cases in your workflow against anonymous >> > enum in ernel doc, please? >> > >> > They are broken again, please fix the script! &g

Re: anonymous enums in kernel doc

2021-02-16 Thread Jonathan Corbet
Andy Shevchenko writes: > Mauro, can you do some test cases in your workflow against anonymous > enum in ernel doc, please? > > They are broken again, please fix the script! > > drivers/pinctrl/intel/pinctrl-intel.c:204: warning: wrong kernel-doc > identifier on line: > * enum - Locking variants

Re: [PATCH] docs: kernel-hacking: Remove the word fuck,trying to be civil :)

2021-02-11 Thread Jonathan Corbet
Bhaskar Chowdhury writes: > s/fuck// > > > Signed-off-by: Bhaskar Chowdhury > --- > Documentation/kernel-hacking/locking.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/kernel-hacking/locking.rst > b/Documentation/kernel-hacking/locking.rst > index

Re: [PATCH] doc/admin-guide: fix spelling mistake: "perfomance" -> "performance"

2021-02-11 Thread Jonathan Corbet
Colin King writes: > From: Colin Ian King > > There is a spelling mistake in the perf-security documentation. Fix it. > > Signed-off-by: Colin Ian King > --- > Documentation/admin-guide/perf-security.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH v2] Documentation/admin-guide: kernel-parameters: Update nohlt section

2021-02-11 Thread Jonathan Corbet
Florian Fainelli writes: > Update the documentation regarding "nohlt" and indicate that it is not > only for bugs, but can be useful to disable the architecture specific > sleep instructions. ARM, ARM64, SuperH and Microblaze all use > CONFIG_GENERIC_IDLE_POLL_SETUP which takes care of honoring

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

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

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 >

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.

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

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

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%) > >

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

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,

Re: [PATCH v4 4/6] Documentation: misc-devices: Add Documentation for dw-xdata-pcie driver

2021-02-03 Thread Jonathan Corbet
Gustavo Pimentel writes: > Add Documentation for dw-xdata-pcie driver. > > Signed-off-by: Gustavo Pimentel > --- > Documentation/misc-devices/dw-xdata-pcie.rst | 40 > > 1 file changed, 40 insertions(+) > create mode 100644

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

Re: [PATCH] kbuild: remove PYTHON variable

2021-02-01 Thread Jonathan Corbet
Masahiro Yamada writes: > Python retired in 2020, and some distributions do not provide the > 'python' command any more. > > As in commit 51839e29cb59 ("scripts: switch explicitly to Python 3"), > we need to use more specific 'python3' to invoke scripts even if they > are written in a way

Re: [PATCH 1/5] docs: arm: marvell: turn the automatic links into labels

2021-01-29 Thread Jonathan Corbet
Lubomir Rintel writes: > Lines ending with obscenely long URLs at the end don't look good. > > Even if these links are not that long at this point, they will be when > replaced with an archive link in a subsequent patch -- let's prepare for > that. > > Signed-off-by: Lubomir Rintel > --- >

Re: [PATCH] Updates Documentation/Makefile to use Python3 as fallback

2021-01-29 Thread Jonathan Corbet
Noa Sakurajin writes: [CC += kbuild maintainers] > Before the command python was needed for the documentation to build. > This patch checks if python is available and uses python3 as > fallback. > > This is needed because a lot of distribution (at least Ubuntu) > only provide python3 and

Re: Small student project idea on appropriate integration trees in MAINTAINERS

2021-01-28 Thread Jonathan Corbet
On Fri, 22 Jan 2021 09:22:24 +0100 Lukas Bulwahn wrote: > In this project, we can make use of: > > - gitdm [git://git.lwn.net/gitdm.git]: gitdm includes some scripts to > parse MAINTAINERS and obtain the integration tree patch of a commit. Look also at the 'treeplot' tool there, which

Re: [PATCH] Documentation: input: define ABS_PRESSURE/ABS_MT_PRESSURE resolution as grams

2021-01-28 Thread Jonathan Corbet
On Wed, 13 Jan 2021 09:03:10 +1000 Peter Hutterer wrote: > ABS_PRESSURE and ABS_MT_PRESSURE on touch devices usually represent > contact size (as a finger flattens with higher pressure the contact size > increases) and userspace translates the kernel pressure value back into > contact size. For

Re: [PATCH] Update Documentation/admin-guide/sysctl/fs.rst

2021-01-28 Thread Jonathan Corbet
On Wed, 20 Jan 2021 13:26:47 + Eric Curtin wrote: > max_user_watches for epoll should say 1/25, rather than 1/32 > > Signed-off-by: Eric Curtin > --- > Documentation/admin-guide/sysctl/fs.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git

Re: [PATCH] docs: Update DTB format references

2021-01-28 Thread Jonathan Corbet
On Wed, 20 Jan 2021 13:31:51 + Milan Lakhani wrote: > There were two references to devicetree/booting-without-of.rst (which has > been removed) for DTB format information, and > devicetree/usage-model.rst pointed to > https://elinux.org/Device_Tree_Usage. Change all three of these references

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

2021-01-28 Thread Jonathan Corbet
On Sun, 24 Jan 2021 20:32:02 -0800 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: Randy Dunl

Re: [PATCH] Documentation: arm: marvell: Update link to unrestricted Armada 38x Functional Spec

2021-01-28 Thread Jonathan Corbet
On Mon, 25 Jan 2021 15:15:29 +0100 Pali Rohár wrote: > On Marvell website is documentation accessible without need to register or > fill any other forms. > > Signed-off-by: Pali Rohár > --- > Documentation/arm/marvell.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH 1/2] Documentation: arm: Fix marvell file name

2021-01-28 Thread Jonathan Corbet
On Thu, 21 Jan 2021 20:34:17 +0100 Pali Rohár wrote: > Signed-off-by: Pali Rohár > --- > Documentation/arm/index.rst | 2 +- > Documentation/arm/{marvel.rst => marvell.rst} | 0 > 2 files changed, 1 insertion(+), 1 deletion(-) > rename Documentation/arm/{marvel.rst =>

Re: [PATCH] Documentation: arm: marvell: Fix dead link to Armada 37xx Product Brief

2021-01-28 Thread Jonathan Corbet
On Mon, 25 Jan 2021 15:13:41 +0100 Pali Rohár wrote: > Signed-off-by: Pali Rohár > --- > Documentation/arm/marvell.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/arm/marvell.rst b/Documentation/arm/marvell.rst > index b16e6f7e8dbe..fa22a72d4391

Re: [PATCH] Documentation/x86/boot.rst: Correct the example of SETUP_INDIRECT

2021-01-28 Thread Jonathan Corbet
On Wed, 27 Jan 2021 13:54:40 +0100 Daniel Kiper wrote: > On Wed, Jan 27, 2021 at 04:49:11PM +0800, Cao jin wrote: > > struct setup_data.len is the length of data field. In case of > > SETUP_INDIRECT, it should be sizeof(setup_indirect). > > > > Signed-off-by: Cao jin > > Reviewed-by: Daniel

Re: [PATCH RESEND] Documentation: kernel-parameters: add missing '<'

2021-01-28 Thread Jonathan Corbet
On Wed, 27 Jan 2021 11:43:43 +0100 Wolfram Sang wrote: > Acked-by: Randy Dunlap > Signed-off-by: Wolfram Sang > --- > Documentation/admin-guide/kernel-parameters.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/admin-guide/kernel-parameters.rst >

Re: [PATCH 00/12] docs: path-lookup: Update pathlookup docs

2021-01-26 Thread Jonathan Corbet
On Tue, 26 Jan 2021 15:24:31 +0800 Fox Chen wrote: > The Path lookup is a very complex subject in VFS. The path-lookup > document provides a very detailed guidance to help people understand > how path lookup works in the kernel.This document was originally > written based on three lwn articles

Re: [PATCH] arch/Kconfig: update a broken file reference

2021-01-21 Thread Jonathan Corbet
On Tue, 19 Jan 2021 10:53:26 +0100 Lukas Bulwahn wrote: > Commit adab66b71abf ("Revert: "ring-buffer: Remove > HAVE_64BIT_ALIGNED_ACCESS"") > added the config HAVE_64BIT_ALIGNED_ACCESS back into arch/Kconfig with this > revert. In the meantime, commit c9b54d6f362c ("docs: move other kAPI >

Re: [PATCH] AFS: Documentation: fix a few typos in afs.rst

2021-01-21 Thread Jonathan Corbet
On Sun, 17 Jan 2021 13:33:51 -0800 Randy Dunlap wrote: > Fix typos (punctuation, grammar, spelling) in afs.rst. > > Signed-off-by: Randy Dunlap > Cc: David Howells > Cc: linux-...@lists.infradead.org > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- >

Re: [PATCH v6 00/16] Fix several bad kernel-doc markups

2021-01-21 Thread Jonathan Corbet
On Thu, 14 Jan 2021 09:04:36 +0100 Mauro Carvalho Chehab wrote: > 1) 10 remaining fixup patches from the series I sent back on Dec, 1st: > >parport: fix a kernel-doc markup >rapidio: fix kernel-doc a markup >fs: fix kernel-doc markups >pstore/zone: fix a kernel-doc markup >

Re: [PATCH bpf-next v3 0/2] BPF docs fixups

2021-01-21 Thread Jonathan Corbet
On Wed, 20 Jan 2021 13:39:44 + Brendan Jackman wrote: > Difference from v2->v3 [1]: > > * Just fixed a commite message, rebased, and added Lukas' review tag - thanks >Lukas! > > Difference from v1->v2 [1]: > > * Split into 2 patches > > * Avoided unnecessary ': ::' in .rst source

Re: [PATCH v6 0/2] Documentation: livepatch: Document reliable stacktrace and minor cleanup

2021-01-21 Thread Jonathan Corbet
On Wed, 20 Jan 2021 16:47:12 + Mark Brown wrote: > This series adds a document, mainly written by Mark Rutland, which makes > explicit the requirements for implementing reliable stacktrace in order > to aid architectures adding this feature. It also updates the other > livepatching

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

2021-01-21 Thread Jonathan Corbet
On Thu, 21 Jan 2021 10:07:48 +0800 (GMT+08:00) 司延腾 wrote: > Sorry, I apologize for the inconvenience caused to you, I do not > quibble, but I have been studying for nearly a week, please pay > attention to my future patches. Please don't worry, mistakes happen; we just have to learn from them.

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

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

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

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

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

Re: [PATCH v3] Documentation: livepatch: document reliable stacktrace

2021-01-15 Thread Jonathan Corbet
On Fri, 15 Jan 2021 17:12:51 + Mark Brown wrote: > On Fri, Jan 15, 2021 at 04:47:18PM +, Mark Rutland wrote: > > On Fri, Jan 15, 2021 at 02:24:46PM +, Mark Brown wrote: > > > > +3. Considerations > > > + 3.1 Identifying successful termination > > > It looks like we

Re: Related work to MAINTAINERS truth and fiction

2021-01-15 Thread Jonathan Corbet
On Fri, 15 Jan 2021 07:57:51 +0100 Lukas Bulwahn wrote: > Pia Eichinger has done some related analysis and work in this area as > part of her bachelor's thesis on Maintainers Expectations vs. > Maintainers Reality: An Analysis of Organisational and Maintenance > Structure of the Linux Kernel.

Re: [PATCH 00/10] Fix documentation warnings at linux-next

2021-01-15 Thread Jonathan Corbet
On Fri, 15 Jan 2021 07:12:38 +0100 Lukas Bulwahn wrote: > We both, Mauro and I, have been submitting patches to address the > documentation warnings on linux-next. If it is okay with you, Mauro, I > would like to take responsibility for the task to send out the patches > to address all warnings

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

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

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

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

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

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

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

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

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

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

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

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

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

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 >

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

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

2021-01-04 Thread Jonathan Corbet
[Digging out from under the pile of mail...] > From: Borislav Petkov > Date: Tue, 22 Dec 2020 13:58:22 +0100 > > Document that backtraces in commit messages should be trimmed down to > the useful information only. > > This has been carved out from a tip subsystem handbook patchset by > Thomas

Re: [PATCH] atomic: remove further references to atomic_ops

2020-12-31 Thread Jonathan Corbet
On Sun, 20 Dec 2020 07:09:27 +0100 Lukas Bulwahn wrote: > Commit f0400a77ebdc ("atomic: Delete obsolete documentation") removed > ./Documentation/core-api/atomic_ops.rst, but missed to remove further > references to that file. > > Hence, make htmldocs warns: > >

Re: [RFC PATCH] Documentation: doc-guide: fixes to sphinx.rst

2020-12-31 Thread Jonathan Corbet
On Mon, 28 Dec 2020 15:12:12 -0800 Randy Dunlap wrote: > Various fixes to sphinx.rst: > > - eliminate a double-space between 2 words > - grammar/wording > - punctuation > - call rows in a table 'rows' instead of 'columns' (or does Sphinx > call everything a column?) > - It seems that

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

2020-12-31 Thread Jonathan Corbet
On Sun, 27 Dec 2020 15:15:19 +0800 winnd...@163.com wrote: > It should be "low watermark" where we wake up kswapd daemon. > > Signed-off-by: Liao Pingfang > --- > Documentation/admin-guide/mm/concepts.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH] Documentation: admin: early_param()s are also listed in kernel-parameters

2020-12-31 Thread Jonathan Corbet
On Sat, 26 Dec 2020 09:44:33 -0800 Randy Dunlap wrote: > Add info that "early_param()" kernel boot parameters are also listed > in kernel-parameters.txt. > > Signed-off-by: Randy Dunlap > Cc: Jonathan Corbet > Cc: linux-...@vger.kernel.org > --- >

Re: [PATCH v2] docs: Fix reST markup when linking to sections

2020-12-31 Thread Jonathan Corbet
On Mon, 28 Dec 2020 14:46:07 + Nícolas F. R. A. Prado wrote: > During the process of converting the documentation to reST, some links > were converted using the following wrong syntax (and sometimes using %20 > instead of spaces): > >`Display text <#section-name-in-html>`__ > > This

[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

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

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

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. > >

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 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 0/2] Documentation/process: Add subsystem/tree handbook

2020-12-17 Thread Jonathan Corbet
On Thu, 17 Dec 2020 16:05:37 +0100 Borislav Petkov wrote: > So, that thing. > > I have this ontop of 5.10 along with most comments integrated. > > Now, I'm thinking if I start sending those pieces which belong into the > main process documentation, the bikeshedding that is going to ensue is >

[GIT PULL] Documentation for 5.11

2020-12-14 Thread Jonathan Corbet
JaeSang Yoo (1): docs: update requirements to install six module Jonathan Corbet (2): docs: Note that sphinx 1.7 will be required soon docs: fix broken cross reference in translations/zh_CN Jonathan Neuschäfer (3): docs: driver-api: mtd: intel-spi: Improve formatting

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

2020-12-14 Thread Jonathan Corbet
ot;) > > I am still getting this warning. OK, enough of that; I've just tacked on the following patch to address this problem, thanks for the report. Thanks, jon From 47e44ed01434e51e2e42b188482d837c01e5d16e Mon Sep 17 00:00:00 2001 From: Jonathan Corbet Date: Mon, 14 Dec 2020 13:14:

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

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

Re: [PATCH 01/13] docs: conf.py: fix sphinx version detection for margin set

2020-12-10 Thread Jonathan Corbet
ches changed it to be around 17.5 cm, > but the logic only works with Sphinx version 1.x.x. > > Fix it. > > Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet Feel free to route this one with the rest of the set. Someday it might be nice to isolate all of the latex stuff

Re: [PATCH] docs: reporting-issues: move 'outdated, need help' note to proper place

2020-12-09 Thread Jonathan Corbet
On Wed, 9 Dec 2020 06:19:14 +0100 Thorsten Leemhuis wrote: > Move the 'this section is a placeholder for now and needs help by > someone with domain knowledge' note one section upwards to the place > where it belongs: the 'Decode failure messages' section. > > Signed-off-by: Thorsten Leemhuis

Re: [External] linux-next: build failure after merge of the pm tree

2020-12-09 Thread Jonathan Corbet
On Wed, 9 Dec 2020 10:04:22 -0500 Mark Pearson wrote: > On 09/12/2020 09:33, Jonathan Corbet wrote: > > On Wed, 9 Dec 2020 08:56:31 -0500 Mark Pearson > > wrote: > > > >> I do see: WARNING: document isn't included in any toctree but I > >> think this is

Re: [External] linux-next: build failure after merge of the pm tree

2020-12-09 Thread Jonathan Corbet
On Wed, 9 Dec 2020 08:56:31 -0500 Mark Pearson wrote: > I do see: >WARNING: document isn't included in any toctree > but I think this is benign - I believe I'm getting it just because I > converted the file to .rst (as requested by Andy Shevchenko). If this is > important and needs to be

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

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:

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

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-by: Ra

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

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

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(-)

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