[GIT PULL] Documentation fixes for 5.3

2019-07-26 Thread Jonathan Corbet
fix typo in madvise reference Jonathan Corbet (2): Merge tag 'v5.3-rc1' into docs-next Merge branch 'pdf_fixes_v1' of https://git.linuxtv.org/mchehab/experimental into mauro Marcus Folkesson (1): docs: driver-api: generic-counter: fix file path to ABI doc

Re: [PATCH] MAINTAINERS: add entries for some documentation scripts

2019-07-26 Thread Jonathan Corbet
On Fri, 26 Jul 2019 11:52:34 -0300 Mauro Carvalho Chehab wrote: > There are some documentation scripts I wrote with doesn't > have any maintainer at maintainer's file. > > Add them to the DOCUMENTATION entry, in order to have > Jon and linux-doc ML c/c on those patches, plus a new > entry to ens

Re: [PATCH] docs: admin-guide: Adjust title underline length

2019-07-26 Thread Jonathan Corbet
On Fri, 26 Jul 2019 13:27:54 -0300 Fabio Estevam wrote: > The following warning is seen when building 'make htmldocs': > > Documentation/admin-guide/sysctl/kernel.rst:397: WARNING: Title underline too > short. > > Fix it by adjusting the title underline length appropriately. > > Signed-off-by

Re: [PATCH] Correct documentation for /proc/schedstat

2019-07-26 Thread Jonathan Corbet
On Wed, 24 Jul 2019 11:50:27 -0700 Phil Frost wrote: > Commit 425e0968a25fa3f111f9919964cac079738140b5 ("sched: move code into > kernel/sched_stats.h") appears to have inadvertently changed the unit of > time from jiffies to nanoseconds as part of the implementation of CFS. > > Signed-off-by: Ph

Re: [PATCH] Documentation/features/locking: update lists

2019-07-26 Thread Jonathan Corbet
On Tue, 23 Jul 2019 14:22:03 +0100 Mark Rutland wrote: > The locking feature lists don't match reality as of v5.3-rc1: > > * arm64 moved to queued spinlocks in commit: > > c11090474d70590170cf5fa6afe85864ab494b37 > > ("arm64: locking: Replace ticket lock implementation with qspinlock") >

Re: [PATCH] Documentation: filesystem: fix "Removed Sysctls" table

2019-07-26 Thread Jonathan Corbet
On Tue, 23 Jul 2019 12:48:13 +0100 Sheriff Esseson wrote: > the "Removed Sysctls" section is a table - bring it alive with ReST. > > Signed-off-by: Sheriff Esseson > --- > Documentation/admin-guide/xfs.rst | 5 +++-- > 1 file changed, 3 insertions(+), 2 deletions(-) > > diff --git a/Documenta

Re: [PATCH] Documentation: move Documentation/virtual to Documentation/virt

2019-07-29 Thread Jonathan Corbet
On Sat, 27 Jul 2019 00:10:32 +0200 Paolo Bonzini wrote: > Does the userspace API > cover only syscall or perhaps sysfs interfaces? There are more API > files (amd-memory-encryption.txt, cpuid.txt, halt-polling.txt msr.txt, > ppc-pv.txt, s390-diag.txt) but, with the exception of > amd-memory-enc

Re: [PATCH] docs: arm: Remove orphan sh-mobile directory

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 11:02:11 +0200 Geert Uytterhoeven wrote: > This directory is empty, except for a .gitignore file, listing an > executable file that can no longer be built since commit > c6535e1e0361157e ("Documentation: Remove ZBOOT MMC/SDHI utility and > docs"). > > Signed-off-by: Geert Uyt

Re: [PATCH] mailmap: add entry to connect my email addresses

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 19:45:10 +0800 Chao Yu wrote: > I've used several email accounts to contribute codes, samsung's one > is obsolete, so let me add entry to map them, in order to let people > find me easily when they blame my codes. > > Signed-off-by: Chao Yu Applied, thanks. jon

Re: [PATCH] doc:it_IT: align translation to mainline

2019-07-31 Thread Jonathan Corbet
On Mon, 29 Jul 2019 23:58:56 +0200 Federico Vaga wrote: > The patch translates the following patches in Italian: > > 1fb12b35e5ff kbuild: Raise the minimum required binutils version to 2.21 > 9c3c0c204814 isdn: remove isdn4linux > > Signed-off-by: Federico Vaga Applied, thanks. jon

Re: [PATCH] doc:it_IT: translations for documents in process/

2019-07-31 Thread Jonathan Corbet
On Sun, 28 Jul 2019 11:20:54 +0200 Federico Vaga wrote: > From: Alessia Mantegazza > > Translations for the following documents in process/: > - email-clients > - management-style > > Signed-off-by: Alessia Mantegazza > Signed-off-by: Federico Vaga This looks generally good, but I h

Re: [PATCH 1/5] MAINTAINERS: fix broken ref for ABI sysfs-bus-counter-ftm-quaddec

2019-07-31 Thread Jonathan Corbet
On Fri, 26 Jul 2019 16:29:10 -0300 Mauro Carvalho Chehab wrote: > There's a typo here: > > sysfs-bus-counter-ftm-quadddec -> sysfs-bus-counter-ftm-quaddec > > Signed-off-by: Mauro Carvalho Chehab These are easy...I've applied this set, thanks. jon

Re: [PATCH] docs: riscv: convert boot-image-header.txt to ReST

