[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>
This commit is contained in:
Mauro Carvalho Chehab 2015-06-07 11:59:27 -03:00
parent ff50574c17
commit b35f6ba978
2 changed files with 31 additions and 10 deletions

View file

@ -468,14 +468,33 @@ get/set up to 64 properties. The actual meaning of each property is described on
<section id="fe-rolloff-t"> <section id="fe-rolloff-t">
<title>fe_rolloff type</title> <title>fe_rolloff type</title>
<programlisting> <table pgwide="1" frame="none" id="fe-rolloff">
typedef enum fe_rolloff { <title>enum fe_rolloff</title>
ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */ <tgroup cols="2">
ROLLOFF_20, &cs-def;
ROLLOFF_25, <thead>
ROLLOFF_AUTO, <row>
} fe_rolloff_t; <entry>ID</entry>
</programlisting> <entry>Description</entry>
</row>
</thead>
<tbody valign="top">
<row>
<entry align="char" id="ROLLOFF-35"><constant>ROLLOFF_35</constant></entry>
<entry align="char">Roloff factor: &alpha;=35%</entry>
</row><row>
<entry align="char" id="ROLLOFF-20"><constant>ROLLOFF_20</constant></entry>
<entry align="char">Roloff factor: &alpha;=20%</entry>
</row><row>
<entry align="char" id="ROLLOFF-25"><constant>ROLLOFF_25</constant></entry>
<entry align="char">Roloff factor: &alpha;=25%</entry>
</row><row>
<entry align="char" id="ROLLOFF-AUTO"><constant>ROLLOFF_AUTO</constant></entry>
<entry align="char">Auto-detect the roloff factor.</entry>
</row>
</tbody>
</tgroup>
</table>
</section> </section>
</section> </section>
<section id="DTV-DISEQC-SLAVE-REPLY"> <section id="DTV-DISEQC-SLAVE-REPLY">

View file

@ -407,12 +407,14 @@ enum fe_pilot {
typedef enum fe_pilot fe_pilot_t; typedef enum fe_pilot fe_pilot_t;
typedef enum fe_rolloff { enum fe_rolloff {
ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */ ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */
ROLLOFF_20, ROLLOFF_20,
ROLLOFF_25, ROLLOFF_25,
ROLLOFF_AUTO, ROLLOFF_AUTO,
} fe_rolloff_t; };
typedef enum fe_rolloff fe_rolloff_t;
typedef enum fe_delivery_system { typedef enum fe_delivery_system {
SYS_UNDEFINED, SYS_UNDEFINED,