Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Matthew Wilcox
On Sat, Jun 29, 2019 at 02:25:08AM +0100, Sheriff Esseson wrote: > On Fri, Jun 28, 2019 at 10:43:24PM +0100, Sheriff Esseson wrote: > > Convert xfs.txt to ReST, markup and rename accordingly. Update > > Documentation/index.rst. Don't quote the entire previous patch when submitting a new on

Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Sheriff Esseson
On Fri, Jun 28, 2019 at 10:43:24PM +0100, Sheriff Esseson wrote: > Convert xfs.txt to ReST, markup and rename accordingly. Update > Documentation/index.rst. > > While at it, make "value" in "option=value" form xfs options definable > by > the user, by embedding in an

Re: [PATCH 3/5] docs: i2c: convert to ReST and add to driver-api bookset

2019-06-28 Thread Alexandre Belloni
On 28/06/2019 18:23:14-0300, Mauro Carvalho Chehab wrote: > diff --git a/drivers/rtc/rtc-ds1374.c b/drivers/rtc/rtc-ds1374.c > index 225a8df1d4e9..1803f3cab39f 100644 > --- a/drivers/rtc/rtc-ds1374.c > +++ b/drivers/rtc/rtc-ds1374.c > @@ -14,7 +14,7 @@ > */ > /* > * It would be more efficient

Re: [PATCH 1/5] docs: convert markdown documents to ReST

2019-06-28 Thread Rob Herring
On Fri, Jun 28, 2019 at 3:23 PM Mauro Carvalho Chehab wrote: > > The documentation standard is ReST and not markdown. > > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/devicetree/writing-schema.md| 130 --- > Documentation/devicetree/writing-schema.rst | 153 ++

Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Darrick J. Wong
On Fri, Jun 28, 2019 at 02:51:06PM -0700, Matthew Wilcox wrote: > On Fri, Jun 28, 2019 at 10:43:02PM +0100, Sheriff Esseson wrote: > > Convert xfs.txt to ReST, markup and rename accordingly. Update > > Documentation/index.rst. > > Didn't get_maintainers.pl suggest that you cc the linux-xfs

Re: [PATCH 3/5] docs: i2c: convert to ReST and add to driver-api bookset

2019-06-28 Thread Alexandre Belloni
On 28/06/2019 18:54:45-0300, Mauro Carvalho Chehab wrote: > Em Fri, 28 Jun 2019 23:41:38 +0200 > Alexandre Belloni escreveu: > > > On 28/06/2019 18:23:14-0300, Mauro Carvalho Chehab wrote: > > > diff --git a/drivers/rtc/rtc-ds1374.c b/drivers/rtc/rtc-ds1374.c > > > index 225a8df1d4e9..1803f3cab39

Re: [PATCH 3/5] docs: i2c: convert to ReST and add to driver-api bookset

2019-06-28 Thread Mauro Carvalho Chehab
Em Fri, 28 Jun 2019 23:41:38 +0200 Alexandre Belloni escreveu: > On 28/06/2019 18:23:14-0300, Mauro Carvalho Chehab wrote: > > diff --git a/drivers/rtc/rtc-ds1374.c b/drivers/rtc/rtc-ds1374.c > > index 225a8df1d4e9..1803f3cab39f 100644 > > --- a/drivers/rtc/rtc-ds1374.c > > +++ b/drivers/rtc/rtc-

Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Shuah Khan
Hi Sheriff, On 6/28/19 3:43 PM, Sheriff Esseson wrote: Convert xfs.txt to ReST, markup and rename accordingly. Update Documentation/index.rst. While at it, make "value" in "option=value" form xfs options definable by the user, by embedding in angle "<>"

Re: [PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Matthew Wilcox
On Fri, Jun 28, 2019 at 10:43:02PM +0100, Sheriff Esseson wrote: > Convert xfs.txt to ReST, markup and rename accordingly. Update > Documentation/index.rst. Didn't get_maintainers.pl suggest that you cc the linux-xfs mailing list? You also need to update MAINTAINERS. > While at

Re: [RFC PATCH 1/3] mm: Introduce VM_IBT for CET legacy code bitmap

2019-06-28 Thread Andy Lutomirski
> On Jun 28, 2019, at 12:41 PM, Yu-cheng Yu wrote: > > The previous discussion of the IBT legacy code bitmap is here: > >https://lkml.org/lkml/2019/6/6/1032 > > When CET Indirect Branch Tracking (IBT) is enabled, the processor expects > every branch target is an ENDBR instruction, or the

[PATCH v1] Doc : fs : convert xfs.txt to ReST

2019-06-28 Thread Sheriff Esseson
Convert xfs.txt to ReST, markup and rename accordingly. Update Documentation/index.rst. While at it, make "value" in "option=value" form xfs options definable by the user, by embedding in angle "<>" brackets, rather than something predifined elsewhe

[PATCH 2/5] docs: misc-devices: convert files without extension to ReST

2019-06-28 Thread Mauro Carvalho Chehab
Those files are also text files. Convert them to ReST and add to the misc-files index.rst. Signed-off-by: Mauro Carvalho Chehab --- .../misc-devices/{eeprom => eeprom.rst} | 43 +-- .../{ics932s401 => ics932s401.rst}| 7 ++- Documentation/misc-devices/index.rst

[PATCH 5/5] docs: spi: convert to ReST and add it to the kABI bookset

2019-06-28 Thread Mauro Carvalho Chehab
While there's one file there with briefily describes the uAPI, the documentation was written just like most subsystems: focused on kernel developers. So, add it together with driver-api books. Signed-off-by: Mauro Carvalho Chehab --- Documentation/index.rst | 1 + .../spi

[PATCH 0/5] Convert misc-devices, i2c, w1, spi and some markdown files to ReST

2019-06-28 Thread Mauro Carvalho Chehab
There are some files under Documentation/ that don't end with .txt but as plain text files. If I did the math right, ~140 of such files make sense to convert, IMO. This series convert most of them. After this series, there will be around 30-40 files without any extension to be converted. The res

[PATCH 1/5] docs: convert markdown documents to ReST

2019-06-28 Thread Mauro Carvalho Chehab
The documentation standard is ReST and not markdown. Signed-off-by: Mauro Carvalho Chehab --- Documentation/devicetree/writing-schema.md| 130 --- Documentation/devicetree/writing-schema.rst | 153 ++ ...entication.md => ubifs-authentication.rst} | 70 +---

[PATCH 4/5] docs: w1: convert to ReST and add to the kAPI group of docs

2019-06-28 Thread Mauro Carvalho Chehab
The 1wire documentation was written with w1 developers in mind, so, it makes sense to add it together with the driver-api set. Signed-off-by: Mauro Carvalho Chehab --- Documentation/ABI/stable/sysfs-bus-w1 | 2 +- .../ABI/stable/sysfs-driver-w1_ds28e04| 4 +- .../ABI/stable/sys

Re: [PATCH] docs: format kernel-parameters -- as code

2019-06-28 Thread Stephen Kitt
On Fri, 28 Jun 2019 12:48:04 -0600, Jonathan Corbet wrote: > On Fri, 28 Jun 2019 20:38:41 +0200 > Stephen Kitt wrote: > > > Right, looking further shows a large number of places where -- is handled > > incorrectly. The following patch disables this “smart” handling wholesale; > > I’ll follow up

Re: [PATCH] docs: format kernel-parameters -- as code

2019-06-28 Thread Stephen Kitt
On Fri, 28 Jun 2019 09:10:21 -0600, Jonathan Corbet wrote: > On Thu, 27 Jun 2019 15:59:38 +0200 > > The current ReStructuredText formatting results in "--", used to > > indicate the end of the kernel command-line parameters, appearing as > > an en-dash instead of two hyphens; this patch formats th

Re: [PATCH] docs: format kernel-parameters -- as code

2019-06-28 Thread Randy Dunlap
On 6/28/19 11:48 AM, Jonathan Corbet wrote: > On Fri, 28 Jun 2019 20:38:41 +0200 > Stephen Kitt wrote: > >> Right, looking further shows a large number of places where -- is handled >> incorrectly. The following patch disables this “smart” handling wholesale; >> I’ll follow up (in the next few da

[RFC PATCH 1/3] mm: Introduce VM_IBT for CET legacy code bitmap

2019-06-28 Thread Yu-cheng Yu
The previous discussion of the IBT legacy code bitmap is here: https://lkml.org/lkml/2019/6/6/1032 When CET Indirect Branch Tracking (IBT) is enabled, the processor expects every branch target is an ENDBR instruction, or the target's address is marked as legacy in the legacy code bitmap. The

[RFC PATCH 3/3] Prevent user from writing to IBT bitmap.

2019-06-28 Thread Yu-cheng Yu
The IBT bitmap is visiable from user-mode, but not writable. Signed-off-by: Yu-cheng Yu --- arch/x86/mm/fault.c | 7 +++ 1 file changed, 7 insertions(+) diff --git a/arch/x86/mm/fault.c b/arch/x86/mm/fault.c index 59f4f66e4f2e..231196abb62e 100644 --- a/arch/x86/mm/fault.c +++ b/arch/x86/m

[RFC PATCH 2/3] Introduce arch_prctl(ARCH_X86_CET_MARK_LEGACY_CODE)

2019-06-28 Thread Yu-cheng Yu
The CET legacy code bitmap covers the whole user-mode address space and is located at the top of the user-mode address space. It is allocated only when the first time arch_prctl(ARCH_X86_MARK_LEGACY_CODE) is called from an application. Introduce: arch_prctl(ARCH_X86_MARK_LEGACY_CODE, unsigned lo

Re: [PATCH v4] RISC-V: Add an Image header that boot loader can parse.

2019-06-28 Thread Atish Patra
On Fri, 2019-06-28 at 12:09 -0700, Paul Walmsley wrote: > On Thu, 6 Jun 2019, Atish Patra wrote: > > > Currently, the last stage boot loaders such as U-Boot can accept > > only > > uImage which is an unnecessary additional step in automating boot > > process. > > > > Add an image header that boot

Re: [PATCH v4] RISC-V: Add an Image header that boot loader can parse.

2019-06-28 Thread Paul Walmsley
On Thu, 6 Jun 2019, Atish Patra wrote: > Currently, the last stage boot loaders such as U-Boot can accept only > uImage which is an unnecessary additional step in automating boot > process. > > Add an image header that boot loader understands and boot Linux from > flat Image directly. ... > +#

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

2019-06-28 Thread Jacek Anaszewski
Hi Mauro, On 6/28/19 2:20 PM, Mauro Carvalho Chehab wrote: > 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

Re: [PATCH] docs: format kernel-parameters -- as code

2019-06-28 Thread Jonathan Corbet
On Fri, 28 Jun 2019 20:38:41 +0200 Stephen Kitt wrote: > Right, looking further shows a large number of places where -- is handled > incorrectly. The following patch disables this “smart” handling wholesale; > I’ll follow up (in the next few days) with patches to use real em- and > en-dashes wher

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

2019-06-28 Thread Roman Gushchin
On Fri, Jun 28, 2019 at 10:16:13AM -0700, Yang Shi wrote: > On Fri, Jun 28, 2019 at 8:32 AM Christopher Lameter wrote: > > > > On Thu, 27 Jun 2019, Roman Gushchin wrote: > > > > > so that objects belonging to different memory cgroups can share the same > > > page > > > and kmem_caches. > > > > >

[RFC PATCH] binfmt_elf: Extract .note.gnu.property from an ELF file

2019-06-28 Thread Yu-cheng Yu
This patch was part of the Intel Control-flow Enforcement (CET) series at: https://lkml.org/lkml/2019/6/6/1014. In the discussion, we decided to look at only an ELF header's PT_GNU_PROPERTY, which is a shortcut pointing to the file's .note.gnu.property. The Linux gABI extension draft is here

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

2019-06-28 Thread Yang Shi
On Fri, Jun 28, 2019 at 8:32 AM Christopher Lameter wrote: > > On Thu, 27 Jun 2019, Roman Gushchin wrote: > > > so that objects belonging to different memory cgroups can share the same > > page > > and kmem_caches. > > > > It's a fairly big change though. > > Could this be done at another level?

Re: [PATCH v3] 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 20:33:45 +0530 Vandana BN escreveu: > This patch converts new-machine.txt and register-banks.txt > to ReST format, No content change. > Added interfaces.rst to contain kernel-doc markups from index.rst > Added interfaces.rst,new-machine.rst and register-banks.rst to sh/index.r

Re: [PATCH] kbuild: get rid of misleading $(AS) from documents

2019-06-28 Thread Sam Ravnborg
Hi Masahiro. On Fri, Jun 28, 2019 at 11:04:33AM +0900, Masahiro Yamada wrote: > The assembler files in the kernel are *.S instead of *.s, so they must > be preprocessed. Hence, we always use $(CC) as an assembler driver. > > $(AS) is almost unused in Kbuild. As of writing, there is just one user.

Клиентские базы! Email: proda...@armyspy.com Узнайте подробнее!

2019-06-28 Thread vlas_m
Клиентские базы! Email: proda...@armyspy.com Узнайте подробнее!

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

2019-06-28 Thread Roman Gushchin
On Fri, Jun 28, 2019 at 03:32:28PM +, Christopher Lameter wrote: > On Thu, 27 Jun 2019, Roman Gushchin wrote: > > > so that objects belonging to different memory cgroups can share the same > > page > > and kmem_caches. > > > > It's a fairly big change though. > > Could this be done at anothe

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

2019-06-28 Thread Dan Williams
On Fri, Jun 28, 2019 at 5:30 AM Mauro Carvalho Chehab wrote: > > The descriptions here are from Kernel driver's PoV. > > Signed-off-by: Mauro Carvalho Chehab Acked-by: Dan Williams

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

2019-06-28 Thread Dan Williams
On Fri, Jun 28, 2019 at 5:21 AM Mauro Carvalho Chehab wrote: > > 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

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

2019-06-28 Thread Christopher Lameter
On Thu, 27 Jun 2019, Roman Gushchin wrote: > so that objects belonging to different memory cgroups can share the same page > and kmem_caches. > > It's a fairly big change though. Could this be done at another level? Put a cgoup pointer into the corresponding structures and then go back to just a

Re: [Linux-kernel-mentees][PATCH] doc: RCU callback locks need only _bh, not necessarily _irq

2019-06-28 Thread Jonathan Corbet
On Thu, 27 Jun 2019 16:01:47 -0500 Jiunn Chang wrote: > The UP.rst file calls for locks acquired within RCU callback functions > to use _irq variants (spin_lock_irqsave() or similar), which does work, > but can be overkill. This commit therefore instead calls for _bh variants > (spin_lock_bh() o

Re: [PATCH] docs: format kernel-parameters -- as code

2019-06-28 Thread Jonathan Corbet
On Thu, 27 Jun 2019 15:59:38 +0200 Stephen Kitt wrote: > The current ReStructuredText formatting results in "--", used to > indicate the end of the kernel command-line parameters, appearing as > an en-dash instead of two hyphens; this patch formats them as code, > "``--``", as done elsewhere in t

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

2019-06-28 Thread Jonathan Corbet
On Fri, 28 Jun 2019 07:20:01 +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(-) > > d

[PATCH v3] 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 interfaces.rst to contain kernel-doc markups from index.rst Added interfaces.rst,new-machine.rst and register-banks.rst to sh/index.rst Signed-off-by: Vandana BN --- Documentation/sh/index.rst

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

2019-06-28 Thread Jonathan Corbet
On Fri, 28 Jun 2019 17:49:48 +0300 Andy Shevchenko wrote: > On Fri, Jun 28, 2019 at 3:12 PM Mauro Carvalho Chehab > wrote: > > > > Changeset 163ede97a9a2 ("Documentation: platform: Delete > > x86-laptop-drivers.txt") > > removed the x86-laptop-drivers.txt file, but forgot to update its > > Kcon

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

2019-06-28 Thread Andy Shevchenko
On Fri, Jun 28, 2019 at 3:30 PM Mauro Carvalho Chehab wrote: > > The docs under Documentation/laptops contain users specific > information. > Acked-by: Andy Shevchenko > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/ABI/testing/sysfs-block-device | 2 +- > Docume

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

2019-06-28 Thread Andy Shevchenko
On Fri, Jun 28, 2019 at 3:12 PM Mauro Carvalho Chehab wrote: > > Changeset 163ede97a9a2 ("Documentation: platform: Delete > x86-laptop-drivers.txt") > removed the x86-laptop-drivers.txt file, but forgot to update its > Kconfig. Acked-by: Andy Shevchenko > > Fixes: 163ede97a9a2 ("Documentation:

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

2019-06-28 Thread Kees Cook
On Fri, Jun 28, 2019 at 09:20:38AM -0300, Mauro Carvalho Chehab wrote: > 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 Acked-by: Kees Cook -Kees > --- > Documentation/{gcc-plugins.txt => core-api/gc

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

2019-06-28 Thread Vandana BN
On 28/06/19 7:09 PM, Mauro Carvalho Chehab wrote: > 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

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

2019-06-28 Thread Georgi Djakov
On 6/28/19 15:30, Mauro Carvalho Chehab wrote: > This is intented for Kernel hackers audience. s/intented/intended/ > > Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Georgi Djakov Thanks! Georgi > --- > Documentation/driver-api/index.rst | 1 + > Documentation/

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

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

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

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

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

  1   2   >