2019-07-31 Thread Jonathan Corbet
On Fri, 26 Jul 2019 18:01:55 -0300 Mauro Carvalho Chehab wrote: > Convert this small file to ReST format by: >- Using a proper markup for the document title; >- marking a code block as such; >- use tags for Author and date; >- use tables for bit map fields. > > While here, fix a

Re: [PATCH v2 01/26] docs: power: add it to to the main documentation index

2019-07-31 Thread Jonathan Corbet
On Fri, 26 Jul 2019 09:51:11 -0300 Mauro Carvalho Chehab wrote: > The power docs are orphaned at the documentation body. > > While it could likely be moved to be inside some guide, I'm opting to just > adding it to the main index.rst, removing the :orphan: and adding the SPDX > header. > > The

Re: [PATCH] doc: email-clients miscellaneous fixes

2019-07-31 Thread Jonathan Corbet
On Sat, 6 Jul 2019 23:01:00 +0200 Federico Vaga wrote: > Fixed some style inconsistencies and remove old statement referring to > kmail missing feature (saving email from the view window is possible). > > Signed-off-by: Federico Vaga So this one fell through the cracks, it seems, sorry. Appl

Re: [PATCH v3] Documentation: filesystems: Convert jfs.txt to

2019-07-31 Thread Jonathan Corbet
On Wed, 10 Jul 2019 08:29:01 -0700 Shobhit Kukreti wrote: > This converts the plain text documentation of jfs.txt to reStructuredText > format. Added to documentation build process and verified with > make htmldocs > > Signed-off-by: Shobhit Kukreti So this kind of fell through the cracks, so

Re: [PATCH v3] Documentation: filesystems: Convert ufs.txt to reStructuredText format

2019-07-31 Thread Jonathan Corbet
On Wed, 10 Jul 2019 08:31:23 -0700 Shobhit Kukreti wrote: > This converts the plain text documentation of ufs.txt to > reStructuredText format. Added to documentation build process > and verified with make htmldocs > > Signed-off-by: Shobhit Kukreti I've applied this one as well; apologies for

Re: [PATCH] Documentation: coresight: convert txt to rst

2019-07-31 Thread Jonathan Corbet
On Thu, 11 Jul 2019 23:52:01 +0700 Phong Tran wrote: > This changes from plain text to reStructuredText as suggestion > in doc-guide [1] > > [1] https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html > > Some adaptations such as: literal block, ``inline literal`` and > alignment text,...

Re: [PATCH v2 01/26] docs: power: add it to to the main documentation index

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 16:16:06 -0300 Mauro Carvalho Chehab wrote: > The remaining ones in this series aren't there yet. > > From this series, besides this patch, you can also exclude patch > 25/26, as it seems that Paul will merge via RCU tree. > > The remaining ones apply cleanly on the top of d

Re: [PATCH v4] tpm: Document UEFI event log quirks

2019-07-31 Thread Jonathan Corbet
On Fri, 12 Jul 2019 18:44:32 +0300 Jarkko Sakkinen wrote: > There are some weird quirks when it comes to UEFI event log. Provide a > brief introduction to TPM event log mechanism and describe the quirks > and how they can be sorted out. > > Signed-off-by: Jarkko Sakkinen > --- > v4: - Unfortane

Re: [PATCH v2 01/26] docs: power: add it to to the main documentation index

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 16:58:59 -0300 Mauro Carvalho Chehab wrote: > > - [PATCH v2 07/26] docs: w1: convert to ReST and add to the kAPI group of > > docs > > > > Gives me the dreaded "could not build fake ancestor" error, I > > don't really understand why. > > That's new! What Sphinx v

Re: [PATCH 5/6] docs: fs: convert porting to ReST

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 17:08:52 -0300 Mauro Carvalho Chehab wrote: > This file has its own proper style, except that, after a while, > the coding style gets violated and whitespaces are placed on > different ways. > > As Sphinx and ReST are very sentitive to whitespace differences, > I had to opt i

Re: [PATCH 0/6] ReST conversion patches not applied yet

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 17:08:47 -0300 Mauro Carvalho Chehab wrote: > As promised, this is the rebased version of the patches that were not applied > from the /26 patch series because you had merge conflicts. > > They're all based on your docs-next branch, so should apply fine. > > The first one fi

Re: [PATCH 2/6] docs: writing-schema.md: convert from markdown to ReST

2019-07-31 Thread Jonathan Corbet
On Wed, 31 Jul 2019 14:45:00 -0600 Rob Herring wrote: > On Wed, Jul 31, 2019 at 05:08:49PM -0300, Mauro Carvalho Chehab wrote: > > The documentation standard is ReST and not markdown. > > > > Signed-off-by: Mauro Carvalho Chehab > > Acked-by: Rob Herring > > --- > > Documentation/devicetree/w

Re: [PATCH] doc:it_IT: translations for documents in process/

2019-08-01 Thread Jonathan Corbet
On Thu, 1 Aug 2019 11:53:06 +0200 Federico Vaga wrote: > Of course, I checked on the version available on my distribution. I did not > look for translation changes on different version of the same email client > @_@ Hmm...normally we expect you to check all versions back to the 1991 release o

Re: [PATCH] mailmap: add entry for Jaegeuk Kim

