Re: [PATCH 1/2] memory-barriers.txt: Fix broken link to atomic_ops.txt

2017-07-12 Thread Jonathan Corbet
On Fri, 7 Jul 2017 03:21:17 +0900 SeongJae Park wrote: > Few obsolete links to atomic_ops.txt exist in memory-barriers.txt though > the file has moved to core-api/atomic_ops.rst. This commit fixes the > obsolete links. Both have been applied, thanks. jon -- To

[PATCH] docs: Do not include from kernel/rcu/srcu.c

2017-07-04 Thread Jonathan Corbet
That file went away with commit bd8cc5a062f4 (srcu: Remove Classic SRCU) during the 4.13 merge window, leading to errors like: Error: Cannot open file ./kernel/rcu/srcu.c during the docs build. Reported-by: Linus Torvalds <torva...@linux-foundation.org> Signed-off-by: Jonathan Corbe

Re: [PULL] Docs for 4.13

2017-07-04 Thread Jonathan Corbet
On Mon, 3 Jul 2017 21:32:33 -0700 Linus Torvalds wrote: > Eg things like > > Error: Cannot open file ./kernel/rcu/srcu.c > Error: Cannot open file ./kernel/rcu/srcu.c > > happen simply because that file no longer exists, and the docs never > got updated. > >

[PULL] Docs for 4.13

2017-07-03 Thread Jonathan Corbet
(1): scripts/kernel-doc: handle DECLARE_HASHTABLE Jonathan Corbet (7): Merge tag 'v4.12-rc1' into docs-next docs: Fix some formatting issues in request-key.rst Merge remote-tracking branch 'mauro-exp/docbook3' into death-to-docbook Docs: Include the Latex "i

Re: [PATCH] scripts/kernel-doc: handle DECLARE_HASHTABLE

2017-07-03 Thread Jonathan Corbet
On Sat, 1 Jul 2017 12:11:03 -0700 Jakub Kicinski wrote: > > That was my question as well...as Andrew would ask: what are the > > user-visible effects of this problem? > > The commit which made me write the patch is sitting in Dave Miller's > net-next tree: > >

Re: [PATCH 0/5] Make PDF builds work again

2017-07-03 Thread Jonathan Corbet
On Mon, 3 Jul 2017 10:25:38 +0200 Daniel Vetter wrote: > Only now stumbled over the full thread, but the drm patch is already > queued up for at least 4.13 (Dave was out and all that). I guess we could > try to cherry-pick through stable. I kind of gave up on the 4.12 goal, at

Re: [PATCH] scripts/kernel-doc: handle DECLARE_HASHTABLE

2017-07-01 Thread Jonathan Corbet
On Sat, 1 Jul 2017 17:42:46 +0200 Markus Heiser wrote: > did you have an example for me, where it takes effect? / Thanks! > > I run kernel-doc against the whole tree, but I can't find any change > in the generated reST and I have a doubt for what DECLARE_BITMAP is >

Re: [PATCH] Documentation: fix wrong example command

2017-06-29 Thread Jonathan Corbet
On Thu, 29 Jun 2017 18:36:35 +0200 Matteo Croce wrote: > Signed-off-by: Matteo Croce > --- > Documentation/networking/ipvlan.txt | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/networking/ipvlan.txt >

Re: [PATCH v2 12/29] kselftest.rst: do some adjustments after ReST conversion

2017-06-25 Thread Jonathan Corbet
On Fri, 23 Jun 2017 18:47:51 -0600 Shuah Khan <sh...@kernel.org> wrote: > Please let me know if you want me to take this through linux-kselftest > In which case, Ack the patch. If not, you already have my Ack. Go ahead and take it if you want: Acked-by: Jonathan Corbet <

Re: [PATCH] Documentation: atomic_ops.txt is core-api/atomic_ops.rst

2017-06-23 Thread Jonathan Corbet
On Fri, 23 Jun 2017 13:25:22 -0700 Palmer Dabbelt wrote: > I was reading the memory barries documentation in order to make sure the > RISC-V barries were correct, and I found a broken link to the atomic > operations documentation. This looks good to me, but can you resend

Re: [PATCH v2 00/53] Get rid of Docbook

2017-06-23 Thread Jonathan Corbet
0:00:00 2001 From: Jonathan Corbet <cor...@lwn.net> Date: Fri, 23 Jun 2017 14:17:38 -0600 Subject: [PATCH] Docs: clean up some DocBook loose ends There were a few bits and pieces left over from the now-disused DocBook toolchain; git rid of them. Reported-by: Markus Heiser <markus.hei...@da

Re: [PATCH] Make the main documentation title less Geocities

2017-06-23 Thread Jonathan Corbet
On Tue, 6 Jun 2017 16:50:04 -0400 Konstantin Ryabitsev wrote: > This is probably the lamest patch ever, but then again "Welcome to The > Linux Kernel's documentation" is nearly equally lame. Really, we don't > need to "Welcome" people to the documentation, just

