Re: [PATCH] mac80211_hwsim: suggest nl80211 instead of wext driver in documentation

On Mon, 2016-10-17 at 00:39 +0200, Linus Lüssing wrote: > For mac80211_hwsim interfaces, suggest to use wpa_supplicant with the > more modern, netlink based driver instead of wext. Makes sense, applied. > Actually, I wasn't even able to make a connection with the > configuration > files and

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

Hi Jon, Am 18.10.2016 um 00:43 schrieb Jonathan Corbet : > 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: >

[PATCH] Documentation/RCU: Fix minor typo

deference should actually be dereference. Signed-off-by: Pranith Kumar --- Documentation/RCU/whatisRCU.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/RCU/whatisRCU.txt b/Documentation/RCU/whatisRCU.txt index 2044227..5cbd8b2 100644

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

Add low level driver to support reprogramming FPGAs for Altera SoCFPGA Arria10. Signed-off-by: Alan Tull --- v19: Added to this patchset as has been changed to use fpga image information struct a checkpatch fix of a block comment do not use clk_put

[PATCH v20 04/10] add sysfs document for fpga bridge class

Add documentation for new FPGA bridge class's sysfs interface. Signed-off-by: Alan Tull Acked-by: Moritz Fischer -- v15: Document added in v15 of patch set v16: No change to this patch in v16 of patch set v17: No change to this patch in v17

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

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 to move the converted files to be inside > a

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

Hi Jani, thanks for your review. > On Sun, 16 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

[PATCH] [linux-next] Doc: dm raid: Fix typo in dm-raid.txt

This patch fix spelling typos in Documentation/device-mapper/dm-raid.txt. Signed-off-by: Masanari Iida --- Documentation/device-mapper/dm-raid.txt | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/device-mapper/dm-raid.txt

Re: [PATCH 4/7] crypto: doc - fix separation of cipher / req API

On Sun, 16 Oct 2016, Stephan Mueller wrote: > Keep the cipher API and the request API function documentation in > separate sections. > > Signed-off-by: Stephan Mueller > --- > Documentation/crypto/api-akcipher.rst | 25 + > 1

Re: [PATCH v11 2/4] drm: Add API for capturing frame CRCs

On Thu, Oct 06, 2016 at 05:21:06PM +0200, Tomeu Vizoso wrote: > Adds files and directories to debugfs for controlling and reading frame > CRCs, per CRTC: > > dri/0/crtc-0/crc > dri/0/crtc-0/crc/control > dri/0/crtc-0/crc/data > > Drivers can implement the set_crc_source callback() in

Documentation/kernel-parameters.txt

I was looking at Documentation/kernel-parameters.txt and figured that has got to be constantly stale and incomplete. It's really data that should be autogenerated. I don't think it should just be converted to Sphinx as-is. * Module parameters. It should be required to use MODULE_PARM_DESC() for

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

On Sun, 16 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' > >

Re: [RFC PATCH 2/3] workqueue: kerneldocify workqueue_attrs

On Sun, 16 Oct 2016, Silvio Fricke wrote: > Only formating changes. > > Signed-off-by: Silvio Fricke > --- > include/linux/workqueue.h | 22 +- > 1 file changed, 13 insertions(+), 9 deletions(-) > > diff --git

Re: [RFC PATCH 3/3] kernel-doc: kerneldocify workqueue documentation

On Sun, 16 Oct 2016, Silvio Fricke wrote: > Only formating changes. > > Signed-off-by: Silvio Fricke > --- > Documentation/index.rst | 1 +- > Documentation/workqueue.rst | 394 +- >

Re: [PATCH 4/7] crypto: doc - fix separation of cipher / req API

Am Montag, 17. Oktober 2016, 14:04:14 CEST schrieb Jani Nikula: Hi Jani, > The directive parameter is plural functions for a reason - you can > specify multiple functions in the same directive. Splitting this to > multiple directives causes the header file to be parsed again for each >

Re: [PATCH 4/7] crypto: doc - fix separation of cipher / req API

On Mon, 17 Oct 2016, Stephan Mueller wrote: > Am Montag, 17. Oktober 2016, 14:04:14 CEST schrieb Jani Nikula: > > Hi Jani, > >> The directive parameter is plural functions for a reason - you can >> specify multiple functions in the same directive. Splitting this to >>

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

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 CAP_SYS_ADMIN. > > This new level of restriction is intended to

[PATCH] Documentation: DMA-API: Clarify semantics of dma_set_mask_and_coherent

The dma mapping api howto gives the impression that using the dma_set_mask_and_coherent (and related DMA APIs) will cause the kernel to check all the components in the path from the device to memory for addressing restrictions. In systems with address translations between the device and memory

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

On Mon, 2016-10-17 at 14:44 +0100, 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

[PATCH v20 06/10] fpga: add fpga bridge framework

This framework adds API functions for enabling/ disabling FPGA bridges under kernel control. This allows the Linux kernel to disable FPGA bridges during FPGA reprogramming and to enable FPGA bridges when FPGA reprogramming is done. This framework is be manufacturer-agnostic, allowing it to be

[PATCH v20 07/10] fpga: fpga-region: device tree control for FPGA