2019-08-02 Thread Jonathan Corbet
On Fri, 2 Aug 2019 09:21:35 +0800 Chao Yu wrote: > Add entry to connect all Jaegeuk's email addresses. > > Acked-by: Jaegeuk Kim > Signed-off-by: Chao Yu > --- > .mailmap | 3 +++ > 1 file changed, 3 insertions(+) > > diff --git a/.mailmap b/.mailmap > index 477debe3d960..70d41c86e644 100644

Re: [PATCH] Documentation/checkpatch: Prefer str_has_prefix over strncmp

2019-08-02 Thread Jonathan Corbet
On Fri, 2 Aug 2019 14:25:37 +0800 Chuhong Yuan wrote: > Add strncmp() to Documentation/process/deprecated.rst since > using strncmp() to check whether a string starts with a > prefix is error-prone. > The safe replacement is str_has_prefix(). Is that the *only* use of strncmp()? > Also add che

Re: [PATCH] kernel-doc: ignore __printf attribute

2019-08-06 Thread Jonathan Corbet
On Mon, 5 Aug 2019 09:29:50 -0700 Randy Dunlap wrote: > From: Randy Dunlap > > Ignore __printf() function attributes just as other __attribute__ > strings are ignored. > > Fixes this kernel-doc warning message: > include/kunit/kunit-stream.h:58: warning: Function parameter or member '2' > not

Re: [PATCH] Input: docs: fix spelling mistake "potocol" -> "protocol"

2019-08-06 Thread Jonathan Corbet
On Mon, 5 Aug 2019 11:49:51 +0100 Colin King wrote: > There is a minor spelling mistake in the documentation, fix it. > > Signed-off-by: Colin Ian King > --- > Documentation/input/multi-touch-protocol.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/

Re: [PATCH] docs/zh_CN: update Chinese howto.rst for latexdocs making

2019-08-06 Thread Jonathan Corbet
On Mon, 5 Aug 2019 11:17:58 +0800 Alex Shi wrote: > Mauro Carvalho Chehab foundd a reference > error in Chinese howto.rst. which need update introducations for > latexdocs/epubdocs format doc making. > > So I update this part according to latest howto.rst. This one doesn't apply to docs-next,

Re: [PATCH v3 0/3] Convert some RCU articles to ReST

2019-08-06 Thread Jonathan Corbet
On Tue, 30 Jul 2019 19:10:27 -0400 "Joel Fernandes (Google)" wrote: > This patch is a respin of the RCU ReST patch from Mauro [1]. > > I updated his changelog, and made some fixes. > > [1] https://www.spinics.net/lists/rcu/msg00750.html > > Joel Fernandes (Google) (2): > docs: rcu: Correct lin

Re: [PATCH] Documentation: fs: Convert xfs-delayed-logging-design.txt to ReSt

2019-08-06 Thread Jonathan Corbet
On Tue, 6 Aug 2019 10:03:23 +0100 Sheriff Esseson wrote: > Convert xfs-delayed-logging-design.txt to ReST and fix broken references. > The enumerations at "Lifecycle Changes" breaks because of lines begining with > "<", treat as diagrams. [...] > @@ -27,14 +30,18 @@ written to disk after change

Re: [PATCH] mailmap: add entry for Jaegeuk Kim

2019-08-09 Thread Jonathan Corbet
On Thu, 8 Aug 2019 22:37:41 +0800 Chao Yu wrote: > > IMO, when we use git-blame to find out who is response for specified code, > > w/o > > mailmap we may just found old obsolete email address in the related commit; > > even > > we can search full name for his/her new email address, how can we

Re: [PATCH] Documentation/networking/af_xdp: Inhibit reference to struct socket

2019-08-10 Thread Jonathan Corbet
On Sat, 10 Aug 2019 14:17:37 +0200 Jonathan Neuschäfer wrote: > With the recent change to auto-detect function names, Sphinx parses > socket() as a reference to the in-kernel definition of socket. It then > decides that struct socket is a good match, which was obviously not > intended in this cas

Re: [PATCH v2 1/2] Documentation: sphinx: Add missing comma to list of strings

2019-08-12 Thread Jonathan Corbet
On Mon, 12 Aug 2019 18:07:04 +0200 Jonathan Neuschäfer wrote: > In Python, like in C, when a comma is omitted in a list of strings, the > two strings around the missing comma are concatenated. > > Signed-off-by: Jonathan Neuschäfer > --- > > v2: > - new patch > --- > Documentation/sphinx/auto

Re: [PATCH v1] kernel-doc: Allow anonymous enum

2019-08-12 Thread Jonathan Corbet
On Mon, 12 Aug 2019 19:06:31 +0300 Andy Shevchenko wrote: > In C is a valid construction to have an anonymous enumerator. > > Though we have now: > > drivers/pinctrl/intel/pinctrl-intel.c:240: error: Cannot parse enum! > > Support it in the kernel-doc script. So I don't get this error; I gu

Re: [PATCH] docs: Fix typo on pull requests guide

2019-08-12 Thread Jonathan Corbet
On Fri, 9 Aug 2019 18:29:07 -0500 Marco Villegas wrote: > Signed-off-by: Marco Villegas > --- > Documentation/maintainer/pull-requests.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/maintainer/pull-requests.rst > b/Documentation/maintainer/pull-req

Re: [PATCH v2] Documentation: virt: Fix broken reference to virt tree's index

