Re: [PATCH] Replace HTTP links with HTTPS ones: Documentation/process

2020-06-22 Thread Jonathan Corbet
On Mon, 22 Jun 2020 01:43:12 +0200 Miguel Ojeda wrote: > > * The script should not be neccessary once all of my changes[1] arrive > > in torvalds/master. Instead reviewers should say like C'mon dude, what's > > this new plain-HTTP link doing in your patch? We have 2020! Look at e.g. > >

Re: [PATCH 22/22] docs: staging: use small font for literal includes

2020-06-19 Thread Jonathan Corbet
On Mon, 15 Jun 2020 08:50:27 +0200 Mauro Carvalho Chehab wrote: > The normal font is too big to display 80 columns, causing extra > breaks to be added at weird places. > > change to the footnotesize, as this would fit a little bit > better. > > Signed-off-by: Mauro Carvalho Chehab > --- >

Re: [PATCH 18/22] docs: trace: ring-buffer-design.txt: convert to ReST format

2020-06-19 Thread Jonathan Corbet
On Mon, 15 Jun 2020 08:50:23 +0200 Mauro Carvalho Chehab wrote: [CC += Steve] > - Just like some media documents, this file is dual licensed > with GPL and GFDL. As right now the GFDL SPDX definition is > bogus (as it doesn't tell anything about invariant parts), > let's not use SPDX

Re: [PATCH 03/22] docs: crypto: convert asymmetric-keys.txt to ReST

2020-06-19 Thread Jonathan Corbet
On Mon, 15 Jun 2020 08:50:08 +0200 Mauro Carvalho Chehab wrote: > This file is almost compatible with ReST. Just minor changes > were needed: > > - Adjust document and titles markups; > - Adjust numbered list markups; > - Add a comments markup for the Contents section; > - Add markups for

Re: [PATCH 02/22] docs: thermal: convert cpu-idle-cooling.rst to ReST

2020-06-19 Thread Jonathan Corbet
On Mon, 15 Jun 2020 08:50:07 +0200 Mauro Carvalho Chehab wrote: > Despite being named with .rst extension, this file doesn't > match the ReST standard. It actually causes a crash at > Sphinx: > > Sphinx parallel build error: > docutils.utils.SystemMessage: >

Re: [PATCH 01/22] docs: dt: convert booting-without-of.txt to ReST format

2020-06-19 Thread Jonathan Corbet
On Mon, 15 Jun 2020 08:50:06 +0200 Mauro Carvalho Chehab wrote: > +Copyright |copy| 2005 Benjamin Herrenschmidt , > +IBM Corp. > + > +Copyright |copy| 2005 Becky Bruce , > +Freescale Semiconductor, FSL SOC and 32-bit additions > + > +Copyright |copy| 2006 MontaVista Software, Inc. > +Flash chip

Re: [PATCH 2/2] docs: fs: proc.rst: fix a warning due to a merge conflict

2020-06-19 Thread Jonathan Corbet
On Wed, 3 Jun 2020 00:38:14 +0200 Mauro Carvalho Chehab wrote: > Changeset 424037b77519 ("mm: smaps: Report arm64 guarded pages in smaps") > added a new parameter to a table. This causes Sphinx warnings, > because there's now an extra "-" at the wrong place: > >

Re: [PATCH] Documentation: Fix most typos

2020-06-19 Thread Jonathan Corbet
On Fri, 19 Jun 2020 12:37:13 -0700 Joe Perches wrote: > Maybe your tree should be added to -next so > people don't have to search out specific trees. > > git git://git.lwn.net/linux.git docs-next What makes you think it's not there...? That doesn't help much when patches from other trees dig

Re: [PATCH v2] docs: block: Create blk-mq documentation

2020-06-19 Thread Jonathan Corbet
On Fri, 5 Jun 2020 14:55:36 -0300 André Almeida wrote: > Create a documentation providing a background and explanation around the > operation of the Multi-Queue Block IO Queueing Mechanism (blk-mq). > > The reference for writing this documentation was the source code and > "Linux Block IO:

Re: [PATCH v2] Documentation: tee: Document TEE kernel interface

2020-06-19 Thread Jonathan Corbet
On Thu, 4 Jun 2020 12:29:39 +0530 Sumit Garg wrote: > Update documentation with TEE bus infrastructure which provides an > interface for kernel client drivers to communicate with corresponding > Trusted Application. > > Signed-off-by: Sumit Garg > --- > > Changes in v2: > - Add TEE client

Re: [PATCH] Replace HTTP links with HTTPS ones: Documentation/translations/zh_CN

2020-06-19 Thread Jonathan Corbet
On Mon, 8 Jun 2020 20:16:49 +0200 "Alexander A. Klimov" wrote: > Rationale: > Reduces attack surface on kernel devs opening the links for MITM > as HTTPS traffic is much harder to manipulate. > > Deterministic algorithm: > For each file: > For each line: > If doesn't contain `\bxmlns\b`:

Re: [PATCH v3] docs: deprecated.rst: Add zero-length and one-element arrays

2020-06-19 Thread Jonathan Corbet
On Mon, 8 Jun 2020 16:37:11 -0500 "Gustavo A. R. Silva" wrote: > Add zero-length and one-element arrays to the list. > > While I continue replacing zero-length and one-element arrays with > flexible-array members, I need a reference to point people to, so > they don't introduce more instances

Re: [PATCH] doc:it_IT: add symbol-namespace translation

2020-06-19 Thread Jonathan Corbet
On Sun, 14 Jun 2020 22:10:53 +0200 Federico Vaga wrote: > - add complete translation of symbol-namespaces.rst > - fix references to this page within the italian translation > - add document to main indexes > > Signed-off-by: Federico Vaga > --- > .../translations/it_IT/core-api/index.rst

Re: [PATCH] docs/zh_CN: update sysfs.txt about show() usage

2020-06-19 Thread Jonathan Corbet
On Wed, 10 Jun 2020 10:53:33 +0800 Chen Zhou wrote: > Update the show() usage according to the English version. > > Signed-off-by: Chen Zhou > --- > Documentation/translations/zh_CN/filesystems/sysfs.txt | 6 -- > 1 file changed, 4 insertions(+), 2 deletions(-) Applied, thanks. jon

Re: [PATCH] docs: mm/gup: Minor documentation update

2020-06-19 Thread Jonathan Corbet
On Thu, 18 Jun 2020 00:57:03 +0530 Souptick Joarder wrote: > Now there are 5 cases. Updated the same. > > Signed-off-by: Souptick Joarder > Cc: John Hubbard > --- > Documentation/core-api/pin_user_pages.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git

Re: [PATCH] Documentation: fix sysctl/kernel.rst heading format warnings

2020-06-19 Thread Jonathan Corbet
On Sun, 14 Jun 2020 21:11:00 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Fix heading format warnings in admin-guide/sysctl/kernel.rst: > > Documentation/admin-guide/sysctl/kernel.rst:339: WARNING: Title underline too > short. > hung_task_all_cpu_backtrace: > > >

Re: [PATCH] Documentation: fix filesystems/locking.rst malformed table warnings

2020-06-19 Thread Jonathan Corbet
On Sun, 14 Jun 2020 20:22:19 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Fix Sphinx malformed table warnings in filesystems/locking.rst: > > lnx-58-rc1/Documentation/filesystems/locking.rst:443: WARNING: Malformed > table. > Text in column margin in table line 8. > >

Re: [PATCH] Documentation: remove SH-5 index entries

2020-06-19 Thread Jonathan Corbet
On Sun, 14 Jun 2020 19:59:07 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Remove SH-5 documentation index entries following the removal > of SH-5 source code. > > Error: Cannot open file ../arch/sh/mm/tlb-sh5.c > Error: Cannot open file ../arch/sh/mm/tlb-sh5.c > Error: Cannot open file

Re: [PATCH] Documentation: Fix most typos

2020-06-19 Thread Jonathan Corbet
On Wed, 10 Jun 2020 16:07:32 -0700 Joe Perches wrote: > These are the typos found in scripts/spelling.txt for > most of the Documentation/ tree. > > Scripted with: > > $ cat scripts/spelling.txt | \ > grep -v -P "^\s*\#" | \ > while read line ; do \ > from=$(echo $line | cut -f1

Re: [PATCH 1/1] doc: x86/speculation: length of underlines

2020-06-19 Thread Jonathan Corbet
On Mon, 15 Jun 2020 22:36:45 +0200 Heinrich Schuchardt wrote: > The lengths of underlines must match the titles to avoid build warnings. > > Signed-off-by: Heinrich Schuchardt > --- > .../hw-vuln/special-register-buffer-data-sampling.rst | 6 +++--- > 1 file changed, 3 insertions(+), 3

Re: [PATCH 1/1] doc: add novamap to efi kernel command line parameters

2020-06-19 Thread Jonathan Corbet
On Tue, 16 Jun 2020 12:40:12 +0200 Heinrich Schuchardt wrote: > Document the efi=novamap kernel command line parameter. > Put the efi parameters into alphabetic order. > > Signed-off-by: Heinrich Schuchardt > --- > .../admin-guide/kernel-parameters.txt | 18 ++ > 1

Re: [PATCH] mailmap: add entries for Alexander Lobakin

2020-06-19 Thread Jonathan Corbet
On Fri, 19 Jun 2020 09:51:14 + Alexander Lobakin wrote: > My D-Link and Yandex addresses don't exist anymore, map them to my > private box. > > Signed-off-by: Alexander Lobakin > --- > .mailmap | 2 ++ > 1 file changed, 2 insertions(+) > > diff --git a/.mailmap b/.mailmap > index

Re: [PATCH] Documentation: fix malformed table in filesystems/proc.rst

2020-06-15 Thread Jonathan Corbet
On Sun, 14 Jun 2020 23:54:26 -0700 Randy Dunlap wrote: > On 6/14/20 11:53 PM, Mauro Carvalho Chehab wrote: > > Em Sun, 14 Jun 2020 20:33:22 -0700 > > Randy Dunlap escreveu: > > > >> From: Randy Dunlap > >> > >> Fix malformed table in "proc.rst" by dropping a needless hyphen ('-'). > >> > >>

Re: [PATCH] Replace HTTP links with HTTPS ones: Documentation/translations/it_IT

2020-06-11 Thread Jonathan Corbet
On Thu, 11 Jun 2020 18:05:37 +0200 "Alexander A. Klimov" wrote: > Once the doc subsystems patches get applied (or even reach > torvalds/master) I'll submit maybe ten patches at once. And the more > maintainers apply them... The first patch is in mainline now. I'll deal with subsequent ones

Re: [PATCH v2 1/3] docs: IOMMU user API

2020-06-11 Thread Jonathan Corbet
On Wed, 10 Jun 2020 21:12:13 -0700 Jacob Pan wrote: A little nit but...this pattern: > +pattern below: > + > +:: > + > + struct { > + __u32 argsz; > + __u32 flags; > + __u8 data[]; > + } can be more concisely and attractively written as: pattern below:: struct {

Re: [PATCH] Replace HTTP links with HTTPS ones: Documentation/translations/it_IT

2020-06-11 Thread Jonathan Corbet
On Thu, 11 Jun 2020 13:02:08 +0200 "Alexander A. Klimov" wrote: > Who if not Linus shall review one huge patch spreading across lots of > subsystems? In practice almost nobody, which is why I've said several times that you shouldn't do that. There is no flag-day situation forcing this work to

[GIT PULL] A bit more documentation for 5.8

2020-06-10 Thread Jonathan Corbet
for devm_platform_get_and_ioremap_resource() Heinrich Schuchardt (1): docs: dev-tools: coccinelle: underlines Jonathan Corbet (1): docs: Update the location of the LF NDA program Lukas Bulwahn (2): doc: zh_CN: use doc reference to resolve undefined label warning docs: it_IT: address

Re: [PATCH] docs/memory-barriers.txt/kokr: smp_mb__{before,after}_atomic(): update Documentation

2020-06-08 Thread Jonathan Corbet
On Sat, 6 Jun 2020 10:37:46 +0200 SeongJae Park wrote: > Translate this commit to Korean: > > 39323c64b8a9 ("smp_mb__{before,after}_atomic(): update Documentation") > > Signed-off-by: SeongJae Park > Reviewed-by: Yunjae Lee Applied, thanks. jon

Re: [PATCH v1] Documentation: devres: add missing entry for devm_platform_get_and_ioremap_resource()

2020-06-08 Thread Jonathan Corbet
On Wed, 27 May 2020 22:45:31 +0800 Dejin Zheng wrote: > The devm_platform_get_and_ioremap_resource() should be documented in > devres.rst. Add the missing entry. > > Signed-off-by: Dejin Zheng > --- > Documentation/driver-api/driver-model/devres.rst | 1 + > 1 file changed, 1 insertion(+) >

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

2020-06-08 Thread Jonathan Corbet
On Tue, 26 May 2020 08:05:44 +0200 "Alexander A. Klimov" wrote: > Rationale: > Reduces attack surface on kernel devs opening the links for MITM > as HTTPS traffic is much harder to manipulate. > > Deterministic algorithm: > For each file: > For each line: > If doesn't contain `\bxmlns\b`:

Re: [PATCH] docs: it_IT: address invalid reference warnings

2020-06-08 Thread Jonathan Corbet
On Sun, 31 May 2020 20:56:18 +0200 Lukas Bulwahn wrote: > Documentation generation warns: > > it_IT/kernel-hacking/hacking.rst: > WARNING: unknown document: ../core-api/symbol/namespaces > > it_IT/process/5.Posting.rst: > WARNING: undefined label: it_email_clients > >

Re: [PATCH] doc: zh_CN: use doc reference to resolve undefined label warning

2020-06-08 Thread Jonathan Corbet
On Sun, 31 May 2020 20:35:56 +0200 Lukas Bulwahn wrote: > Documentation generation warns: > > Documentation/translations/zh_CN/filesystems/debugfs.rst:5: > WARNING: undefined label: debugfs_index > > Use doc reference for files rather than introducing a label to refer to. > This resolves

Re: [PATCH 0/2] a couple documentation fixes

2020-06-08 Thread Jonathan Corbet
On Wed, 3 Jun 2020 00:38:12 +0200 Mauro Carvalho Chehab wrote: > It follows a couple of fixes for two tables that got broken, probably due to > some conflict between the ReST conversion patches and ungoing updates. > > IMO, it would be nice to have those two applied during the merge window, >

Re: [PATCH 1/1] docs: dev-tools: coccinelle: underlines

2020-06-08 Thread Jonathan Corbet
On Fri, 5 Jun 2020 05:04:05 +0200 Heinrich Schuchardt wrote: > Underline lengths should match the lengths of headings to avoid build > warnings with Sphinx. > > Signed-off-by: Heinrich Schuchardt > --- > Documentation/dev-tools/coccinelle.rst | 8 > 1 file changed, 4 insertions(+),

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

2020-06-05 Thread Jonathan Corbet
On Fri, 5 Jun 2020 22:28:54 +0200 "Alexander A. Klimov" wrote: > Am I completely blind or did the patch completely disappear? > > $ git log v5.0..docs-5.8 |grep -Fwe 'Alexander A. Klimov' > $ git log v5.0..lwn/docs-next |grep -Fwe 'Alexander A. Klimov' > $ git log v5.0..lwn/docs-next-merge

[PATCH] irqchip: Fix the description of the Loongson PCH MSI controller

2020-06-03 Thread Jonathan Corbet
Signed-off-by: Jonathan Corbet --- drivers/irqchip/Kconfig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/irqchip/Kconfig b/drivers/irqchip/Kconfig index 66b9a68f5e9f..d7c920afcfcb 100644 --- a/drivers/irqchip/Kconfig +++ b/drivers/irqchip/Kconfig @@ -550,7 +550,7

Re: reference to Linux Foundation NDA program obsolete?

2020-06-03 Thread Jonathan Corbet
On Sun, 24 May 2020 07:33:29 +0200 (CEST) Lukas Bulwahn wrote: > http://www.linuxfoundation.org/en/NDA_program > > This kind of review is often enough to avoid serious problems later on > without requiring public disclosure of the project. > > <-- > > The link is dead; internet search

[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: document ngroups_max&quo

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

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

Re: [RFC PATCH v5 2/3] docs: scheduler: Add scheduler overview documentation

2020-05-29 Thread Jonathan Corbet
On Fri, 29 May 2020 13:00:12 +0200 Peter Zijlstra wrote: > > +**Thermal Pressure**: > > I find these attached headers really hard to read. And what's with the > ** stuff ? > > Other files in this same patch use a different style: > > Header > -- > test goes here, > > Which I find a lot

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

2020-05-26 Thread Jonathan Corbet
On Tue, 26 May 2020 08:01:22 +1000 Stephen Rothwell wrote: > Commit > > 1fe411077207 ("Replace HTTP links with HTTPS ones: documentation") > > is missing a Signed-off-by from its author. Argh, I don't know how I missed that. Thanks for catching it, it will be fixed up. jon

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

2020-05-25 Thread Jonathan Corbet
On Mon, 25 May 2020 20:01:45 +0200 "Alexander A. Klimov" wrote: > > But this does not seem to do harm at this point, so I have gone ahead and > > applied it. > What does this mean? Is there a kernel.org repo/branch with my patch? That means it's in the docs-next tree. jon

Re: [PATCH] tracing: Fix events.rst section numbering

2020-05-25 Thread Jonathan Corbet
On Fri, 22 May 2020 08:37:41 -0400 Steven Rostedt wrote: > On Mon, 18 May 2020 13:29:24 -0500 > Tom Zanussi wrote: > > > The in-kernel trace event API should have its own section, and the > > duplicate section numbers need fixing as well. > > > > Signed-off-by: Tom Zanussi > > Acked-by:

Re: [PATCH v1 1/2] docs: filesystems: add info about efivars content

2020-05-25 Thread Jonathan Corbet
On Tue, 19 May 2020 10:41:27 +0200 Flavio Suligoi wrote: > When an EFI variable is reading from: > > /sys/firmware/efi/efivars > > (for example using "hexdump"), the first 4 bytes of the > output are not the real EFI variable data, but the variable > attributes (in little-endian format). > >

Re: [PATCH 1/1] Documentation: security: core.rst: add missing argument

2020-05-25 Thread Jonathan Corbet
On Mon, 25 May 2020 10:33:10 -0600 Jonathan Corbet wrote: > On Fri, 15 May 2020 20:39:17 -0400 > Ben Boeckel wrote: > > > From: Ben Boeckel > > > > This argument was just never documented in the first place. > > > > Signed-off-by: Ben Boeckel &

Re: [PATCH] mailmap: change email for Ricardo Ribalda

2020-05-25 Thread Jonathan Corbet
On Thu, 30 Apr 2020 15:52:24 +0200 Ricardo Ribalda wrote: > From: Ricardo Ribalda Delgado > > Modify emails to riba...@kernel.org and unify my surname in all the > files. > > Signed-off-by: Ricardo Ribalda > --- > .mailmap | 4 +++- > CREDITS

Re: [RFC PATCH v5 0/3] Add scheduler overview documentation

2020-05-25 Thread Jonathan Corbet
On Thu, 14 May 2020 12:26:34 +0300 john mathew wrote: > This patch series updates the scheduler documentation to add more topics > wrt to scheduler overview. New sections are added to provide a brief > overview of the kernel structs used by the scheduler, scheduler invocation, > context switch

Re: [PATCH v2] docs: sysctl/kernel: document unaligned controls

2020-05-25 Thread Jonathan Corbet
On Fri, 15 May 2020 23:24:44 +0200 Stephen Kitt wrote: > This documents ignore-unaligned-usertrap, unaligned-dump-stack, and > unaligned-trap, based on arch/arc/kernel/unaligned.c, > arch/ia64/kernel/unaligned.c, and arch/parisc/kernel/unaligned.c. > > While we're at it, integrate

Re: [PATCH 1/1] Documentation: security: core.rst: add missing argument

2020-05-25 Thread Jonathan Corbet
On Fri, 15 May 2020 20:39:17 -0400 Ben Boeckel wrote: > From: Ben Boeckel > > This argument was just never documented in the first place. > > Signed-off-by: Ben Boeckel > --- > Documentation/security/keys/core.rst | 8 ++-- > 1 file changed, 6 insertions(+), 2 deletions(-) Applied,

Re: [PATCH] Documentation: admin-guide: update bug-hunting.rst

2020-05-25 Thread Jonathan Corbet
On Sat, 16 May 2020 20:43:39 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Update Documentation/admin-guide/bug-hunting.rst: > > - add a small section on "Modules linked in" and their possible flags; > - delete all references to ksymoops since it is no longer applicable; > - fix spello,

Re: [PATCH v2] docs: sysctl/kernel: document ngroups_max

2020-05-25 Thread Jonathan Corbet
On Mon, 18 May 2020 16:58:36 +0200 Stephen Kitt wrote: > This is a read-only export of NGROUPS_MAX. > > Signed-off-by: Stephen Kitt > --- > Changes since v1: > - drop changes to kernel/sysctl.c > > Documentation/admin-guide/sysctl/kernel.rst | 9 + > 1 file changed, 9 insertions(+)

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

2020-05-25 Thread Jonathan Corbet
On Wed, 20 May 2020 22:00:37 +0200 "Alexander A. Klimov" wrote: > Rationale: Reduces attack surface on kernel devs for MITM. > > Deterministic algorithm: > For each file: > For each line: > If doesn't contain `\bxmlns\b`: > For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`: >

Re: [PATCH] nvdimm: fixes to maintainter-entry-profile

2020-05-25 Thread Jonathan Corbet
On Thu, 21 May 2020 09:51:37 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Fix punctuation and wording in a few places. > > Signed-off-by: Randy Dunlap > Cc: Dan Williams > Cc: Vishal Verma > Cc: Dave Jiang > Cc: Ira Weiny > Cc: linux-nvd...@lists.01.o

Re: [PATCH] Documentation/features: Correct RISC-V kprobes support entry

2020-05-25 Thread Jonathan Corbet
On Sat, 23 May 2020 23:00:05 +0200 Björn Töpel wrote: > The Documentation/features/debug/kprobes/arch-support.txt incorrectly > states that RISC-V has kprobes support. This is not the case. > > Note that entries that have been incorrectly marked with 'ok' will not > be changed back to 'TODO' by

Re: [PATCH] Documentation/features: Refresh the arch support status files

2020-05-25 Thread Jonathan Corbet
On Sat, 23 May 2020 21:11:35 +0200 Björn Töpel wrote: > I was manually editing the arch-support.txt for eBPF-JIT, when I > realized the refresh script [1] has not been run for a while. Let's > fix that, so that the entries are more up-to-date. > > [1]

Re: reference to Linux Foundation NDA program obsolete?

2020-05-25 Thread Jonathan Corbet
On Sun, 24 May 2020 07:33:29 +0200 (CEST) Lukas Bulwahn wrote: > The link is dead; internet search only showed some references from > meeting minutes in 2008, but nothing more since then. > > Has this LF NDA program simply been phased out? That's a good question...I'm asking around at the LF,

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

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

2020-05-19 Thread Jonathan Corbet
o 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_signer:21/109=19%,commit_signer:

Re: linux-next: manual merge of the jc_docs tree with the vfs and net-next trees

2020-05-18 Thread Jonathan Corbet
On Mon, 18 May 2020 12:30:13 +1000 Stephen Rothwell wrote: > Today's linux-next merge of the jc_docs tree got a conflict in: > > kernel/sysctl.c > > between commit: > > f461d2dcd511 ("sysctl: avoid forward declarations") > > from the vfs tree and commit: > > 2f4c33063ad7 ("docs:

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

2020-05-17 Thread Jonathan Corbet
On Sat, 16 May 2020 14:27:40 +0200 "Alexander A. Klimov" wrote: > ... for security reasons. > > No breaking changes as either the HTTP vhost redirects to HTTPS > or both vhosts redirect to the same location > or both serve the same content. We're getting closer, but... - There is still too

Re: [PATCH 11/14] docs: move other kAPI documents to core-api

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:55 +0200 Mauro Carvalho Chehab wrote: > There are a number of random documents that seem to be > describing some aspects of the core-api. Move them to such > directory, adding them at the core-api/index.rst file. > > Signed-off-by: Mauro Carvalho Chehab > --- >

Re: [PATCH 10/14] docs: move locking-specific documenta to locking/ directory

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:54 +0200 Mauro Carvalho Chehab wrote: > Several files under Documentation/*.txt describe some type of > locking API. Move them to locking/ subdir and add to the > locking/index.rst index file. > > Signed-off-by: Mauro Carvalho Chehab I've applied this, but it really

Re: [PATCH 09/14] docs: move digsig docs to the security book

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:53 +0200 Mauro Carvalho Chehab wrote: > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/{digsig.txt => security/digsig.rst} | 0 > Documentation/security/index.rst | 1 + > 2 files changed, 1 insertion(+) > rename Documentation/{digsig.txt

Re: [PATCH 08/14] docs: move kobject and kref docs into the core-api book

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:52 +0200 Mauro Carvalho Chehab wrote: > Both documents are documenting Kernel core objects. So, add > them into the core-api book. > > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/core-api/index.rst | 1 + >

Re: [PATCH 07/14] docs: add IRQ documentation at the core-api book

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:51 +0200 Mauro Carvalho Chehab wrote: > There are 4 IRQ documentation files under Documentation/*.txt. > > Move them into a new directory (core-api/irq) and add a new > index file for it. > > While here, use a title markup for the Debugging section of the >

Re: [PATCH 06/14] docs: debugging-via-ohci1394.txt: add it to the core-api book

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:50 +0200 Mauro Carvalho Chehab wrote: > There is an special chapter inside the core-api book about > some debug infrastructure like tracepoints and debug objects. > > It sounded to me that this is the best place to add a chapter > explaining how to use a FireWire

Re: [PATCH 04/14] docs: move IPMI.txt to the driver API book

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:48 +0200 Mauro Carvalho Chehab wrote: > The IPMI is under drivers/char. This doc describes the kAPI > part of the IPMI (mainly). > > So, move it to the driver-api directory and add it to the > corresponding index.rst file. > > Signed-off-by: Mauro Carvalho Chehab

Re: [PATCH 02/14] docs: add bus-virt-phys-mapping.txt to core-api

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:46 +0200 Mauro Carvalho Chehab wrote: > This describes an old interface used prior the new DMA-API > interfaces. Add it to the core-api guide, just after the > DMA stuff. > > Signed-off-by: Mauro Carvalho Chehab > --- > .../bus-virt-phys-mapping.rst}

Re: [PATCH 01/14] docs: move DMA kAPI to Documentation/core-api

2020-05-15 Thread Jonathan Corbet
On Fri, 1 May 2020 17:37:45 +0200 Mauro Carvalho Chehab wrote: > Move those files to the core-api, where they belong, renaming > them to ReST and adding to the core API index file. > > Signed-off-by: Mauro Carvalho Chehab > --- > .../{DMA-API-HOWTO.txt => core-api/dma-api-howto.rst}

Re: [PATCH 2/2] docs: acpi: fix old http link and improve document format

2020-05-15 Thread Jonathan Corbet
On Tue, 5 May 2020 12:17:16 +0200 Flavio Suligoi wrote: > The website: > > http://wiki.minnowboard.org > > doesn't exist anymore. The same pages are moved to: > > https://www.elinux.org/Minnowboard > > Other improvements concern the introduction of some rst > semantic markup in the

Re: [PATCH v2] doc: Fix some errors in ras.rst

2020-05-15 Thread Jonathan Corbet
On Wed, 6 May 2020 09:37:15 -0700 Matthew Wilcox wrote: > On Wed, May 06, 2020 at 12:22:17PM -0400, Waiman Long wrote: > > Make some miscellaneous fixes to the first paragraph of "ECC memory": > > - Change the incorrect "74 bits" to "72 bits". > > - Change "mentioned on" to "mentioned in". > >

Re: [PATCH] Documentation: update numastat explanation

2020-05-15 Thread Jonathan Corbet
On Thu, 7 May 2020 14:02:17 +0200 Vlastimil Babka wrote: > During recent patch discussion [1] it became apparent that the "other_node" > definition in the numastat documentation has always been different from actual > implementation. It was also noted that the stats can be innacurate on systems

Re: [PATCH] docs: debugfs: Update struct debugfs_reg32 definition

2020-05-15 Thread Jonathan Corbet
On Fri, 8 May 2020 23:29:49 +0200 Rikard Falkeborn wrote: > Update the docs to match the implementation, both the definition of > struct debugfs_regset32 and the definition of debugfs_print_regs32(). > > Signed-off-by: Rikard Falkeborn Applied, thanks. jon

Re: [PATCH] doc: zh_CN: add translatation for debugfs.txt

2020-05-15 Thread Jonathan Corbet
On Sat, 9 May 2020 01:05:35 -0700 Wang Wenhu wrote: > From: Chucheng Luo > > Translate Documentation/filesystems/debugfs.txt into Chinese. > > Signed-off-by: Chucheng Luo > Reviewed-by: Alex Shi > Signed-off-by: Wang Wenhu > [rebase for upstream conflict and minor change of subject] >

Re: [PATCH] docs: sysctl/kernel: document unaligned controls

2020-05-15 Thread Jonathan Corbet
On Fri, 15 May 2020 18:04:06 +0200 Stephen Kitt wrote: > diff --git a/Documentation/index.rst b/Documentation/index.rst > index 9599c0f3eea8..17c38d899572 100644 > --- a/Documentation/index.rst > +++ b/Documentation/index.rst > @@ -143,6 +143,7 @@ Architecture-agnostic documentation >

Re: [PATCH] docs: sysctl/kernel: document ngroups_max

2020-05-15 Thread Jonathan Corbet
On Fri, 15 May 2020 18:02:22 +0200 Stephen Kitt wrote: > This is a read-only export of NGROUPS_MAX, so this patch also changes > the declarations in kernel/sysctl.c to const. > > Signed-off-by: Stephen Kitt > --- > Documentation/admin-guide/sysctl/kernel.rst | 9 + > kernel/sysctl.c

Re: [PATCH 2/2] Add a new sysctl knob: unprivileged_userfaultfd_user_mode_only

2020-05-07 Thread Jonathan Corbet
On Wed, 6 May 2020 15:38:16 -0400 Peter Xu wrote: > If this is going to be added... I am thinking whether it should be easier to > add another value for unprivileged_userfaultfd, rather than a new sysctl. > E.g.: > > "0": unprivileged userfaultfd forbidden > "1": unprivileged userfaultfd

Re: [PATCH] doc: thermal: add cpu-idle-cooling to index tree

2020-05-05 Thread Jonathan Corbet
On Wed, 29 Apr 2020 06:11:09 -0700 Wang Wenhu wrote: > Add cpu-idle-cooling.rst to the index list for user reference through > self-compiled htmldocs or online documentation tree of kernel. > > Like: https://www.kernel.org/doc/html/latest/driver-api/thermal/index.html > > Signed-off-by: Wang

Re: [PATCH] doc:locking: remove info about old behavior of locktorture

2020-05-05 Thread Jonathan Corbet
On Sun, 26 Apr 2020 23:14:29 +0200 Federico Vaga wrote: > It is not useful to know what was the default at some point in the > past: remove the information. > > Signed-off-by: Federico Vaga > --- > Documentation/locking/locktorture.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) >

Re: [PATCH v2 1/2] docs: sysctl/kernel: document ftrace entries

2020-05-05 Thread Jonathan Corbet
On Wed, 29 Apr 2020 20:58:01 -0400 Steven Rostedt wrote: > On Wed, 29 Apr 2020 22:57:56 +0200 > Stephen Kitt wrote: > > > Based on the ftrace documentation, the tp_printk boot parameter > > documentation, and the implementation in kernel/trace/trace.c. > > > > Signed-off-by: Stephen Kitt > >

Re: [PATCH] samples: fix binderfs sample

2020-05-05 Thread Jonathan Corbet
On Wed, 29 Apr 2020 10:01:13 +0200 Christian Brauner wrote: > On Tue, Apr 28, 2020 at 11:25:33PM +0200, Arnd Bergmann wrote: > > A routine check for misspelled Kconfig symbols showed on instance > > from last year, the correct symbol name is CONFIG_ANDROID_BINDERFS, > > not

Re: [PATCH] docs: s390: Fix wrong label Guest2 instead of Guest3

2020-05-05 Thread Jonathan Corbet
On Thu, 30 Apr 2020 19:12:38 -0300 Vitor Massaru Iha wrote: > This fixes: > > Documentation/s390/vfio-ap.rst:488: WARNING: duplicate label > s390/vfio-ap:guest2, other instance in > /home/iha/sdb/opensource/lkmp/linux_doc/Documentation/s390/vfio-ap.rst > > Signed-off-by: Vitor Massaru Iha >

Re: [PATCH] docs: coresight: fix `make htmldocs` warning

2020-05-05 Thread Jonathan Corbet
On Thu, 30 Apr 2020 17:36:12 -0300 Vitor Massaru Iha wrote: > Fix `make htmldocs` warning: > > Documentation/trace/coresight/coresight-ect.rst:2: WARNING: Explicit markup > ends without a blank line; unexpected unindent. > > Signed-off-by: Vitor Massaru Iha > --- >

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

2020-05-05 Thread Jonathan Corbet
On Fri, 1 May 2020 00:20:37 +0200 Federico Vaga wrote: > Translation for the following patches: > > commit c4f4af4094d6 ("docs: Add documentation for Symbol Namespaces") > commit 36bc683dde0a ("kernel-doc: rename the kernel-doc directive 'functions' > to 'identifiers'") > commit a035d552a93b

Re: [RESEND] doc: misc-device: add uacce to toctree(index)

2020-05-05 Thread Jonathan Corbet
On Thu, 30 Apr 2020 19:58:28 -0300 Vitor Massaru Iha wrote: > This fixes: > > Documentation/misc-devices/uacce.rst: WARNING: document isn't included in any > toctree > > Signed-off-by: Vitor Massaru Iha > --- > Documentation/misc-devices/index.rst | 1 + > 1 file changed, 1 insertion(+) >

Re: [PATCH v2] docs: kvm: Fix KVM_KVMCLOCK_CTRL API doc

2020-05-05 Thread Jonathan Corbet
On Fri, 1 May 2020 18:36:24 -0400 Joshua Abraham wrote: > The KVM_KVMCLOCK_CTRL ioctl signals to supported KVM guests > that the hypervisor has paused it. Update the documentation to > reflect that the guest is notified by this API. > > Signed-off-by: Joshua Abraham > --- > Changes in v2: >

Re: [PATCH] watchdog: update email address in conversion doc

2020-05-05 Thread Jonathan Corbet
On Sat, 2 May 2020 16:30:58 +0200 Wolfram Sang wrote: > The old one is defunct. However, I think it makes sense that I am still > the primary contact person for updates here. > > Signed-off-by: Wolfram Sang > --- > > ... if there will be any. Let me know if you agree. > >

Re: [PATCH] kobject: documentation: Fix erroneous function example in kobject doc.

2020-05-05 Thread Jonathan Corbet
On Tue, 5 May 2020 14:18:28 +0800 Qi Zheng wrote: > Update the definitions of some functions listed in the kobject > document, since they have been changed. > > Signed-off-by: Qi Zheng I've applied this since it's an improvement on the original. The proper fix, though, is to bring in the

Re: [PATCH] doc: Fix some typo errors in ras.rst

2020-05-05 Thread Jonathan Corbet
On Tue, 5 May 2020 11:10:49 -0400 Waiman Long wrote: > Fix typo errors. > > Signed-off-by: Waiman Long > --- > Documentation/admin-guide/ras.rst | 8 > 1 file changed, 4 insertions(+), 4 deletions(-) > > diff --git a/Documentation/admin-guide/ras.rst >

Re: [PATCH v3 00/29] Convert files to ReST - part 2

2020-05-05 Thread Jonathan Corbet
On Tue, 28 Apr 2020 13:01:28 -0600 Jonathan Corbet wrote: > So I'm happy to merge this set, but there is one thing that worries me a > bit... > > > fs/cachefiles/Kconfig |4 +- > > fs/coda/Kconfig |2 +- >

Re: [PATCH] Documentation: fix `make htmldocs ` warning

2020-04-30 Thread Jonathan Corbet
On Thu, 30 Apr 2020 17:54:47 -0300 Vitor Massaru Iha wrote: > Fix 'make htmldocs' warning: > Documentation/virt/kvm/amd-memory-encryption.rst:76: WARNING: Inline literal > start-string without end-string. > > Signed-off-by: Vitor Massaru Iha > --- >

Re: [PATCH] docs: filesystems: fix `make htmldocs` warning

2020-04-30 Thread Jonathan Corbet
On Thu, 30 Apr 2020 16:57:24 -0300 Vitor Massaru Iha wrote: > Sorry about that. I searched but I didn't find the documentation tree. > Could you point me to the git url? The MAINTAINERS file is always the place to look for such things: > T:git git://git.lwn.net/linux.git docs-next jon

Re: [PATCH] docs: filesystems: fix `make htmldocs` warning

2020-04-30 Thread Jonathan Corbet
On Thu, 30 Apr 2020 16:07:37 -0300 Vitor Massaru Iha wrote: > make htmldocs > Documentation/filesystems/orangefs.rst:124: WARNING: Literal block expected; > none found. > > Signed-off-by: Vitor Massaru Iha > --- > Documentation/filesystems/orangefs.rst | 4 +--- > 1 file changed, 1

Re: [PATCH 00/38] net: manually convert files to ReST format - part 1

2020-04-28 Thread Jonathan Corbet
On Tue, 28 Apr 2020 13:11:43 -0700 (PDT) David Miller wrote: > Jon, do you mind if I merge this via the networking tree? Not at all, that's what I was expecting you would do. Thanks, jon

Re: [PATCH v3 00/29] Convert files to ReST - part 2

2020-04-28 Thread Jonathan Corbet
On Mon, 27 Apr 2020 23:16:52 +0200 Mauro Carvalho Chehab wrote: > This is the second part of a series I wrote sometime ago where I manually > convert lots of files to be properly parsed by Sphinx as ReST files. > > As it touches on lot of stuff, this series is based on today's linux-next, > at

Re: [RFC] Documentation: zh_CN: convert to use i2c_new_client_device()

2020-04-28 Thread Jonathan Corbet
On Sat, 25 Apr 2020 22:26:57 +0800 Alex Shi wrote: > 在 2020/4/25 下午6:06, Wolfram Sang 写道: > > Move away from the deprecated API and advertise the new one. > > > > Signed-off-by: Wolfram Sang > > --- > > > > I can't read Chinese. But given the context, I think just updating to > > the new

Re: [PATCH 0/5] More changes for sphinx-pre-install script

2020-04-28 Thread Jonathan Corbet
On Tue, 21 Apr 2020 16:31:04 +0200 Mauro Carvalho Chehab wrote: > As asked, I changed the sphinx-pre-install script to print a different message > for the PDF minimal recommended version. This change itself was easy, > but, while testing the patch, I noticed some new weird behaviors when python

Re: [PATCH] docs: orangefs: fix pvfs2tab literal block

2020-04-28 Thread Jonathan Corbet
On Fri, 24 Apr 2020 17:35:15 +0200 Stephen Kitt wrote: > Following a merge fix-up, the literal block is introduced too early; > this patch merges the localhost mention with the introduction, fixing > > Documentation/filesystems/orangefs.rst:124: WARNING: Literal block > expected; none

Re: [PATCH] doc: nvdimm: remove reference to non-existent CONFIG_NFIT_TEST

2020-04-28 Thread Jonathan Corbet
On Wed, 15 Apr 2020 23:16:50 +0200 Michal Suchanek wrote: > The test driver is in tools/testing/nvdimm and cannot be selected by a > config option. > > Signed-off-by: Michal Suchanek > --- > Documentation/driver-api/nvdimm/nvdimm.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-)

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