Re: [PATCH] Documentation/RCU: Fix minor typo

2016-10-18 Thread Paul E. McKenney
On Tue, Oct 18, 2016 at 12:43:24AM -0700, Josh Triplett wrote: > On Tue, Oct 18, 2016 at 12:54:03AM -0400, Pranith Kumar wrote: > > deference should actually be dereference. > > > > Signed-off-by: Pranith Kumar > > Good catch. > > Reviewed-by: Josh Triplett Applied, thank you both!

Re: [PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

2016-10-18 Thread Markus Heiser
Am 18.10.2016 um 18:05 schrieb Mauro Carvalho Chehab : > Em Tue, 18 Oct 2016 16:27:54 +0100 > David Howells escreveu: > >> Mauro Carvalho Chehab wrote: >> >>> - Fix identatio for the document title; >>> - remove its index; >>> - create a table for hash algorithm to be used; >>> - use quote bl

Re: [PATCH] mcp3021: rework for DT support of reference-voltage

2016-10-18 Thread Guenter Roeck
On Wed, Oct 19, 2016 at 12:44:44AM +0200, Clemens Gruber wrote: > Support setting the reference voltage in the device tree. > Rework of driver structure, put chip specific data in a separate > structure and assign it depending on device id from platform data or > DT match. > Extend the device docum

[RESEND PATCH v2 4/4] usb: doc: add document for USB3 debug port usage

2016-10-18 Thread Lu Baolu
Add Documentation/usb/usb3-debug-port.txt. This document includes the user guide for USB3 debug port. Cc: linux-doc@vger.kernel.org Signed-off-by: Lu Baolu --- Documentation/usb/usb3-debug-port.txt | 87 +++ 1 file changed, 87 insertions(+) create mode 100644 Doc

Re: sequence diagrams in rst documentation

2016-10-18 Thread Jonathan Corbet
On Tue, 18 Oct 2016 13:43:41 +0200 Johannes Berg wrote: > > Example here: > > https://johannes.sipsolutions.net/files/80211/mac80211.html#connection-flow > > > > Coming back to this - sadly, it appears that this software (blockdiag, > seqdiag) is completely unmaintained, with open pull reques

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-10-18 Thread Jonathan Corbet
On Tue, 18 Oct 2016 08:20:18 -0200 Mauro Carvalho Chehab wrote: > > While at it, how about unifying some of the FilenamesInCamelCase, > > filenames-with-hyphens, and filenames_with_underscores too...? To at > > least move things towards just one of them within one directory. > > Sure, let's do

[PATCH] mcp3021: rework for DT support of reference-voltage

2016-10-18 Thread Clemens Gruber
Support setting the reference voltage in the device tree. Rework of driver structure, put chip specific data in a separate structure and assign it depending on device id from platform data or DT match. Extend the device documentation and add new documentation for the devicetree bindings. Also chang

Re: [PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

2016-10-18 Thread David Howells
Mauro Carvalho Chehab wrote: > See the enclosed patch. I'm putting a ".." before each line in the index, > so that those lines won't be processed by Sphinx when generating PDF or > HTML. That'll do, thanks. > With such changes, it will now be seen in HTML as: > > https://mchehab.fedorape

Re: [kernel-hardening] [PATCH 1/2] security, perf: allow further restriction of perf_event_open

2016-10-18 Thread Daniel Micay
On Tue, 2016-10-18 at 13:48 -0700, Kees Cook wrote: > On Mon, Oct 17, 2016 at 6:44 AM, Mark Rutland > wrote: > > Hi, > > > > Attempt to revive discussions below... > > > > On Wed, Jul 27, 2016 at 07:45:46AM -0700, Jeff Vander Stoep wrote: > > > When kernel.perf_event_paranoid is set to 3 (or gre

Re: [PATCH v20 10/10] fpga-manager: Add Socfpga Arria10 support

2016-10-18 Thread Moritz Fischer
On Mon, Oct 17, 2016 at 11:09:41AM -0500, Alan Tull wrote: > Add low level driver to support reprogramming FPGAs for Altera > SoCFPGA Arria10. > > Signed-off-by: Alan Tull Reviewed-by: Moritz Fischer > --- > v19: Added to this patchset as has been changed to use >fpga image information

Re: [kernel-hardening] [PATCH 1/2] security, perf: allow further restriction of perf_event_open

2016-10-18 Thread Kees Cook
On Mon, Oct 17, 2016 at 6:44 AM, Mark Rutland wrote: > Hi, > > Attempt to revive discussions below... > > On Wed, Jul 27, 2016 at 07:45:46AM -0700, Jeff Vander Stoep wrote: >> When kernel.perf_event_paranoid is set to 3 (or greater), disallow >> all access to performance events by users without CA

Re: [PATCHv12 1/3] rdmacg: Added rdma cgroup controller

2016-10-18 Thread Parav Pandit
Hi Doug, Leon has finished review as well in [7]. Christoph Acked too in [8]. Can you please advise whether (1) I should rebase and resend PatchV12? (2) If so for which branch - master/4.9 or? Tejun and Christoph mentioned that it might be late for 4.9. Can we atleast merge to linux-rdma tree, s

Re: sequence diagrams in rst documentation

2016-10-18 Thread Johannes Berg
> This could probably be argued either way... Yeah, I guess it could :) > My view has been all along that we should prefer to use existing > extensions written and maintained by others. Perhaps we (the kind of > royal "we" of which I'm personally really not part of) could take on > maintainershi

Re: [PATCH v20 03/10] add bindings document for altera freeze bridge

2016-10-18 Thread atull
On Tue, 18 Oct 2016, Rob Herring wrote: > On Mon, Oct 17, 2016 at 11:09:34AM -0500, Alan Tull wrote: > > Add bindings document for the Altera Freeze Bridge. A Freeze > > Bridge is used to gate traffic to/from a region of a FPGA > > such that that region can be reprogrammed. The Freeze Bridge > >

Re: [PATCH v20 02/10] doc: fpga-mgr: add fpga image info to api

2016-10-18 Thread atull
On Mon, 17 Oct 2016, Moritz Fischer wrote: > Hi Alan, > > couple of nits inline and some comments on ordering the patches ;-) > > On Mon, Oct 17, 2016 at 6:09 PM, Alan Tull > wrote: > > This patch adds a minor change in the FPGA Mangager API > > s/Mangager/Manager/ Yup! > > > to hold infor

[PATCH] doc-rst: reST-directive kernel-cmd parse with tabs

2016-10-18 Thread Markus Heiser
Add a 'tab-width' option to the kernel-cmd, and convert whitespace (tabs) well. The default 'tab-width' is 8. This is also a bugfix, since without this patch, tabs in command's output are not handled. Signed-off-by: Markus Heiser --- Documentation/sphinx/kernel_cmd.py | 17 + 1

[PATCH] kernel-cmd and tabs

2016-10-18 Thread Markus Heiser
Hi Mauro, this patch adress the problems you reported with the kernel-cmd directive [1]. The problem was, that my nested parse didn't handled tabs well (sorry for being slow-witted this morning ;-). The patch is based on your git.linuxtv.org/mchehab/experimental.git lkml-books branch. [1] https:

Re: [PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

2016-10-18 Thread Jani Nikula
On Tue, 18 Oct 2016, David Howells wrote: > Mauro Carvalho Chehab wrote: > >> - Fix identatio for the document title; >> - remove its index; >> - create a table for hash algorithm to be used; >> - use quote blocks where needed; >> - use monotonic fonts for parameters; >> - adjust whitespaces and

Re: [PATCH] doc-rst: DocBook to reST migration of the uio-howto.tmpl

2016-10-18 Thread Markus Heiser
Am 18.10.2016 um 17:59 schrieb Greg KH : > On Tue, Oct 18, 2016 at 05:52:58PM +0200, Markus Heiser wrote: >> The migration is done with the dbxml2rst project with small additional >> handmade. The uio-howto is chunked along its chapters into smal parts. > > "small"? :) ups > And why small par

Re: [PATCH v20 03/10] add bindings document for altera freeze bridge

2016-10-18 Thread Rob Herring
On Mon, Oct 17, 2016 at 11:09:34AM -0500, Alan Tull wrote: > Add bindings document for the Altera Freeze Bridge. A Freeze > Bridge is used to gate traffic to/from a region of a FPGA > such that that region can be reprogrammed. The Freeze Bridge > exist in FPGA fabric that is not currently being r

Re: [PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
Em Tue, 18 Oct 2016 16:27:54 +0100 David Howells escreveu: > Mauro Carvalho Chehab wrote: > > > - Fix identatio for the document title; > > - remove its index; > > - create a table for hash algorithm to be used; > > - use quote blocks where needed; > > - use monotonic fonts for parameters; > >

Re: [PATCH] doc-rst: DocBook to reST migration of the uio-howto.tmpl

2016-10-18 Thread Greg KH
On Tue, Oct 18, 2016 at 05:52:58PM +0200, Markus Heiser wrote: > The migration is done with the dbxml2rst project with small additional > handmade. The uio-howto is chunked along its chapters into smal parts. "small"? :) And why small parts? Is that the new "desired" way? > > [1] https://retu

Re: [PATCH] doc-rst: DocBook to reST migration of the uio-howto.tmpl

2016-10-18 Thread Jonathan Corbet
On Tue, 18 Oct 2016 17:52:57 +0200 Markus Heiser wrote: > this is the DocBook to reST migration of the uio-howto.tmpl as ordered by > Stephen Hemminger [1]. Markus, slow down just a little bit, please. Let me get docs-next going for 4.9 (will happen once I get LWN together for this week) and ge

[PATCH] doc-rst: DocBook to reST migration of the uio-howto.tmpl

2016-10-18 Thread Markus Heiser
Hi, this is the DocBook to reST migration of the uio-howto.tmpl as ordered by Stephen Hemminger [1]. The patch is on top of git://git.lwn.net/linux.git docs-next [1] https://www.mail-archive.com/linux-doc@vger.kernel.org/msg06891.html Markus Heiser (1): doc-rst: DocBook to reST migration of t

[PATCH] doc-rst: DocBook to reST migration of the uio-howto.tmpl

2016-10-18 Thread Markus Heiser
The migration is done with the dbxml2rst project with small additional handmade. The uio-howto is chunked along its chapters into smal parts. [1] https://return42.github.io/dbxml2rst/ Signed-off-by: Markus Heiser --- Documentation/DocBook/Makefile |2 +- Documentation/DocB

Re: [PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

2016-10-18 Thread David Howells
Mauro Carvalho Chehab wrote: > - Fix identatio for the document title; > - remove its index; > - create a table for hash algorithm to be used; > - use quote blocks where needed; > - use monotonic fonts for parameters; > - adjust whitespaces and blank lines; > - Fix case on section titles; > - add

Re: sequence diagrams in rst documentation

2016-10-18 Thread Jani Nikula
On Tue, 18 Oct 2016, Johannes Berg wrote: > On Tue, 2016-10-18 at 15:51 +0200, Markus Heiser wrote: >> Here are my thoughts ... >> >> Every extension which is not a part of the sphinx distro brings new >> external dependencies > > I agree. > >> and the development of such extensions is IMO >> fa

[PATCH v2 26/37] Documentation/volatile-considered-harmful.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document section markups; - use quote blocks where needed; - adjust spaces and blank lines; - add it to the development-processs book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/volatile-considered-harmful.txt | 19 +++ 1 file changed, 11 insertions(+), 8 deleti

[PATCH v2 08/37] Documentation/braille-console: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix identation for the document title; - use monotonic fonts for paths; - use quote blocks where needed; - adjust spaces to properly format paragraphs; - use :menuselection: and :kbd: for the menu item and keys; - point too the right item at the menu; - add it to the user book. Signed-off-by: Ma

[PATCH v2 01/37] Documentation/applying-patches.txt: fix a bad external link

2016-10-18 Thread Mauro Carvalho Chehab
We can't use :ref: for external links. Signed-off-by: Mauro Carvalho Chehab --- Documentation/applying-patches.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/applying-patches.txt b/Documentation/applying-patches.txt index 02ce4924468e..3395da13d415 100644

[PATCH v2 32/37] docs-rst: add documents to development-process

2016-10-18 Thread Mauro Carvalho Chehab
Add several documents to the development-process ReST book. As we don't want renames, use symlinks instead, keeping those documents on their original place. Acked-by: Greg Kroah-Hartman Signed-off-by: Mauro Carvalho Chehab --- .../adding-syscalls.rst} | 0 .../applyi

[PATCH v2 33/37] docs-rst: create an user's manual book

2016-10-18 Thread Mauro Carvalho Chehab
Place README, REPORTING-BUGS, SecurityBugs and kernel-parameters on an user's manual book. As we'll be numbering the user's manual, remove the manual numbering from SecurityBugs. Signed-off-by: Mauro Carvalho Chehab --- README => Documentation/admin-guide/README.rst | 0 .../{bad_memory.tx

[PATCH v2 28/37] Documentation/CodeOfConflict: convert to ReST

2016-10-18 Thread Mauro Carvalho Chehab
Fix ReST notation for a bullet item Signed-off-by: Mauro Carvalho Chehab --- Documentation/CodeOfConflict | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/CodeOfConflict b/Documentation/CodeOfConflict index 49a8ecc157a2..47b6de763203 100644 --- a/Documentation/

[PATCH v2 14/37] Documentation/magic-number.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- add a title for the document; - convert the table; - use quote block for the changelog; - use monotonic fonts for file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/magic-number.txt | 216 +--

[PATCH v2 29/37] REPORTING-BUGS: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- add a title to the document; - use :: before verbatim blocks; - add blank lines where required; - use protocol for URL references; - use a verbatim block for the bugs template; - add cross references to SecurityBugs. Signed-off-by: Mauro Carvalho Chehab --- REPORTING-BUGS | 66

[PATCH v2 31/37] docs: rename development-process/ to process/

2016-10-18 Thread Mauro Carvalho Chehab
As we'll type this a lot, after adding CodingStyle & friends, let's rename the directory name to a shorter one. Signed-off-by: Mauro Carvalho Chehab --- Documentation/00-INDEX | 2 +- Documentation/SubmittingPatches

[PATCH v2 27/37] Documentation/parport.txt: fix table to show on LaTeX

2016-10-18 Thread Mauro Carvalho Chehab
Sphinx doesn't like nested tables on the LaTex output. So, change the table there to be displayed properly at the PDF output. Signed-off-by: Mauro Carvalho Chehab --- Documentation/parport.txt | 33 ++--- 1 file changed, 22 insertions(+), 11 deletions(-) diff --git

[PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix identatio for the document title; - remove its index; - create a table for hash algorithm to be used; - use quote blocks where needed; - use monotonic fonts for parameters; - adjust whitespaces and blank lines; - Fix case on section titles; - add it to the user's book. Signed-off-by: Mauro C

[PATCH v2 20/37] Documentation/parport.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Add a document title; - use quote blocks where needed; - convert parameters to a nested table; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - replace _foo_ by **foo**; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Docume

[PATCH v2 13/37] Documentation/init.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- use a quote blocks where needed; - use ``foo`` for monotonic; - adjust whitespaces and blank lines; - fix the second list (that starts with 0, instead of A) - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/init.txt | 29 - 1 file c

[PATCH v2 17/37] Documentation/mono.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document title; - use quote blocks where needed; - use .. note:: for notes; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/mono.txt | 44 +

[PATCH v2 11/37] Documentation/dynamic-debug-howto.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- use a quote blocks where needed; - fix the chapter/section/subsection markups; - use ``foo`` for monotonic; - use .. note:: for the line-range note; - cleanup whitespaces; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/dynamic-debug-howto.txt | 297

[PATCH v2 30/37] README: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
Adjust the readme file for it to use the ReST markup: - add chapter/section markups; - use ``foo`` for commands; - use :: for verbatim and script blocks; - replace unsupported markup _foo_ by **foo**; - add cross-references to other ReST files; - use lower case on the section titles, to match othe

[PATCH v2 12/37] Documentation/initrd.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- use a quote blocks where needed; - fix the chapter/section/subsection markups; - use ``foo`` for monotonic; - use .. note:: for /sbin/init file permissions; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/initrd.txt | 19

[PATCH v2 19/37] Documentation/oops-tracing.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Add a document title; - use .. note:: markup; - use quote blocks where needed; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - replace _foo_ by **foo**; - while here, remove whitespaces at the end of paragraph; - add it to the user's book. Signed-

[PATCH v2 18/37] Documentation/java.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document title; - use quote blocks where needed; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/java.txt | 244 ++-

[PATCH v2 15/37] Documentation/md.txt: Convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- add a title for the document; - convert some parameters to tables; - use quote blocks where needed; - use monotonic fonts for parameters; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/md.txt | 528 +

[PATCH v2 35/37] doc: re-add CodingStyle and SubmittingPatches

2016-10-18 Thread Mauro Carvalho Chehab
Those files got moved to Documentation/process, but as they're very well known files, add pointers to their new locations. PS.: I opted to not merge this patch with the previous one in order to make the diff of the previous one more consistent, as it will show only renames. Signed-off-by: Mauro C

[PATCH v2 03/37] Documentation/kernel-parameters.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
Adjust the file for it to be parsed by Sphinx: - adjust the document title to be parsed; - use :: for quote blocks; - fix the horizontal bar markup; - lower case the TODO title. Signed-off-by: Mauro Carvalho Chehab --- Documentation/kernel-parameters.txt | 33 +++-- 1

[PATCH v2 22/37] Documentation/sysfs-rules.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document title; - use quote blocks where needed; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sysfs-rules.txt | 218 ++--

[PATCH v2 02/37] Documentation/adding-syscalls.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
Convert adding-syscalls.txt to ReST markup and add it to the development-process book: - add extra lines to make Sphinx to correctly parse paragraphs; - use quote blocks for examples; - use monotonic font for dirs, function calls, etc; - mark manpage pages using the right markup; - add cross-refer

[PATCH v2 00/37] Create an User's manual and improve development-process book

2016-10-18 Thread Mauro Carvalho Chehab
This patch series continues the efforts of converting the Linux Kernel documentation to Sphinx. It contains text to ReST conversion of several files under Documentation, and a few ones under the main dir (README, REPORTING-BUGS). All patches on this series can be found on my development tree:

[PATCH v2 07/37] Documentation/serial-console.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix identation for the document title; - use monotonic fonts for paths; - use quote blocks where needed; - adjust spaces to properly format paragraphs; - use :menuselection: for the menu item; - add it to the user book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/serial-console.txt

[PATCH v2 23/37] Documentation/sysrq.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document title; - use a table for the valid commands; - use quote blocks where needed; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sysrq.txt | 266

[PATCH v2 36/37] README: add a new README file, pointing to the Documentation/

2016-10-18 Thread Mauro Carvalho Chehab
As we moved the real README file to Documentation/admin-guide/README.rst, let's add a replacement, pointing to it, and giving the main directions about documentation. In the future, perhaps it would be worth to move the contents of Documentation/00-Index into this README. Signed-off-by: Mauro Car

[PATCH v2 06/37] Documentation/binfmt_misc.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix identation for the document title; - use monotonic fonts for commands, paths, etc; - use quote blocks where needed; - adjust spaces to properly format paragraphs; - add it to the user book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/binfmt_misc.txt | 134 +++

[PATCH v2 05/37] Documentation/basic_profiling.rst: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
Convert it to ReST markup and add it to the user book: - Add a title to the document; - touch spaces/new lines to fix Sphinx format; - use ``foo`` for commands; - use quote blocks where needed; - add it to the user book; Signed-off-by: Mauro Carvalho Chehab --- Documentation/basic_profiling.txt

[PATCH v2 09/37] Documentation/BUG-HUNTING: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Add a document title and remove its own index; - use monotonic fonts for paths; - use quote blocks where needed; - adjust/use spaces to properly format paragraphs; - add it to the user book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/BUG-HUNTING | 162 +++---

[PATCH v2 25/37] Documentation/VGA-softcursor.txt: convert to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document title; - use quote blocks where needed; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/VGA-softcursor.txt | 73 +++---

[PATCH v2 37/37] Documentation/00-INDEX: remove legacy media directories

2016-10-18 Thread Mauro Carvalho Chehab
The dvb/ and video4linux/ dirs were removed, as now, all media documentation is under media/. Signed-off-by: Mauro Carvalho Chehab --- Documentation/00-INDEX | 4 1 file changed, 4 deletions(-) diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX index 39caa6544d1f..903ebc494f29 10

[PATCH v2 21/37] Documentation/ramoops.txt: convert it to ReST format

2016-10-18 Thread Mauro Carvalho Chehab
- Fix document title; - use quote blocks where needed; - use monotonic fonts for config options and file names; - adjust whitespaces and blank lines; - add it to the user's book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/ramoops.txt | 86 ++---

[PATCH v2 24/37] Documentation/unicode.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
Probably, unicode is something that we might remove from the docs, as all modern systems support it. Yet, this chapter is fun, as it mentions support for the Klington fictional charset ;) On the other hand, I bet all other OS user manuals explicit mention unicode support. So, convert it to ReST a

[PATCH v2 04/37] Documentation/bad_memory.txt: convert it to ReST markup

2016-10-18 Thread Mauro Carvalho Chehab
- promote the section level of the document name; - add/remove spaces/new lines where needed to format the output; - use quote blocks. - add it to the user book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/bad_memory.txt | 26 -- 1 file changed, 16 insertions(+

Re: Renaming Documentation/ [was [PATCH 00/32] Create an User's manual and improve development-process book]

2016-10-18 Thread Theodore Ts'o
On Tue, Oct 18, 2016 at 07:37:34AM -0600, Jonathan Corbet wrote: > On Tue, 18 Oct 2016 06:30:48 +0200 > Markus Heiser wrote: > > > One Silly request of mine: > > > > Is there a chance moving "./Documentation" to something shorter > > like "./doc"? Even with "Text completion" (in Emacs [1]), IMO

Re: sequence diagrams in rst documentation

2016-10-18 Thread Johannes Berg
On Tue, 2016-10-18 at 15:51 +0200, Markus Heiser wrote: > Here are my thoughts ... > > Every extension which is not a part of the sphinx distro brings new > external dependencies I agree. > and the development of such extensions is IMO > far of kernel development's scope. Arguably, having good

Re: [PATCH v2 3/3] doc: add documentation for uio-hv-generic

2016-10-18 Thread Markus Heiser
Am 18.10.2016 um 15:59 schrieb Stephen Hemminger : > On Tue, 18 Oct 2016 13:01:20 +0200 > Markus Heiser wrote: > >> Am 18.10.2016 um 12:54 schrieb Jani Nikula : >> >>> On Mon, 17 Oct 2016, Stephen Hemminger wrote: From: Stephen Hemminger Update UIO documentation to include

Re: [PATCH v2 3/3] doc: add documentation for uio-hv-generic

2016-10-18 Thread Stephen Hemminger
On Tue, 18 Oct 2016 13:01:20 +0200 Markus Heiser wrote: > Am 18.10.2016 um 12:54 schrieb Jani Nikula : > > > On Mon, 17 Oct 2016, Stephen Hemminger wrote: > >> From: Stephen Hemminger > >> > >> Update UIO documentation to include basic information about > >> uio_hv_generic. > > > > How a

Re: sequence diagrams in rst documentation

2016-10-18 Thread Markus Heiser
Am 18.10.2016 um 13:43 schrieb Johannes Berg : > On Tue, 2016-10-11 at 15:53 +0200, Johannes Berg wrote: >>> >>> >>> Related question: I have some sequence diagrams, and just found the >>> seqdiag sphinx plugin. How should we manage adding extensions? Or >>> would you prefer not to add any at a

Renaming Documentation/ [was [PATCH 00/32] Create an User's manual and improve development-process book]

2016-10-18 Thread Jonathan Corbet
On Tue, 18 Oct 2016 06:30:48 +0200 Markus Heiser wrote: > One Silly request of mine: > > Is there a chance moving "./Documentation" to something shorter > like "./doc"? Even with "Text completion" (in Emacs [1]), IMO > "Documentation" is to long. I'd be entirely in favor of that. It would req

sequence diagrams in rst documentation

2016-10-18 Thread Johannes Berg
On Tue, 2016-10-11 at 15:53 +0200, Johannes Berg wrote: > > > > > > Related question: I have some sequence diagrams, and just found the > > seqdiag sphinx plugin. How should we manage adding extensions? Or > > would you prefer not to add any at all? > > Example here: > https://johannes.sipsoluti

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

2016-10-18 Thread Markus Heiser
Am 18.10.2016 um 12:06 schrieb Mauro Carvalho Chehab : > Sorry, I missed part of your comments on my last reply... > > > Em Tue, 18 Oct 2016 09:03:28 +0200 > Markus Heiser escreveu: > >> +- ``T:`` SCM tree type and location. >> + >>> + - Type is one of: **git**, **hg**, **quilt**, **stgit

Re: [PATCH v2 3/3] doc: add documentation for uio-hv-generic

2016-10-18 Thread Markus Heiser
Am 18.10.2016 um 12:54 schrieb Jani Nikula : > On Mon, 17 Oct 2016, Stephen Hemminger wrote: >> From: Stephen Hemminger >> >> Update UIO documentation to include basic information about >> uio_hv_generic. > > How about converting to Sphinx/reStructuredText first...? It's not a big > file... >

Re: [PATCH v2 3/3] doc: add documentation for uio-hv-generic

2016-10-18 Thread Jani Nikula
On Mon, 17 Oct 2016, Stephen Hemminger wrote: > From: Stephen Hemminger > > Update UIO documentation to include basic information about > uio_hv_generic. How about converting to Sphinx/reStructuredText first...? It's not a big file... BR, Jani. > > Signed-off-by: Stephen Hemminger > --- >

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-10-18 Thread Mauro Carvalho Chehab
Em Tue, 18 Oct 2016 13:35:39 +0300 Jani Nikula escreveu: > On Tue, 18 Oct 2016, Mauro Carvalho Chehab wrote: > > Em Tue, 18 Oct 2016 13:01:01 +0300 > > Jani Nikula escreveu: > > > >> On Tue, 18 Oct 2016, Jonathan Corbet wrote: > >> > So I raised this topic in talks at both Kernel Recipes a

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-10-18 Thread Jani Nikula
On Tue, 18 Oct 2016, Mauro Carvalho Chehab wrote: > Em Tue, 18 Oct 2016 13:01:01 +0300 > Jani Nikula escreveu: > >> On Tue, 18 Oct 2016, Jonathan Corbet wrote: >> > So I raised this topic in talks at both Kernel Recipes and LinuxCon >> > Europe, and nobody threw things at me. I have come to sus

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-10-18 Thread Mauro Carvalho Chehab
Em Tue, 18 Oct 2016 13:01:01 +0300 Jani Nikula escreveu: > On Tue, 18 Oct 2016, Jonathan Corbet wrote: > > So I raised this topic in talks at both Kernel Recipes and LinuxCon > > Europe, and nobody threw things at me. I have come to suspect that I'm > > worrying a little too much about it; mayb

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

2016-10-18 Thread Mauro Carvalho Chehab
Sorry, I missed part of your comments on my last reply... Em Tue, 18 Oct 2016 09:03:28 +0200 Markus Heiser escreveu: > +-``T:`` SCM tree type and location. > + > > + - Type is one of: **git**, **hg**, **quilt**, **stgit**, **topgit** > > + > > Hmm, why is the last line a bullet list, s

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-10-18 Thread Jani Nikula
On Tue, 18 Oct 2016, Jonathan Corbet wrote: > So I raised this topic in talks at both Kernel Recipes and LinuxCon > Europe, and nobody threw things at me. I have come to suspect that I'm > worrying a little too much about it; maybe we should go ahead and move > the documents and see who screams.

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

2016-10-18 Thread Mauro Carvalho Chehab
Em Tue, 18 Oct 2016 09:07:03 +0300 Jani Nikula escreveu: > On Mon, 17 Oct 2016, Mauro Carvalho Chehab wrote: > > [PATCH] docs-rst: user: add MAINTAINERS > > > > including MAINTAINERS using ReST is tricky, because all > > maintainer's entries are like: > > > > FOO SUBSYSTEM: > > M: My Name > > L

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

2016-10-18 Thread Mauro Carvalho Chehab
Em Tue, 18 Oct 2016 09:03:28 +0200 Markus Heiser escreveu: > Am 17.10.2016 um 18:46 schrieb Mauro Carvalho Chehab : > > > Hi Markus, > > > > Em Thu, 6 Oct 2016 09:20:17 +0200 > > Markus Heiser escreveu: > > > >> From: Markus Heiser > >> > >> The ``kernel-cmd`` directive includes contend

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-10-18 Thread Mauro Carvalho Chehab
Em Mon, 17 Oct 2016 16:43:42 -0600 Jonathan Corbet escreveu: > I've only been able to take a quick look at these - I'm buried fairly deep > at the moment. A few superficial thoughts. > > On Mon, 17 Oct 2016 14:55:37 -0200 > Mauro Carvalho Chehab wrote: > > > In my opinion, it would be better

Re: [PATCH] Documentation/RCU: Fix minor typo

2016-10-18 Thread Josh Triplett
On Tue, Oct 18, 2016 at 12:54:03AM -0400, Pranith Kumar wrote: > deference should actually be dereference. > > Signed-off-by: Pranith Kumar Good catch. Reviewed-by: Josh Triplett > Documentation/RCU/whatisRCU.txt | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Docum

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

2016-10-18 Thread Markus Heiser
Am 17.10.2016 um 18:46 schrieb Mauro Carvalho Chehab : > Hi Markus, > > Em Thu, 6 Oct 2016 09:20:17 +0200 > Markus Heiser escreveu: > >> From: Markus Heiser >> >> The ``kernel-cmd`` directive includes contend from the stdout of a >> command-line. With the ``kernel-cmd`` directive we can incl