2019-08-12 Thread Jonathan Corbet
On Fri, 9 Aug 2019 14:23:49 +0100 Sheriff Esseson wrote: > Fix broken reference to virt/index.rst. > > Fixes: 2f5947dfcaec ("Documentation: move Documentation/virtual to > Documentation/virt") > > Signed-off-by: Sheriff Esseson Note that you should keep the "Fixes:" tag on a single line, and

Re: [PATCH v2] docs/zh_CN: update Chinese howto.rst for latexdocs making

2019-08-12 Thread Jonathan Corbet
On Fri, 9 Aug 2019 20:04:47 +0800 Alex Shi wrote: > Mauro Carvalho Chehab found a reference > error in Chinese howto.rst. and further more there more infos of > latexdocs/epubdocs format doc making in English howto.rst. > > So I update this part according to latest howto.rst and settled > the

Re: [PATCH 1/2] Documentation/arm/sa1100: Remove some obsolete documentation

2019-08-12 Thread Jonathan Corbet
On Thu, 8 Aug 2019 18:58:55 +0200 Jonathan Neuschäfer wrote: > The support for the following boards, among others, was removed in 2004 > with commit "[ARM] Remove broken SA1100 machine support.": > > - ADS Bitsy > - Brutus > - Freebird > - ADS GraphicsClient Plus > - ADS GraphicsMaster > - Höft

Re: [PATCH 2/2] Documentation/arm/sa1100/assabet: Fix 'make assabet_defconfig' command

2019-08-12 Thread Jonathan Corbet
On Thu, 8 Aug 2019 18:58:56 +0200 Jonathan Neuschäfer wrote: > "make assabet_config" doesn't work. > > Signed-off-by: Jonathan Neuschäfer > --- > Documentation/arm/sa1100/assabet.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/arm/sa1100/assabet.rst

Re: [PATCH] Documentation/arm/samsung-s3c24xx: Remove stray U+FEFF character to fix title

2019-08-12 Thread Jonathan Corbet
On Thu, 8 Aug 2019 18:48:09 +0200 Jonathan Neuschäfer wrote: > It seems a UTF-8 byte order mark (the least useful kind of BOM...) snuck > into the file and broke Sphinx's detection of the title line. > > Besides making arm/samsung-s3c24xx/index.html look a little better, this > patch also confi

Re: [PATCH] docs: process: fix broken link

2019-08-24 Thread Jonathan Corbet
On Fri, 16 Aug 2019 13:22:09 +0100 Jacob Huisman wrote: > http://linux.yyz.us/patch-format.html seems to be down since > approximately September 2018. There is a working archive copy on > arhive.org. Replaced the links in documenation + translations. > > Signed-off-by: Jacob Huisman > --- > Do

Re: [PATCH v2] Ext4 documentation fixes.

2019-08-24 Thread Jonathan Corbet
On Thu, 15 Aug 2019 09:16:23 -0700 Andreas Dilger wrote: > On Aug 15, 2019, at 09:11, Ayush Ranjan wrote: > > > > This commit aims to fix the following issues in ext4 documentation: > > - Flexible block group docs said that the aim was to group block > > metadata together instead of block gro

Re: [PATCH v2] Ext4 documentation fixes.

2019-08-25 Thread Jonathan Corbet
On Sat, 24 Aug 2019 19:09:30 -0400 "Theodore Y. Ts'o" wrote: > If you haven't pushed out your doc tree, can you please drop it? I've > already applied an (improved) version of this patch to the ext4 tree, > and I actually have some plans to do further fixups of ext4 on-disk > format documentatio

Re: [PATCH] Documentation: add link to stm32mp157 docs

2019-08-27 Thread Jonathan Corbet
On Tue, 27 Aug 2019 12:19:32 + Gerald BAEZA wrote: > Link to the online stm32mp157 documentation added > in the overview. > > Signed-off-by: Gerald Baeza > --- > Documentation/arm/stm32/stm32mp157-overview.rst | 6 ++ > 1 file changed, 6 insertions(+) > > diff --git a/Documentation/ar

Re: [PATCH] Documentation: add link to stm32mp157 docs

2019-08-29 Thread Jonathan Corbet
On Tue, 27 Aug 2019 17:23:30 +0200 Alexandre Torgue wrote: > >> +Datasheet and reference manual are publicly available on ST website: > >> +.. _STM32MP157: > >> https://www.st.com/en/microcontrollers-microprocessors/stm32mp157.html > >> + > > > > Adding the URL is a fine idea. But you don't

Re: [PATCH] doc:lock: remove reference to clever use of read-write lock

2019-08-31 Thread Jonathan Corbet
On Sat, 31 Aug 2019 15:41:16 +0200 Federico Vaga wrote: > several CPU's and you want to use spinlocks you can potentially use > -cheaper versions of the spinlocks. IFF you know that the spinlocks are > +cheaper versions of the spinlocks. If you know that the spinlocks are > never used in interr

Re: [PATCH v2] docs: ftrace: clarify when tracing is disabled by the trace file

2019-09-02 Thread Jonathan Corbet
On Sat, 31 Aug 2019 11:58:35 -0400 Steven Rostedt wrote: > Acked-by: Steven Rostedt (VMware) > > Jon care to take this in your tree? Will do. jon

Re: [PATCH] doc:lock: remove reference to clever use of read-write lock

2019-09-02 Thread Jonathan Corbet
On Mon, 02 Sep 2019 21:19:24 +0200 Federico Vaga wrote: > > > I am not used to the mathematical English jargon. It make sense, but then > > > I > > > would replace it with "If and only if": for clarity. > > > > While it's used in a number of places and it's pretty common wording > > overall in

