Re: [RFC PATCH 2/2] software node: Add documentation

2019-10-03 Thread Randy Dunlap
Hi, Below are a few doc edits for you. On 10/2/19 5:33 AM, Heikki Krogerus wrote: > API documentation for the software nodes. > > Signed-off-by: Heikki Krogerus > --- > Documentation/driver-api/software_node.rst | 197 + > 1 file changed, 197 insertions(+) > create mode 10

Re: [PATCH v2 1/2] idr: Document calling context for IDA APIs mustn't use locks

2019-10-03 Thread Stephen Boyd
Quoting Stephen Boyd (2019-07-30 14:20:47) > The documentation for these functions indicates that callers don't need > to hold a lock while calling them, but that documentation is only in one > place under "IDA Usage". Let's state the same information on each IDA > function so that it's clear what

Re: [PATCH] docs: networking: phy: Improve phrasing

2019-10-03 Thread David Miller
From: Jonathan Neuschäfer Date: Thu, 3 Oct 2019 22:43:22 +0200 > It's not about times (multiple occurences of an event) but about the > duration of a time interval. > > Signed-off-by: Jonathan Neuschäfer Looks fine to me: Acked-by: David S. Miller

[PATCH] docs: networking: phy: Improve phrasing

2019-10-03 Thread Jonathan Neuschäfer
It's not about times (multiple occurences of an event) but about the duration of a time interval. Signed-off-by: Jonathan Neuschäfer --- Documentation/networking/phy.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/networking/phy.rst b/Documentation/networkin

Re: [PATCH] docs: networking: devlink-trap: Fix reference to other document

2019-10-03 Thread David Miller
From: Jonathan Neuschäfer Date: Thu, 3 Oct 2019 21:05:36 +0200 > This fixes the following Sphinx warning: > > Documentation/networking/devlink-trap.rst:175: WARNING: unknown document: > /devlink-trap-netdevsim > > Fixes: 9e0874570488 ("Documentation: Add description of netdevsim traps") > Sig

