[0/3] Add a glossary and fix some issues at open.rst docs

Message

Mauro Carvalho Chehab Sept. 25, 2018, 12:06 p.m. UTC

Those three patches were part of an attempt to add definitions for
some terms used at the media subsystem:

	https://lwn.net/Articles/732022/

On that time, the first patch generated heated discussions, on terms
related to mc-centric/vdev-centric. The cern of the discussions were
how to call the subdev API and the non-subdev API part of the 
video4linux API.

I ended by being side-tracked by other things, and didn't have a chance
to submit an updated version.

Well, now I'm doing things differently: at the glossary.rst, I removed
everything related to hardware control. So, it should contain only the
terms that there aren't any divergences. So, I hope we can manage to
merge it this time.

After having this series merged, I'll address again the MC/vdev centric
hardware control on a separate patchset, perhaps using a different
approach together with the new glossary definitions related
to it.

Mauro Carvalho Chehab (3):
  media: add glossary.rst with common terms used at V4L2 spec
  media: open.rst: better document device node naming
  media: open.rst: remove the minor number range

 Documentation/media/uapi/v4l/glossary.rst | 108 ++++++++++++++++++++++
 Documentation/media/uapi/v4l/open.rst     |  53 +++++++++--
 Documentation/media/uapi/v4l/v4l2.rst     |   1 +
 3 files changed, 154 insertions(+), 8 deletions(-)
 create mode 100644 Documentation/media/uapi/v4l/glossary.rst

Comments

Sakari Ailus Sept. 25, 2018, 1:04 p.m. UTC | #1

On Tue, Sep 25, 2018 at 09:06:50AM -0300, Mauro Carvalho Chehab wrote:
> Those three patches were part of an attempt to add definitions for
> some terms used at the media subsystem:
> 
> 	https://lwn.net/Articles/732022/
> 
> On that time, the first patch generated heated discussions, on terms
> related to mc-centric/vdev-centric. The cern of the discussions were
> how to call the subdev API and the non-subdev API part of the 
> video4linux API.
> 
> I ended by being side-tracked by other things, and didn't have a chance
> to submit an updated version.
> 
> Well, now I'm doing things differently: at the glossary.rst, I removed
> everything related to hardware control. So, it should contain only the
> terms that there aren't any divergences. So, I hope we can manage to
> merge it this time.
> 
> After having this series merged, I'll address again the MC/vdev centric
> hardware control on a separate patchset, perhaps using a different
> approach together with the new glossary definitions related
> to it.
> 
> Mauro Carvalho Chehab (3):
>   media: add glossary.rst with common terms used at V4L2 spec
>   media: open.rst: better document device node naming
>   media: open.rst: remove the minor number range

For patches 2 and 3:

Acked-by: Sakari Ailus <[e-mail]>