FPGA Regions support programming FPGA under control of the Device Tree. Signed-off-by: Alan Tull --- v9: initial version (this patch added during rest of patchset's v9) v10: request deferral if fpga mgr or bridges not available yet cleanup as fpga manager core

[PATCH v20 01/10] fpga: add bindings document for fpga region

New bindings document for FPGA Region to support programming FPGA's under Device Tree control Signed-off-by: Alan Tull Signed-off-by: Moritz Fischer Reviewed-by: Rob Herring --- v9: initial version added to this patchset

[PATCH v20 00/10] Device Tree support for FPGA Programming

This patchset supports FPGA programming under the control of Device Tree overlays. Changes from v19: * One line fix in FPGA Freeze Bridge DT binding doc (s/_/-/). * Squashed patches that add FPGA image info struct so they won't break bisect. * Minor changes as suggested for the SoCFPGA

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

This patch adds a minor change in the FPGA Mangager API to hold information that is specific to an FPGA image file. This change is expected to bring little, if any, pain. An FPGA image file will have particulars that affect how the image is programmed to the FPGA. One example is that current

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

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 reconfigured. Signed-off-by: Alan Tull

[PATCH v20 05/10] fpga-mgr: add fpga image information struct

This patch adds a minor change in the FPGA Mangager API to hold information that is specific to an FPGA image file. This change is expected to bring little, if any, pain. The socfpga and zynq drivers are fixed up in this patch. An FPGA image file will have particulars that affect how the image

[PATCH v20 08/10] ARM: socfpga: fpga bridge driver support

Supports Altera SOCFPGA bridges: * fpga2sdram * fpga2hps * hps2fpga * lwhps2fpga Allows enabling/disabling the bridges through the FPGA Bridge Framework API functions. The fpga2sdram driver only supports enabling and disabling of the ports that been configured early on. This is due to a

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

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 include the >

[PATCH 25/32] Documentation/parport.txt: convert to ReST markup

- 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

[PATCH 19/32] Documentation/magic-number.txt: convert it to ReST markup

- 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 ---

[PATCH 14/32] Documentation/CodeOfConflict: add it to the development-process book

This file is already in ReST format. So, just add an extra blank line to improve its output and add it to the development-process book. Signed-off-by: Mauro Carvalho Chehab --- Documentation/development-process/CodeOfConflict.rst | 1 +

[PATCH 16/32] Documentation/dynamic-debug-howto.txt: convert it to ReST markup

- 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 ---

[PATCH 31/32] Documentation/volatile-considered-harmful.txt: convert to ReST markup

- 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/development-process/index.rst | 1 +

[PATCH v20 09/10] fpga: add altera freeze bridge support

Add a low level driver for Altera Freeze Bridges to the FPGA Bridge framework. A freeze bridge is a bridge that exists in the FPGA fabric to isolate one region of the FPGA from the busses while that one region is being reprogrammed. Signed-off-by: Alan Tull

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

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). As several of the files that document the user's book and the

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

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

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

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 ---

[PATCH 22/32] Documentation/mono.txt: convert to ReST markup

- 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

[PATCH 10/32] Documentation/binfmt_misc.txt: convert it to ReST markup

- 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

[PATCH 06/32] docs-rst: create an user's manual book

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 --- Documentation/SecurityBugs | 12

[PATCH 18/32] Documentation/init.txt: convert to ReST markup

- 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

[PATCH 23/32] Documentation/java.txt: convert to ReST markup

- 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 02/32] REPORTING-BUGS: convert to ReST markup

- 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 ---

[PATCH 04/32] Documentation/kernel-parameters.txt: convert to ReST markup

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

[PATCH 20/32] Documentation/md.txt: Convert to ReST markup

- 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

[PATCH 13/32] Documentation/BUG-HUNTING: convert to ReST markup

- 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

[PATCH 21/32] Documentation/module-signing.txt: convert to ReST markup

- 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

[PATCH 26/32] Documentation/ramoops.txt: convert it to ReST format

- 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 30/32] Documentation/VGA-softcursor.txt: convert to ReST markup

- 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 07/32] Documentation/adding-syscalls.txt: convert it to ReST markup

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

[PATCH 29/32] Documentation/unicode.txt: convert it to ReST markup

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

[PATCH 24/32] Documentation/oops-tracing.txt: convert to ReST markup

- 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.

[PATCH 03/32] README: convert it to ReST markup

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

[PATCH 09/32] Documentation/basic_profiling.rst: convert to ReST markup

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 ---

[PATCH 11/32] Documentation/serial-console.txt: convert it to ReST markup

- 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 ---

Re: [PATCH v20 06/10] fpga: add fpga bridge framework

On Mon, 17 Oct 2016, Alan Tull wrote: > +/** > + * of_fpga_bridge_get - get an exclusive reference to a fpga bridge > + * > + * @np: node pointer of a FPGA bridge > + * @info: fpga image specific information > + * > + * Return fpga_bridge struct if successful. > + * Return -EBUSY if someone

Re: [PATCH] mac80211_hwsim: suggest nl80211 instead of wext driver in documentation

On Mon, Oct 17, 2016 at 11:39:04AM +0200, Johannes Berg wrote: > On Mon, 2016-10-17 at 00:39 +0200, Linus Lüssing wrote: > > For mac80211_hwsim interfaces, suggest to use wpa_supplicant with the > > more modern, netlink based driver instead of wext. > > Makes sense, applied. > > > Actually, I

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

From: Stephen Hemminger Update UIO documentation to include basic information about uio_hv_generic. Signed-off-by: Stephen Hemminger --- Documentation/DocBook/uio-howto.tmpl | 62 1 file changed, 62

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

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/ > to hold information that is specific to an FPGA image >

Remove binary files from documentation

Hi, Some of the files in documentation are binary (pdfs/jpg/png etc.) and do not play nicely with patches $ curl -s https://cdn.kernel.org/pub/linux/kernel/v4.x/testing/patch-4.9-rc1.xz | xzcat | grep "Binary files" Binary files a/Documentation/media/media_api_files/typical_media_device.pdf