Re: [PATCH] Documentation: cpu-freq: Convert core.txt file to ReST format

2019-07-06 Thread Rafael J. Wysocki
On Fri, Jul 5, 2019 at 11:04 PM Shreeya Patel wrote: > > Convert core file to ReST format, in order to allow it to > be parsed by Sphinx. Make a minor change of correcting the wrong > function name cpufreq_put_cpu to cpufreq_cpu_put. > Also create an index.rst file in cpu-freq and add it's entry >

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

2019-07-06 Thread Mauro Carvalho Chehab
Em Fri, 28 Jun 2019 21:01:40 +0200 Jacek Anaszewski escreveu: > 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

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

2019-07-06 Thread Mauro Carvalho Chehab
Em Wed, 3 Jul 2019 15:06:41 -0300 Jason Gunthorpe escreveu: > On Fri, Jun 28, 2019 at 09:19:57AM -0300, Mauro Carvalho Chehab wrote: > > 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

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

2019-07-06 Thread Mauro Carvalho Chehab
Em Wed, 3 Jul 2019 15:08:02 -0300 Jason Gunthorpe escreveu: > On Fri, Jun 28, 2019 at 09:30:28AM -0300, Mauro Carvalho Chehab wrote: > > 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

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

2019-07-06 Thread Mauro Carvalho Chehab
Em Wed, 3 Jul 2019 10:44:38 +0200 Linus Walleij escreveu: > On Fri, Jun 28, 2019 at 2:30 PM Mauro Carvalho Chehab > wrote: > > > 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 Cheha

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

2019-07-06 Thread Masahiro Yamada
The assembler files in the kernel are *.S instead of *.s, so they must be preprocessed. Since 'as' of GNU binutils is not able to preprocess, we always use $(CC) as an assembler driver. $(AS) is almost unused in Kbuild. As of writing, there is just one place that directly invokes $(AS). $ git g

[PATCH] docs: automarkup.py: ignore exceptions when seeking for xrefs

2019-07-06 Thread Mauro Carvalho Chehab
When using the automarkup extension with: make pdfdocs without passing an specific book, the code will raise an exception: File "/devel/v4l/docs/Documentation/sphinx/automarkup.py", line 86, in auto_markup node.parent.replace(node, markup_funcs(name, app, node))

Re: [PATCH] Documentation: cpu-freq: Convert core.txt file to ReST format

2019-07-06 Thread Shreeya Patel
On Sat, 2019-07-06 at 09:58 +0200, Rafael J. Wysocki wrote: > On Fri, Jul 5, 2019 at 11:04 PM Shreeya Patel > wrote: > > > > Convert core file to ReST format, in order to allow it to > > be parsed by Sphinx. Make a minor change of correcting the wrong > > function name cpufreq_put_cpu to cpufreq_

[PATCH] doc: email-clients miscellaneous fixes

2019-07-06 Thread Federico Vaga
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 --- Documentation/process/email-clients.rst | 20 +--- 1 file changed, 9 insertions(+), 11 deletions(-) diff

[PATCH 0/3] [PATCH 0/3] Documentation: virtual: convert files from .txt to

2019-07-06 Thread Luke Nowakowski-Krijger
From: Luke Nowakowski-Krijger Converted a few documents in virtual and virtual/kvm to .rst format. Also added toctree hooks wherever there were .rst files. Adding hooks to the main doc tree should be in another patch series once there are more files in the directory. After confirming with the a

[PATCH 2/3] Documentation: kvm: Convert cpuid.txt to .rst

2019-07-06 Thread Luke Nowakowski-Krijger
From: Luke Nowakowski-Krijger Convert cpuid.txt to .rst format to be parsable by sphinx. Change format and spacing to make function definitions and return values much more clear. Also added a table that is parsable by sphinx and makes the information much more clean. Signed-off-by: Luke Nowak

[PATCH 1/3] Documentation: virtual: Add toctree hooks

2019-07-06 Thread Luke Nowakowski-Krijger
From: Luke Nowakowski-Krijger Added toctree hooks for indexing. Hooks added only for newly added files or already existing files. The hook for the top of the tree will be added in a later patch series when a few more substantial changes have been added. Signed-off-by: Luke Nowakowski-Krijger

[PATCH 3/3] Documentation: virtual: Convert paravirt_ops.txt to .rst

2019-07-06 Thread Luke Nowakowski-Krijger
From: Luke Nowakowski-Krijger Convert paravirt_opts.txt to .rst format to be able to be parsed by sphinx. Made some minor spacing and formatting corrections to make defintions much more clear and easy to read. Signed-off-by: Luke Nowakowski-Krijger --- .../{paravirt_ops.txt => paravirt_ops.

[Linux-kernel-mentees] [PATCH] Documentation: filesystems: Convert jfs.txt to reStructedText format.

2019-07-06 Thread Shobhit Kukreti
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 --- Documentation/filesystems/index.rst | 1 + Documentation/filesystems/jfs.rst | 74

[Linux-kernel-mentees] [PATCH] Documentation: filesystems: Convert ufs.txt to reStructuredText format

2019-07-06 Thread Shobhit Kukreti
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 --- Documentation/filesystems/index.rst | 1 + Documentation/filesystems/ufs.rst | 65