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

2016-10-19 Thread Lu Baolu
Hi Jani, On 10/19/2016 03:48 PM, Jani Nikula wrote: > On Wed, 19 Oct 2016, Lu Baolu wrote: >> Add Documentation/usb/usb3-debug-port.txt. This document includes >> the user guide for USB3 debug port. > If you're adding completely new files, please at least consider writing > them in reStructuredTe

Re: The downside of math::

2016-10-19 Thread Mauro Carvalho Chehab
Em Wed, 19 Oct 2016 22:26:18 -0200 Mauro Carvalho Chehab escreveu: > Hi Jon, > > Em Wed, 19 Oct 2016 17:02:46 -0600 > Jonathan Corbet escreveu: > > > Hey, Mauro, > > > > So I was a little surprised to find that the htmldocs build now breaks on > > one of my machines due to a lack of LaTeX. B

Re: The downside of math::

2016-10-19 Thread Mauro Carvalho Chehab
Hi Jon, Em Wed, 19 Oct 2016 17:02:46 -0600 Jonathan Corbet escreveu: > Hey, Mauro, > > So I was a little surprised to find that the htmldocs build now breaks on > one of my machines due to a lack of LaTeX. A bit of digging turned up > the culprit: commit b7ff94df5628 (pixfmt-007.rst: use Sphin

The downside of math::

2016-10-19 Thread Jonathan Corbet
Hey, Mauro, So I was a little surprised to find that the htmldocs build now breaks on one of my machines due to a lack of LaTeX. A bit of digging turned up the culprit: commit b7ff94df5628 (pixfmt-007.rst: use Sphinx math:: expressions). The math:: directive uses LaTeX to process the math markup

Re: [PATCH v2 1/3] kernel-doc: better parsing of named variable arguments

2016-10-19 Thread Jani Nikula
On Wed, 19 Oct 2016, Silvio Fricke wrote: > Without this patch we get warnings for named variable arguments. > > warning: No description found for parameter '...' > warning: Excess function parameter 'args' description in > 'alloc_ordered_workqueue' > > Signed-off-by: Silvio Fricke kern

Re: [PATCH v2 3/3] Documentation/workqueue.txt: convert to ReST markup

2016-10-19 Thread Tejun Heo
On Wed, Oct 19, 2016 at 08:38:39PM +0200, Silvio Fricke wrote: > This patch add a "misc" documentation section and add the workqueue > documentation to this section. > > Signed-off-by: Silvio Fricke Looks good to me. How should these patches be routed? Should I take 2 and 3 through wq/for-4.10

[PATCH v2 2/3] workqueue: kerneldocify workqueue_attrs

2016-10-19 Thread Silvio Fricke
Only formating changes. Signed-off-by: Silvio Fricke --- include/linux/workqueue.h | 30 +- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/include/linux/workqueue.h b/include/linux/workqueue.h index fc6e221..afc1d46 100644 --- a/include/linux/workqueue

[PATCH v2 3/3] Documentation/workqueue.txt: convert to ReST markup

2016-10-19 Thread Silvio Fricke
This patch add a "misc" documentation section and add the workqueue documentation to this section. Signed-off-by: Silvio Fricke --- Documentation/index.rst | 1 +- Documentation/misc/conf.py | 5 +- Documentation/misc/index.rst | 17 ++- Documentation/workqueue.rst | 394 +++

[PATCH v2 0/3] workqueue documentation reformatted

2016-10-19 Thread Silvio Fricke
Hi, Thanks Jani for reviewing of my first attempt. v1 -> v2: * s/kernel-doc: $type_param takes care that this parameter is used for formatting too. * i/l/workqueue.h: inlining of documentation for workqueue_attrs struct members * D/workqueue.rst: Every author get a own :AUTHOR:-label * D/index.

[PATCH v2 1/3] kernel-doc: better parsing of named variable arguments

2016-10-19 Thread Silvio Fricke
Without this patch we get warnings for named variable arguments. warning: No description found for parameter '...' warning: Excess function parameter 'args' description in 'alloc_ordered_workqueue' Signed-off-by: Silvio Fricke --- scripts/kernel-doc | 8 ++-- 1 file changed, 6 inse

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

2016-10-19 Thread Jani Nikula
On Wed, 19 Oct 2016, Lu Baolu wrote: > Add Documentation/usb/usb3-debug-port.txt. This document includes > the user guide for USB3 debug port. If you're adding completely new files, please at least consider writing them in reStructuredText, so we can easily bolt them to the Sphinx build. Just a f

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

2016-10-19 Thread Peter Zijlstra
On Tue, Oct 18, 2016 at 05:15:01PM -0400, Daniel Micay wrote: > It's also worth noting that fine-grained control via a scoped mechanism > would likely only be used to implement *more restrictions* on Android, > not to make the feature less aggressive. > It's desirable for perf events to be disable

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

2016-10-19 Thread Mauro Carvalho Chehab
Em Tue, 18 Oct 2016 17:25:42 -0600 Jonathan Corbet escreveu: > 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

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

2016-10-19 Thread Peter Zijlstra
On Wed, Oct 19, 2016 at 07:26:02AM -0300, Arnaldo Carvalho de Melo wrote: > Em Wed, Oct 19, 2016 at 12:01:26PM +0200, Peter Zijlstra escreveu: > > On Tue, Oct 18, 2016 at 05:15:01PM -0400, Daniel Micay wrote: > > > It's also worth noting that fine-grained control via a scoped mechanism > > > would

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

2016-10-19 Thread atull
On Tue, 18 Oct 2016, Moritz Fischer wrote: > 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 > > + > > +MODULE_AUTHOR("Alan Tull

Re: sequence diagrams in rst documentation

2016-10-19 Thread Johannes Berg
On Tue, 2016-10-18 at 17:52 -0600, Jonathan Corbet wrote: > In summary, I think we can consider taking on a module if it's what > we need to do the docs right.  And if somebody agrees to maintain it! > :) :) I think for the ones that we carry, they're probably specific? > I've heard others say

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

2016-10-19 Thread Daniel Micay
On Wed, 2016-10-19 at 07:26 -0300, Arnaldo Carvalho de Melo wrote: > > But self profiling JITs would be useful for non-developers, on Android > (anywhere, really), and for that it would require being able to at > least, well, self profile, using sys_perf_event_open() by a normal > process, limited

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

2016-10-19 Thread Daniel Micay
On Wed, 2016-10-19 at 10:41 +0100, Mark Rutland wrote: > On Mon, Oct 17, 2016 at 10:54:33AM -0400, Daniel Micay wrote: > > On Mon, 2016-10-17 at 14:44 +0100, Mark Rutland wrote: > > > It's also my understanding that for Android, perf_event_paranoid > > > is > > > lowered when the user enables devel

Re: sequence diagrams in rst documentation

2016-10-19 Thread Jani Nikula
On Wed, 19 Oct 2016, Markus Heiser wrote: > Am 18.10.2016 um 16:52 schrieb Jani Nikula : > >>> *Only* adding the PNG would be awful, I'd have to keep track of the >>> corresponding source elsewhere, and perhaps couldn't even GPL it >>> because then I couldn't distribute the PNG without correspondi

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

2016-10-19 Thread Arnaldo Carvalho de Melo
Em Wed, Oct 19, 2016 at 12:01:26PM +0200, Peter Zijlstra escreveu: > On Tue, Oct 18, 2016 at 05:15:01PM -0400, Daniel Micay wrote: > > It's also worth noting that fine-grained control via a scoped mechanism > > would likely only be used to implement *more restrictions* on Android, > > not to make t

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

2016-10-19 Thread Mark Rutland
On Mon, Oct 17, 2016 at 10:54:33AM -0400, Daniel Micay wrote: > On Mon, 2016-10-17 at 14:44 +0100, Mark Rutland wrote: > > It's also my understanding that for Android, perf_event_paranoid is > > lowered when the user enables developer mode (rather than only when an > > external debugger is attached

[PATCH 1/2] hwmon: (mcp3021) rework for DT support

2016-10-19 Thread Clemens Gruber
Support setting the reference voltage from 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 also change S_IRUGO to the better readable 0444, which fixe

Re: sequence diagrams in rst documentation

2016-10-19 Thread Markus Heiser
Am 18.10.2016 um 16:52 schrieb Jani Nikula : >> *Only* adding the PNG would be awful, I'd have to keep track of the >> corresponding source elsewhere, and perhaps couldn't even GPL it >> because then I couldn't distribute the PNG without corresponding >> source... >> >> Adding the source text wo

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

2016-10-19 Thread Markus Heiser
Am 19.10.2016 um 01:25 schrieb 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 jus

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

2016-10-19 Thread Mark Rutland
On Tue, Oct 18, 2016 at 05:15:01PM -0400, Daniel Micay wrote: > It's also worth noting that fine-grained control via a scoped > mechanism would likely only be used to implement *more restrictions* > on Android, not to make the feature less aggressive. It's desirable > for perf events to be disabled

Re: [PATCH] Documentation/sphinx: rename kernel-doc.py to kerneldoc.py

2016-10-19 Thread Markus Heiser
Am 19.10.2016 um 12:44 schrieb Jani Nikula : > Python module names should not have hyphens per [PEP 8]. Drop the hyphen > from kernel-doc.py. The extension directive remains unchanged. > > [PEP 8] https://www.python.org/dev/peps/pep-0008/#package-and-module-names > > Reported-by: Markus Heiser

miss some documentation on https://www.kernel.org/doc/

2016-10-19 Thread Markus Heiser
Hi kernel.org maintainers, sorry for my silly question: I miss the documentation of the reST (sphinx) content [1] on https://www.kernel.org/doc/ Since the DocBook files migrated to reST (sphinx) increase the "htmldocs" at [3] are decreasing. I suppose you build HTML of the DocBook content of [3]

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

2016-10-19 Thread Mauro Carvalho Chehab
Em Wed, 19 Oct 2016 06:58:12 +0200 Markus Heiser escreveu: > just a small suggestion of mine > > .. CONTENTS > > - Overview. > - Configuring module signing. > - Generating signing keys. > - Public keys in the kernel. > - Manually signing modules. > - Signed modules and strippi

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

2016-10-19 Thread Markus Heiser
Am 19.10.2016 um 11:33 schrieb Mauro Carvalho Chehab : > Em Wed, 19 Oct 2016 06:58:12 +0200 > Markus Heiser escreveu: > >> just a small suggestion of mine >> >> .. CONTENTS >> >> - Overview. >> - Configuring module signing. >> - Generating signing keys. >> - Public keys in the kernel

[PATCH] Documentation/sphinx: rename kernel-doc.py to kerneldoc.py

2016-10-19 Thread Jani Nikula
Python module names should not have hyphens per [PEP 8]. Drop the hyphen from kernel-doc.py. The extension directive remains unchanged. [PEP 8] https://www.python.org/dev/peps/pep-0008/#package-and-module-names Reported-by: Markus Heiser Signed-off-by: Jani Nikula --- Documentation/conf.py