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

[media] DocBook: better document the DVB-S2 rolloff factor

Instead of using a program listing, use a table and make clearer
what each define means.

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

+31 -10
+27 -8
Documentation/DocBook/media/dvb/dvbproperty.xml
··· 468 468 469 469 <section id="fe-rolloff-t"> 470 470 <title>fe_rolloff type</title> 471 - <programlisting> 472 - typedef enum fe_rolloff { 473 - ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */ 474 - ROLLOFF_20, 475 - ROLLOFF_25, 476 - ROLLOFF_AUTO, 477 - } fe_rolloff_t; 478 - </programlisting> 471 + <table pgwide="1" frame="none" id="fe-rolloff"> 472 + <title>enum fe_rolloff</title> 473 + <tgroup cols="2"> 474 + &cs-def; 475 + <thead> 476 + <row> 477 + <entry>ID</entry> 478 + <entry>Description</entry> 479 + </row> 480 + </thead> 481 + <tbody valign="top"> 482 + <row> 483 + <entry align="char" id="ROLLOFF-35"><constant>ROLLOFF_35</constant></entry> 484 + <entry align="char">Roloff factor: &alpha;=35%</entry> 485 + </row><row> 486 + <entry align="char" id="ROLLOFF-20"><constant>ROLLOFF_20</constant></entry> 487 + <entry align="char">Roloff factor: &alpha;=20%</entry> 488 + </row><row> 489 + <entry align="char" id="ROLLOFF-25"><constant>ROLLOFF_25</constant></entry> 490 + <entry align="char">Roloff factor: &alpha;=25%</entry> 491 + </row><row> 492 + <entry align="char" id="ROLLOFF-AUTO"><constant>ROLLOFF_AUTO</constant></entry> 493 + <entry align="char">Auto-detect the roloff factor.</entry> 494 + </row> 495 + </tbody> 496 + </tgroup> 497 + </table> 479 498 </section> 480 499 </section> 481 500 <section id="DTV-DISEQC-SLAVE-REPLY">
+4 -2
include/uapi/linux/dvb/frontend.h
··· 407 407 408 408 typedef enum fe_pilot fe_pilot_t; 409 409 410 - typedef enum fe_rolloff { 410 + enum fe_rolloff { 411 411 ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */ 412 412 ROLLOFF_20, 413 413 ROLLOFF_25, 414 414 ROLLOFF_AUTO, 415 - } fe_rolloff_t; 415 + }; 416 + 417 + typedef enum fe_rolloff fe_rolloff_t; 416 418 417 419 typedef enum fe_delivery_system { 418 420 SYS_UNDEFINED,