Re: [PATCH 1/2] mm, memcontrol: Add memcg_iterate_all()

2019-06-28 Thread Michal Hocko
On Thu 27-06-19 17:03:06, Waiman Long wrote: > On 6/27/19 11:07 AM, Michal Hocko wrote: > > On Mon 24-06-19 13:42:18, Waiman Long wrote: > >> Add a memcg_iterate_all() function for iterating all the available > >> memory cgroups and call the given callback function for each of the > >> memory cgruo

Re: [PATCH 2/2] mm, slab: Extend vm/drop_caches to shrink kmem slabs

2019-06-28 Thread Michal Hocko
On Thu 27-06-19 17:16:04, Waiman Long wrote: > On 6/27/19 11:15 AM, Michal Hocko wrote: > > On Mon 24-06-19 13:42:19, Waiman Long wrote: > >> With the slub memory allocator, the numbers of active slab objects > >> reported in /proc/slabinfo are not real because they include objects > >> that are he

Re: [linux-kernel-mentees] [PATCH v2] Doc : doc-guide : Fix a typo

2019-06-28 Thread Sheriff Esseson
On Fri, Jun 28, 2019 at 07:33:42AM +0100, Sheriff Esseson wrote: > fix the disjunction by replacing "of" with "or". > > Signed-off-by: Sheriff Esseson > --- > > changes in v2: > - cc-ed Corbet. > > Documentation/doc-guide/kernel-doc.rst | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) >

Re: [PATCH 2/2] drivers/perf: Add CCPI2 PMU support in ThunderX2 UNCORE driver.

2019-06-28 Thread Will Deacon
Hi again, Ganapat, Thanks for the quick reply. On Fri, Jun 28, 2019 at 11:09:33AM +0530, Ganapatrao Kulkarni wrote: > On Thu, Jun 27, 2019 at 3:27 PM Will Deacon wrote: > > On Fri, Jun 14, 2019 at 05:42:46PM +, Ganapatrao Kulkarni wrote: > > > CCPI2 is a low-latency high-bandwidth serial int

[PATCH 3/9] docs: signal: fix a kernel-doc markup

2019-06-28 Thread Mauro Carvalho Chehab
The kernel-doc parser doesn't handle expressions with %foo*. Instead, when an asterisk should be part of a constant, it uses an alternative notation: `foo*`. Signed-off-by: Mauro Carvalho Chehab --- kernel/signal.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/kernel/signal

[PATCH 6/9] docs: virtual: there are two orphan docs there

2019-06-28 Thread Mauro Carvalho Chehab
Signed-off-by: Mauro Carvalho Chehab --- Documentation/virtual/kvm/amd-memory-encryption.rst | 2 ++ Documentation/virtual/kvm/vcpu-requests.rst | 2 ++ 2 files changed, 4 insertions(+) diff --git a/Documentation/virtual/kvm/amd-memory-encryption.rst b/Documentation/virtual/kvm/amd-memo

[PATCH 5/9] docs: fix some broken references due to txt->rst renames

2019-06-28 Thread Mauro Carvalho Chehab
There are three left-overs from the recent file renames, probably due to some other conflicting patch. Fix them. Signed-off-by: Mauro Carvalho Chehab Acked-by: Wolfram Sang Acked-by: Daniel Vetter --- Documentation/devicetree/bindings/arm/idle-states.txt | 2 +- drivers/gpu/drm/i915/intel_run

[PATCH 0/9] Some doc fixes

2019-06-28 Thread Mauro Carvalho Chehab
This patch series is against linux-next (next-20190627). I doubt those would apply cleanly against docs next tree. So, please apply it via the subsystem trees. Otherwise, they could be pushed by the end of the merge window or for -rc1 via a docs tree. Most, if not all were I already sent. Mauro

[PATCH 4/9] dt: leds-lm36274.txt: fix a broken reference to ti-lmu.txt

2019-06-28 Thread Mauro Carvalho Chehab
There's a typo there: ti_lmu.txt -> ti-lmu.txt Signed-off-by: Mauro Carvalho Chehab Acked-by: Pavel Machek Acked-by: Dan Murphy --- Documentation/devicetree/bindings/leds/leds-lm36274.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindi

