xiaomi-sm8450/android_kernel_xiaomi_sm8450
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[media] DocBook: Change format for enum dmx_output documentation

Browse Source 
Use a table for the Demux output. No new information added
here. They were all merged inside the table.

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
This commit is contained in:
Mauro Carvalho Chehab
2015-06-07 19:29:43 -03:00
parent 6c72edab02
commit 6eab8043f9
3 changed files with 47 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
Documentation/DocBook/media/Makefile
View File

@@ -88,12 +88,8 @@ ENUMS = \
ENUM_DEFS = \ ENUM_DEFS = \
$(shell perl -e 'open IN,"cat @ARGV| cpp -fpreprocessed |"; while (<IN>) { if ($$enum) {print "$$1\n" if (/\s*([A-Z]\S+)\b/); } $$enum = 0 if ($$enum && /^\}/); $$enum = 1 if(/^\s*enum\s/); }; close IN;' \ $(shell perl -e 'open IN,"cat @ARGV| cpp -fpreprocessed |"; while (<IN>) { if ($$enum) {print "$$1\n" if (/\s*([A-Z]\S+)\b/); } $$enum = 0 if ($$enum && /^\}/); $$enum = 1 if(/^\s*enum\s/); }; close IN;' \
$(srctree)/include/uapi/linux/dvb/audio.h \
$(srctree)/include/uapi/linux/dvb/ca.h \
$(srctree)/include/uapi/linux/dvb/dmx.h \ $(srctree)/include/uapi/linux/dvb/dmx.h \
$(srctree)/include/uapi/linux/dvb/frontend.h \ $(srctree)/include/uapi/linux/dvb/frontend.h)
$(srctree)/include/uapi/linux/dvb/net.h \
$(srctree)/include/uapi/linux/dvb/video.h)
STRUCTS = \ STRUCTS = \
$(shell perl -ne 'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree)/include/uapi/linux/videodev2.h) \ $(shell perl -ne 'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree)/include/uapi/linux/videodev2.h) \
@@ -251,9 +247,14 @@ $(MEDIA_OBJ_DIR)/dmx.h.xml: $(srctree)/include/uapi/linux/dvb/dmx.h $(MEDIA_OBJ_
@( \ @( \
echo "<programlisting>") > $@ echo "<programlisting>") > $@
@( \ @( \
for ident in $(ENUM_DEFS) ; do \
entity=`echo $$ident | tr _ -` ; \
r="$$r s/([^\w\-])$$ident([^\w\-])/\1\&$$entity\;\2/g;";\
done; \
expand --tabs=8 < $< | \ expand --tabs=8 < $< | \
sed $(ESCAPE) $(DVB_DOCUMENTED) | \ sed $(ESCAPE) $(DVB_DOCUMENTED) | \
sed 's/i\.e\./&ie;/') >> $@ sed 's/i\.e\./&ie;/' | \
perl -ne "$$r print $$_;") >> $@
@( \ @( \
echo "</programlisting>") >> $@ echo "</programlisting>") >> $@

57
Documentation/DocBook/media/dvb/demux.xml
View File

@@ -8,26 +8,43 @@ accessed by including <constant>linux/dvb/dmx.h</constant> in your application.
<title>Demux Data Types</title> <title>Demux Data Types</title>
<section id="dmx-output-t"> <section id="dmx-output-t">
<title>dmx_output_t</title> <title>Output for the demux</title>
<programlisting>
typedef enum <table pgwide="1" frame="none" id="dmx-output">
{ <title>enum dmx_output</title>
DMX_OUT_DECODER, /&#x22C6; Streaming directly to decoder. &#x22C6;/ <tgroup cols="2">
DMX_OUT_TAP, /&#x22C6; Output going to a memory buffer &#x22C6;/ &cs-def;
/&#x22C6; (to be retrieved via the read command).&#x22C6;/ <thead>
DMX_OUT_TS_TAP, /&#x22C6; Output multiplexed into a new TS &#x22C6;/ <row>
/&#x22C6; (to be retrieved by reading from the &#x22C6;/ <entry>ID</entry>
/&#x22C6; logical DVR device). &#x22C6;/ <entry>Description</entry>
DMX_OUT_TSDEMUX_TAP /&#x22C6; Like TS_TAP but retrieved from the DMX device &#x22C6;/ </row>
} dmx_output_t; </thead>
</programlisting> <tbody valign="top">
<para><constant>DMX_OUT_TAP</constant> delivers the stream output to the demux device on which the ioctl is <row>
called. <entry align="char" id="DMX-OUT-DECODER">DMX_OUT_DECODER</entry>
</para> <entry>Streaming directly to decoder.</entry>
<para><constant>DMX_OUT_TS_TAP</constant> routes output to the logical DVR device <constant>/dev/dvb/adapter?/dvr?</constant>, </row><row>
which delivers a TS multiplexed from all filters for which <constant>DMX_OUT_TS_TAP</constant> was <entry align="char" id="DMX-OUT-TAP">DMX_OUT_TAP</entry>
specified. <entry>Output going to a memory buffer (to be retrieved via the
</para> read command). Delivers the stream output to the demux
device on which the ioctl is called.</entry>
</row><row>
<entry align="char" id="DMX-OUT-TS-TAP">DMX_OUT_TS_TAP</entry>
<entry>Output multiplexed into a new TS (to be retrieved by
reading from the logical DVR device). Routes output to the
logical DVR device <constant>/dev/dvb/adapter?/dvr?</constant>,
which delivers a TS multiplexed from all filters for which
<constant>DMX_OUT_TS_TAP</constant> was specified.</entry>
</row><row>
<entry align="char" id="DMX-OUT-TSDEMUX-TAP">DMX_OUT_TSDEMUX_TAP</entry>
<entry>Like &DMX-OUT-TS-TAP; but retrieved from the DMX
device.</entry>
</row>
</tbody>
</tgroup>
</table>
</section> </section>
<section id="dmx-input-t"> <section id="dmx-input-t">

6
include/uapi/linux/dvb/dmx.h
View File

@@ -32,7 +32,7 @@
#define DMX_FILTER_SIZE 16 #define DMX_FILTER_SIZE 16
typedef enum dmx_output enum dmx_output
{ {
DMX_OUT_DECODER, /* Streaming directly to decoder. */ DMX_OUT_DECODER, /* Streaming directly to decoder. */
DMX_OUT_TAP, /* Output going to a memory buffer */ DMX_OUT_TAP, /* Output going to a memory buffer */
@@ -41,8 +41,9 @@ typedef enum dmx_output
/* (to be retrieved by reading from the */ /* (to be retrieved by reading from the */
/* logical DVR device). */ /* logical DVR device). */
DMX_OUT_TSDEMUX_TAP /* Like TS_TAP but retrieved from the DMX device */ DMX_OUT_TSDEMUX_TAP /* Like TS_TAP but retrieved from the DMX device */
} dmx_output_t; };
typedef enum dmx_output dmx_output_t;
typedef enum dmx_input typedef enum dmx_input
{ {
@@ -139,7 +140,6 @@ struct dmx_stc {
__u64 stc; /* output: stc in 'base'*90 kHz units */ __u64 stc; /* output: stc in 'base'*90 kHz units */
}; };
#define DMX_START _IO('o', 41) #define DMX_START _IO('o', 41)
#define DMX_STOP _IO('o', 42) #define DMX_STOP _IO('o', 42)
#define DMX_SET_FILTER _IOW('o', 43, struct dmx_sct_filter_params) #define DMX_SET_FILTER _IOW('o', 43, struct dmx_sct_filter_params)