Re: [PATCH 0/3] Add the Documentation/ABI to the admin-guide

2016-10-31 Thread Jani Nikula
On Fri, 28 Oct 2016, Mauro Carvalho Chehab wrote: > This patch series fix a few issues on some ABI files that violate what's > written at Documentation/ABI/README, and add a parser, using > kernel-cmd, to produce an ABI book. A parsed version of it can be found at: > > https://mchehab.fedora

Re: [PATCH 0/3] Add the Documentation/ABI to the admin-guide

2016-10-31 Thread Mauro Carvalho Chehab
Em Mon, 31 Oct 2016 10:24:36 +0200 Jani Nikula escreveu: > On Fri, 28 Oct 2016, Mauro Carvalho Chehab wrote: > > This patch series fix a few issues on some ABI files that violate what's > > written at Documentation/ABI/README, and add a parser, using > > kernel-cmd, to produce an ABI book. A par

Kernel documentation discussions

2016-10-31 Thread Mauro Carvalho Chehab
Hi Jon, As I wake up too early today, due to the time zone differences, and inspired by your article about documentation at lwn (https://lwn.net/Articles/704613/), I decided to take some time and do some brain storming to help with the KS discussions. Feel free to pick the good things here, and d

Re: Was: Re: [PATCH 0/4] reST-directive kernel-cmd / include contentent from scripts

2016-10-31 Thread Markus Heiser
Am 28.10.2016 um 14:37 schrieb Mauro Carvalho Chehab : > On a separate matter: any news with regards to the man pages > Sphinx extension? I have one extension active in my POC: https://h2626237.stratoserver.net/kernel/ follow the "man" links. There you will also find my efforts in pdf and th

[PATCH 1/2] swiotlb: Rate-limit printing when running out of SW-IOMMU space

2016-10-31 Thread Geert Uytterhoeven
If the system runs out of SW-IOMMU space, changes are high successive requests will fail, too, flooding the kernel log. This is true especially for streaming DMA, which is typically used repeatedly outside the driver's initialization routine. Add rate-limiting to fix this. While at it, get rid o

[PATCH 2/2] swiotlb: Add swiotlb=nobounce debug option

2016-10-31 Thread Geert Uytterhoeven
On architectures like arm64, swiotlb is tied intimately to the core architecture DMA support. In addition, ZONE_DMA cannot be disabled. To aid debugging and catch devices not supporting DMA to memory outside the 32-bit address space, add a kernel command line option "swiotlb=nobounce", which disab

[PATCH 0/2] swiotlb: Rate-limit printing and 64-bit memory debugging

2016-10-31 Thread Geert Uytterhoeven
Hi Konrad, Jon, This patch series contains two improvements for the SWIOTLB subsystem. The first patch adds rate-limiting to an error message, to avoid flooding the kernel log. The second patch adds a kernel command line option to aid debugging when developing support for DMA to memory ou

Re: [PATCH 1/2] swiotlb: Rate-limit printing when running out of SW-IOMMU space

2016-10-31 Thread Sergei Shtylyov
On 10/31/2016 06:45 PM, Geert Uytterhoeven wrote: If the system runs out of SW-IOMMU space, changes are high successive s/changes/chances/? requests will fail, too, flooding the kernel log. This is true especially for streaming DMA, which is typically used repeatedly outside the driver's

Re: [PATCH 2/2] swiotlb: Add swiotlb=nobounce debug option

2016-10-31 Thread Robin Murphy
Hi Geert, On 31/10/16 15:45, Geert Uytterhoeven wrote: > On architectures like arm64, swiotlb is tied intimately to the core > architecture DMA support. In addition, ZONE_DMA cannot be disabled. To be fair, that only takes a single-character change in arch/arm64/Kconfig - in fact, I'm amused to s

Re: [PATCH 2/2] swiotlb: Add swiotlb=nobounce debug option

2016-10-31 Thread Konrad Rzeszutek Wilk
On Mon, Oct 31, 2016 at 04:45:04PM +0100, Geert Uytterhoeven wrote: > On architectures like arm64, swiotlb is tied intimately to the core > architecture DMA support. In addition, ZONE_DMA cannot be disabled. > > To aid debugging and catch devices not supporting DMA to memory outside > the 32-bit a

Re: [PATCH 2/2] swiotlb: Add swiotlb=nobounce debug option

2016-10-31 Thread Geert Uytterhoeven
Hi Robin, On Mon, Oct 31, 2016 at 6:41 PM, Robin Murphy wrote: > On 31/10/16 15:45, Geert Uytterhoeven wrote: >> On architectures like arm64, swiotlb is tied intimately to the core >> architecture DMA support. In addition, ZONE_DMA cannot be disabled. > > To be fair, that only takes a single-char

make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Jim Davis
Running make pdfdocs on a Ubuntu 16.04 system fails with Makefile:58: recipe for target 'media.pdf' failed make[2]: *** [media.pdf] Error 1 Documentation/Makefile.sphinx:79: recipe for target 'pdfdocs' failed make[1]: *** [pdfdocs] Error 2 Makefile:1442: recipe for target 'pdfdocs' failed make: **

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Jonathan Corbet
On Mon, 31 Oct 2016 11:51:20 -0700 Jim Davis wrote: > Running make pdfdocs on a Ubuntu 16.04 system fails with > > Makefile:58: recipe for target 'media.pdf' failed > make[2]: *** [media.pdf] Error 1 > Documentation/Makefile.sphinx:79: recipe for target 'pdfdocs' failed > make[1]: *** [pdfdocs]

make psdocs fails with v4.9-rc3

2016-10-31 Thread Jim Davis
Running make psdocs on a Ubuntu 16.04 system fails with Documentation/DocBook/Makefile:142: recipe for target 'Documentation/DocBook/kernel-hacking.ps' failed make[1]: *** [Documentation/DocBook/kernel-hacking.ps] Error 9 Makefile:1442: recipe for target 'psdocs' failed make: *** [psdocs] Error 2

make cleandocs missing files with v4.9-rc3

2016-10-31 Thread Jim Davis
On my Ubuntu 16.04 system, make htmldocs works just fine (hurrah!) but make cleandocs misses a fair number of files: HTMLDocumentation/DocBook/index.html jim@krebstar:~/linux-rc$ make cleandocs jim@krebstar:~/linux-rc$ git status HEAD detached at v4.9-rc3 nothing to commit, working directory

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Mauro Carvalho Chehab
Em Mon, 31 Oct 2016 13:15:24 -0600 Jonathan Corbet escreveu: > On Mon, 31 Oct 2016 11:51:20 -0700 > Jim Davis wrote: > > > Running make pdfdocs on a Ubuntu 16.04 system fails with > > > > Makefile:58: recipe for target 'media.pdf' failed > > make[2]: *** [media.pdf] Error 1 > > Documentation/M

[PATCH v2 03/12] ko_KR/HOWTO: Fix subtitles style

2016-10-31 Thread SeongJae Park
This commit fixes subtitles style. It aligns them with their header, adjust blank lines between them properly. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 17 - 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/Documentation/ko_KR/HOWTO b/Documentati

[PATCH v2 08/12] ko_KR/HOWTO: Improve some markups to make it visually better

2016-10-31 Thread SeongJae Park
This commit applies commit 34fed7e7e0e5 ("Documentation/HOWTO: improve some markups to make it visually better") to Korean translation. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 16 ++-- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/Documentation/k

[PATCH v2 04/12] ko_KR/HOWTO: Update obsolete link to bugzilla faq

2016-10-31 Thread SeongJae Park
Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/ko_KR/HOWTO b/Documentation/ko_KR/HOWTO index 1a5d7a8d66be..f3348ef68bbd 100644 --- a/Documentation/ko_KR/HOWTO +++ b/Documentation/ko_KR/HOWTO @@ -325,7 +3

[PATCH v2 10/12] ko_KR/HOWTO: Clean up bare :: lines

2016-10-31 Thread SeongJae Park
This commit applies commit 1b49ecf2f3be ("docs: Clean up bare :: lines") to Korean translation. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 12 +++- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/Documentation/ko_KR/HOWTO b/Documentation/ko_KR/HOWTO index

[PATCH v2 09/12] ko_KR/HOWTO: Adjust external link references

2016-10-31 Thread SeongJae Park
This commit appplies commit f1eebe92c265 ("Documentation/HOWTO: adjust external link references") to Korean translation. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 39 ++- 1 file changed, 18 insertions(+), 21 deletions(-) diff --git a/Docume

[PATCH v2 12/12] ko_KR/HOWTO: Mark subsection in suggested format

2016-10-31 Thread SeongJae Park
`Specific guidelines for the kernel documentation` section of `kernel-documentation.rst` suggests to use ``~`` for subsection but subsections in HOWTO is not marked in the format. This commit marks them in the format. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 12

[PATCH v2 07/12] ko_KR/HOWTO: Update information about generating documentation

2016-10-31 Thread SeongJae Park
This commit applies commit 43fb67a5258c ("Documentation/HOWTO: update information about generating documentation") to Korean translation. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 30 ++ 1 file changed, 22 insertions(+), 8 deletions(-) diff --git a

[PATCH v2 11/12] ko_KR/HOWTO: Add whitespace between URL and text

2016-10-31 Thread SeongJae Park
Because few sentences has no whitespace between URL and text, few document viewers fail to properly parse the URL from it. This commit adds whitespace between them to fix the problem. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 6 +++--- 1 file changed, 3 insertions(+), 3 delet

[PATCH v2 05/12] ko_KR/HOWTO: Convert to ReST notation

2016-10-31 Thread SeongJae Park
This commit applies commit 022e04d6f555 ("Documentation/HOWTO: convert to ReST notation") to Korean translation and fix a trivial ReST build failure problem. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 55 --- 1 file changed, 52 insert

[PATCH v2 00/12] Fix and update HOWTO Korean translation

2016-10-31 Thread SeongJae Park
This patchset applies ReST conversion effort for HOWTO document to its Korean translation. It also contains fixup of trivial nitpicks in the document and the translation. Changes from v1: - Rebased on next-20161028 The base version contains commit 186128f75392 ("docs-rst: add documents to dev

[PATCH v2 06/12] ko_KR/HOWTO: Add cross-references to other documents

2016-10-31 Thread SeongJae Park
This commit applies commit 609d99a3b72e ("Documentation/HOWTO: add cross-references to other documents") to Korean translation. Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 19 +-- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/Documentation/ko_KR/

[PATCH v2 01/12] Documentation/process/howto: Mark subsection in suggested format

2016-10-31 Thread SeongJae Park
`Specific guidelines for the kernel documentation` section of `kernel-documentation.rst` suggests to use ``~`` for subsection but subsections in HOWTO is not marked in the format. This commit marks them in the format. Signed-off-by: SeongJae Park --- Documentation/process/howto.rst | 15 +++

[PATCH v2 02/12] ko_KR/HOWTO: Fix a typo: s/Linux Torvalds/Linus Torvalds

2016-10-31 Thread SeongJae Park
Signed-off-by: SeongJae Park --- Documentation/ko_KR/HOWTO | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/ko_KR/HOWTO b/Documentation/ko_KR/HOWTO index 025252731af5..4f5778dfeed2 100644 --- a/Documentation/ko_KR/HOWTO +++ b/Documentation/ko_KR/HOWTO @@ -231,7 +2

[PATCH] Documentation/sphinx: prevent generation of .pyc files in the source tree

2016-10-31 Thread Jani Nikula
Use PYTHONDONTWRITEBYTECODE=1 to prevent python from creating .pyc files in the source tree. Python 3.2 has a __pycache__ scheme [1], but before that the only alternative seems to be to copy the source files to the build tree to ensure the .pyc files are created there too. Just prevent .pyc file ge

Re: make cleandocs missing files with v4.9-rc3

2016-10-31 Thread Jani Nikula
On Mon, 31 Oct 2016, Jim Davis wrote: > On my Ubuntu 16.04 system, make htmldocs works just fine (hurrah!) but > make cleandocs misses a fair number of files: > > HTMLDocumentation/DocBook/index.html > jim@krebstar:~/linux-rc$ make cleandocs > jim@krebstar:~/linux-rc$ git status > HEAD detac

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Mauro Carvalho Chehab
Em Mon, 31 Oct 2016 14:17:59 -0600 Mauro Carvalho Chehab escreveu: > Em Mon, 31 Oct 2016 13:15:24 -0600 > Jonathan Corbet escreveu: > > > On Mon, 31 Oct 2016 11:51:20 -0700 > > Jim Davis wrote: > > > > > Running make pdfdocs on a Ubuntu 16.04 system fails with > > > > > > Makefile:58: reci

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Jim Davis
On Mon, Oct 31, 2016 at 1:58 PM, Mauro Carvalho Chehab wrote: > Em Mon, 31 Oct 2016 14:17:59 -0600 > Mauro Carvalho Chehab escreveu: > >> Em Mon, 31 Oct 2016 13:15:24 -0600 >> Jonathan Corbet escreveu: >> >> > On Mon, 31 Oct 2016 11:51:20 -0700 >> > Jim Davis wrote: >> > >> > > Running make pdf

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Mauro Carvalho Chehab
Em Mon, 31 Oct 2016 15:04:42 -0700 Jim Davis escreveu: > On Mon, Oct 31, 2016 at 1:58 PM, Mauro Carvalho Chehab > wrote: > > Em Mon, 31 Oct 2016 14:17:59 -0600 > > Mauro Carvalho Chehab escreveu: > > > >> Em Mon, 31 Oct 2016 13:15:24 -0600 > >> Jonathan Corbet escreveu: > >> > >> > On Mon,

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Mauro Carvalho Chehab
Em Mon, 31 Oct 2016 16:40:02 -0600 Mauro Carvalho Chehab escreveu: > Em Mon, 31 Oct 2016 15:04:42 -0700 > Jim Davis escreveu: > > > On Mon, Oct 31, 2016 at 1:58 PM, Mauro Carvalho Chehab > > wrote: > > > Em Mon, 31 Oct 2016 14:17:59 -0600 > > > Mauro Carvalho Chehab escreveu: > > > > > >> E

Re: make pdfdocs fails with v4.9-rc3

2016-10-31 Thread Mauro Carvalho Chehab
Em Mon, 31 Oct 2016 16:41:48 -0600 Mauro Carvalho Chehab escreveu: > Em Mon, 31 Oct 2016 16:40:02 -0600 > Mauro Carvalho Chehab escreveu: > > > Em Mon, 31 Oct 2016 15:04:42 -0700 > > Jim Davis escreveu: > > > > > On Mon, Oct 31, 2016 at 1:58 PM, Mauro Carvalho Chehab > > > wrote: > > > > Em

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

2016-10-31 Thread Lu Baolu
Add Documentation/usb/usb3-debug-port.rst. 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.rst | 95 +++ 1 file changed, 95 insertions(+) create mode 100644 Doc