[PATCH 1/9] hrtimer: Use a bullet for the returns bullet list

2019-06-28 Thread Mauro Carvalho Chehab
That gets rid of this warning: ./kernel/time/hrtimer.c:1119: WARNING: Block quote ends without a blank line; unexpected unindent. and displays nicely both at the source code and at the produced documentation. Signed-off-by: Mauro Carvalho Chehab --- kernel/time/hrtimer.c | 7 ---

[PATCH 2/9] docs: trace: fix a broken label

2019-06-28 Thread Mauro Carvalho Chehab
Sphinx warnings about his: Documentation/trace/kprobetrace.rst:68: WARNING: undefined label: user_mem_access (if the link has no caption the label must precede a section header) The problem is quite simple: Sphinx wants a blank line after references. Signed-off-by: Mauro Carvalho Cheha

[PATCH 8/9] drm: fix a reference for a renamed file: fb/modedb.rst

2019-06-28 Thread Mauro Carvalho Chehab
Due to two patches being applied about the same time, the reference for modedb.rst file got wrong: Documentation/fb/modedb.txt is now Documentation/fb/modedb.rst. Fixes: 1bf4e09227c3 ("drm/modes: Allow to specify rotation and reflection on the commandline") Fixes: ab42b818954c ("docs: fb

[PATCH 9/9] platform: x86: get rid of a non-existent document

2019-06-28 Thread Mauro Carvalho Chehab
Changeset 163ede97a9a2 ("Documentation: platform: Delete x86-laptop-drivers.txt") removed the x86-laptop-drivers.txt file, but forgot to update its Kconfig. Fixes: 163ede97a9a2 ("Documentation: platform: Delete x86-laptop-drivers.txt") Signed-off-by: Mauro Carvalho Chehab --- drivers/platform/x

[PATCH 08/43] docs: lp855x-driver.txt: convert to ReST and move to kernel-api

2019-06-28 Thread Mauro Carvalho Chehab
This small file seems to be an attempt to start documenting backlight drivers. It contains descriptions of the controls for the driver with could sound as an somewhat user-faced description, but it's main focus is to describe, instead, the data that should be passed via platform data and some driv

[PATCH 20/43] docs: rbtree.txt: fix Sphinx build warnings

2019-06-28 Thread Mauro Carvalho Chehab
Ths file is already at ReST format. Yet, some recent changes made it to produce a few warnings when building it with Sphinx. Those are trivially fixed by marking some literal blocks. Fix them before adding it to the docs building system. Signed-off-by: Mauro Carvalho Chehab --- Documentation/r

[PATCH 41/43] docs: extcon: convert it to ReST and move to acpi dir

2019-06-28 Thread Mauro Carvalho Chehab
The intel-int3496.txt file is a documentation for an ACPI driver. There's no reason to keep it on a separate directory. So, instead of keeping it on some random location, move it to a sub-directory inside the ACPI documentation dir, renaming it to .rst. Signed-off-by: Mauro Carvalho Chehab ---

[PATCH 11/43] docs: console.txt: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
Convert this small file to ReST in preparation for adding it to the driver-api book. While this is not part of the driver-api book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab Acked-by: Greg Kroah-Hartman --- .../console/{console.txt => console.r

[PATCH 25/43] docs: laptops: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the laptops documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mau

[PATCH 10/43] docs: cma/debugfs.txt: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
The debugfs interface for CMA should be there together with other mm-related documents. Convert this small file to ReST and move it to its rightful place. The conversion is actually quite simple: just add a title for the document. In order to make it to look better for the audience, also mark the

[PATCH 42/43] docs: move gcc_plugins.txt to core-api and rename to .rst

2019-06-28 Thread Mauro Carvalho Chehab
The gcc_plugins.txt file is already a ReST file. Move it to the core-api book while renaming it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/{gcc-plugins.txt => core-api/gcc-plugins.rst} | 0 Documentation/core-api/index.rst| 2 +- MAINTAINERS

[PATCH 35/43] docs: thermal: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the thermal documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mau

[PATCH 31/43] docs: xtensa: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the xtensa documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Maur

[PATCH 27/43] docs: nfc: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the nfc documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro C

[PATCH 36/43] docs: rapidio: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the rapidio documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mau

[PATCH 18/43] docs: nvmem: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
In order to be able to add it into a doc book, we need first convert it to ReST. The conversion is actually: - add blank lines and identation in order to identify paragraphs; - mark literal blocks; - adjust title markups. While this is not part of any book, mark it as :orphan:, in order to

[PATCH 21/43] docs: DMA-API-HOWTO.txt: fix an unmarked code block

2019-06-28 Thread Mauro Carvalho Chehab
When building with Sphinx, it would produce this warning: docs/Documentation/DMA-API-HOWTO.rst:222: WARNING: Definition list ends without a blank line; unexpected unindent. Signed-off-by: Mauro Carvalho Chehab --- Documentation/DMA-API-HOWTO.txt | 2 +- 1 file changed, 1 insertion(+), 1 de

[PATCH 37/43] docs: blockdev: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the blockdev documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. The drbd sub-directory contains some graphs and data flows. Add those too to the documentation. At its new index.rst, let's add a :orphan: while th

[PATCH 40/43] docs: block: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the block documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro

[PATCH 05/43] docs: powerpc: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
Convert docs to ReST and add them to the arch-specific book. The conversion here was trivial, as almost every file there was already using an elegant format close to ReST standard. The changes were mostly to mark literal blocks and add a few missing section title identifiers. One note with regar

[PATCH 04/43] docs: locking: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
Convert the locking documents to ReST and add them to the kernel development book where it belongs. Most of the stuff here is just to make Sphinx to properly parse the text file, as they're already in good shape, not requiring massive changes in order to be parsed. The conversion is actually: -

[PATCH 23/43] docs: ia64: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the ia64 documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. There are two upper case file names. Rename them to lower case, as we're working to avoid upper case file names at Documentation. At its new index.rst,

[PATCH 38/43] docs: perf: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the perf documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro

[PATCH 29/43] docs: mtd: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the mtd documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. It should be noticed that Sphinx doesn't handle very well URLs with dots in the middle. Thankfully, internally, the '.' char is translated to %2E, so we

[PATCH 24/43] docs: leds: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the leds documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro

[PATCH 30/43] docs: nvdimm: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the nvdimm documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Maur

[PATCH 33/43] docs: ioctl-number.txt: convert it to ReST format

2019-06-28 Thread Mauro Carvalho Chehab
The conversion itself is simple: add a markup for the title of this file and add markups for both tables. Yet, the big table here with IOCTL numbers is badly formatted: on several lines, the "Include File" column has some values that are bigger than the reserved space there. Also, on several plac

[PATCH 03/43] docs: hid: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the HID documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. While here, fix the sysfs example from hid-sensor.txt, that has a lot of "?" instead of the proper UTF-8 characters that are produced by the tree command

[PATCH 39/43] docs: sysctl: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the /proc/sys/ documentation files to ReST, using the README file as a template for an index.rst, adding the other files there via TOC markup. Despite being written on different times with different styles, try to make them somewhat coherent with a similar look and feel, ensuring that they'

[PATCH 12/43] docs: pti_intel_mid.txt: convert it to pti_intel_mid.rst

2019-06-28 Thread Mauro Carvalho Chehab
Convert this small file to ReST format and rename it. Most of the conversion were related to adjusting whitespaces in order for each section to be properly parsed. While this is not part of any book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab ---

[PATCH 17/43] docs: bus-devices: ti-gpmc.rst: convert it to ReST

2019-06-28 Thread Mauro Carvalho Chehab
In order to be able to add this file to a book, it needs first to be converted to ReST and renamed. While this is not part of any book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab --- .../bus-devices/{ti-gpmc.txt => ti-gpmc.rst} | 159 +++

[PATCH 32/43] docs: mmc: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the mmc documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro C

[PATCH 09/43] docs: m68k: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
Convert the m68k kernel-options.txt file to ReST. The conversion is trivial, as the document is already on a format close enough to ReST. Just some small adjustments were needed in order to make it both good for being parsed while keeping it on a good txt shape. At its new index.rst, let's add a

[PATCH 06/43] docs: connector: convert to ReST and rename to connector.rst

2019-06-28 Thread Mauro Carvalho Chehab
As it has some function definitions, move them to connector.h. The remaining conversion is actually: - add blank lines and identation in order to identify paragraphs; - fix tables markups; - add some lists markups; - mark literal blocks; - adjust title markups. At its new index.rst, let

[PATCH 01/43] docs: infiniband: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
The InfiniBand docs are plain text with no markups. So, all we needed to do were to add the title markups and some markup sequences in order to properly parse tables, lists and literal blocks. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order

[PATCH 22/43] docs: accounting: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the accounting documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by:

[PATCH 19/43] docs: phy: convert samsung-usb2.txt to ReST format

2019-06-28 Thread Mauro Carvalho Chehab
In order to merge it into a Sphinx book, we need first to convert to ReST. While this is not part of any book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab --- .../{samsung-usb2.txt => samsung-usb2.rst}| 62 ++- MAINTAINERS

[PATCH 43/43] docs: logo.txt: rename it to COPYING-logo

2019-06-28 Thread Mauro Carvalho Chehab
This file has nothing to do with the Kernel documentation. It contains the copyright permissions for Tux at Documentation/logo.gif. So, rename it accordingly. Signed-off-by: Mauro Carvalho Chehab --- Documentation/{logo.txt => COPYING-logo} | 0 1 file changed, 0 insertions(+), 0 deletions(-)

[PATCH 13/43] docs: early-userspace: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
The two files there describes a Kernel API feature, used to support early userspace stuff. Prepare for moving them to the kernel API book by converting to ReST format. The conversion itself was quite trivial: just add/mark a few titles as such, add a literal block markup, add a table markup and a

[PATCH 16/43] docs: xen-tpmfront.txt: convert it to .rst

2019-06-28 Thread Mauro Carvalho Chehab
In order to be able to add this file to the security book, we need first to convert it to reST. While this is not part of any book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab --- .../{xen-tpmfront.txt => xen-tpmfront.rst}| 103 ++-

[PATCH 00/43] Convert doc files to ReST

2019-06-28 Thread Mauro Carvalho Chehab
This patchset contains the patches that weren't merged yet from part 2 and 3 of the previous ReST conversion patchset. This is based aganst linux-next (next-20190627), so they may not apply cleanly at docs-next. It does contain file renames, but, except for a few exceptions, the files are kept wh

[PATCH 34/43] docs: ioctl: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the iio documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. The cdrom.txt and hdio.txt have their own particular syntax. In order to speedup the conversion, I used a small ancillary perl script: my $d;

[PATCH 28/43] docs: md: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the md documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro Ca

[PATCH 02/43] docs: iio: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the iio documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. At its new index.rst, let's add a :orphan: while this is not linked to the main index.rst file, in order to avoid build warnings. Signed-off-by: Mauro C

[PATCH 07/43] docs: lcd-panel-cgram.txt: convert docs to ReST and rename to *.rst

2019-06-28 Thread Mauro Carvalho Chehab
This small text file describes the usage of parallel port LCD displays from userspace PoV. So, a good candidate for the admin guide. While this is not part of the admin-guide book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab --- .../{lcd-panel-cgr

[PATCH 26/43] docs: namespaces: convert to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Rename the namespaces documentation files to ReST, add an index for them and adjust in order to produce a nice html output via the Sphinx build system. There are two upper case file names. Rename them to lower case, as we're working to avoid upper case file names at Documentation. At its new inde

[PATCH 15/43] docs: memory-devices: convert ti-emif.txt to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Prepare this file to be moved to a kernel book by converting it to ReST format and renaming it to ti-emif.rst. While this is not part of any book, mark it as :orphan:, in order to avoid build warnings. Signed-off-by: Mauro Carvalho Chehab --- .../{ti-emif.txt => ti-emif.rst} | 27 +

[PATCH 36/39] docs: add SPDX tags to new index files

2019-06-28 Thread Mauro Carvalho Chehab
All those new files I added are under GPL v2.0 license. Add the corresponding SPDX headers to them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/blockdev/drbd/figures.rst | 2 ++ Documentation/admin-guide/blockdev/index.rst| 2 ++ Documentation/admin-guide/laptops/

[PATCH 22/39] docs: ocxl.rst: add it to the uAPI book

2019-06-28 Thread Mauro Carvalho Chehab
The content of this file is user-faced. Signed-off-by: Mauro Carvalho Chehab --- Documentation/{ => userspace-api}/accelerators/ocxl.rst | 2 -- Documentation/userspace-api/index.rst | 1 + MAINTAINERS | 2 +- 3 files changed, 2 inser

[PATCH 30/39] docs: driver-api: add xilinx driver API documentation

2019-06-28 Thread Mauro Carvalho Chehab
The current file there (emmi) provides a description of the driver uAPI and kAPI. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + Documentation/{ => driver-api}/xilinx/eemi.rst | 0 Documentation/{ => driver-api}/xilinx/index.rst | 1 - 3 files ch

[PATCH 15/39] docs: early-userspace: move to driver-api guide

2019-06-28 Thread Mauro Carvalho Chehab
Those documents describe a kAPI. So, add to the driver-api book. Signed-off-by: Mauro Carvalho Chehab --- .../{ => driver-api}/early-userspace/buffer-format.rst| 0 .../early-userspace/early_userspace_support.rst | 0 Documentation/{ => driver-api}/early-userspace/index.rst

[PATCH 34/39] docs: add a memory-devices subdir to driver-api

2019-06-28 Thread Mauro Carvalho Chehab
There are two docs describing memory device drivers. Add both to this new chapter of the driver-api. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + .../driver-api/memory-devices/index.rst | 16 .../{ => driver-api}/mem

[PATCH 24/39] docs: driver-model: move it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
The audience for the Kernel driver-model is clearly Kernel hackers. Signed-off-by: Mauro Carvalho Chehab --- Documentation/{ => driver-api}/driver-model/binding.rst | 0 Documentation/{ => driver-api}/driver-model/bus.rst | 0 Documentation/{ => driver-api}/driver-model/class.rst

[PATCH 18/39] docs: admin-guide: add kdump documentation into it

2019-06-28 Thread Mauro Carvalho Chehab
The Kdump documentation describes procedures with admins use in order to solve issues on their systems. Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/bug-hunting.rst| 4 ++-- Documentation/admin-guide/index.rst | 1 + Documentation/{ => admin-gui

[PATCH 37/39] docs: adds some directories to the main documentation index

2019-06-28 Thread Mauro Carvalho Chehab
The contents of those directories were orphaned at the documentation body. While those directories could likely be moved to be inside some guide, I'm opting to just adding their indexes to the main one, removing the :orphan: and adding the SPDX header. For the drivers, the rationale is that the d

[PATCH 39/39] docs: gpio: add sysfs interface to the admin-guide

2019-06-28 Thread Mauro Carvalho Chehab
While this is stated as obsoleted, the sysfs interface described there is still valid, and belongs to the admin-guide. Signed-off-by: Mauro Carvalho Chehab --- Documentation/ABI/obsolete/sysfs-gpio | 2 +- Documentation/{ => admin-guide}/gpio/index.rst| 2 +- Documentation/{ => a

[PATCH 28/39] docs: admin-guide: add a series of orphaned documents

2019-06-28 Thread Mauro Carvalho Chehab
There are lots of documents that belong to the admin-guide but are on random places (most under Documentation root dir). Move them to the admin guide. Signed-off-by: Mauro Carvalho Chehab --- Documentation/ABI/stable/sysfs-devices-node | 2 +- Documentation/ABI/testing/procfs-diskstats

[PATCH 01/39] docs: thermal: add it to the driver API

2019-06-28 Thread Mauro Carvalho Chehab
The file contents mostly describes driver internals. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + .../{ => driver-api}/thermal/cpu-cooling-api.rst | 0 .../{ => driver-api}/thermal/exynos_thermal.rst | 0 .../thermal/exynos_ther

[PATCH 26/39] docs: aoe: add it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
Those files belong to the admin guide, so add them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/{ => admin-guide}/aoe/aoe.rst | 4 ++-- Documentation/{ => admin-guide}/aoe/autoload.sh | 0 Documentation/{ => admin-guide}/aoe/examples.rst| 0 Documentation/{ => admin-gu

[PATCH 17/39] docs: admin-guide: add laptops documentation

2019-06-28 Thread Mauro Carvalho Chehab
The docs under Documentation/laptops contain users specific information. Signed-off-by: Mauro Carvalho Chehab --- Documentation/ABI/testing/sysfs-block-device | 2 +- Documentation/ABI/testing/sysfs-platform-asus-laptop | 2 +- Documentation/admin-guide/index.rst

[PATCH 13/39] docs: add arch doc directories to the index

2019-06-28 Thread Mauro Carvalho Chehab
Now that several arch documents were converted to ReST, add their indexes to Documentation/index.rst and remove the :orphan: from them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/arm/index.rst | 2 -- Documentation/arm64/index.rst | 2 -- Documentation/ia64/index.rst| 2

[PATCH 20/39] docs: security: move some books to it and update

2019-06-28 Thread Mauro Carvalho Chehab
The following files belong to security: Documentation/security/LSM.rst -> Documentation/security/lsm-development.rst Documentation/lsm.txt -> Documentation/security/lsm.rst Documentation/SAK.txt -> Documentation/security/sak.rst Documentation/siphash.txt -> Documentation/security/siphash.r

[PATCH 31/39] docs: driver-api: add remaining converted dirs to it

2019-06-28 Thread Mauro Carvalho Chehab
There are a number of driver-specific descriptions that contain a mix of userspace and kernelspace documentation. Just like we did with other similar subsystems, add them at the driver-api groupset, but don't move the directories. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api

[PATCH 33/39] docs: phy: place documentation under driver-api

2019-06-28 Thread Mauro Carvalho Chehab
This subsystem-specific documentation belongs to the driver-api. Signed-off-by: Mauro Carvalho Chehab --- .../devicetree/bindings/phy/phy-bindings.txt | 2 +- .../devicetree/bindings/phy/phy-pxa-usb.txt | 2 +- Documentation/driver-api/index.rst | 1 + Documentation/dri

[PATCH 19/39] docs: blockdev: add it to the admin-guide

2019-06-28 Thread Mauro Carvalho Chehab
The blockdev book basically contains user-faced documentation. Signed-off-by: Mauro Carvalho Chehab --- .../blockdev/drbd/DRBD-8.3-data-packets.svg| 0 .../blockdev/drbd/DRBD-data-packets.svg| 0 .../blockdev/drbd/conn-states-8.dot| 0 .../blockdev/drbd/data-structure-

[PATCH 38/39] docs: locking: add it to the main index

2019-06-28 Thread Mauro Carvalho Chehab
The locking directory is part of the Kernel API bookset. Add it to the index file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/index.rst | 1 + Documentation/locking/index.rst | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/index.rst b/Docum

[PATCH 14/39] docs: device-mapper: move it to the admin-guide

2019-06-28 Thread Mauro Carvalho Chehab
The DM support describes lots of aspects related to mapped disk partitions from the userspace PoV. Signed-off-by: Mauro Carvalho Chehab --- .../{ => admin-guide}/device-mapper/cache-policies.rst | 0 Documentation/{ => admin-guide}/device-mapper/cache.rst | 0 Documentation/{ =>

[PATCH 21/39] docs: x86: move two x86-specific files to x86 arch dir

2019-06-28 Thread Mauro Carvalho Chehab
Those two docs belong to the x86 architecture: Documentation/Intel-IOMMU.txt -> Documentation/x86/intel-iommu.rst Documentation/intel_txt.txt -> Documentation/x86/intel_txt.rst Signed-off-by: Mauro Carvalho Chehab --- Documentation/x86/index.rst| 2 ++ Document

[PATCH 27/39] docs: cgroup-v1: add it to the admin-guide book

2019-06-28 Thread Mauro Carvalho Chehab
Those files belong to the admin guide, so add them. Signed-off-by: Mauro Carvalho Chehab --- .../{ => admin-guide}/cgroup-v1/blkio-controller.rst | 0 Documentation/{ => admin-guide}/cgroup-v1/cgroups.rst | 4 ++-- Documentation/{ => admin-guide}/cgroup-v1/cpuacct.rst |

[PATCH 35/39] docs: infiniband: add it to the driver-api bookset

2019-06-28 Thread Mauro Carvalho Chehab
While this contains some uAPI stuff, it was intended to be read by a kernel doc. So, let's not move it to a different dir, but, instead, just add it to the driver-api bookset. Signed-off-by: Mauro Carvalho Chehab --- Documentation/index.rst| 1 + Documentation/infiniband/index.rst |

[PATCH 32/39] docs: serial: move it to the driver-api

2019-06-28 Thread Mauro Carvalho Chehab
The contents of this directory is mostly driver-api stuff. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + Documentation/{ => driver-api}/serial/cyclades_z.rst | 0 Documentation/{ => driver-api}/serial/driver.rst | 2 +- Docum

[PATCH 16/39] docs: admin-guide: move sysctl directory to it

2019-06-28 Thread Mauro Carvalho Chehab
The stuff under sysctl describes /sys interface from userspace point of view. So, add it to the admin-guide and remove the :orphan: from its index file. Signed-off-by: Mauro Carvalho Chehab --- CREDITS | 2 +- Documentation/admin-guide/index.rst

[PATCH 23/39] docs: lp855x-driver.rst: add it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
The content of this file is intended for backlight Kernel developers. Signed-off-by: Mauro Carvalho Chehab --- Documentation/{ => driver-api}/backlight/lp855x-driver.rst | 2 -- Documentation/driver-api/index.rst | 1 + MAINTAINERS

[PATCH 09/39] docs: md: move it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
The docs there were meant to be read by a Kernel developer. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst| 1 + Documentation/{ => driver-api}/md/index.rst | 2 -- Documentation/{ => driver-api}/md/md-cluster.rst | 0 Documentation/{ => driver

[PATCH 02/39] docs: rapidio: add it to the driver API

2019-06-28 Thread Mauro Carvalho Chehab
This is actually a subsystem description, with contains both kAPI and uAPI. While it should ideally be slplit, let's place it at driver-api, as most things are related to kAPI and driver-specific info. Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/index.rst

[PATCH 12/39] docs: interconnect.rst: add it to the driver-api guide

2019-06-28 Thread Mauro Carvalho Chehab
This is intented for Kernel hackers audience. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + Documentation/{interconnect => driver-api}/interconnect.rst | 2 -- MAINTAINERS | 2 +- 3 file

[PATCH 11/39] docs: ioctl: add it to the uAPI guide

2019-06-28 Thread Mauro Carvalho Chehab
While 100% of its contents is userspace, let's keep the dir at the same place, as this is a well-known location. Signed-off-by: Mauro Carvalho Chehab --- Documentation/index.rst | 1 + Documentation/ioctl/index.rst| 2 +- Documentation/ioctl/ioctl-number.rst | 2 -- 3 files

[PATCH 10/39] docs: leds: add it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
The contents of leds driver docs is messy: it has lots of admin-guide stuff and kernel internal ones, just like other driver subsystems. I'm opting to keep the dir at the same place and just add a link to it. This makes clearer that this require changes. Signed-off-by: Mauro Carvalho Chehab ---

[PATCH 08/39] docs: mmc: move it to the driver-api

2019-06-28 Thread Mauro Carvalho Chehab
Most of the stuff here is related to the kAPI. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + Documentation/{ => driver-api}/mmc/index.rst | 2 -- Documentation/{ => driver-api}/mmc/mmc-async-req.rst | 0 Documentation/{ => driver-api

[PATCH 05/39] docs: namespace: move it to the admin-guide

2019-06-28 Thread Mauro Carvalho Chehab
As stated at the documentation, this is meant to be for users to better understand namespaces. Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/index.rst | 1 + .../{ => admin-guide}/namespaces/compatibility-list.rst | 0 Documentation/{ => a

[PATCH 00/39] Don't let ReST documents orphaned

2019-06-28 Thread Mauro Carvalho Chehab
The goal on this series is to not let ReST documents orphaned. It moves files that are already on ReST format to a better place, when needed, and add them to the documentation body. On my past attempt, I was too "aggressive" trying to move all files under Documentation/*.txt to some place. It end

[PATCH 25/39] docs: add some documentation dirs to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
Those are subsystem docs, with a mix of kABI and user-faced docs. While they're not split, keep the dirs where they are, adding just a pointer to the main index. Signed-off-by: Mauro Carvalho Chehab --- Documentation/accounting/index.rst | 2 +- Documentation/block/index.rst | 2 +- Documen

[PATCH 06/39] docs: mtd: move it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
While I was tempted to move it to admin-guide, as some docs there are more userspace-faced, there are some very technical discussions about memory error correction code from the Kernel implementer's PoV. So, let's place it inside the driver-api book. Signed-off-by: Mauro Carvalho Chehab --- Docu

[PATCH 03/39] docs: perf: move to the admin-guide

2019-06-28 Thread Mauro Carvalho Chehab
The perf infrastructure is used for userspace to track issues. At least a good part of what's described here is related to it. So, add it to the admin-guide. Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/index.rst| 1 + Documentation/{ => admin-guide}/pe

[PATCH 07/39] docs: nfc: add it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
Most of the descriptions here are oriented to a Kernel developer. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + Documentation/{ => driver-api}/nfc/index.rst | 2 -- Documentation/{ => driver-api}/nfc/nfc-hci.rst | 0 Documentation/{ => dri

[PATCH 04/39] docs: nvdimm: add it to the driver-api book

2019-06-28 Thread Mauro Carvalho Chehab
The descriptions here are from Kernel driver's PoV. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst | 1 + Documentation/{ => driver-api}/nvdimm/btt.rst | 0 Documentation/{ => driver-api}/nvdimm/index.rst| 2 -- Documentation/{ => driver-api}

Re: [PATCH 1/9] hrtimer: Use a bullet for the returns bullet list

2019-06-28 Thread Joe Perches
On Fri, 2019-06-28 at 09:12 -0300, Mauro Carvalho Chehab wrote: > That gets rid of this warning: > > ./kernel/time/hrtimer.c:1119: WARNING: Block quote ends without a blank > line; unexpected unindent. > > and displays nicely both at the source code and at the produced > documentation. >

Re: [PATCH 1/9] hrtimer: Use a bullet for the returns bullet list

2019-06-28 Thread Mauro Carvalho Chehab
Em Fri, 28 Jun 2019 05:39:25 -0700 Joe Perches escreveu: > On Fri, 2019-06-28 at 09:12 -0300, Mauro Carvalho Chehab wrote: > > That gets rid of this warning: > > > > ./kernel/time/hrtimer.c:1119: WARNING: Block quote ends without a blank > > line; unexpected unindent. > > > > and displays

Re: [tip:timers/core] hrtimer: Use a bullet for the returns bullet list

2019-06-28 Thread Mauro Carvalho Chehab
Em Thu, 27 Jun 2019 19:40:24 -0700 Joe Perches escreveu: > On Thu, 2019-06-27 at 21:39 -0300, Mauro Carvalho Chehab wrote: > > Em Thu, 27 Jun 2019 15:08:59 -0700 > > Joe Perches escreveu: > [] > > > > hrtimer: Use a bullet for the returns bullet list > > > > > > > > That gets rid of this warn

[PATCH v2] Documentation:sh:convert register-banks.txt and new-machine.txt to rst format.

2019-06-28 Thread Vandana BN
This patch converts new-machine.txt and register-banks.txt to ReST format, No content change. Added new-machine.rst and register-banks.rst to sh/index.rst Signed-off-by: Vandana BN --- Documentation/sh/index.rst| 6 + .../sh/{new-machine.txt => new-machine.rst} | 171 +++

Re: [PATCH v2] Documentation:sh:convert register-banks.txt and new-machine.txt to rst format.

2019-06-28 Thread Mauro Carvalho Chehab
Em Fri, 28 Jun 2019 18:54:59 +0530 Vandana BN escreveu: > This patch converts new-machine.txt and register-banks.txt to ReST format, No > content > change. > Added new-machine.rst and register-banks.rst to sh/index.rst > > Signed-off-by: Vandana BN > --- > Documentation/sh/index.rst

  1   2   >