[RFC PATCH 0/2] Document the V4L2 (stateful) Codec API

From: Tomasz Figa
Date: Tue Jun 05 2018 - 06:33:41 EST


This series attempts to add the documentation of what was discussed
during Media Workshops at LinuxCon Europe 2012 in Barcelona and then
later Embedded Linux Conference Europe 2014 in DÃsseldorf and then
eventually written down by Pawel Osciak and tweaked a bit by Chrome OS
video team (but mostly in a cosmetic way or making the document more
precise), during the several years of Chrome OS using the APIs in
production.

Note that most, if not all, of the API is already implemented in
existing mainline drivers, such as s5p-mfc or mtk-vcodec. Intention of
this series is just to formalize what we already have.

It is an initial conversion from Google Docs to RST, so formatting is
likely to need some further polishing. It is also the first time for me
to create such long RST documention. I could not find any other instance
of similar userspace sequence specifications among our Media documents,
so I mostly followed what was there in the source. Feel free to suggest
a better format.

Much of credits should go to Pawel Osciak, for writing most of the
original text.

Tomasz Figa (2):
media: docs-rst: Add decoder UAPI specification to Codec Interfaces
media: docs-rst: Add encoder UAPI specification to Codec Interfaces

Documentation/media/uapi/v4l/dev-codec.rst | 1084 ++++++++++++++++++++
Documentation/media/uapi/v4l/v4l2.rst | 14 +-
2 files changed, 1097 insertions(+), 1 deletion(-)

--
2.17.1.1185.g55be947832-goog