[PATCH 3/4] sphinx.rst: Allow Sphinx version 1.6 at the docs

2017-08-26 Thread Mauro Carvalho Chehab
Now that the PDF building issues with Sphinx 1.6 got fixed, update the documentation and scripts accordingly. Signed-off-by: Mauro Carvalho Chehab --- Documentation/doc-guide/sphinx.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Documentation/doc-guide/sphinx.rst b/D

[PATCH 1/4] docs-rst: fix verbatim font size on tables

2017-08-26 Thread Mauro Carvalho Chehab
On Sphinx 1.6, fancy boxes are used for verbatim. The sphinx.sty sets verbatim font is always \small. That causes a problem inside tables that use smaller fonts, as it can be too big for the box. Signed-off-by: Mauro Carvalho Chehab --- Documentation/conf.py | 2 +- 1 file changed, 1 insertion(+

[PATCH 2/4] media: fix pdf build with Spinx 1.6

2017-08-26 Thread Mauro Carvalho Chehab
Sphinx 1.6 generates some LaTeX code before each table, starting its own environment before calling tabulary, apparently to improve table layout. The problem is that such environment is incompatible with adjustbox. While, in thesis, it should be possible to override it or to redefine tabulary, I w

[PATCH 0/4] Fix problems on building documentation with Sphinx 1.6

2017-08-26 Thread Mauro Carvalho Chehab
Sphinx 1.6 changed the way tables are produced, adding some new macros before tables that do vertical alignments. This is incompatible with adjustbox, used by the media book, causing build to fail. This series fix such issues and make the layout on Sphinx 1.6 acceptable. The first patch in this s

[PATCH 4/4] docs-rst: don't require adjustbox anymore

2017-08-26 Thread Mauro Carvalho Chehab
Only the media PDF book was requiring adjustbox, in order to scale big tables. That worked pretty good with Sphinx versions 1.4 and 1.5, but Spinx 1.6 changed the way tables are produced, by introducing some weird macros before tabulary. That causes adjustbox to fail. So, it can't be used anymore,

Re: [PATCH v2 4/4] docs-rst: Allow Sphinx version 1.6

2017-08-26 Thread Mauro Carvalho Chehab
Em Thu, 24 Aug 2017 13:29:14 -0600 Jonathan Corbet escreveu: > On Thu, 24 Aug 2017 13:26:28 -0600 > Jonathan Corbet wrote: > > > > - % To allow adjusting table sizes > > > - \\usepackage{adjustbox} > > > - > > > ''' > > > } > > > > So this change doesn't quite match the changelog...

Re: [PATCH v2 2/3] media: open.rst: document devnode-centric and mc-centric types

2017-08-26 Thread Mauro Carvalho Chehab
Em Fri, 25 Aug 2017 15:42:21 +0200 Hans Verkuil escreveu: > On 25/08/17 14:52, Mauro Carvalho Chehab wrote: > > From: "mche...@s-opensource.com" > > > > When we added support for omap3, back in 2010, we added a new > > type of V4L2 devices that aren't fully controlled via the V4L2 > > device no

[PATCH v4 3/7] media: open.rst: remove the minor number range

2017-08-26 Thread Mauro Carvalho Chehab
minor numbers use to range between 0 to 255, but that was changed a long time ago. While it still applies when CONFIG_VIDEO_FIXED_MINOR_RANGES, when the minor number is dynamically allocated, this may not be true. In any case, this is not relevant, as udev will take care of it. So, remove this use

[PATCH v4 4/7] media: open.rst: document devnode-centric and mc-centric types

2017-08-26 Thread Mauro Carvalho Chehab
When we added support for omap3, back in 2010, we added a new type of V4L2 devices that aren't fully controlled via the V4L2 device node. Yet, we have never clearly documented in the V4L2 specification the differences between the two types. Let's document them based on the the current implementat

[PATCH v4 6/7] media: videodev2: add a flag for MC-centric devices

2017-08-26 Thread Mauro Carvalho Chehab
As both vdev-centric and MC-centric devices may implement the same APIs, we need a flag to allow userspace to distinguish between them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/uapi/v4l/open.rst| 7 +++ Documentation/media/uapi/v4l/vidioc-querycap.rst | 5

[PATCH v4 2/7] media: open.rst: better document device node naming

2017-08-26 Thread Mauro Carvalho Chehab
Right now, only kAPI documentation describes the device naming. However, such description is needed at the uAPI too. Add it, and describe how to get an unique identify for a given device. Acked-by: Hans Verkuil Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/uapi/v4l/open.rst | 39

[PATCH v4 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-08-26 Thread Mauro Carvalho Chehab
Add a glossary of terms for V4L2, as several concepts are complex enough to cause misunderstandings. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/uapi/v4l/glossary.rst | 98 +++ Documentation/media/uapi/v4l/v4l2.rst | 1 + 2 files changed, 99 inse

[PATCH v4 0/7] document types of hardware control for V4L2

2017-08-26 Thread Mauro Carvalho Chehab
On Kernel 2.6.39, the omap3 driver was introduced together with a new way to control complex V4L2 devices used on embedded systems, but this was never documented, as the original idea were to have "soon" support for standard apps to use it as well, via libv4l, but that didn't happen so far. Also,

[PATCH v4 7/7] media: open.rst: add a notice about subdev-API on vdev-centric

2017-08-26 Thread Mauro Carvalho Chehab
The documentation doesn't mention if vdev-centric hardware control would have subdev API or not. Add a notice about that, reflecting the current status, where three drivers use it, in order to support some subdev-specific controls. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/ua

[PATCH v4 5/7] media: open.rst: Adjust some terms to match the glossary

2017-08-26 Thread Mauro Carvalho Chehab
As we now have a glossary, some terms used on open.rst require adjustments. Signed-off-by: Mauro Carvalho Chehab --- Documentation/media/uapi/v4l/open.rst | 12 ++-- 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/media/uapi/v4l/open.rst b/Documentation/media

Re: [PATCH 0/4] Fix problems on building documentation with Sphinx 1.6

2017-08-26 Thread Jonathan Corbet
On Sat, 26 Aug 2017 06:28:24 -0300 Mauro Carvalho Chehab wrote: > IMHO, the best is if I apply patch 2 on my trees. Please apply > patches 1 and 3 on your tree. > > Patch 4 can only be applied after patch 2 gets merged, but it > is just a cleanup patch that can be applied any time later. OK, I

Re: [PATCH] swap: Remove obsolete sentence

2017-08-26 Thread Jonathan Corbet
On Fri, 25 Aug 2017 14:29:00 +0300 Nikolay Borisov wrote: > Currently there are no ->swap_{in,out} method in address_space_operations > sructure definition, so the statement that anything is going to be proxied > through them is wrong. > > Signed-off-by: Nikolay Borisov > --- > Documentation/f