Re: [RFC PATCH v1 2/6] kernel-doc: replace kernel-doc perl parser with a pure python one (WIP)

2017-01-24 Thread Markus Heiser
Hi Jon, hi Daniel ! Am 25.01.2017 um 07:37 schrieb Daniel Vetter : >> Again, quick comments... >> >> - I would *much* rather evolve our existing Sphinx extension in the >> direction we want it to go than to just replace it wholesale. >> Replacement is the wrong approach for a few reasons, in

Re: [RFC PATCH v1 3/6] kernel-doc: add kerneldoc-lint command

2017-01-24 Thread Daniel Vetter
On Tue, Jan 24, 2017 at 08:52:41PM +0100, Markus Heiser wrote: > this patch adds a command to lint kernel-doc comments.:: > > scripts/kerneldoc-lint --help > > The lint check include (only) kernel-doc rules described at [1]. It > does not check against reST (sphinx-doc) markup used in the kerne

Re: [RFC PATCH v1 2/6] kernel-doc: replace kernel-doc perl parser with a pure python one (WIP)

2017-01-24 Thread Daniel Vetter
On Tue, Jan 24, 2017 at 05:13:14PM -0700, Jonathan Corbet wrote: > On Tue, 24 Jan 2017 20:52:40 +0100 > Markus Heiser wrote: > > > This patch is the initial merge of a pure python implementation > > to parse kernel-doc comments and generate reST from. > > > > It consist mainly of to parts, the p

Re: [PATCH 31/37] misc: Add host side pci driver for pci test function device

2017-01-24 Thread Kishon Vijay Abraham I
Hi, On Tuesday 24 January 2017 09:32 PM, Christoph Hellwig wrote: > On Thu, Jan 12, 2017 at 03:56:20PM +0530, Kishon Vijay Abraham I wrote: >> Add PCI endpoint test driver that can verify base address >> register, legacy interrupt/MSI interrupt and read/write/copy >> buffers between host and devic

[PATCH v2 3/3] docs/zh_CN: Add coding-style into docs build system

2017-01-24 Thread Andy Deng
Tested by the command: make htmldocs During the compiling process, zh_CN/coding-style.rst has no errors and warnings generated, the generated html document has been checked. Signed-off-by: Andy Deng --- Documentation/index.rst | 10 +- .../trans

[PATCH v2 1/3] zh_CN/CodingStyle: improve translation

2017-01-24 Thread Andy Deng
Some of the sentences in Chapters 19 and 20 are re-translated: - Fixed translation errors in Section 2 of Chapter 19 to prevent misleading readers; - Retranslate some sentences to make the translation more clear and accurate. Signed-off-by: Andy Deng --- Documentation/translations/zh_CN/Cod

Re: [PATCH 1/2] zh_CN/CodingStyle: Convert to ReST markup

2017-01-24 Thread Andy Deng
2017-01-25 7:57 GMT+08:00 Jonathan Corbet : > > On Wed, 25 Jan 2017 07:54:21 +0800 > Andy Deng wrote: > > > This commit applies all changes from the English version, and should > > be able to work with documentation build system. > > > > Also fixed some translation errors. > > So I approve of all

Re: [RFC PATCH v1 2/6] kernel-doc: replace kernel-doc perl parser with a pure python one (WIP)

2017-01-24 Thread Jonathan Corbet
On Tue, 24 Jan 2017 20:52:40 +0100 Markus Heiser wrote: > This patch is the initial merge of a pure python implementation > to parse kernel-doc comments and generate reST from. > > It consist mainly of to parts, the parser module (kerneldoc.py) and the > sphinx-doc extension (rstKernelDoc.py). F

Re: [PATCH 1/2] zh_CN/CodingStyle: Convert to ReST markup

2017-01-24 Thread Jonathan Corbet
On Wed, 25 Jan 2017 07:54:21 +0800 Andy Deng wrote: > This commit applies all changes from the English version, and should > be able to work with documentation build system. > > Also fixed some translation errors. So I approve of all of this, to the extent that I can understand it. But can we

[PATCH 2/2] zh_CN/coding-style: Add coding-style into docs build system

2017-01-24 Thread Andy Deng
Tested by the command: make htmldocs During the compiling process, some rendering issues were found and fixed, most of which were due to Chinese characters leading to a syntax failure, such as `` ``, ** **. I have not tested to generate pdf format, but html documents have been checked. Sign

Re: [PATCH] kernel-doc: Handle returning pointers to pointers

2017-01-24 Thread Markus Heiser
Am 24.01.2017 um 16:35 schrieb Matthew Wilcox : > From: Markus Heiser [mailto:markus.hei...@darmarit.de] >> Am 23.01.2017 um 16:24 schrieb Jonathan Corbet : >>> Markus, would you consider sending out a new patch set for review? >> >> Yes, I send RFC soon ... > > Could I ask for some features?

[RFC PATCH v1 4/6] kernel-doc: insert TODOs on kernel-doc errors

2017-01-24 Thread Markus Heiser
The rstKernelDoc.py sphinx-extensions inserts '.. todo::' on errors. With this patch sphinx.ext.todo extension [1] is activated. This is similar to what we know from DocBook's *Oops* functionality of the kernel-doc perl script [2]. I added this functionality (only) to the subproject, to left the m