Re: [PATCH] docs: license-rules.txt: cover SPDX headers on Python scripts

2019-09-05 Thread Jonathan Corbet
On Thu, 5 Sep 2019 06:23:13 -0300 Mauro Carvalho Chehab wrote: > Python's PEP-263 [1] dictates that an script that needs to default to > UTF-8 encoding has to follow this rule: > > 'Python will default to ASCII as standard encoding if no other >encoding hints are given. > >

Re: [PATCH] docs: license-rules.txt: cover SPDX headers on Python scripts

2019-09-05 Thread Jonathan Corbet
On Thu, 5 Sep 2019 16:28:10 -0300 Mauro Carvalho Chehab wrote: > I don't think we can count that python 3 uses utf-8 per default. > > I strongly suspect that, if one uses a Python3 version < 3.7, it will > still default to ASCII. > > On a quick look, the new UTF-8 mode was added on PEP-540: >

Re: [PATCH] Documentation: sysrq: don't recommend 'S' 'U' before 'B'

2019-09-06 Thread Jonathan Corbet
On Tue, 3 Sep 2019 18:08:40 +0200 Adam Borowski wrote: > This advice is obsolete and slightly harmful for filesystems from this > millenium: any modern filesystem can handle unexpected crashes without > requiring fsck -- and on the other hand, trying to write to the disk when > the kernel is in

Re: [PATCH] doc: arm64: fix grammar dtb placed in no attributes region

2019-09-06 Thread Jonathan Corbet
On Tue, 3 Sep 2019 11:07:27 +0800 lixianfa wrote: > Fix grammar dtb placed in no attributes region. > This makes Chinese translation smooth to read. > > Signed-off-by: lixinafa Applied, thanks. jon

Re: [PATCH] docs: mtd: Update spi nor reference driver

2019-09-06 Thread Jonathan Corbet
On Wed, 7 Aug 2019 00:06:23 +0800 John Garry wrote: > The reference driver no longer exists since commit 50f1242c6742 ("mtd: > fsl-quadspi: Remove the driver as it was replaced by spi-fsl-qspi.c"). > > Update reference to spi-fsl-qspi.c driver. > > Signed-off-by: John Garry So this appears to

Re: [PATCH] Documentation/process/embargoed-hardware-issues: Microsoft ambassador

2019-09-06 Thread Jonathan Corbet
On Fri, 6 Sep 2019 05:58:52 -0400 Sasha Levin wrote: > Add Sasha Levin as Microsoft's process ambassador. > > Signed-off-by: Sasha Levin > Signed-off-by: Sasha Levin > --- > Documentation/process/embargoed-hardware-issues.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff

Re: [PATCH] docs: mtd: Update spi nor reference driver

2019-09-06 Thread Jonathan Corbet
On Fri, 6 Sep 2019 15:58:41 +0100 John Garry wrote: > I don't think that it was appropriate to apply this patch in the end - > maybe this could have been communicated better. If you check the > subsequent discussion in this thread, it seems that completely new > documentation is required: > >

Re: [PATCH 0/6] Address issues with SPDX requirements and PEP-263

2019-09-07 Thread Jonathan Corbet
On Thu, 5 Sep 2019 16:57:47 -0300 Mauro Carvalho Chehab wrote: > The description at Documentation/process/license-rules.rst is very strict > with regards to the position where the SPDX tags should be. > > In the past several developers and maintainers interpreted it on a > more permissive way,

Re: [PATCH] devices.txt: improve entry for comedi (char major 98)

2019-09-14 Thread Jonathan Corbet
On Wed, 11 Sep 2019 17:39:41 +0100 Ian Abbott wrote: > Describe how the comedi minor device numbers are split across comedi > devices and comedi subdevices. > > Replace the current, long dead URL with an official URL for the Comedi > project. > > Signed-off-by: Ian Abbott Applied, thanks. jo

Re: [PATCH v3] doc:lock: remove reference to clever use of read-write lock

2019-09-14 Thread Jonathan Corbet
On Thu, 12 Sep 2019 14:32:27 +0100 Will Deacon wrote: > > So there is no reason to teach cleaver things that people should not do. > > cleaver => clever I dunno...personally I'm also opposed to teaching people tricks with cleavers too, at least in the kernel-development context. Our flame wa

Re: [PATCH] Documentation: Add "earlycon=sbi" to the admin guide

2019-09-14 Thread Jonathan Corbet
On Fri, 13 Sep 2019 13:38:43 -0700 Palmer Dabbelt wrote: > This argument is supported on RISC-V systems and widely used, but was > not documented here. > > Signed-off-by: Palmer Dabbelt Applied, thanks. jon

Re: [PATCH] docs: printk-formats: Stop encouraging use of unnecessary %h[xudi] and %hh[xudi]

2019-09-14 Thread Jonathan Corbet
On Fri, 06 Sep 2019 14:11:51 -0700 Joe Perches wrote: > Standard integer promotion is already done and %hx and %hhx is useless > so do not encourage the use of %hh[xudi] or %h[xudi]. > > As Linus said in: > Link: > https://lore.kernel.org/lkml/CAHk-=wgoxnmsj8GEVFJSvTwdnWm8wVJthefNk2n6+4TC=20...

Re: [PATCH v2] Documentation: kbuild: Add document about reproducible builds