Re: [PATCH 2/5] Docs: Remove redundant geometry package inclusion

2017-06-23 Thread Jonathan Corbet
On Mon, 19 Jun 2017 07:49:06 -0300 Mauro Carvalho Chehab wrote: > There's a catch, though: as sphinxsetup hmargin/vmargin was added > only on Sphinx version 1.5.3, the enclosed patch won't adjust the > margins for versions 1.5.0 to 1.5.2. While I didn't test, I bet it >

Re: [PATCH] doc/kokr/howto: Only send regression fixes after -rc1

2017-06-22 Thread Jonathan Corbet
On Fri, 16 Jun 2017 20:34:32 +0900 SeongJae Park wrote: > This commit applies commit 388f9b20f98d ("Documentation/process/howto: > Only send regression fixes after -rc1") to Korean translation. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send

Re: [PATCH] docs-rst: fix broken links to dynamic-debug-howto in kernel-parameters

2017-06-22 Thread Jonathan Corbet
On Wed, 14 Jun 2017 12:24:12 +0200 Steffen Maier wrote: > Another place in lib/Kconfig.debug was already fixed in commit f8998c226587 > ("lib/Kconfig.debug: correct documentation paths"). Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the

Re: [PATCH] doc: Document suitability of IBM Verse for kernel development

2017-06-22 Thread Jonathan Corbet
On Mon, 19 Jun 2017 15:31:22 +1000 Stewart Smith wrote: > IBM Verse is a web UI around Lotus Domino mail servers (much like > the Lotus Notes client talks to Domino servers). > > For various reasons, it is not at all suitable for kernel development, > all of which

Re: [PATCH] docs: add virtualenv to Documentation's build chain

2017-06-20 Thread Jonathan Corbet
On Tue, 20 Jun 2017 16:51:40 +0200 Markus Heiser wrote: > This add a virtualenv [1] with we can control the versions > of Documentation's (python) requirements. It also changes the > default behavior, if sphinx is not installed on the OS. > > If Sphinx is not

Re: [PATCH] changes.rst: explain the usage of virtual environment

2017-06-19 Thread Jonathan Corbet
On Mon, 19 Jun 2017 06:08:37 -0700 Christoph Hellwig wrote: > On Mon, Jun 19, 2017 at 08:24:10AM -0300, Mauro Carvalho Chehab wrote: > > As the Sphinx build seems very fragile, specially for > > PDF output, add a notice about how to use it on a virtual > > environment. > >

Re: [PATCH 0/5] Make PDF builds work again

2017-06-18 Thread Jonathan Corbet
On Sun, 18 Jun 2017 17:46:25 -0600 Jonathan Corbet <cor...@lwn.net> wrote: > In general, I'm dismayed by the fragility of the whole thing. I'm also a > little concerned that nobody except Jim complained about the problem. Jim, I just realized I neglected Reported-by

[PATCH 5/5] DRM: Fix an incorrectly formatted table

2017-06-18 Thread Jonathan Corbet
aniel Vetter <daniel.vet...@ffwll.ch> Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- include/drm/bridge/dw_hdmi.h | 70 ++-- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/include/drm/bridge/dw_hdmi.h b/include/drm/bridge/d

[PATCH 4/5] Docs: Use kernel-figure in vidioc-g-selection.rst

2017-06-18 Thread Jonathan Corbet
...otherwise the PDF build fails when it can't find constraints.pdf. CC: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- Documentation/media/uapi/v4l/vidioc-g-selection.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)

[PATCH 3/5] Docs: fix table problems in ras.rst

2017-06-18 Thread Jonathan Corbet
. The HTML build is forgiving of such things, but PDF is not. Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- Documentation/admin-guide/ras.rst | 10 +- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Document

[PATCH 0/5] Make PDF builds work again

2017-06-18 Thread Jonathan Corbet
PDF output anymore? In the absence of a concerted effort on somebody's part, I predict that PDF building will be broken much of the time. I have to wonder if it's worth it... Jonathan Corbet (5): Docs: Include the Latex "ifthen" package Docs: Remove redundant geometry package inclus

[PATCH 2/5] Docs: Remove redundant geometry package inclusion

2017-06-18 Thread Jonathan Corbet
figure out a better way. Fixes: 85c21e5c3ee74fb75d690c57f7066bae7e2dca55 Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- Documentation/conf.py | 2 -- 1 file changed, 2 deletions(-) diff --git a/Documentation/conf.py b/Docum

[PATCH 1/5] Docs: Include the Latex "ifthen" package

2017-06-18 Thread Jonathan Corbet
Otherwise we get PDF build failures when LaTeX refused to acknowledge the existence of \ifthenelse Fixes: 41cff161fe99d1c6a773becc2250a1dc3ac035ff Cc: Mauro Carvalho Chehab <mche...@kernel.org> Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- Documentation/conf.py | 1 + 1 fil