[RFC PATCH v1 3/6] kernel-doc: add kerneldoc-lint command

2017-01-24 Thread Markus Heiser
this patch adds a command to lint kernel-doc comments.:: scripts/kerneldoc-lint --help The lint check include (only) kernel-doc rules described at [1]. It does not check against reST (sphinx-doc) markup used in the kernel-doc comments. Since reST markups could include depencies to the build- c

[RFC PATCH v1 1/6] kernel-doc: pure python kernel-doc parser (preparation)

2017-01-24 Thread Markus Heiser
This is the first patch of a series which merges a pure python implementation of the kernel-doc parser. It adds the prerequisites which are needed by the pure python implementation (which comes later in the series). The fspath module in this patch is a reduced implementation of pypi's fspath [1].

[RFC PATCH v1 5/6] kernel-doc: add kerneldoc-src2rst command

2017-01-24 Thread Markus Heiser
this patch adds a command to auto-generate documentation from kernel's source tree.:: scripts/kerneldoc-src2rst --help E.g. to autodoc the kernel's ./include folder use:: scripts/kerneldoc-src2rst ./include /tmp/test123 >From the resulting reST-doctree you can build HTML rendered output lik

[RFC PATCH v1 6/6] kernel-doc: add man page builder (target mandocs)

2017-01-24 Thread Markus Heiser
This patch brings man page build we already know from the DocBook toolchain. It adds a sphinx extension 'manKernelDoc' which consists of: * '.. kernel-doc-man::' : directive implemented in class KernelDocMan * 'kernel_doc_man' : *invisible* node * 'kernel-doc-man' : an alternative man bu

[RFC PATCH v1 0/6] pure python kernel-doc parser and more

2017-01-24 Thread Markus Heiser
Hi Jon, here is my RFC, replacing the kernel-doc parser perl script with a python implementation. The parser is implemented as module and is used by several kernel-doc applications: * kerneldoc : the parser * kerneldoc-lint: liniting * kerneldoc-src2rst : autodoc source tree * manKern

[PATCH v2] pci: drop link_reset

2017-01-24 Thread Michael S. Tsirkin
No hardware seems to actually call link_reset, and no driver implements it as more than a nop stub. This drops the mentions of the callback from everywhere. It's dropped from the documentation as well, but the doc really needs to be updated to reflect reality better (e.g. on pcie slot reset is the

Re: [PATCH 31/37] misc: Add host side pci driver for pci test function device

2017-01-24 Thread Christoph Hellwig
On Thu, Jan 12, 2017 at 03:56:20PM +0530, Kishon Vijay Abraham I wrote: > Add PCI endpoint test driver that can verify base address > register, legacy interrupt/MSI interrupt and read/write/copy > buffers between host and device. The corresponding pci-epf-test > function driver should be used on th

RE: [PATCH] kernel-doc: Handle returning pointers to pointers

2017-01-24 Thread Matthew Wilcox
From: Markus Heiser [mailto:markus.hei...@darmarit.de] > Am 23.01.2017 um 16:24 schrieb Jonathan Corbet : > > Markus, would you consider sending out a new patch set for review? > > Yes, I send RFC soon ... Could I ask for some features? I'd've been trying to add them to the perl script, but sin

Re: [PATCH v3 2/5] arm64: Work around Falkor erratum 1003

2017-01-24 Thread Christopher Covington
Hi Catalin, On 01/11/2017 01:06 PM, Catalin Marinas wrote: > Some minor comments below, nothing fundamental (as long as you say the > new sequence doesn't have the speculative TLB load problem I mentioned > on a previous version). This workaround is documented as providing functional correctness

Re: [PATCH] pci: drop link_reset

2017-01-24 Thread Michael S. Tsirkin
On Wed, Jan 18, 2017 at 07:19:48PM -0500, Doug Ledford wrote: > On Wed, 2017-01-18 at 23:39 +0200, Michael S. Tsirkin wrote: > > No hardware seems to actually call link_reset, and > > no driver implements it as more than a nop stub. > > > > This drops the mentions of the callback from everywhere.

Re: [PATCH v3 2/5] arm64: Work around Falkor erratum 1003

2017-01-24 Thread Christopher Covington
On 01/12/2017 11:12 AM, Mark Rutland wrote: > On Thu, Jan 12, 2017 at 03:45:48PM +, Catalin Marinas wrote: >> On Wed, Jan 11, 2017 at 06:40:52PM +, Mark Rutland wrote: > >>> Likewise, I beleive we may need to modify cpu_set_reserved_ttbr0(). >> >> This may be fine if my assumptions about t

[PATCH] [linux-next] Doc: Fix double words in Documentation

2017-01-24 Thread Masanari Iida
This patch fix some double words found in Documentation. Signed-off-by: Masanari Iida --- Documentation/block/pr.txt | 2 +- Documentation/ioctl/botching-up-ioctls.txt | 2 +- Documentation/livepatch/livepatch.txt | 2 +- Documentation/networking/kcm.txt | 2 +- Do