aboutsummaryrefslogtreecommitdiff
path: root/Documentation/process
AgeCommit message (Collapse)AuthorFilesLines
2017-03-22drm/doc: Document feature merge deadlinesDaniel Vetter1-0/+1
The discussion pretty much concluded without objections, let's document what we agreed on. Cc'ing linux-doc for the new tag in Documentation/process/index.rst. Acked-by: Dave Airlie <[email protected]> Reviewed-by: Sean Paul <[email protected]> Cc: Jonathan Corbet <[email protected]> Cc: [email protected] Cc: Dave Airlie <[email protected]> Cc: Sean Paul <[email protected]> Cc: Jani Nikula <[email protected]> Cc: Alex Deucher <[email protected]> Cc: Lukas Wunner <[email protected]> Signed-off-by: Daniel Vetter <[email protected]> Link: http://patchwork.freedesktop.org/patch/msgid/[email protected]
2017-03-09docs-rst: automatically convert Graphviz and SVG imagesMarkus Heiser1-3/+4
This patch brings scalable figure, image handling and a concept to embed *render* markups: * DOT (http://www.graphviz.org) * SVG For image handling use the 'image' replacement:: .. kernel-image:: svg_image.svg :alt: simple SVG image For figure handling use the 'figure' replacement:: .. kernel-figure:: svg_image.svg :alt: simple SVG image SVG image example Embed *render* markups (or languages) like Graphviz's **DOT** is provided by the *render* directive.:: .. kernel-render:: DOT :alt: foobar digraph :caption: Embedded **DOT** (Graphviz) code. digraph foo { "bar" -> "baz"; } The *render* directive is a concept to integrate *render* markups and languages, yet supported markups: * DOT: render embedded Graphviz's **DOT** * SVG: render embedded Scalable Vector Graphics (**SVG**) Cc: Jani Nikula <[email protected]> Cc: Laurent Pinchart <[email protected]> Tested-by: Mauro Carvalho Chehab <[email protected]> Tested-by: Daniel Vetter <[email protected]> Signed-off-by: Daniel Vetter <[email protected]> (v2 - v5) Signed-off-by: Markus Heiser <[email protected]> (v1, v6) Signed-off-by: Jonathan Corbet <[email protected]>
2016-12-01Doc: Correct typo, "Introdution" => "Introduction"Sanjeev1-2/+2
This corrects a set of spelling mistakes, probably from an automated conversion. Signed-off-by: Sanjeev Gupta <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-11-30Documentation/atomic_ops.txt: convert to ReST markupSilvio Fricke1-0/+3
... and move to core-api folder. Signed-off-by: Silvio Fricke <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-11-28Documentation/process/howto: Only send regression fixes after -rc1Dan Carpenter1-9/+10
The original text was not clear if white space or other harmless patches should be merged in -rc kernels. The discussion at Kernel Summit said that we should be more strict about sending regression fixes only. Signed-off-by: Dan Carpenter <[email protected]> Acked-by: Greg Kroah-Hartman <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-11-19docs-rst: doc-guide: split the kernel-documentation.rst contentsMauro Carvalho Chehab2-4/+4
Having the kernel-documentation at the topmost level doesn't allow generating a separate PDF file for it. Also, makes harder to add extra contents. So, place it on a sub-dir. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-11-07coding-style: fix mismatch of jump label nameMasahiro Yamada1-1/+1
Commit 865a1caa4b6b ("CodingStyle: Clarify and complete chapter 7") renamed the label "out_buffer" to "out_free_buffer", but missed to change this line. Signed-off-by: Masahiro Yamada <[email protected]> Reviewed-by: Jean Delvare <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-11-07Documentation/process/howto: Mark subsection in suggested formatSeongJae Park1-5/+10
`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 <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-27Merge branch 'doc-tweaks' into docs-nextJonathan Corbet5-23/+48
The creation of the admin and process guides is a great thing, but, without care, we risk replacing a messy docs directory with a few messy Sphinx books. In an attempt to head that off and show what I'm thinking, here's a set of tweaks that, I think, make the existing Sphinx-formatted docs a bit more accessible.
2016-10-27docs: Add a warning to applying-patches.rstJonathan Corbet1-0/+4
This is ancient stuff and we don't do things this way anymore. In the absence of simply deleting the document, at least add a warning to it. Reviewed-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-27docs: add a warning to submitting-drivers.rstJonathan Corbet1-0/+8
This is crufty stuff and should maybe just be deleted, but I'm not quite ready to do that yet. Reviewed-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-27docs: Collapse the process guide TOCJonathan Corbet1-3/+3
I believe this makes the page as a whole more approachable. Reviewed-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-27docs: Tweak submitting-patches.rst formattingJonathan Corbet1-10/+6
The main goal here was to get the subsections to show in the TOC as they do for all the other documents. Also call out the DCO in the section title since it's important. Reviewed-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-27docs: Apply some basic organization to the process guideJonathan Corbet2-10/+29
Put like documents together, with the essential ones at the top, and split the TOC into sections. Reviewed-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-26doc-rst: include index only in subproject AND htmlMarkus Heiser1-0/+8
The index should only be included if the build of the sub-folder is done with the html-builder (HTML output). Signed-off-by: Markus Heiser <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-10-24docs: fix locations of several documents that got movedMauro Carvalho Chehab11-42/+42
The previous patch renamed several files that are cross-referenced along the Kernel documentation. Adjust the links to point to the right places. Signed-off-by: Mauro Carvalho Chehab <[email protected]>
2016-10-24docs-rst: add documents to development-processMauro Carvalho Chehab17-0/+6330
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 <[email protected]> Signed-off-by: Mauro Carvalho Chehab <[email protected]>
2016-10-24docs: rename development-process/ to process/Mauro Carvalho Chehab11-0/+2230
As we'll type this a lot, after adding CodingStyle & friends, let's rename the directory name to a shorter one. Signed-off-by: Mauro Carvalho Chehab <[email protected]>