Re: [PATCH] Fixed a little typo

2017-06-05 Thread Jonathan Corbet
On Thu, 18 May 2017 14:32:57 -0400 Ayan Shafqat wrote: > --- > Documentation/process/coding-style.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/process/coding-style.rst > b/Documentation/process/coding-style.rst >

Re: [PATCH] docs: driver-api: i2c: remove some outdated information

2017-06-05 Thread Jonathan Corbet
On Tue, 23 May 2017 15:46:54 +0200 Wolfram Sang wrote: > a) Linux can be an I2C slave meanwhile > b) all drivers except one use the driver model currently > > Update the documentation. I wasn't sure if you wanted me to apply this one or not...I don't see it in linux-next,

Re: [PATCH] Documentation: DMA API: fix a typo in a function name

2017-06-05 Thread Jonathan Corbet
On Sat, 27 May 2017 20:52:43 +0200 Wolfram Sang wrote: > Correct the typo, the wrongly typed function does not exist. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to

Re: [PATCH] doc/ko_KR/memory-barriers: Update control-dependencies example

2017-06-05 Thread Jonathan Corbet
On Thu, 1 Jun 2017 13:21:02 +0900 SeongJae Park wrote: > This commit applies upstream change, commit b26cfc48e3e0 ("doc: Update > control-dependencies section of memory-barriers.txt"), to Korean > translation. I've applied this to the docs tree, thanks. jon -- To

Re: Clarify documentation license?

2017-05-19 Thread Jonathan Corbet
On Thu, 18 May 2017 17:15:17 -0400 Konstantin Ryabitsev wrote: > Would it be fair to say documentation is "GNU GPLv2 unless otherwise > indicated?" And if that's not the case (because I'm not sure GPLv2 is a > sane license for documentation), would it make sense

Re: [PATCH] Documentation, kbuild: fix typo "minimun" -> "minimum"

2017-05-18 Thread Jonathan Corbet
On Thu, 18 May 2017 14:17:29 +0200 Tobias Klauser wrote: > Documentation/kbuild/makefiles.txt | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/kbuild/makefiles.txt > b/Documentation/kbuild/makefiles.txt > index

Re: [PATCH 00/17] convert/reorganize Documentation/security/

2017-05-18 Thread Jonathan Corbet
On Sat, 13 May 2017 04:51:36 -0700 Kees Cook wrote: > This ReSTifies everything under Documentation/security/, and reorganizes > some of it (mainly the LSMs) under /admin-guide/ per Jon's request. Since > /security/ is already being indexed under the kernel development

Re: [PATCH] doc-rst: fix inline emphasis in unshare.rst

2017-05-18 Thread Jonathan Corbet
On Sat, 13 May 2017 15:41:38 +0200 Markus Heiser wrote: > The asterisk of the pointer is interpreted as a start tag for inline > emphasis. Asterisks which are not Sphinx markup need to be quoted in > rst-files. This fixes the Sphinx warning: > >

Re: [PATCH] core-api: remove an unexpected unident

2017-05-18 Thread Jonathan Corbet
On Sat, 13 May 2017 15:28:25 +0200 Markus Heiser wrote: > As complained by Sphinx: > Documentation/core-api/assoc_array.rst:13: WARNING: Enumerated list > ends without a blank line; unexpected unindent. > > This was already addressed, but not really fixed in

Re: [PATCH v3 0/6] Add kselftest_harness.h

2017-05-16 Thread Jonathan Corbet
Signed-off-by: Mickaël Salaün <m...@digikod.net> > Acked-by: Kees Cook <keesc...@chromium.org> > Cc: Andy Lutomirski <l...@amacapital.net> > Cc: Jonathan Corbet <cor...@lwn.net> > Cc: Shuah Khan <sh...@kernel.org> > Cc: Will Drewry <w...@chromium.or

Re: [PATCH 06/17] doc: security: minor cleanups to build kernel-doc

2017-05-15 Thread Jonathan Corbet
On Mon, 15 May 2017 09:17:25 +1000 (AEST) James Morris wrote: > On Sat, 13 May 2017, Kees Cook wrote: > > > These fixes were needed to parse lsm_hooks.h kernel-doc. More work is > > needed, but this is the first step. > > > > Cc: Casey Schaufler > >

Re: [PATCH 0/5] Convert more books to ReST

2017-05-15 Thread Jonathan Corbet
On Mon, 15 May 2017 14:09:12 +0200 Boris Brezillon wrote: > > mtd: adjust kernel-docs to avoid Sphinx/kerneldoc warnings > > Not sure how you plan to merge these changes, but if it goes through > a single tree I'll probably need an immutable topic branch,

