Sounds OK. I guess it is ready for addition at Kaffeine.
Answering your questions:
<!--<member>qt5options(1)</member> only for application with a GUI FIXME use if we have an updated man page qt5options-->
Kaffeine does accept qt5options. It doesn't do anything special to them, just whatever Qt5 implements.
<!--<member>foo(1)</member> FIXME any ref to an other man page here ? vlc? or an utility to detect a tv card and gives outpout necessary to unse kaffeine?-->
For now, I don't think we need to point to VLC manpage, as there's nothing there that would help the user. Yet, we can mention at the manpage that it uses libVLC as video/audio play backend.
The only thing external that Kaffeine indirectly uses is this tree: https://git.linuxtv.org/dtv-scan-tables.git/
It contains the list of known channels per locality and per Satellite (for DVB-S). There's a developer's utility that generates a Kaffeine-specific file (scanfile.dvb) with uses such information. We run such tool from time to time, and we store the scanfile on a public repository. There's a button at the "Configura Television" screen that says: "Update scan data over Internet". When the user clicks on it, it downloads the latest file stored at: http://kaffeine.kde.org/scanfile.dvb.qz (I'm actually thinking that maybe the best would be to store it at linuxtv.org, and add there some automation to auto-create it when the upstream dtv-scan-tree changes).
Unfortunately, we don't have a manfile for dtv-scan-tables yet - patches are welcome.
Anyway, if the user has the need for a channel that it is not listed on Kaffeine, he needs to either use dvbv5-scan or w_scan to generate a new file (in the latter case, converted to the proper format using dvb-format-convert), and submit it to firstname.lastname@example.org, with "[PATCH] dtv-scan-tables: <some description>" at the subject, for us to add it at the tree and create a new scanfile.dvb.qz.
So, I guess we should mention the above procedure and point to the manpages for dvbv5-scan and w_scan.
add a Files sect with infos about scanfile.dvb and how to add new channels
bump date + releaseinfo
add dvbv5-scan + w-scan
kf5options is still commented, cause we ship a horrible outdated version fron Qt 3.2 of that file
Revision 2 (+164)
Version 2 is OK!
A side note: On version 2.0.2, I added the Kaffeine version at CListMake.txt, and added some logic to auto-updte the version when cmake is called:
Maybe we could use it too for the man and doc files. What do you think?