sailus: did you see my mail? You missed adding the new format descriptions to v4l2-ioctl.c. I can't accept the patches without that change.
And you'll have to redo the doc patches for rst. Annoying, but it's just one of those things...
It's a big improvement compared to docbook, so it's worth a bit of extra effort.
ok, the new ReST/Sphinx docs will now be auto-built at linuxtv: https://linuxtv.org/downloads/v4l-dvb-apis-new/media/media_uapi.html
and should support building also with sphinx version 1.2
btw, just for fun, I also added an epub at: https://linuxtv.org/downloads/v4l-dvb-apis-new/TheLinuxKernel.epub
mchehab: that looks so much nicer than the old generated docs
mchehab: what do you use to render epub files
?
make epubdocs
ah, to read?  calligra
that's to generate them, but what about displaying them ?
ok
I think calligra is actually a frontend to the app that actually displays epub
sorry, callibre
gah, just one 'l'
calibre
Ah, calibre makes more sense.
I've tried okular but the result ins't very convincing
I looked at it with calibre as well, but I wasn't impressed either.
html output is much better.
maybe it's not okular's fault then
yeah, I prefer html output
the html output is nice, but I miss a full table of contents
To be honest, I've never been impressed by the calibre book viewer.
pinchartl: there's a way to generate a single html output file with sphinx
you'll likely need to call it by hand
as, right now, there's no Makefile target for it
I'd like multiple files with a full table of contents ;-)
I'm not sure how to generate a full TOC
How do I do that? (single html file, or even better: one html file per part)
one html per part should be easy too, I guess
the plane is boarding
you need to auto-generate the *.h.rst files first
mchehab: tomorrow I'll do another run through the pending patches and make pull requests. That's probably the last set for 4.8.
I'll have a v4.8 pull request for a regression fix, I'll try to send it this week
talk to you from Tokyo
Have a good flight!
  BUILDDIR=Documentation/output sphinx-build -b html -D version=4.7.0-rc1 -D release= -d Documentation/output/.doctrees -D kerneldoc_srctree=/devel/v4l/patchwork -D kerneldoc_bin=/devel/v4l/patchwork/scripts/kernel-doc  -c /devel/v4l/patchwork/Documentation  /devel/v4l/patchwork/Documentation Documentation/output/html
have a nice flight
the above is the command to build everything
if you play with "-b" you may be able to generate a single html, I guess
and -c specifies the dir to build
if you pass Documentation/uapi/v4l instead, I guess it will build only for V4L part
OK, I'm gonna play with that for the daily build
hmm... it complained about missing conf.py
you'll need to play with that ;)
       singlehtml
              HTML file generation with all content in a single HTML file.
just checked: changing from "html" to "singlehtml" made it generate one big html file
not that big... ~3MB
-rw-rw-r--. 1 mchehab mchehab 2985274 Jul 10 10:42 index.html
hverkuil:
sphinx-build -b singlehtml -D version=4.7.0-rc1 -D release= -d Documentation/output/.doctrees -D kerneldoc_srctree=`pwd` -c `pwd`/Documentation  `pwd`/Documentation/media/uapi/v4l/ Documentation/output/html/
this generates "only" v4l documentation
but it produces 630 warnings with stuff like:
None:None: WARNING: undefined label: fdl-document (if the link has no caption the label must precede a section header)
None:None: WARNING: undefined label: gen-errors (if the link has no caption the label must precede a section header)
there is one extension to do cross references with stuff outside the book
intersphinx, I guess
maybe playing with it, you'll be able do to what you want
and still keep those references to the other parts
which pci card has the best linux support out there?  i am reading about the Hauppauge HVR-2205 and HVR-2215. What do you think ?
hi all
I just asked this on #linuxtv but no reply
is there any reason for which read() is not yet supported for UVC?
in uvc_v4l2.c
1417: uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_read: not implemented.\n");
a few questions in regards to a tv card choice if anyone can take a look: https://forums.gentoo.org/viewtopic-p-7942514.html#7942514