This is basically a resend of v3 after 6 month, with some minor updates. Changes since v3: * Adjust title and description to better match existing documentation. * Fix warnings from kernel test robot. (At least I hope it is fixed now, I couldn't reproduce this warning.) No changes to the text it self. The layout is still identical since v1, just split into multiple patches. My comments of v3 attached below, they refer to Mauros comments[3] to v2 and still fully apply. [3: https://patchwork.kernel.org/project/linux-media/patch/decd5d71-f06e-5873-5ebf-7028107f65ee@xxxxxxxxxxxxxx/] [PATCH v3] (July '23) --------------------------------------------------- Changes since v2: * Split the patch into a patch series. * Incorporate the changes requested. * Style updates to better match the existing documentation. * And a lot of small fixes. Hi Mauro, it took a little longer then expected, but I didn't had much time in spare for this. I'm pretty much occupied by other things at the moment. The winter season would be better for things like this, but I try to finish it as quick as possible. I went through your mail point by point and I'm confident, that I was able to sort out your questions now. At least I don't see anything that need to be improved anymore. The work has been done in a lot of small blocks over a pretty long period after my daily work, mostly late at night. Despite double checking everything, I maybe still have missed something. I hope it is not too much. For usage it has been checked against the known projects using the DVB decoder APIs: * The AV7110 kernel driver. * The out of tree driver for the HD full featured cards.[1] * The "Enigma2" sources from openatv team.[2] (The drivers of the boxes are binary only.) Possibly unused items have been listed in the comment of the patches. Please take this lists with a pinch of salt. With the number of items checked, it is pretty easy to miss an occurrence or have a false positive. Although I've done my best, there is still the chance that I've missed an use case. I tried to complete the documentation of this unused definition too. Most information had been collect anyway and writing it down wasn't that much of effort. Removing the definition and documentation later at once is always an option. I would prefer to do it this way, if something has to be removed. It is easier to revert the change in case of a regression. If necessary I can provide the patches too. Regards Stefan [1: https://github.com/s-moch/linux-saa716x] [2: https://github.com/openatv/enigma2/tree/master] Stefan Herdler (6): Add documentation for legacy DVB decoder API Add documentation for osd.h Add documentation for audio.h (data types) Add documentation for audio.h (function calls) Add documentation for video.h (data types) Add documentation for video.h (function calls) .../media/dvb/legacy_dvb_apis.rst | 1 + .../media/dvb/legacy_dvb_audio.rst | 1642 +++++++++++ .../media/dvb/legacy_dvb_decoder_api.rst | 61 + .../media/dvb/legacy_dvb_osd.rst | 883 ++++++ .../media/dvb/legacy_dvb_video.rst | 2430 +++++++++++++++++ 5 files changed, 5017 insertions(+) create mode 100644 Documentation/userspace-api/media/dvb/legacy_dvb_audio.rst create mode 100644 Documentation/userspace-api/media/dvb/legacy_dvb_decoder_api.rst create mode 100644 Documentation/userspace-api/media/dvb/legacy_dvb_osd.rst create mode 100644 Documentation/userspace-api/media/dvb/legacy_dvb_video.rst -- 2.34.0