2019-09-15 Thread Jonathan Corbet
On Sun, 15 Sep 2019 12:24:49 +0900 Masahiro Yamada wrote: > On Sat, Sep 14, 2019 at 8:24 PM Ben Hutchings wrote: > > > > In the Distribution Kernels track at Linux Plumbers Conference there > > was some discussion around the difficulty of making kernel builds > > reproducible. > > > > This is a

Re: [PATCH] docs: hwmon: Suppress Sphinx warning

2019-09-15 Thread Jonathan Corbet
On Sun, 15 Sep 2019 18:27:18 +1000 Adam Zerella wrote: > When generating documentation output Sphinx > outputs a warning for not including > the page 'inspur-ipsps1.rst' in 'index.rst'. > Assuming this documentation is useful it > should be included in the index > > Signed-off-by: Adam Zerella

[GIT PULL] Documentation for 5.4

2019-09-15 Thread Jonathan Corbet
The following changes since commit d2eba640a4b96bc1bdc0f4a500b8b8d5e16725c8: docs: phy: Drop duplicate 'be made' (2019-07-26 08:15:26 -0600) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-5.4 for you to fetch changes up to fe013f8bc160d79c6e33bb66d9bb0cd249492

Re: [PATCH v2] docs: Use make invocation's -j argument for parallelism

2019-09-22 Thread Jonathan Corbet
On Thu, 19 Sep 2019 14:44:37 -0700 Kees Cook wrote: > While sphinx 1.7 and later supports "-jauto" for parallelism, this > effectively ignores the "-j" flag used in the "make" invocation, which > may cause confusion for build systems. Instead, extract the available What sort of confusion might w

Re: [PATCH] docs: use flexible array members, not zero-length

2019-09-28 Thread Jonathan Corbet
On Fri, 27 Sep 2019 16:29:27 +0200 Stephen Kitt wrote: > Update the docs throughout to remove zero-length arrays, replacing > them with C99 flexible array members. GCC will then ensure that the > arrays are always the last element in the struct. I appreciate the thought but... > diff --git a/Do

Re: [PATCH] docs: use flexible array members, not zero-length

2019-09-30 Thread Jonathan Corbet
On Sat, 28 Sep 2019 10:55:57 +0200 Stephen Kitt wrote: > Wouldn’t it be better to update the docs simultaneously in each patch which > fixes a structure? Or is that unworkable with current development practices? Definitely update the two together. The doc fix should just go through the appropri

Re: Why no section for "Kernel/Linux Documentation" here : https://patchwork.kernel.org/

2019-09-30 Thread Jonathan Corbet
On Mon, 30 Sep 2019 21:28:26 +0530 Bhaskar Chowdhury wrote: > Why that page missing a section "Kernel Documentation" ?? OR am I > missing the title therenot sure...there must be some reason. Many kernel subsystems do not use patchwork; documentation has always been one of them. Perhaps th

Re: [PATCH v3] docs: Use make invocation's -j argument for parallelism

2019-10-01 Thread Jonathan Corbet
On Tue, 24 Sep 2019 16:29:58 -0700 Kees Cook wrote: > While sphinx 1.7 and later supports "-jauto" for parallelism, this > effectively ignores the "-j" flag used in the "make" invocation, which > may cause confusion for build systems. Instead, extract the available > parallelism from "make"'s job

Re: [PATCH 1/2] docs: security: fix section hyperlink

2019-10-01 Thread Jonathan Corbet
On Wed, 25 Sep 2019 17:17:44 +0700 bhenryj0...@gmail.com wrote: > From: Brendan Jackman > > The reStructuredText syntax is wrong here; not sure how it was > intended but we can just use the section header as an implicit > hyperlink target, with a single "outward" underscore. > > Signed-off-by:

Re: [PATCH 2/2] docs: security: update base LSM documentation file

2019-10-01 Thread Jonathan Corbet
On Wed, 25 Sep 2019 13:06:28 -0700 Kees Cook wrote: > > +always appears first in the stack of LSM hooks. A > > +:c:func:`security_add_hooks()` function (in ``security/security.c``) > > IIUC, the :c:func:`...()` marking isn't needed any more, just having a > word followed by "()" should trigger

Re: [PATCH] docs: kmemleak: DEBUG_KMEMLEAK_EARLY_LOG_SIZE changed names

2019-10-01 Thread Jonathan Corbet
On Wed, 25 Sep 2019 15:32:10 +0100 Catalin Marinas wrote: > On Wed, Sep 25, 2019 at 02:31:14PM +, Jeremy Cline wrote: > > Commit c5665868183f ("mm: kmemleak: use the memory pool for early > > allocations") renamed CONFIG_DEBUG_KMEMLEAK_EARLY_LOG_SIZE to > > CONFIG_DEBUG_KMEMLEAK_MEM_POOL_SIZE

Re: [PATCH] docs: fix memory.low description in cgroup-v2.rst

2019-10-01 Thread Jonathan Corbet
On Wed, 25 Sep 2019 12:56:04 -0700 Jon Haslam wrote: > The current cgroup-v2.rst file contains an incorrect description of when > memory is reclaimed from a cgroup that is using the 'memory.low' > mechanism. This fix simply corrects the text to reflect the actual > implementation. > > Fixes: 785

Re: [PATCH 2/2] kernel-doc: add support for ____cacheline_aligned_in_smp attribute