Re: [PATCH 01/36] docs-rst: convert kernel-hacking to ReST

2017-05-15 Thread Jonathan Corbet
On Fri, 12 May 2017 10:59:44 -0300 Mauro Carvalho Chehab wrote: > Documentation/DocBook/Makefile|2 +- > Documentation/DocBook/kernel-hacking.tmpl | 1312 > - > Documentation/conf.py |2 + >

Re: [Resend][PATCH] cpufreq: intel_pstate: Document the current behavior and user interface

2017-05-12 Thread Jonathan Corbet
On Fri, 12 May 2017 22:47:25 +0200 "Rafael J. Wysocki" wrote: > > Hi Jon, > > > > All of the dependencies for this patch have been merged, so I can route it > > through the PM tree. > > > > Please let me know if you prefer to take it into the documentation tree > >

[PULL] A few small documentation updates

2017-05-11 Thread Jonathan Corbet
The following changes since commit 4a1e31c68e9f40be32838944931178b0d9ed9162: Merge tag 'arc-4.12-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git/vgupta/arc (2017-05-09 10:10:15 -0700) are available in the git repository at: git://git.lwn.net/linux.git tags/docs-4.12-2 for you to

Re: [PATCH] doc: replace FTP URL to kernel.org with HTTPS one

2017-05-11 Thread Jonathan Corbet
On Thu, 11 May 2017 10:13:44 +0200 Michael Heimpold wrote: > FTP services were shutdown some weeks ago, so the FTP URL > does not work anymore. Fix this by replacing it with > corresponding HTTPS URL. Applied, we definitely don't want to have broken pointers. That

Re: [PATCHv3] docs: update references to the device io book

2017-05-09 Thread Jonathan Corbet
On Wed, 3 May 2017 11:51:46 +0200 Helmut Grohne wrote: > While converting the deviceiobook from DocBook to RST, dangling > references were left behind. This commit updates all remaining > references to the new location. SeongJae Park improved the ko_KR > translation.

Re: [PATCH] Documentation: earlycon: fix Marvell Armada 3700 UART name

2017-05-09 Thread Jonathan Corbet
On Thu, 4 May 2017 00:49:36 +0100 Andre Przywara wrote: > The Marvell Armada 3700 UART uses "ar3700_uart" for its earlycon name. > Adjust documentation to match the code. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe

Re: [PATCH] docs-rst: add input docs at main index and use kernel-figure

2017-05-09 Thread Jonathan Corbet
On Tue, 11 Apr 2017 07:01:19 -0300 Mauro Carvalho Chehab wrote: > The input subsystem documentation got converted into ReST. > > Add it to the main documentation index and use kernel-figure > for the two svg images there. > > Signed-off-by: Mauro Carvalho Chehab

