Am 18.10.2016 um 08:07 schrieb Jani Nikula :
> If you're going to insist on getting kernel-cmd upstream (and I haven't
> changed my opinion on that) please at least have the sense to have just
> *one* perl script to parse MAINTAINERS, not many. The one script should
> be scripts/get_maintainer.pl
On Mon, 17 Oct 2016, Mauro Carvalho Chehab wrote:
> [PATCH] docs-rst: user: add MAINTAINERS
>
> including MAINTAINERS using ReST is tricky, because all
> maintainer's entries are like:
>
> FOO SUBSYSTEM:
> M: My Name
> L: mailing@list
> S: Maintained
> F: foo/bar
>
> On ReST, this would be displa
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
--- a/Documentation/RCU/w
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:
>
>> In my opinion, it would be better to mo
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 Sphinx build directory, but Jon
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 in
> > 'alloc_ordered_wor
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 and
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
> file. This change is expected
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 alread
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 insertions(+)
diff --git a/Documentation/DocBook/uio-howt
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 was
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 of patch set
v18: No change to this patch in v18 of pat
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 because we are using devm_clk_g
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
---
Documentation/basic_profiling.txt
- 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
---
Documentation/serial-console.txt
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 othe
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 a
- promote the section level of the document name;
- add/remove spaces/new lines where needed to format the output;
- use quote blocks.
- add it to the user book.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/bad_memory.txt | 26 --
Documentation/user/bad_mem
- 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.
Signed-
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 cross-refer
- 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 | 528 +
- 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 | 44 +++
- Fix document title;
- use a table for the valid commands;
- 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/sysrq.txt | 266 +++
- 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 | 134 ++
- 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 -
Do
- 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 +++--
- 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
---
REPORTING-BUGS | 66
Sphinx doesn't like nested tables on the LaTex output.
So, change the table there to be displayed properly at
the PDF output.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/parport.txt | 33 ++---
1 file changed, 22 insertions(+), 11 deletions(-)
diff --git
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 +++--
1
- Fix identation for the document title;
- use monotonic fonts for paths;
- use quote blocks where needed;
- adjust spaces to properly format paragraphs;
- use :menuselection: and :kbd: for the menu item and keys;
- point too the right item at the menu;
- add it to the user book.
Signed-off-by: Ma
- 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 +++-
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 ++--
Documentation/c
- 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 | 162 +++--
- 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 C
- 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 -
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 +
Documentation/development-process/index.rst | 1 +
- use a quote blocks where needed;
- fix the chapter/section/subsection markups;
- use ``foo`` for monotonic;
- use .. note:: for /sbin/init file permissions;
- adjust whitespaces and blank lines;
- add it to the user's book.
Signed-off-by: Mauro Carvalho Chehab
---
Documentation/initrd.txt
- 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
---
Documentation/dynamic-debug-howto.txt | 297 +++
- 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 +
.../volatile-considered-harmful.rst
- 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/sysfs-rules.txt | 218 +++
- 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
---
Docume
- 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
---
Documentation/development-process/index.rst| 1 +
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 02ce4924468e..3395da13d415 100644
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
---
Documentation/development-process/Changes.rst | 1 +
Docum
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
Signed-off-by: Matthew Gerlach
---
v1
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 deve
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
> output of any (Perl or whatever) script. This is a more gene
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 goes into the real kernel
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
v10: s/fpga/FPGA/g
replace DT overlay example with slightly more com
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 Arria
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 'fl
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 i
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
Signed-off-by: Matthew Gerl
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 use
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 hard
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 witho
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 (e.g
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
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 drm_crtc_fun
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 r
On Sun, 16 Oct 2016, Silvio Fricke wrote:
> Only formating changes.
>
> Signed-off-by: Silvio Fricke
> ---
> Documentation/index.rst | 1 +-
> Documentation/workqueue.rst | 394 +-
> Documentation/workqueue.txt | 388 +
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 a/include/linux/workqueue.h b/include/linux/workqueue.h
> index fc
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'
>
> Signed-off-by: Silvio Fricke
> ---
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
>> multiple directives causes th
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
> directive.
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
b/Documentation/device-mapper/dm
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 file changed, 13 insertions(+), 12 deletions(-
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 infor
68 matches
Mail list logo