[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/process/index.rst

[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/{ => use

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

2019-10-03 Thread Jonathan Corbet
We have a handful of ioctl() documentation that doesn't really merit a top-level directory, especially when there are more suitable places for it. So: - Move botching-up-ioctls.rst to the process guide; it's aimed at kernel developers so should be where they will look. - Move the rest to th

[PATCH] docs: networking: devlink-trap: Fix reference to other document

2019-10-03 Thread Jonathan Neuschäfer
This fixes the following Sphinx warning: Documentation/networking/devlink-trap.rst:175: WARNING: unknown document: /devlink-trap-netdevsim Fixes: 9e0874570488 ("Documentation: Add description of netdevsim traps") Signed-off-by: Jonathan Neuschäfer --- Documentation/networking/devlink-trap.rst

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

2019-10-03 Thread Jonathan Corbet
Commit 795ee30648c7 ("lib/genalloc: introduce chunk owners") made a number of changes to the genalloc API and implementation but did not update the documentation to match, leading to these docs build warnings: ./lib/genalloc.c:1: warning: 'gen_pool_add_virt' not found ./lib/genalloc.c:1: warni

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

2019-10-03 Thread Jonathan Neuschäfer
On Thu, Oct 03, 2019 at 10:47:37AM -0600, Jonathan Corbet wrote: > 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

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:

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] 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] Documentation: update about adding syscalls

2019-10-03 Thread Aleksa Sarai
On 2019-10-03, Jonathan Corbet wrote: > [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 sys

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

[PATCH 2/4] docs/arm64: elf_hwcaps: sort the HWCAP{,2} documentation by ascending value

2019-10-03 Thread Julien Grall
Part of the hardware capabilities documented in elf_hwcap.rst are ordered following the definition in the header arch/arm64/include/uapi/asm/hwcap.h but others seems to be documented in random order. To make easier to match against the definition in the header, they are now sorted in the same orde

[PATCH 3/4] docs/arm64: elf_hwcaps: Document HWCAP_SB

2019-10-03 Thread Julien Grall
All the hardware capabilities but HWCAP_SB is not documented in elf_hwcaps.rst. So document it. Signed-off-by: Julien Grall --- Documentation/arm64/elf_hwcaps.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/arm64/elf_hwcaps.rst b/Documentation/arm64/elf_hwcaps.rst index

[PATCH 0/4] arm64/cpufeature: Fix + doc update

2019-10-03 Thread Julien Grall
Hi all, This patch fix an issue related to exposing the FRINT capability to userspace (see patch #1). The rest is documentation update. Cheers, Julien Grall (4): arm64: cpufeature: Effectively expose FRINT capability to userspace docs/arm64: elf_hwcaps: sort the HWCAP{,2} documentation by as

[PATCH 1/4] kbuild: two minor updates for Documentation/kbuild/modules.rst

2019-10-03 Thread Masahiro Yamada
Capitalize the first word in the sentence. Use obj-m instead of obj-y. obj-y still works, but we have no built-in objects in external module builds. So, obj-m is better IMHO. Signed-off-by: Masahiro Yamada --- Documentation/kbuild/modules.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deleti

[PATCH 3/4] kbuild: do not read $(KBUILD_EXTMOD)/Module.symvers

2019-10-03 Thread Masahiro Yamada
Since commit 040fcc819a2e ("kbuild: improved modversioning support for external modules"), the external module build reads Module.symvers in the directory of the module itself, then dumps symbols back into it. It accumulates stale symbols in the file when you build an external module incrementally.

RE: [PATCH v3 0/5] stm32-ddr-pmu driver creation

2019-10-03 Thread Gerald BAEZA
Dear all Gentle reminder for this review. Thanks in advance ! Gérald > From: Gerald BAEZA > > The DDRPERFM is the DDR Performance Monitor embedded in STM32MP1 > SOC. > > This series adds support for the DDRPERFM via a new stm32-ddr-pmu driver, > registered into the perf framework. > > This

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

2019-10-03 Thread Gerald BAEZA
Hi Jonathan > From: Alexandre TORGUE > Hi Jonathan, > > On 8/27/19 3:48 PM, Jonathan Corbet wrote: > > 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 > >> --- > >> Do

[PATCH v7 3/5] mfd: ioc3: Add driver for SGI IOC3 chip

2019-10-03 Thread Thomas Bogendoerfer
SGI IOC3 chip has integrated ethernet, keyboard and mouse interface. It also supports connecting a SuperIO chip for serial and parallel interfaces. IOC3 is used inside various SGI systemboards and add-on cards with different equipped external interfaces. Support for ethernet and serial interfaces

[PATCH v7 0/5] Use MFD framework for SGI IOC3 drivers

2019-10-03 Thread Thomas Bogendoerfer
SGI IOC3 ASIC includes support for ethernet, PS2 keyboard/mouse, NIC (number in a can), GPIO and a byte bus. By attaching a SuperIO chip to it, it also supports serial lines and a parallel port. The chip is used on a variety of SGI systems with different configurations. This patchset moves code ou

[PATCH v7 1/5] nvmem: core: add nvmem_device_find

2019-10-03 Thread Thomas Bogendoerfer
nvmem_device_find provides a way to search for nvmem devices with the help of a match function simlair to bus_find_device. Reviewed-by: Srinivas Kandagatla Acked-by: Srinivas Kandagatla Signed-off-by: Thomas Bogendoerfer --- Documentation/driver-api/nvmem.rst | 2 ++ drivers/nvmem/core.c

[PATCH v7 2/5] MIPS: PCI: use information from 1-wire PROM for IOC3 detection

2019-10-03 Thread Thomas Bogendoerfer
IOC3 chips in SGI system are conntected to a bridge ASIC, which has a 1-wire prom attached with part number information. This changeset uses this information to create PCI subsystem information, which the MFD driver uses for further platform device setup. Signed-off-by: Thomas Bogendoerfer --- a

[PATCH v7 5/5] MIPS: SGI-IP27: Enable ethernet phy on second Origin 200 module

2019-10-03 Thread Thomas Bogendoerfer
PROM only enables ethernet PHY on first Origin 200 module, so we must do it ourselves for the second module. Signed-off-by: Thomas Bogendoerfer --- arch/mips/pci/pci-ip27.c | 22 ++ 1 file changed, 22 insertions(+) diff --git a/arch/mips/pci/pci-ip27.c b/arch/mips/pci/pci-ip

[PATCH v7 4/5] MIPS: SGI-IP27: fix readb/writeb addressing

2019-10-03 Thread Thomas Bogendoerfer
Our chosen byte swapping, which is what firmware already uses, is to do readl/writel by normal lw/sw intructions (data invariance). This also means we need to mangle addresses for u8 and u16 accesses. The mangling for 16bit has been done aready, but 8bit one was missing. Correcting this causes diff

Re: [PATCH] Documentation: gpio: driver: Format code blocks properly

2019-10-03 Thread Bartosz Golaszewski
śr., 2 paź 2019 o 16:41 Jonathan Neuschäfer napisał(a): > > This fixes a lot of Sphinx warnings, and makes the code blocks look nice > in HTML. > > Signed-off-by: Jonathan Neuschäfer > --- > Documentation/driver-api/gpio/driver.rst | 4 > 1 file changed, 4 insertions(+) > > diff --git a/Doc

Re: [PATCH 1/3] docs: fix some broken references

2019-10-03 Thread Bartosz Golaszewski
wt., 24 wrz 2019 o 15:01 Mauro Carvalho Chehab napisał(a): > > There are a number of documentation files that got moved or > renamed. update their references. > > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/devicetree/bindings/cpu/cpu-topology.txt| 2 +- > Documentation/device