Re: converting Documentation/security/* to .rst

2017-05-03 Thread Jonathan Corbet
On Mon, 1 May 2017 09:31:55 -0700 Kees Cook wrote: > > The real question would be one of organization. Most of the security > > stuff looks like it properly belongs in the admin guide, but that's not > > universally the case. > > Are the index area "purposes" documented

[PULL] Docs for 4.12

2017-05-01 Thread Jonathan Corbet
with intel_powerclamp code behavior Johan Hovold (1): Documentation: stable-kernel-rules: fix stable-tag format Jonathan Corbet (4): Merge tag 'v4.11-rc1' into docs-next docs: Create a user-space API guide docs: Convert unshare.txt to RST and add to the user-space API manual

Re: converting Documentation/security/* to .rst

2017-05-01 Thread Jonathan Corbet
On Fri, 28 Apr 2017 13:24:36 -0700 Kees Cook wrote: > I was curious if the conversion of security/ (and prctl/ which only > has two files that should probably both be moved to security/) was > already on someone's TODO list? I'd love to get these done (I refer > people

Re: [PATCH] KVM: Documentation: remove VM mmap documentation

2017-04-27 Thread Jonathan Corbet
On Thu, 27 Apr 2017 15:40:42 -0600 Jonathan Corbet <cor...@lwn.net> wrote: > On Mon, 24 Apr 2017 11:16:49 +0200 > Jann Horn <ja...@google.com> wrote: > > > Since commit 80f5b5e700fa9c ("KVM: remove vm mmap method"), the VM mmap > > handler is g

Re: [PATCH] docs: Fix a couple typos

2017-04-27 Thread Jonathan Corbet
On Fri, 21 Apr 2017 13:16:03 +0200 Stan Drozd wrote: > docs: Fix a couple typos > > This commit gets rid of some minor errors in Documentation/: > * cputopology.txt: drawes -> drawers > * debugging-via-ohci1394.txt: remove an unnecessary line break > * static-keys:

Re: [PATCH] docs: Fix a spelling error in vfio-mediated-device.txt

2017-04-27 Thread Jonathan Corbet
On Fri, 21 Apr 2017 13:07:10 +0200 Stan Drozd wrote: > docs: Fix a spelling error in vfio-mediated-device.txt > > This commit fixes a repeated "the" in vfio-mediated-device.txt and reflows the > paragraph. Applied to the docs tree, thanks. jon -- To unsubscribe from this

Re: [PATCH] KVM: Documentation: remove VM mmap documentation

2017-04-27 Thread Jonathan Corbet
On Mon, 24 Apr 2017 11:16:49 +0200 Jann Horn wrote: > Since commit 80f5b5e700fa9c ("KVM: remove vm mmap method"), the VM mmap > handler is gone. Remove the corresponding documentation. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line

Re: [PATCH] docs: update references to the device io book

2017-04-27 Thread Jonathan Corbet
On Thu, 27 Apr 2017 10:21:49 +0200 Helmut Grohne wrote: > diff --git a/Documentation/translations/ko_KR/memory-barriers.txt > b/Documentation/translations/ko_KR/memory-barriers.txt > index ce0b48d..7d241c6 100644 > --- a/Documentation/translations/ko_KR/memory-barriers.txt

Re: [PATCH] Documentation: allow installing man pages to a user defined directory

2017-04-20 Thread Jonathan Corbet
On Thu, 20 Apr 2017 15:57:28 -0300 "Herton R. Krzesinski" wrote: > Documentation/DocBook/Makefile hard codes the prefixed path to which you > can install the built man pages (/usr/local prefix). That's unfortunate > since the user may want to install to another prefix or

Re: [PATCH v2 00/11] Documentation: Add ABI to the admin guide

2017-04-20 Thread Jonathan Corbet
On Thu, 13 Apr 2017 07:08:43 -0300 Mauro Carvalho Chehab wrote: > That's the third attempt to add support for the Kernel ABI > at the Documentation's admin guide. > > The first approach was based on a generic extension that > calls a random script. This one is based on

Re: [PATCH v4 0/6] Get rid of usbfs leftovers

2017-04-20 Thread Jonathan Corbet
On Sun, 16 Apr 2017 21:51:05 -0300 Mauro Carvalho Chehab wrote: > When we got rid of usbfs, the old /proc/bus/usb stuff got moved > to two different places: > usb/devices is now at /sys/kernel/debug > /proc/bus/usb/BBB/DDD are not at /dev/bus/usb/BBB/DDD >

Re: [PATCH v2] docs-rst: usb: update old usbfs-related documentation

2017-04-20 Thread Jonathan Corbet
On Sun, 16 Apr 2017 13:04:36 -0300 Mauro Carvalho Chehab wrote: > There's no usbfs anymore. The old features are now either > exported to /dev/bus/usb or via debugfs. > > Update documentation accordingly, pointing to the new > places where the character devices and

Re: [PATCH] Documentation: DocBook: kgdb: update CONFIG_STRICT_KERNEL_RWX info

2017-04-20 Thread Jonathan Corbet
On Tue, 18 Apr 2017 18:58:45 -0700 Li Qiang wrote: > CONFIG_STRICT_KERNEL_RWX is no longer selectable on most architectures. > Update this info to the documentation. > > Signed-off-by: Li Qiang > --- > Documentation/DocBook/kgdb.tmpl | 4 +++- > 1 file

Re: [PATCH] arm: Documentation: update a path name

2017-04-20 Thread Jonathan Corbet
On Thu, 20 Apr 2017 12:58:40 +0800 Perr Zhang wrote: > the path in the example cmd is out of date, and the path for now > is also mentioned in the same file Gee, that's only been wrong since 2008...:) Applied, thanks. jon -- To unsubscribe from this list: send the line

Re: [PATCH V2] docs: process/4.Coding.rst: Fix a couple of document refs

2017-04-20 Thread Jonathan Corbet
On Thu, 20 Apr 2017 14:54:21 -0300 Mauro Carvalho Chehab wrote: > I guess those three guides complement each other, the first one with a > comprehensive explanation; the second one with a quick list of > tasks to submit a patch and the third one with a list of things to

Re: [PATCH V2] docs: process/4.Coding.rst: Fix a couple of document refs

2017-04-20 Thread Jonathan Corbet
On Thu, 20 Apr 2017 14:04:15 +0100 Andrew Clayton wrote: > In Documentation/process/4.Coding.rst there were a couple of paragraphs > that spilled over the 80 character line length. This was likely caused > when the document was converted to reStructuredText. Re-flow

Re: [PATCH] docs: swat a bunch of trivial typos

2017-04-17 Thread Jonathan Corbet
On Sun, 16 Apr 2017 00:25:33 +0200 Stanisław Drozd wrote: > This patch corrects a couple mistakes I've found when reading through > Documentation/. > > This is my first submission and I hope to send more meaningful > fixes in the future. It's a good start. A couple of

Re: [PATCH] docs: conf.py: increase recursion limit

2017-04-13 Thread Jonathan Corbet
On Thu, 13 Apr 2017 14:55:03 +0200 Markus Heiser wrote: > Sphinx caches the doctree (they call it "pickling"). On re-compile, this > cached doctree is readed in and changes from the rst-files are merged into > this doctree. After, the "updated" doctree is pickled

Re: [PATCH] docs-rst: add input docs at main index and use kernel-figure

2017-04-11 Thread Jonathan Corbet
On Tue, 11 Apr 2017 07:01:19 -0300 Mauro Carvalho Chehab wrote: > This patch contains the final bits of the input documentation > conversion. The linux-input tree has already the ReST conversion > patches, but it doesn't have the > Documentation/sphinx/load_config.py

Re: [PATCH v2 00/21] Convert USB documentation to ReST format

2017-04-11 Thread Jonathan Corbet
On Tue, 11 Apr 2017 16:58:40 +0200 Greg Kroah-Hartman wrote: > Nope, they don't apply to my tree, it was probably based on yours. And > the first two are ones I shouldn't be taking. > > So, feel free to take all of these with a: > Acked-by: Greg Kroah-Hartman

Re: [PATCH v2 00/21] Convert USB documentation to ReST format

2017-04-08 Thread Jonathan Corbet
On Wed, 5 Apr 2017 10:22:54 -0300 Mauro Carvalho Chehab wrote: > Currently, there are several USB core documents that are at either > written in plain text or in DocBook format. Convert them to ReST > and add to the driver-api book. Greg, do you see any reason not to

Re: [PATCH] Documentation: stable-kernel-rules: fix stable-tag format

2017-04-08 Thread Jonathan Corbet
On Mon, 3 Apr 2017 15:53:34 +0200 Johan Hovold wrote: > A patch documenting how to specify which kernels a particular fix should > be backported to (seemingly) inadvertently added a minus sign after the > kernel version. This particular stable-tag format had never been used >

Re: [PATCH] Documentation: Add HOWTO Japanese translation into rst based build system

2017-04-08 Thread Jonathan Corbet
On Sat, 8 Apr 2017 12:24:04 +0200 Greg KH wrote: > This commit adds Japanese translation of HOWTO document into rst based > documentation build system with updates. > > Signed-off-by: Tsugikazu Shibata > Signed-off-by: Greg Kroah-Hartman

Re: [PATCH v2 01/22] tmplcvt: make the tool more robust

2017-04-02 Thread Jonathan Corbet
On Thu, 30 Mar 2017 07:45:35 -0300 Mauro Carvalho Chehab wrote: > Currently, the script just assumes to be called at > Documentation/sphinx/. Change it to work on any directory, > and make it abort if something gets wrong. > > Also, be sure that both parameters are

[PATCH 0/2] Create an initial user-space API manual

2017-04-02 Thread Jonathan Corbet
For a bit we have talked about adding another manual for user-space API documentation. This is that manual. I've started by populating it with an ancient document that nobody probably cares about, but it shows the direction I'm thinking of going. Jonathan Corbet (2): docs: Create a user-space

[PATCH 2/2] docs: Convert unshare.txt to RST and add to the user-space API manual

2017-04-02 Thread Jonathan Corbet
This is a straightforward conversion, without any real textual changes. Since this document has seen no substantive changes since its addition in 2006, some such changes are probably warranted. Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- Documentation/userspace-api/ind

[PATCH 1/2] docs: Create a user-space API guide

2017-04-02 Thread Jonathan Corbet
This is meant to be the place for documentation relevant to application developers. It's empty for the moment, but at least we have a place now! Signed-off-by: Jonathan Corbet <cor...@lwn.net> --- Documentation/index.rst | 12 Documentation/userspace-api/c

Re: [PATCH 0/9] convert genericirq.tmpl and kernel-api.tmpl to DocBook

2017-04-02 Thread Jonathan Corbet
On Thu, 30 Mar 2017 17:11:27 -0300 Mauro Carvalho Chehab wrote: > This series converts just two documents, adding them to the > core-api.rst book. It addresses the errors/warnings that popup > after the conversion. > > I had to add two fixes to scripts/kernel-doc, in

Re: [PATCH v2] Use sphinx.version_info directly instead of parsing

2017-03-31 Thread Jonathan Corbet
On Fri, 31 Mar 2017 09:49:55 +0200 Remy Leone wrote: > Did this patch got applied? Yup, it did, it's in docs-next now. Sorry for the delay. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org

Re: [PATCH] sparse doc: fix reference path

2017-03-31 Thread Jonathan Corbet
On Fri, 24 Mar 2017 17:03:17 +0800 Cao jin wrote: > Documentation/sparse.txt has been moved to > Documentation/dev-tools/sparse.rst > > Signed-off-by: Cao jin > --- > Documentation/translations/zh_CN/sparse.txt | 4 ++-- > Makefile

Re: [PATCH 5/9] kernel-api.tmpl: convert it to ReST

2017-03-31 Thread Jonathan Corbet
On Thu, 30 Mar 2017 17:11:32 -0300 Mauro Carvalho Chehab wrote: > Brainless conversion of genericirq.tmpl book to ReST, via > Documentation/sphinx/tmplcvt This one kind of showcases why I'm nervous about bulk conversions. It's a bit of a dumping-ground document,

Re: [PATCH 3/9] genericirq.tmpl: convert it to ReST

2017-03-31 Thread Jonathan Corbet
On Thu, 30 Mar 2017 17:11:30 -0300 Mauro Carvalho Chehab wrote: [Reordering things a bit] > +== > +Linux generic IRQ handling > +== > + > +:Copyright: |copy| 2005-2010: Thomas Gleixner > +:Copyright: |copy| 2005-2006:

Re: [PATCH 02/22] docs-rst: convert usb docbooks to ReST

2017-03-31 Thread Jonathan Corbet
On Thu, 30 Mar 2017 11:20:14 +0200 Markus Heiser wrote: > @Jon: what do you think about a bulk conversion? I'm a bit leery of it, to tell the truth. We're trying to create a better set of kernel docs, and I'm far from convinced that dumping a bunch of unloved stuff

Re: [PATCH] pci-error-recovery: doc cleanup

2017-03-29 Thread Jonathan Corbet
On Tue, 21 Mar 2017 21:24:18 +0800 Cao jin wrote: > Include whitespace shooting; correction; typo fix; superfluous word > dropping. > > Signed-off-by: Cao jin > --- > This patch was sent in last December, which is not quite suitable at that

Re: [PATCH] Documentation: Fix dead URLs to ftp.kernel.org

2017-03-26 Thread Jonathan Corbet
On Sun, 26 Mar 2017 23:25:50 +0900 SeongJae Park wrote: CC += davem If nobody objects, I'll just take this through the docs tree. Thanks, jon > As ftp.kernel.org is closed [0], this commit fixes dead URLs in > documents to use www.kernel.org instead. > > [0]

Re: [PATCH v2] Docs: Input: initial uinput documentation

2017-03-24 Thread Jonathan Corbet
On Fri, 24 Mar 2017 00:34:58 -0300 Marcos Paulo de Souza wrote: > this is the second iteration of this patch. The first version can be checked > here[1]. A special thanks to Peter Hutterer who dug the last patch and > suggested > a lot of changes , hopefully, all

Re: [PATCH] Documentation: acpi: Fix typos

2017-03-17 Thread Jonathan Corbet
On Wed, 15 Mar 2017 01:05:43 +0200 Tamara Diaconita wrote: > Fix typos in acpi directory to make documentation grammatically correct. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a

Re: [PATCH v2] Documentation: md: md-cluster.txt: Fix typos

2017-03-17 Thread Jonathan Corbet
On Fri, 17 Mar 2017 20:14:08 +0200 Tamara Diaconita wrote: > Fix typos in md-cluster.txt file to make documentation clear. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to

Re: [PATCH] Documentation: mmc: mmc-dev-attrs.txt: Fix typos

2017-03-17 Thread Jonathan Corbet
On Fri, 17 Mar 2017 20:00:34 +0200 Tamara Diaconita wrote: > Fix typos in mmc-dev-attrs.txt to make documentation clear. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to

Re: [PATCH] Documentaion: leds: leds-lp55xx.txt: Fix typos

2017-03-17 Thread Jonathan Corbet
On Fri, 17 Mar 2017 19:29:48 +0200 Tamara Diaconita wrote: > Fix spelling mistakes in leds-lp55xx.txt file to make documentation > clear. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a

Re: [PATCH v2] Documentation: vfio-mediated-device.txt: Fix typos

2017-03-17 Thread Jonathan Corbet
On Thu, 16 Mar 2017 17:42:16 +0200 Tamara Diaconita wrote: > Correct spelling mistakes in vfio-mediates-device.txt to make > documentation clear. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body

Re: [PATCH v2] Documentation: sync_file.txt: Fix typos

2017-03-17 Thread Jonathan Corbet
On Thu, 16 Mar 2017 17:39:46 +0200 Tamara Diaconita wrote: > Fix spelling mistakes in sync_file.txt to make documentation clear. Applied to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to

Re: [PATCH v2] lib/Kconfig.debug: correct documentation paths

2017-03-17 Thread Jonathan Corbet
On Thu, 16 Mar 2017 09:37:32 +0100 Hans Holmberg wrote: > A bunch of documentation files have moved, correct the paths. Applied (finally!) to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to

Re: [Outreachy kernel] [PATCH] Documentation: Fix typos

2017-03-15 Thread Jonathan Corbet
On Wed, 15 Mar 2017 14:56:20 -0700 Alison Schofield wrote: > I'm wondering if there is one 'official' dictionary linux kernel > follows? No, I don't think there's really a need for one. If we can get a minimum of documentation without obvious errors, we'll be ahead of

Re: [PATCH] Documentation: Fix typos

2017-03-15 Thread Jonathan Corbet
On Wed, 15 Mar 2017 19:54:07 +0200 Tamara Diaconita wrote: > Fix typos in vfio-mediated-device.txt to make documentation > grammatically correct. Can you put the file name (or some other indication of what's being patched) in the subject line, so the patches can be

Re: [PATCH] Documentation: x86: Fix typos

2017-03-14 Thread Jonathan Corbet
On Tue, 14 Mar 2017 10:39:02 +0200 Tamara Diaconita wrote: > - If set to a nonzero value, contains a pointer to a NUL-terminated > + If set to a nonzero value, contains a pointer to a NULL-terminated This one is actually correct as-is. NUL is an ASCII character

Re: [Outreachy kernel] [PATCH v2] Documentation: admin-guide: Fix typos

2017-03-14 Thread Jonathan Corbet
On Tue, 14 Mar 2017 15:06:40 +0200 Daniel Baluta wrote: > Also for easier reviewing next patches you can mention in the > commit message what were the typos: > > e.g: witdh -> width I'm not sure that's helpful in a change like this which is fixing up a lot of different

Re: [PATCH 1/4] Documentation: hid: fix path to input bus definitions

2017-03-13 Thread Jonathan Corbet
On Sun, 12 Mar 2017 12:54:21 +0100 Martin Kepplinger wrote: > The UAPI header split failed to update the documentation here; fix things > accordingly. I've applied all four to the docs tree, thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc"

Re: [PATCH] cpufreq: User/admin documentation update and consolidation

2017-03-13 Thread Jonathan Corbet
On Mon, 13 Mar 2017 23:59:57 +0100 "Rafael J. Wysocki" wrote: > Well, to be honest, I downloaded the previous iteration from Patchwork and > I though it would apply, so I didn't check. Sorry about that. > > The one below applies for me with "git am" on top of 4.11-rc2.

Re: [PATCH] docs-rst: Don't use explicit Makefile rules to build SVG and DOT files

2017-03-13 Thread Jonathan Corbet
On Thu, 9 Mar 2017 15:14:52 -0300 Mauro Carvalho Chehab wrote: > Now that we have an extension to handle images, use it. Applied, finally - thanks. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to

Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

2017-03-13 Thread Jonathan Corbet
- Daniel Vetter (1): doc: Explain light-handed markup preference a bit better Jonathan Corbet (1): Merge tag 'v4.11-rc1' into docs-next Kees Cook (1): docs: Clarify details for reporting security bugs Markus Heiser (1): docs-rst: automatically convert Graphviz a

Re: [PATCH 2/3] Documentation: admin-guide: Fix typos

2017-03-13 Thread Jonathan Corbet
On Mon, 13 Mar 2017 13:47:39 +0200 Tamara Diaconita wrote: This set is good, but with one quibble: > @@ -1048,7 +1048,7 @@ found on newer Intel CPUs, such as ``i7core_edac``, > ``sb_edac`` and > echo 2

Re: [PATCH 1/3] Documentation: admin-guide: Fix typos

2017-03-13 Thread Jonathan Corbet
On Mon, 13 Mar 2017 13:44:56 +0200 Tamara Diaconita wrote: > Fix typos in kernel-parameters.rst file. So your fixes are generally good, but... > > -.. include:: kernel-parameters.txt > +.. include:: kernel-parameters.TNT > :literal: ...this one show a bit of

Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

2017-03-09 Thread Jonathan Corbet
On Mon, 6 Mar 2017 14:09:27 +0100 Markus Heiser wrote: > This patch brings scalable figure, image handling and a concept to > embed *render* markups: > > * DOT (http://www.graphviz.org) > * SVG OK, this is finally in docs-next - thanks everybody. Mauro, I tried to

Re: [PATCH 1/6] doc: Explain light-handed markup preference a bit better

2017-03-07 Thread Jonathan Corbet
On Tue, 7 Mar 2017 17:40:35 +0100 Daniel Vetter wrote: > Jon, can you pls pick this one up, or want me to resend stand-alone? I got it; I should get both applied before too long. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a

Re: [PATCH] docs: Clarify details for reporting security bugs

2017-03-07 Thread Jonathan Corbet
On Mon, 6 Mar 2017 11:13:51 -0800 Kees Cook wrote: > The kernel security team is regularly asked to provide CVE identifiers, > which we don't normally do. This updates the documentation to mention > this and adds some more details about coordination and patch handling >

<    1   2   3   4   5   6   7   8   >