Hi Jon,
Please pick the docs-next patches from:
git://linuxtv.org/mchehab/experimental.git docs-rst
(or from the patches sent to you)
For:
- Markus patches adding the c-domain override Sphinx extension;
- added support to build just LaTeX format. That's useful at least
for me, as it allows to not build all PDF documents (still, Sphinx
keeps building the *.tex files for everybody). But, as each PDF
requires 5 calls to xelatex, this reduces the amount of time to
build just the media document.
- LaTeX build fixes:
- PDF adjustments for .. note:: tag;
- kernel-doc fixups for struct members to fit at PDF output;
- better colors for note/warning/attention boxes on PDF output;
- fix a non-fatal LaTeX error when handling note boxes;
- add adjustbox package, needed to rescale big tables.
NOTE:
=====
I'm also adding there a patch that re-adds the media documentation
to the PDF output:
- docs-rst: add media documentation to PDF output
You probably should not merge this one, as it will cause
build failures without the other patches that are on my tree...
On the other hand, if you don't merge, I'll need to add it to my
tree, and we may have trivial conflicts at conf.py, as, unfortunately,
the LaTeX sources are currently not passed via command line on Sphinx
Makefile, but, instead, are hardcoded at the conf.py.
Yet, as plan is to merge from your tree before applying the remaining
patches at the media development tree, perhaps such conflict won't happen.
Regards,
Mauro
The following changes since commit e349b1b700c1fda12380cd5dcf6af8a3b82edff3:
Merge branch 'doc/4.9' into docs-next (2016-08-19 11:51:08 -0600)
are available in the git repository at:
git://linuxtv.org/mchehab/experimental.git docs-rst
for you to fetch changes up to 1f1ca6f00b0e60054f89b97ba5cc2ba9cade7e73:
docs-rst: add package adjustbox (2016-08-22 10:54:51 -0300)
----------------------------------------------------------------
Markus Heiser (5):
doc-rst: add boilerplate to customize c-domain
doc-rst: c-domain: ref-name of a function declaration
doc-rst: moved *duplicate* warnings to nitpicky mode
doc-rst: Revert "kernel-doc: fix handling of address_space tags"
doc-rst: migrate ioctl CEC_DQEVENT to c-domain
Mauro Carvalho Chehab (7):
docs-rst: add media documentation to PDF output
docs-rst: add support for LaTeX output
docs-rst: conf.py: adjust the size of .. note:: tag
docs-rst: kernel-doc: better output struct members
docs-rst: Use better colors for note/warning/attention boxes
docs-rst: Fix an warning when in interactive mode
docs-rst: add package adjustbox
Documentation/DocBook/Makefile | 1 +
Documentation/Makefile.sphinx | 7 ++++++-
Documentation/conf.py | 49
+++++++++++++++++++++++++++++++++++++------------
Documentation/kernel-documentation.rst | 29
+++++++++++++++++++++++++++++
Documentation/media/uapi/cec/cec-func-open.rst | 2 +-
Documentation/media/uapi/cec/cec-ioc-dqevent.rst | 5 +++--
Documentation/sphinx/cdomain.py | 102
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Makefile | 2 +-
scripts/kernel-doc | 6 ++----
9 files changed, 182 insertions(+), 21 deletions(-)
create mode 100644 Documentation/sphinx/cdomain.py
Thanks,
Mauro
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
