Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

[media] dvb: frontend.h: improve dvb_frontent_parameters comment

The comment for struct dvb_frontend_parameters is weird, as it
mixes delivery system name (ATSC) with modulation names
(QPSK, QAM, OFDM).

Use delivery system names there on the frequency comment, as this
is clearer, specially after 2GEN delivery systems.

While here, add comments at the union, to make live easier for ones
that may try to understand the convention used by the legacy API.

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>

+6 -6
+6 -6
include/uapi/linux/dvb/frontend.h
··· 540 540 }; 541 541 542 542 struct dvb_frontend_parameters { 543 - __u32 frequency; /* (absolute) frequency in Hz for QAM/OFDM/ATSC */ 544 - /* intermediate frequency in kHz for QPSK */ 543 + __u32 frequency; /* (absolute) frequency in Hz for DVB-C/DVB-T/ATSC */ 544 + /* intermediate frequency in kHz for DVB-S */ 545 545 fe_spectral_inversion_t inversion; 546 546 union { 547 - struct dvb_qpsk_parameters qpsk; 548 - struct dvb_qam_parameters qam; 549 - struct dvb_ofdm_parameters ofdm; 550 - struct dvb_vsb_parameters vsb; 547 + struct dvb_qpsk_parameters qpsk; /* DVB-S */ 548 + struct dvb_qam_parameters qam; /* DVB-C */ 549 + struct dvb_ofdm_parameters ofdm; /* DVB-T */ 550 + struct dvb_vsb_parameters vsb; /* ATSC */ 551 551 } u; 552 552 }; 553 553