29310a5...
by
Jonathan Corbet <email address hidden>
Revert "doc/sphinx: Enable keep_warnings"
This reverts commit 47d6d752b9e20dbe8a2acd22e887be81a6f39de9.
Commit f42ddca7bebc (doc-rst: kernel-doc directive, fix state machine
reporter) from Marcus Heiser provides a better fix, so this configuration
change is no longer needed.
f42ddca...
by
Markus Heiser <email address hidden>
doc-rst: kernel-doc directive, fix state machine reporter
Add a reporter replacement that assigns the correct source name and line
number to a system message, as recorded in a ViewList.
Signed-off-by: Markus Heiser <email address hidden>
Tested-by: Mauro Carvalho Chehab <email address hidden>
Signed-off-by: Jonathan Corbet <email address hidden>
8ed292f...
by
Jonathan Corbet <email address hidden>
docs: deprecate kernel-doc-nano-HOWTO.txt
Now that the new Sphinx world order is taking over, the information in
kernel-doc-nano-HOWTO.txt is outmoded. I hate to remove it altogether,
since it's one of those files that people expect to find. But we can add a
warning and fix all the other pointers to it.
Reminded-by: Daniel Vetter <email address hidden>
Signed-off-by: Jonathan Corbet <email address hidden>
Unfortunately warnings generated after parsing in sphinx can end up
with entirely bogus files and line numbers as sources. Strangely for
outright errors this is not a problem. Trying to convert warnings to
errors also doesn't fix it.
The only way to get useful output out of sphinx to be able to root
cause the error seems to be enabling keep_warnings, which inserts
a System Message into the actual output. Not pretty at all, but I
don't really want to fix up core rst/sphinx code, and this gets the job
done meanwhile.
Cc: Markus Heiser <email address hidden>
Cc: Jonathan Corbet <email address hidden>
Cc: <email address hidden>
Signed-off-by: Daniel Vetter <email address hidden>
Signed-off-by: Jonathan Corbet <email address hidden>
e6507a0...
by
Jerome Marchand <email address hidden>
Documentation: add watermark_scale_factor to the list of vm systcl file
Commit 795ae7a0de6b ("mm: scale kswapd watermarks in proportion to
memory") properly added the description of the new knob to
Documentation/sysctl/vm.txt, but forgot to add it to the list of files
in /proc/sys/vm. Let's fix that.
Signed-off-by: Jerome Marchand <email address hidden>
Acked-by: Johannes Weiner <email address hidden>
Signed-off-by: Jonathan Corbet <email address hidden>
While trying to make gpu docs warning free I stumbled over one output
which wasn't following proper compiler error output standards. Fix it
up for more quickfix awesomeness.
Cc: Jonathan Corbet <email address hidden>
Cc: Jani Nikula <email address hidden>
Cc: <email address hidden>
Signed-off-by: Daniel Vetter <email address hidden>
Signed-off-by: Jonathan Corbet <email address hidden>
fd7db68...
by
Jonathan Corbet <email address hidden>
docs: Get rid of some kernel-documentation warnings
Sphinx wants to interpret all literal blocks as being in the chosen
language and complains when an attempt to parse a block fails.
kernel-documentation.rst has a few blocks that are not in C; make that
explicit to shut down the associated warnings.
Signed-off-by: Jonathan Corbet <email address hidden>
5472188...
by
Mauro Carvalho Chehab <email address hidden>
doc-rst: add an option to ignore DocBooks when generating docs
Sometimes, we want to do a partial build, instead of building
everything. However, right now, if one wants to build just
Sphinx books, it will build also the DocBooks.
Add an option to allow to ignore all DocBooks when building
documentation.
