2 # Media build rules - Auto-generates media contents/indexes and *.h xml's
7 MEDIA_OBJ_DIR
=$(objtree
)/Documentation
/DocBook
/
8 MEDIA_SRC_DIR
=$(srctree
)/Documentation
/DocBook
/media
10 MEDIA_TEMP
= media-entities.tmpl \
22 IMGFILES
:= $(addprefix $(MEDIA_OBJ_DIR
)/media
/, $(notdir $(shell ls
$(MEDIA_SRC_DIR
)/*/*.gif
$(MEDIA_SRC_DIR
)/*/*.png
)))
23 GENFILES
:= $(addprefix $(MEDIA_OBJ_DIR
)/, $(MEDIA_TEMP
))
25 PHONY
+= cleanmediadocs mediaindexdocs
28 -@
rm `find $(MEDIA_OBJ_DIR) -type l` $(GENFILES
) $(IMGFILES
)
30 $(obj
)/media_api.xml
: $(GENFILES
) FORCE
32 #$(MEDIA_OBJ_DIR)/media_api.html: $(MEDIA_OBJ_DIR)/media_api.xml
33 #$(MEDIA_OBJ_DIR)/media_api.pdf: $(MEDIA_OBJ_DIR)/media_api.xml
34 #$(MEDIA_OBJ_DIR)/media_api.ps: $(MEDIA_OBJ_DIR)/media_api.xml
37 $(shell ls
$(MEDIA_SRC_DIR
)/v4l
/*.xml|perl
-ne
'print "$$1 " if (m,.*/(.*)\n,)') \
43 $(shell ls
$(MEDIA_SRC_DIR
)/dvb
/*.xml|perl
-ne
'print "$$1 " if (m,.*/(.*)\n,)')
45 MEDIA_SGMLS
= $(addprefix .
/,$(V4L_SGMLS
)) $(addprefix .
/,$(DVB_SGMLS
)) $(addprefix .
/,$(MEDIA_TEMP
))
59 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/videodev2.h
) \
60 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/audio.h
) \
61 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/ca.h
) \
62 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/dmx.h
) \
63 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/frontend.h
) \
64 $(shell perl
-ne
'print "$$1 " if /\#define\s+([A-Z][^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/net.h
) \
65 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/osd.h
) \
66 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/dvb
/video.h
) \
67 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/media.h
) \
68 $(shell perl
-ne
'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree
)/include/linux
/v4l2-subdev.h
) \
69 VIDIOC_SUBDEV_G_FRAME_INTERVAL \
70 VIDIOC_SUBDEV_S_FRAME_INTERVAL \
71 VIDIOC_SUBDEV_ENUM_MBUS_CODE \
72 VIDIOC_SUBDEV_ENUM_FRAME_SIZE \
73 VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL \
76 $(shell perl
-ne
'print "$$1 " if /^typedef\s+[^\s]+\s+([^\s]+)\;/' $(srctree
)/include/linux
/videodev2.h
) \
77 $(shell perl
-ne
'print "$$1 " if /^}\s+([a-z0-9_]+_t)/' $(srctree
)/include/linux
/dvb
/frontend.h
)
80 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/videodev2.h
) \
81 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/audio.h
) \
82 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/ca.h
) \
83 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/dmx.h
) \
84 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/frontend.h
) \
85 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/net.h
) \
86 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/osd.h
) \
87 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/dvb
/video.h
) \
88 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/media.h
) \
89 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/v4l2-mediabus.h
) \
90 $(shell perl
-ne
'print "$$1 " if /^enum\s+([^\s]+)\s+/' $(srctree
)/include/linux
/v4l2-subdev.h
)
93 $(shell perl
-ne
'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree
)/include/linux
/videodev2.h
) \
94 $(shell perl
-ne
'print "$$1 " if (/^struct\s+([^\s\{]+)\s*/)' $(srctree
)/include/linux
/dvb
/audio.h
) \
95 $(shell perl
-ne
'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree
)/include/linux
/dvb
/ca.h
) \
96 $(shell perl
-ne
'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree
)/include/linux
/dvb
/dmx.h
) \
97 $(shell perl
-ne
'print "$$1 " if (!/dtv\_cmds\_h/ && /^struct\s+([^\s]+)\s+/)' $(srctree
)/include/linux
/dvb
/frontend.h
) \
98 $(shell perl
-ne
'print "$$1 " if (/^struct\s+([A-Z][^\s]+)\s+/)' $(srctree
)/include/linux
/dvb
/net.h
) \
99 $(shell perl
-ne
'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree
)/include/linux
/dvb
/osd.h
) \
100 $(shell perl
-ne
'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree
)/include/linux
/dvb
/video.h
) \
101 $(shell perl
-ne
'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree
)/include/linux
/media.h
) \
102 $(shell perl
-ne
'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree
)/include/linux
/v4l2-subdev.h
) \
103 $(shell perl
-ne
'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree
)/include/linux
/v4l2-mediabus.h
)
138 # Generate references to these structs in videodev2.h.xml.
140 -e
"s/\(enum *\)v4l2_mpeg_cx2341x_video_\([a-z]*_spatial_filter_type\)/\1<link linkend=\"\2\">v4l2_mpeg_cx2341x_video_\2<\/link>/g" \
141 -e
"s/\(\(enum\|struct\) *\)\(v4l2_[a-zA-Z0-9_]*\)/\1<link linkend=\"\3\">\3<\/link>/g" \
142 -e
"s/\(V4L2_PIX_FMT_[A-Z0-9_]\+\) /<link linkend=\"\1\">\1<\/link> /g" \
143 -e
":a;s/\(linkend=\".*\)_\(.*\">\)/\1-\2/;ta" \
144 -e
"s/v4l2\-mpeg\-vbi\-ITV0/v4l2-mpeg-vbi-itv0-1/g"
147 -e
"s/\(linkend\=\"\)FE_SET_PROPERTY/\1FE_GET_PROPERTY/g" \
148 -e
"s,\(struct\s\+\)\([a-z0-9_]\+\)\(\s\+{\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
149 -e
"s,\(}\s\+\)\([a-z0-9_]\+_t\+\),\1\<link linkend=\"\2\">\2\<\/link\>,g" \
150 -e
"s,\(define\s\+\)\(DTV_[A-Z0-9_]\+\)\(\s\+[0-9]\+\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
151 -e
"s,<link linkend=\".*\">\(DTV_IOCTL_MAX_MSGS\|dtv_cmds_h\)<\/link>,\1,g" \
152 -e
":a;s/\(linkend=\".*\)_\(.*\">\)/\1-\2/;ta" \
153 -e
"s,DTV-ISDBT-LAYER[A-C],DTV-ISDBT-LAYER,g" \
154 -e
"s,\(define\s\+\)\([A-Z0-9_]\+\)\(\s\+_IO\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
157 # Media targets and dependencies
160 $(MEDIA_OBJ_DIR
)/v4l2.xml
:
162 @
(mkdir
-p
$(MEDIA_OBJ_DIR
)/media
)
163 @
(cp
$(MEDIA_SRC_DIR
)/dvb
/*.png
$(MEDIA_SRC_DIR
)/v4l
/*.gif
$(MEDIA_OBJ_DIR
)/media
/)
164 @
(ln
-sf
$(MEDIA_SRC_DIR
)/v4l
/*xml
$(MEDIA_OBJ_DIR
)/)
165 @
(ln
-sf
$(MEDIA_SRC_DIR
)/dvb
/*xml
$(MEDIA_OBJ_DIR
)/)
167 $(MEDIA_OBJ_DIR
)/videodev2.h.xml
: $(srctree
)/include/linux
/videodev2.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
170 echo
"<programlisting>") > $@
172 expand
--tabs
=8 < $< | \
173 sed
$(ESCAPE
) $(DOCUMENTED
) | \
174 sed
's/i\.e\./&ie;/') >> $@
176 echo
"</programlisting>") >> $@
178 $(MEDIA_OBJ_DIR
)/audio.h.xml
: $(srctree
)/include/linux
/dvb
/audio.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
181 echo
"<programlisting>") > $@
183 expand
--tabs
=8 < $< | \
184 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
185 sed
's/i\.e\./&ie;/') >> $@
187 echo
"</programlisting>") >> $@
189 $(MEDIA_OBJ_DIR
)/ca.h.xml
: $(srctree
)/include/linux
/dvb
/ca.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
192 echo
"<programlisting>") > $@
194 expand
--tabs
=8 < $< | \
195 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
196 sed
's/i\.e\./&ie;/') >> $@
198 echo
"</programlisting>") >> $@
200 $(MEDIA_OBJ_DIR
)/dmx.h.xml
: $(srctree
)/include/linux
/dvb
/dmx.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
203 echo
"<programlisting>") > $@
205 expand
--tabs
=8 < $< | \
206 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
207 sed
's/i\.e\./&ie;/') >> $@
209 echo
"</programlisting>") >> $@
211 $(MEDIA_OBJ_DIR
)/frontend.h.xml
: $(srctree
)/include/linux
/dvb
/frontend.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
214 echo
"<programlisting>") > $@
216 expand
--tabs
=8 < $< | \
217 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
218 sed
's/i\.e\./&ie;/') >> $@
220 echo
"</programlisting>") >> $@
222 $(MEDIA_OBJ_DIR
)/net.h.xml
: $(srctree
)/include/linux
/dvb
/net.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
225 echo
"<programlisting>") > $@
227 expand
--tabs
=8 < $< | \
228 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
229 sed
's/i\.e\./&ie;/') >> $@
231 echo
"</programlisting>") >> $@
233 $(MEDIA_OBJ_DIR
)/osd.h.xml
: $(srctree
)/include/linux
/dvb
/osd.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
236 echo
"<programlisting>") > $@
238 expand
--tabs
=8 < $< | \
239 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
240 sed
's/i\.e\./&ie;/') >> $@
242 echo
"</programlisting>") >> $@
244 $(MEDIA_OBJ_DIR
)/video.h.xml
: $(srctree
)/include/linux
/dvb
/video.h
$(MEDIA_OBJ_DIR
)/v4l2.xml
247 echo
"<programlisting>") > $@
249 expand
--tabs
=8 < $< | \
250 sed
$(ESCAPE
) $(DVB_DOCUMENTED
) | \
251 sed
's/i\.e\./&ie;/') >> $@
253 echo
"</programlisting>") >> $@
255 $(MEDIA_OBJ_DIR
)/media-entities.tmpl
: $(MEDIA_OBJ_DIR
)/v4l2.xml
258 echo
"<!-- Generated file! Do not edit. -->") >$@
260 echo
-e
"\n<!-- Functions -->") >>$@
262 for ident in
$(FUNCS
) ; do \
263 entity
=`echo $$ident | tr _ -` ; \
264 echo
"<!ENTITY func-$$entity \"<link" \
265 "linkend='func-$$entity'><function>$$ident()</function></link>\">" \
269 echo
-e
"\n<!-- Ioctls -->") >>$@
271 for ident in
$(IOCTLS
) ; do \
272 entity
=`echo $$ident | tr _ -` ; \
273 id
=`grep "<refname>$$ident" $(MEDIA_OBJ_DIR)/vidioc-*.xml | sed -r s,"^.*/(.*).xml.*","\1",` ; \
274 echo
"<!ENTITY $$entity \"<link" \
275 "linkend='$$id'><constant>$$ident</constant></link>\">" \
279 echo
-e
"\n<!-- Types -->") >>$@
281 for ident in
$(TYPES
) ; do \
282 entity
=`echo $$ident | tr _ -` ; \
283 echo
"<!ENTITY $$entity \"<link" \
284 "linkend='$$entity'>$$ident</link>\">" >>$@
; \
287 echo
-e
"\n<!-- Enums -->") >>$@
289 for ident in
$(ENUMS
) ; do \
290 entity
=`echo $$ident | sed -e "s/v4l2_mpeg_cx2341x_video_\([a-z]*_spatial_filter_type\)/\1/" | tr _ -` ; \
291 echo
"<!ENTITY $$entity \"enum <link" \
292 "linkend='$$entity'>$$ident</link>\">" >>$@
; \
295 echo
-e
"\n<!-- Structures -->") >>$@
297 for ident in
$(STRUCTS
) ; do \
298 entity
=`echo $$ident | tr _ - | sed s/v4l2-mpeg-vbi-ITV0/v4l2-mpeg-vbi-itv0-1/g` ; \
299 echo
"<!ENTITY $$entity \"struct <link" \
300 "linkend='$$entity'>$$ident</link>\">" >>$@
; \
303 echo
-e
"\n<!-- Error Codes -->") >>$@
305 for ident in
$(ERRORS
) ; do \
306 echo
"<!ENTITY $$ident \"<errorcode>$$ident</errorcode>" \
307 "error code\">" >>$@
; \
310 echo
-e
"\n<!-- Subsections -->") >>$@
312 for file in
$(MEDIA_SGMLS
) ; do \
313 entity
=`echo "$$file" | sed $(FILENAME) -e s/"^([^-]*)"/sub\1/` ; \
314 if
! echo
"$$file" | \
315 grep
-q
-E
-e
'^(func|vidioc|pixfmt)-' ; then \
316 echo
"<!ENTITY sub-$$entity SYSTEM \"$$file\">" >>$@
; \
320 echo
-e
"\n<!-- Function Reference -->") >>$@
322 for file in
$(MEDIA_SGMLS
) ; do \
324 grep
-q
-E
-e
'(func|vidioc|pixfmt)-' ; then \
325 entity
=`echo "$$file" |sed $(FILENAME)` ; \
326 echo
"<!ENTITY $$entity SYSTEM \"$$file\">" >>$@
; \
330 # Jade can auto-generate a list-of-tables, which includes all structs,
331 # but we only want data types, all types, and sorted please.
332 $(MEDIA_OBJ_DIR
)/media-indices.tmpl
: $(MEDIA_OBJ_DIR
)/v4l2.xml
335 echo
"<!-- Generated file! Do not edit. -->") >$@
337 echo
-e
"\n<index><title>List of Types</title>") >>$@
339 for ident in
$(TYPES
) ; do \
340 id
=`echo $$ident | tr _ -` ; \
341 echo
"<indexentry><primaryie><link" \
342 "linkend='$$id'>$$ident</link></primaryie></indexentry>" >>$@
; \
345 for ident in
$(ENUMS
) ; do \
346 id
=`echo $$ident | sed -e "s/v4l2_mpeg_cx2341x_video_\([a-z]*_spatial_filter_type\)/\1/" | tr _ -`; \
347 echo
"<indexentry><primaryie>enum <link" \
348 "linkend='$$id'>$$ident</link></primaryie></indexentry>" >>$@
; \
351 for ident in
$(STRUCTS
) ; do \
352 id
=`echo $$ident | tr _ - | sed s/v4l2-mpeg-vbi-ITV0/v4l2-mpeg-vbi-itv0-1/g` ; \
353 echo
"<indexentry><primaryie>struct <link" \
354 "linkend='$$id'>$$ident</link></primaryie></indexentry>" >>$@
; \
357 echo
"</index>") >>$@