This patch series fix the severe issues related to LaTeX output with media.
After applying it, "make pdfdocs" generates the Kernel documentation with
all books upstream, including the media books.
There are still some caveats, but the end result can be seen at:
https://mchehab.fedorapeople.org/TheLinuxKernel.pdf
To help people testing it, I pushed the patches on this series, plus two patches
from Jani at:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=docs-next
This series contain:
1) 3 patches fixing LaTeX handling at Documentation/conf.py
Those patches use "xelatex" instead of "pdflatex", with fix support for
UTF-8 characters, needed by the media books. It also fixes the breakages
on LaTeX Sphinx output for notes inside tables. Finally, it allows rotating
some pages at the PDF output. This is needed in order to output very big
tables. Patches to rotate such tables are not in this series.
2) a patch that makes usage of Sphinx math extension;
3) One patch converting some GIF files to PNG (needed by pdflatex).
Didn't check if xelatex needs it, but it is still a good idea to use PNG.
4) 3 fixup patches (that are actually independent of this series
5) A hack that does two things:
- comment out C blocks inside tables, as Sphinx 1.4.5 produces a broken
LaTeX file if it sees such blocks;
- Cleans the auto-generated rst files, as the escape codes there are meant
to work with HTML, and not LaTeX. It is likely easy to fix the perl
script to do
the right thing here, but, as Markus is writing a Sphinx extension for it,
let's discuss it uptream before doing rework.
PS.: The last patch are not meant to be merged. Merging the other ones should
be OK.
Mauro Carvalho Chehab (9):
docs-rst: allow generating some LaTeX pages in landscape
docs-rst: improve output for .. notes:: on LaTeX
docs-rst: Don't mangle with UTF-8 chars on LaTeX/PDF output
[media] pixfmt-007.rst: use Sphinx math:: expressions
[media] pixfmt-nv12mt.rst: use PNG instead of GIF
[media] vidioc-enumstd.rst: fix a broken reference
[media] vidioc-enumstd.rst: remove bullets from sound carrier
[media] docs-rst: better use the .. note:: tag
HACK: make pdfdocs build with media books
Documentation/Makefile.sphinx | 7 +-
Documentation/conf.py | 56 ++++--
Documentation/media/uapi/cec/cec-func-close.rst | 4 +-
Documentation/media/uapi/cec/cec-func-ioctl.rst | 4 +-
Documentation/media/uapi/cec/cec-func-open.rst | 4 +-
Documentation/media/uapi/cec/cec-func-poll.rst | 4 +-
Documentation/media/uapi/cec/cec-intro.rst | 4 +-
.../media/uapi/cec/cec-ioc-adap-g-caps.rst | 4 +-
.../media/uapi/cec/cec-ioc-adap-g-log-addrs.rst | 4 +-
.../media/uapi/cec/cec-ioc-adap-g-phys-addr.rst | 4 +-
Documentation/media/uapi/cec/cec-ioc-dqevent.rst | 4 +-
Documentation/media/uapi/cec/cec-ioc-g-mode.rst | 4 +-
Documentation/media/uapi/cec/cec-ioc-receive.rst | 4 +-
.../media/uapi/dvb/dvb-fe-read-status.rst | 4 +-
Documentation/media/uapi/dvb/dvbapi.rst | 4 +-
Documentation/media/uapi/dvb/dvbproperty.rst | 4 +-
Documentation/media/uapi/dvb/examples.rst | 4 +-
Documentation/media/uapi/dvb/fe-get-info.rst | 4 +-
Documentation/media/uapi/dvb/fe-read-status.rst | 4 +-
Documentation/media/uapi/dvb/frontend.rst | 4 +-
.../media/uapi/rc/lirc-set-wideband-receiver.rst | 4 +-
Documentation/media/uapi/v4l/audio.rst | 4 +-
Documentation/media/uapi/v4l/buffer.rst | 13 +-
Documentation/media/uapi/v4l/crop.rst | 12 +-
Documentation/media/uapi/v4l/dev-codec.rst | 4 +-
Documentation/media/uapi/v4l/dev-osd.rst | 4 +-
Documentation/media/uapi/v4l/dev-overlay.rst | 8 +-
Documentation/media/uapi/v4l/dev-rds.rst | 4 +-
Documentation/media/uapi/v4l/extended-controls.rst | 4 +-
Documentation/media/uapi/v4l/func-mmap.rst | 4 +-
Documentation/media/uapi/v4l/pixfmt-006.rst | 4 +-
Documentation/media/uapi/v4l/pixfmt-007.rst | 187 ++++++++++++++-------
Documentation/media/uapi/v4l/pixfmt-nv12mt.rst | 4 +-
.../media/uapi/v4l/pixfmt-nv12mt_files/nv12mt.gif | Bin 2108 -> 0 bytes
.../media/uapi/v4l/pixfmt-nv12mt_files/nv12mt.png | Bin 0 -> 1920 bytes
.../v4l/pixfmt-nv12mt_files/nv12mt_example.gif | Bin 6858 -> 0 bytes
.../v4l/pixfmt-nv12mt_files/nv12mt_example.png | Bin 0 -> 5261 bytes
Documentation/media/uapi/v4l/pixfmt-sbggr16.rst | 4 +-
Documentation/media/uapi/v4l/pixfmt-y16-be.rst | 4 +-
Documentation/media/uapi/v4l/pixfmt-y16.rst | 4 +-
Documentation/media/uapi/v4l/standard.rst | 4 +-
Documentation/media/uapi/v4l/tuner.rst | 4 +-
Documentation/media/uapi/v4l/userp.rst | 4 +-
.../media/uapi/v4l/vidioc-dv-timings-cap.rst | 4 +-
.../media/uapi/v4l/vidioc-enum-dv-timings.rst | 4 +-
Documentation/media/uapi/v4l/vidioc-enum-fmt.rst | 17 +-
.../media/uapi/v4l/vidioc-enum-frameintervals.rst | 4 +-
.../media/uapi/v4l/vidioc-enum-framesizes.rst | 4 +-
.../media/uapi/v4l/vidioc-enum-freq-bands.rst | 4 +-
.../media/uapi/v4l/vidioc-enumaudioout.rst | 4 +-
Documentation/media/uapi/v4l/vidioc-enumstd.rst | 27 ++-
Documentation/media/uapi/v4l/vidioc-g-audioout.rst | 4 +-
Documentation/media/uapi/v4l/vidioc-g-edid.rst | 4 +-
.../media/uapi/v4l/vidioc-g-ext-ctrls.rst | 8 +-
.../media/uapi/v4l/vidioc-g-modulator.rst | 4 +-
.../media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst | 4 +-
Documentation/media/uapi/v4l/vidioc-g-tuner.rst | 8 +-
Documentation/media/uapi/v4l/vidioc-qbuf.rst | 4 +-
.../media/uapi/v4l/vidioc-query-dv-timings.rst | 4 +-
Documentation/media/uapi/v4l/vidioc-querycap.rst | 20 +--
Documentation/media/uapi/v4l/vidioc-queryctrl.rst | 16 +-
Documentation/media/uapi/v4l/vidioc-querystd.rst | 4 +-
Documentation/media/uapi/v4l/vidioc-streamon.rst | 4 +-
.../media/uapi/v4l/vidioc-subscribe-event.rst | 4 +-
Documentation/media/v4l-drivers/bttv.rst | 1 +
65 files changed, 396 insertions(+), 176 deletions(-)
delete mode 100644 Documentation/media/uapi/v4l/pixfmt-nv12mt_files/nv12mt.gif
create mode 100644 Documentation/media/uapi/v4l/pixfmt-nv12mt_files/nv12mt.png
delete mode 100644
Documentation/media/uapi/v4l/pixfmt-nv12mt_files/nv12mt_example.gif
create mode 100644
Documentation/media/uapi/v4l/pixfmt-nv12mt_files/nv12mt_example.png
--
2.7.4
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