2019-10-01 Thread Jonathan Corbet
On Tue, 17 Sep 2019 16:41:46 -0300 André Almeida wrote: > -if ($x =~ > /(struct|union)\s+(\w+)\s*\{(.*)\}(\s*(__packed|__aligned|__attribute__\s*\(\([a-z0-9,_\s\(\)]*\)\)))*/) > { > +if ($x =~ > /(struct|union)\s+(\w+)\s*\{(.*)\}(\s*(__packed|__aligned|cacheline_aligned_in_smp|__at

Re: [PATCH v2] docs: perf: Add imx-ddr to documentation index

2019-10-01 Thread Jonathan Corbet
On Sun, 15 Sep 2019 18:20:10 +1000 Adam Zerella wrote: > Sphinx is currently outputting a warning where > the file 'imx-ddr.rst' is not included in the > documentation index. Additionally, the code > highlighting and doc formatting can be slightly > improved. > > Signed-off-by: Adam Zerella > -

Re: [PATCH] Documentation: document earlycon without options for more platforms

2019-10-01 Thread Jonathan Corbet
On Mon, 16 Sep 2019 09:03:16 +0200 Christoph Hellwig wrote: > The earlycon options without arguments is supposed on all device > tree platforms, not just arm64. > > Signed-off-by: Christoph Hellwig > --- > Documentation/admin-guide/kernel-parameters.txt | 10 -- > 1 file changed, 4 ins

Re: [PATCH] riscv-docs: correct the sequence of the magic number 2 since it's little endian

2019-10-01 Thread Jonathan Corbet
On Mon, 16 Sep 2019 13:01:40 + Chester Lin wrote: > Correct the sequence of the magic number 2 since it's little endian. > > Signed-off-by: Chester Lin > --- > Documentation/riscv/boot-image-header.txt | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) So I'm slowly digging my way th

Re: [PATCH 0/2] docs: Programmatically render MAINTAINERS into ReST

2019-10-01 Thread Jonathan Corbet
On Tue, 24 Sep 2019 16:02:06 -0700 Kees Cook wrote: > Commit log from Patch 2 repeated here for cover letter: > > In order to have the MAINTAINERS file visible in the rendered ReST > output, this makes some small changes to the existing MAINTAINERS file > to allow for better machine processing,

Re: [PATCH 0/2] docs: Programmatically render MAINTAINERS into ReST

2019-10-01 Thread Jonathan Corbet
On Tue, 1 Oct 2019 09:16:41 -0700 Kees Cook wrote: > > > This almost certainly has to do with the fact that I'm (intentionally) > > > running the Python2 Sphinx build here. Something's not doing unicode that > > > should be. > > Given this would be for v5.5, and python2 is EOL in 2 months[1],

Re: [PATCH 0/2] docs: Programmatically render MAINTAINERS into ReST

2019-10-01 Thread Jonathan Corbet
roblem is that we're feeding UTF8 into Sphinx as an ordinary str, then sphinx is trying to decode it as ASCII. The attached hack makes things work. Kees, I can either just keep this fix (breaking bisectability of the docs build :) or you can send a new version - up to you. Thanks,

Re: [PATCH 0/2] docs: Programmatically render MAINTAINERS into ReST

2019-10-01 Thread Jonathan Corbet
On Tue, 1 Oct 2019 09:27:29 -0700 Kees Cook wrote: > On Tue, Oct 01, 2019 at 08:31:47AM -0600, Jonathan Corbet wrote: > > On a separate note...it occurred to me, rather belatedly as usual, that > > last time we discussed doing this that there was some opposition to addi

[PATCH] docs/driver-api: Catch up with dma_buf file-name changes

2019-10-01 Thread Jonathan Corbet
_resv') Signed-off-by: Jonathan Corbet --- [I'll carry this in docs-next unless somebody objects.] Documentation/driver-api/dma-buf.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/driver-api/dma-buf.rst b/Documentation/driver-api/dm

Re: [PATCH v2 0/2] docs: Programmatically render MAINTAINERS into ReST

2019-10-02 Thread Jonathan Corbet
On Tue, 1 Oct 2019 11:25:30 -0700 Kees Cook wrote: > v1: https://lore.kernel.org/lkml/20190924230208.12414-1-keesc...@chromium.org > > v2: fix python2 utf-8 issue thanks to Jonathan Corbet > > > Commit log from Patch 2 repeated here for cover letter: > > In order

Re: [PATCH] Documentation: networking: device drivers: Remove stray asterisks

2019-10-03 Thread Jonathan Corbet
On Wed, 02 Oct 2019 17:25:26 -0700 (PDT) David Miller wrote: > Jon, how do you want to handle changes like this? In whatever way works best. Documentation should make our lives easier, not get in the way :) > I mean, there are unlikely to be conflicts from something like this so it > could sim

Re: [PATCH] docs: it_IT: maintainer-pgp-guide: Fix reference to "Nitrokey Pro 2"

2019-10-03 Thread Jonathan Corbet
On Wed, 2 Oct 2019 17:18:39 +0200 Jonathan Neuschäfer wrote: > This fixes the following Sphinx warning: > > Documentation/translations/it_IT/process/maintainer-pgp-guide.rst:458: > WARNING: Unknown target name: "nitrokey pro". > > Signed-off-by: Jonathan Neuschäfer Applied, thanks. jon

Re: [PATCH] Documentation: update about adding syscalls

2019-10-03 Thread Jonathan Corbet
[Expanding CC a bit; this is the sort of change I'm reluctant to take without being sure it reflects what the community thinks.] On Wed, 2 Oct 2019 17:14:37 +0200 Christian Brauner wrote: > Add additional information on how to ensure that syscalls with structure > arguments are extensible and a

Re: [PATCH] riscv-docs: correct the sequence of the magic number 2 since it's little endian

2019-10-03 Thread Jonathan Corbet
On Tue, 1 Oct 2019 11:35:11 -0700 (PDT) Paul Walmsley wrote: > This was simply due to idiocy on my part, due to a very last-minute patch > submission, where I missed that the original documented magic number was > already in little-endian format. The updated number from Chester is > correct.

Re: [PATCH v2 2/2] scripts/sphinx-pre-install: Add a new path for the debian package "fonts-noto-cjk"

2019-10-03 Thread Jonathan Corbet
On Wed, 2 Oct 2019 10:45:04 -0300 Mauro Carvalho Chehab wrote: > Em Wed, 2 Oct 2019 15:35:42 +0200 > Jeremy MAURO escreveu: > > > The latest debian version "bullseye/sid" has changed the path of the file > > "notoserifcjk-regular.ttc", with the previous change and this change we > > keep the b

Re: [PATCH] Documentation: networking: device drivers: Remove stray asterisks

2019-10-03 Thread Jonathan Corbet
On Wed, 2 Oct 2019 17:09:55 +0200 Jonathan Neuschäfer wrote: > These asterisks were once references to a line that said: > "* Other names and brands may be claimed as the property of others." > But now, they serve no purpose; they can only irritate the reader. > > Fixes: de3edab4276c ("e1000:

[PATCH] genalloc: Fix a set of docs build warnings

2019-10-03 Thread Jonathan Corbet
leting the update of one kerneldoc comment. Fixes: 795ee30648c7 ("lib/genalloc: introduce chunk owners") Signed-off-by: Jonathan Corbet --- Documentation/core-api/genalloc.rst | 8 lib/genalloc.c | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/D

[PATCH 1/2] docs: move botching-up-ioctls.rst to the process guide

2019-10-03 Thread Jonathan Corbet
This is overall information for kernel developers, and not part of the user-space API. Cc: Daniel Vetter Signed-off-by: Jonathan Corbet --- Documentation/ioctl/index.rst | 1 - Documentation/{ioctl => process}/botching-up-ioctls.rst | 0 Documentation/proc

[PATCH 2/2] docs: Move the user-space ioctl() docs to userspace-api

2019-10-03 Thread Jonathan Corbet
This is strictly user-space material at this point, so put it with the other user-space API documentation. Signed-off-by: Jonathan Corbet --- Documentation/index.rst| 1 - Documentation/userspace-api/index.rst | 1 + Documentation

[PATCH 0/2] docs: move the ioctl() documentation out of the top level

2019-10-03 Thread Jonathan Corbet
he rest to the userspace-api book along with the rest of the user-space documentation. Jonathan Corbet (2): docs: move botching-up-ioctls.rst to the process guide docs: Move the user-space ioctl() docs to userspace-api Documentation/index.rst| 1 - Doc

[PATCH 2/2] docs: Add request_irq() documentation

2019-10-04 Thread Jonathan Corbet
While checking the results of the :c:func: removal, I noticed that there was no documentation for request_irq(), and request_threaded_irq() was not mentioned at all. Add a kerneldoc comment for request_irq() and add request_threaded_irq() to the list of functions. Signed-off-by: Jonathan Corbet

[PATCH 0/2] Improvements to the genericirq documentation

2019-10-04 Thread Jonathan Corbet
tree, whichever is preferable. Jonathan Corbet (2): docs: remove :c:func: from genericirq.rst docs: Add request_irq() documentation Documentation/core-api/genericirq.rst | 52 ++- include/linux/interrupt.h | 13 +++ 2 files changed, 40 insertions(+), 25 dele

[PATCH 1/2] docs: remove :c:func: from genericirq.rst

2019-10-04 Thread Jonathan Corbet
As of 5.3, the automarkup extension will do the right thing with function() notation, so we don't need to clutter the text with :c:func: invocations. So remove them. Signed-off-by: Jonathan Corbet --- Documentation/core-api/genericirq.rst | 50 +-- 1 file change

[PATCH] docs: remove :c:func: from refcount-vs-atomic.rst

2019-10-04 Thread Jonathan Corbet
te problem. Signed-off-by: Jonathan Corbet --- I'll feed this through docs-next unless somebody tells me otherwise... Documentation/core-api/refcount-vs-atomic.rst | 36 +-- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/Documentation/core-api/refcount-v

Re: [PATCH] Documentation: kbuild: Add document about namespaces

2019-10-07 Thread Jonathan Corbet
On Mon, 7 Oct 2019 04:26:24 + wrote: > > Sphinx outputs the following build warning: > > > > Documentation/kbuild/namespaces.rst: > > WARNING: document isn't included in any toctree > > > Oh, I did not notice this file was added to the kbuild directory. > > I do not understand why it is

Re: [PATCH] doc: move namespaces.rst out of kbuild directory

2019-10-07 Thread Jonathan Corbet
On Mon, 7 Oct 2019 10:12:42 +0200 Jessica Yu wrote: > This was my line of thought as well, since the audience of > admin-guide/ is sysadmins and users. Namespaces are mostly relevant to > module authors and kernel developers. Currently, I don't think there > is an existing good place in Documenta

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