BMC/Intel-BMC/linux.git/drivers/media/dvb-core, branch dev-4.3

[media] dvbdev: document most of the functions/data structs

2015-08-22T22:39:38+00:00

Document the most relevant functions and data structs for developers that are working with the DVB subsystem. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb_frontend.h: document the struct dvb_frontend

2015-08-22T17:52:59+00:00

That struct is used on every DVB Front End driver, as it contains what's needed to register/use a frontend at the Kernel. Document it. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb-frontend.h: document struct dtv_frontend_properties

2015-08-22T17:52:59+00:00

Most of the parameters here are already well defined at the userspace documentation. Yet, it is good to add some documentation, for the developers to be sure that they are the same as the ones at userspace API. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb-frontend.h: document struct dvb_frontend_ops

2015-08-22T17:52:58+00:00

This is one of the most important functions of the DVB frontend, containing the logic needed to set the parameters at the demux and to send commands via SEC. Document it. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb: Use DVBFE_ALGO_HW where applicable

2015-08-22T17:52:58+00:00

The dvb_frontend.c core defines a FE_ALGO_HW symbol that it is never used. Also, both cx24123 returns 1 to get_algo() callback instead of using DVBFE_ALGO_HW. Probably, those are some left overs from some code cleanup. Let's stop returning magic numbers and use the proper macro value. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb_frontend.h: document struct analog_demod_ops

2015-08-22T17:52:57+00:00

Add documentation for struct analog_demod_info and struct analog_demod_ops. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb_frontend.h: Document struct dvb_tuner_ops

2015-08-22T17:52:56+00:00

The struct dvb_tuner_ops contains lots of callbacks used by tuners. Document them. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] Docbook: Document struct analog_parameters

2015-08-22T17:52:56+00:00

That struct inside dvb-frontend.h stores some parameters from V4L2 API (videodev2.h), in order to be used by the hybrid analog/digital TV tuners. Document it. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] dvb_frontend.h: get rid of dvbfe_modcod

2015-08-22T17:52:55+00:00

This enum is not used anymore, as drivers use the modulation definitions from the public API. It is probably a left over from some DVB core cleanup. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet

[media] add documentation for struct dvb_tuner_info

2015-08-22T17:52:55+00:00

Despite being used everywhere at DVB frontends, the struct dvb_tuner_info were never documented. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Corbet