27 Jun, 2019
7 commits
-
RCU basic concepts reST markup.
Reviewed-by: Joel Fernandes (Google)
Signed-off-by: Jiunn Chang
Signed-off-by: Jonathan Corbet -
There's no need to use a .rst on Sphinx toc tables. As most of
the Documentation don't use, remove the remaing occurrences.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Build of htmldocs fails for out-of-tree builds:
$ make V=1 O=~/build/kernel/ htmldocs
make -C /home/rppt/build/kernel -f /home/rppt/git/linux-docs/Makefile htmldocs
make[1]: Entering directory '/home/rppt/build/kernel'
make -f /home/rppt/git/linux-docs/scripts/Makefile.build obj=scripts/basic
rm -f .tmp_quiet_recordmcount
make -f /home/rppt/git/linux-docs/scripts/Makefile.build obj=Documentation htmldocs
Can't open Documentation/conf.py at /home/rppt/git/linux-docs/scripts/sphinx-pre-install line 230.
/home/rppt/git/linux-docs/Documentation/Makefile:80: recipe for target 'htmldocs' failed
make[2]: *** [htmldocs] Error 2The scripts/sphinx-pre-install is trying to open files in the current
directory which is $KBUILD_OUTPUT rather than in $srctree.Fix it.
Signed-off-by: Mike Rapoport
Reviewed-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Somehow, this file ended with Documentation/ twice.
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Newer devices like Yubikey 5 and Nitrokey Pro 2 have added support for
NISTP's implementation of ECC cryptography, so update the guide
accordingly and add a note on when to use nistp256 and when to use
ed25519 for generating S keys.Signed-off-by: Konstantin Ryabitsev
Signed-off-by: Jonathan Corbet -
Add documentation for Spectre vulnerability and the mitigation mechanisms:
- Explain the problem and risks
- Document the mitigation mechanisms
- Document the command line controls
- Document the sysfs filesCo-developed-by: Andi Kleen
Signed-off-by: Andi Kleen
Co-developed-by: Tim Chen
Signed-off-by: Tim Chen
Reviewed-by: Randy Dunlap
Reviewed-by: Thomas Gleixner
Cc: stable@vger.kernel.org
Signed-off-by: Jonathan Corbet -
The list of laptops supported by drivers in PDx86 subsystem is quite
big and growing. x86-laptop-drivers.txt contains details of very few
laptop models. Remove it because it does not serve any purpose.Signed-off-by: Puranjay Mohan
Acked-by: Andy Shevchenko
Signed-off-by: Jonathan Corbet
21 Jun, 2019
10 commits
-
"git diff" says:
\ No newline at end of file
after modifying the file.
Signed-off-by: Geert Uytterhoeven
Signed-off-by: Jonathan Corbet -
These are all obvious typos.
Signed-off-by: James Morse
Signed-off-by: Jonathan Corbet -
"If the MBA is specified in MB then user can enter the max b/w in MB"
is a tautology. How can the user know if the schemata takes a percentage
or a MB/s value?This is referring to whether the software controller is interpreting
the schemata's value. Make this clear.Signed-off-by: James Morse
Signed-off-by: Jonathan Corbet -
"L2 cache does not support code and data prioritization". This isn't
true, elsewhere the document says it can be enabled with the cdpl2
mount option.While we're here, these sample strings have lower-case code/data,
which isn't how the kernel exports them.Signed-off-by: James Morse
Signed-off-by: Jonathan Corbet -
Since commit 4d05bf71f157 ("x86/resctrl: Introduce AMD QOS feature")
resctrl has supported non-contiguous cache bit masks. The interface
for this is currently try-it-and-see.Update the documentation to say Intel CPUs have this requirement,
instead of X86.Cc: Babu Moger
Signed-off-by: James Morse
Signed-off-by: Jonathan Corbet -
The asterisks prepended to the quoted text currently get translated to
bullet points, which gets increasingly confusing the smaller your
screen is (when viewing the sphinx output, that is).Convert the whole quote to a literal block.
Signed-off-by: Valentin Schneider
Signed-off-by: Jonathan Corbet -
Since strlcpy is deprecated, the documentation shouldn't suggest using
it. This patch fixes the examples to use strscpy instead. It also uses
sizeof instead of underlying constants as far as possible, to simplify
future changes to the corresponding data structures.Signed-off-by: Stephen Kitt
Acked-by: Kees Cook
Acked-by: Federico Vaga
Signed-off-by: Jonathan Corbet -
In order for a list to be recognized as such, blank lines
are required.Solve those Sphinx warnings:
./lib/list_sort.c:162: WARNING: Unexpected indentation.
./lib/list_sort.c:163: WARNING: Block quote ends without a blank line; unexpected unindent.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Sphinx expects a blank line after a literal block markup.
Signed-off-by: Mauro Carvalho Chehab
Acked-by: Steven Rostedt (VMware)
Acked-by: Masami Hiramatsu
Signed-off-by: Jonathan Corbet -
The new font is available since recently.
Signed-off-by: Takashi Iwai
Acked-by: Randy Dunlap
Signed-off-by: Jonathan Corbet
18 Jun, 2019
1 commit
-
Every merge window seems to involve at least one episode where subsystem
maintainers don't manage their trees as Linus would like. Document the
expectations so that at least he has something to point people to.Acked-by: David Rientjes
Signed-off-by: Jonathan Corbet
15 Jun, 2019
22 commits
-
Since commit 5b18b5a73760 ("block: delete part_round_stats and switch to
less precise counting") io_ticks is approximated by adding one at each
start and end of requests if jiffies has changed.This works perfectly for requests shorter than a jiffy. If requests runs
more than 2 jiffies some I/O time will not be accounted unless there are
other reuqests.Signed-off-by: Konstantin Khlebnikov
Signed-off-by: Jonathan Corbet -
powerpc architecture (both 64-bit and 32-bit) supports stack protector
mechanism since some time now [see commit 06ec27aea9fc ("powerpc/64:
add stack protector support")].Update stackprotector arch support documentation to reflect the same.
Cc: Michael Ellerman
Signed-off-by: Bhupesh Sharma
Signed-off-by: Jonathan Corbet -
Update the documentation to reflect the new naming scheme with
latest changes.Reported-by: Leo Yan
Reviewed-by: Mathieu Poirier
Signed-off-by: Suzuki K Poulose
Signed-off-by: Jonathan Corbet -
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 -
When there's no Documentation/output directory, the script will
complain about those missing references:Documentation/doc-guide/sphinx.rst: Documentation/output
Documentation/doc-guide/sphinx.rst: Documentation/output
Documentation/process/howto.rst: Documentation/output
Documentation/translations/it_IT/doc-guide/sphinx.rst: Documentation/output
Documentation/translations/it_IT/doc-guide/sphinx.rst: Documentation/output
Documentation/translations/it_IT/process/howto.rst: Documentation/output
Documentation/translations/ja_JP/howto.rst: Documentation/output
Documentation/translations/ko_KR/howto.rst: Documentation/outputThose are false positives, so add an ignore rule for them.
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Sphinx need to know when a paragraph ends. So, do some adjustments
at the file for it to be properly parsed.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.that's said, I believe that this file should be moved to the
GPU/DRM documentation.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
In order to prepare to add them to the Kernel API book,
convert the files to ReST format.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
This is a very trivial conversion: adjust the title markup
and add a few literal block markups to produce a better
visual when parsed and avoid warnings.As newer documents related to xilinx could be added in the future,
create a new index file for it.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Convert those documents and prepare them to be part of the kernel
API book, as most of the stuff there are related to the
Kernel interfaces.Still, in the future, it would make sense to split the docs,
as some of the stuff is clearly focused on sysadmin tasks.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Reviewed-by: Guenter Roeck
Signed-off-by: Jonathan Corbet -
The conversion here is really trivial: just a bunch of title
markups and very few puntual changes is enough to make it to
be parsed by Sphinx and generate a nice html.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Mark Brown
Signed-off-by: Jonathan Corbet -
Convert the TCM docs to ReST format and add them to the
bookset.This has a mix of userspace-faced and Kernelspace faced
docs. Still, it sounds a better candidate to be added at
the kernel API set of docs.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The conversion here is trivial:
- Adjust the document title's markup
- Do some whitespace alignment;
- mark literal blocks;
- Use ReST way to markup indented lists.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The conversion is trivial: just adjust title markups.
In order to avoid conflicts, let's add an :orphan: tag
to it, to be removed when this file gets added to the
driver-api book.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Richard Cochran
Signed-off-by: Jonathan Corbet -
This file is already in a good shape: just its title and
adding some literal block markups is needed for it to be
part of the document.While it has a small chapter with sysfs stuff, most of
the document is focused on driver development.As it describes a kernel API, move it to the driver-api
directory.In order to avoid conflicts, let's add an :orphan: tag
to it, to be removed when added to the driver-api book.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Rodolfo Giometti
Signed-off-by: Jonathan Corbet -
Convert the pcmcia docs to ReST format. Most of the changes here
are trivial.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Dominik Brodowski
Signed-off-by: Jonathan Corbet -
Convert netlabel documentation to ReST.
This was trivial: just add proper title markups.
At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Paul Moore
Signed-off-by: Jonathan Corbet -
Convert Intel Many Integrated Core architecture docs to ReST.
The conversion is trivial: just add title and literal block
markups, and adjust some identation.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
Convert kdump documentation to ReST and add it to the
user faced manual, as the documents are mainly focused on
sysadmins that would be enabling kdump.Note: the vmcoreinfo.rst has one very long title on one of its
sub-sections:PG_lru|PG_private|PG_swapcache|PG_swapbacked|PG_slab|PG_hwpoision|PG_head_mask|PAGE_BUDDY_MAPCOUNT_VALUE(~PG_buddy)|PAGE_OFFLINE_MAPCOUNT_VALUE(~PG_offline)
I opted to break this one, into two entries with the same content,
in order to make it easier to display after being parsed in html and PDF.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The kbuild documentation clearly shows that the documents
there are written at different times: some use markdown,
some use their own peculiar logic to split sections.Convert everything to ReST without affecting too much
the author's style and avoiding adding uneeded markups.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Acked-by: Geert Uytterhoeven
Signed-off-by: Jonathan Corbet -
The dfl.txt file is almost there. It needs just a few
adjustments to be properly parsed.The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet -
The conversion is actually:
- add blank lines and identation in order to identify paragraphs;
- fix tables markups;
- add some lists markups;
- mark literal blocks;
- adjust title markups.At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.Also, removed the Maintained by, as requested by Geert.
Signed-off-by: Mauro Carvalho Chehab
Signed-off-by: Jonathan Corbet
