17 Sep, 2020
1 commit
-
The syntax to cross-reference between documentation pages wasn't
documented anywhere.Document the cross-referencing using the new automarkup for
Documentation/... and also Sphinx's doc directive for using relative
paths.Signed-off-by: Nícolas F. R. A. Prado
Link: https://lore.kernel.org/r/20200911133339.327721-4-nfraprado@protonmail.com
Signed-off-by: Jonathan Corbet
27 Jun, 2019
1 commit
-
Now that we can mark up function() automatically, there is no reason to use
:c:func: and every reason to avoid it. Adjust the documentation to reflect
that fact.Signed-off-by: Jonathan Corbet
15 Jun, 2019
1 commit
-
There's a paragraph that explains how to create fixed width text block,
but it doesn't explains how to create fixed width text inline, although
this feature is really used through the documentation. Fix that adding a
quick note about it.Signed-off-by: André Almeida
Signed-off-by: Jonathan Corbet
31 May, 2019
1 commit
-
As discussed at the linux-doc ML, while we'll still support
version 1.3, it is time to recommend a more modern version.So, let's switch the minimal requirements to Sphinx 1.7.9,
as it has the "-jauto" flag, with makes a lot faster when
building documentation.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet
15 Jan, 2019
1 commit
-
While using this guide to learn the new documentation method, I saw
a few phrases that I felt could be improved. These small changes
improve the grammar and choice of words to further enhance the
installation instructions.Signed-off-by: Joel Nider
Acked-by: Mike Rapoport
Acked-by: Matthew Wilcox
Signed-off-by: Jonathan Corbet
07 Dec, 2018
1 commit
-
Some documents are refering to others without links. With this
patch I add those missing links.This patch affects only documents under process/ and labels where
necessary.Signed-off-by: Federico Vaga
Signed-off-by: Jonathan Corbet
26 Jun, 2018
1 commit
-
Fix a typo in sphinx.rst and a minor error in parse-header.rst
Signed-off-by: Federico Vaga
Signed-off-by: Jonathan Corbet
27 Aug, 2017
1 commit
-
Now that the PDF building issues with Sphinx 1.6 got fixed,
update the documentation and scripts accordingly.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet
24 Jul, 2017
1 commit
-
Now that we have a script to check for Sphinx dependencies,
document it.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet
18 Jul, 2017
5 commits
-
Instead of having it on just one note, add a separate section.
This way, we could later improve it, providing a better
guide about the needed steps for PDF builds.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
As we now have a document describing the install
requirements for Sphinx, add there the need for GraphViz
and ImageMagick.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
There's no "Sphinx C Domain" reference at the Kernel
documentation. So, don't use references for it.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
As the Sphinx build seems very fragile, specially for
PDF output, add a notice about how to use it on a virtual
environment.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The toolchain used by Sphinx is somewhat complex, and installing
it should be part of the doc-guide.Move it out of changes.rst.
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet
16 May, 2017
1 commit
-
DocBook is mentioned several times at the documentation. Update
the obsolete references from it at the DocBook.Acked-by: SeongJae Park
Signed-off-by: Mauro Carvalho Chehab
09 Mar, 2017
2 commits
-
This patch brings scalable figure, image handling and a concept to
embed *render* markups:* DOT (http://www.graphviz.org)
* SVGFor image handling use the 'image' replacement::
.. kernel-image:: svg_image.svg
:alt: simple SVG imageFor figure handling use the 'figure' replacement::
.. kernel-figure:: svg_image.svg
:alt: simple SVG imageSVG 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
Cc: Laurent Pinchart
Tested-by: Mauro Carvalho Chehab
Tested-by: Daniel Vetter
Signed-off-by: Daniel Vetter (v2 - v5)
Signed-off-by: Markus Heiser (v1, v6)
Signed-off-by: Jonathan Corbet -
We're still pretty far away from anything like a consensus, but
there's clearly a lot of people who prefer an as-light as possible
approach to converting existing .txt files to .rst. Make sure this is
properly taken into account and clear.Motivated by discussions with Peter and Christoph and others.
Cc: Christoph Hellwig
Cc: Peter Zijlstra
Cc: Jani Nikula
Cc: Mauro Carvalho Chehab
Signed-off-by: Daniel Vetter
Signed-off-by: Jonathan Corbet
20 Nov, 2016
1 commit
-
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
Signed-off-by: Jonathan Corbet