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 \
21 IMGFILES := $(patsubst %.b64,%, $(notdir $(shell ls $(MEDIA_SRC_DIR)/*.b64)))
22 OBJIMGFILES := $(addprefix $(MEDIA_OBJ_DIR)/, $(IMGFILES))
23 GENFILES := $(addprefix $(MEDIA_OBJ_DIR)/, $(MEDIA_TEMP))
25 PHONY += cleanmediadocs
28 -@rm -f `find $(MEDIA_OBJ_DIR) -type l` $(GENFILES) $(OBJIMGFILES) 2>/dev/null
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/uapi/linux/videodev2.h) \
60 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/dvb/audio.h) \
61 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/dvb/ca.h) \
62 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/dvb/dmx.h) \
63 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/dvb/frontend.h) \
64 $(shell perl -ne 'print "$$1 " if /\#define\s+([A-Z][^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/dvb/net.h) \
65 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/dvb/video.h) \
66 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/media.h) \
67 $(shell perl -ne 'print "$$1 " if /\#define\s+([^\s]+)\s+_IO/' $(srctree)/include/uapi/linux/v4l2-subdev.h) \
70 $(shell perl -ne 'print "$$1 " if /\#define\s+(DTV_[^\s]+)\s+/' $(srctree)/include/uapi/linux/dvb/frontend.h) \
73 $(shell perl -ne 'print "$$1 " if /^typedef\s+.*\s+(\S+)\;/' $(srctree)/include/uapi/linux/videodev2.h) \
74 $(shell perl -ne 'print "$$1 " if /^typedef\s+.*\s+(\S+)\;/' $(srctree)/include/uapi/linux/dvb/frontend.h)
77 $(shell perl -ne 'print "$$1 " if /^enum\s+([^\s]+)\s+/' \
78 $(srctree)/include/uapi/linux/videodev2.h \
79 $(srctree)/include/uapi/linux/dvb/audio.h \
80 $(srctree)/include/uapi/linux/dvb/ca.h \
81 $(srctree)/include/uapi/linux/dvb/dmx.h \
82 $(srctree)/include/uapi/linux/dvb/frontend.h \
83 $(srctree)/include/uapi/linux/dvb/net.h \
84 $(srctree)/include/uapi/linux/dvb/video.h \
85 $(srctree)/include/uapi/linux/media.h \
86 $(srctree)/include/uapi/linux/v4l2-mediabus.h \
87 $(srctree)/include/uapi/linux/v4l2-subdev.h)
90 $(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;' \
91 $(srctree)/include/uapi/linux/dvb/audio.h \
92 $(srctree)/include/uapi/linux/dvb/ca.h \
93 $(srctree)/include/uapi/linux/dvb/dmx.h \
94 $(srctree)/include/uapi/linux/dvb/frontend.h \
95 $(srctree)/include/uapi/linux/dvb/net.h \
96 $(srctree)/include/uapi/linux/dvb/video.h)
99 $(shell perl -ne 'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree)/include/uapi/linux/videodev2.h) \
100 $(shell perl -ne 'print "$$1 " if (/^struct\s+([^\s\{]+)\s*/)' $(srctree)/include/uapi/linux/dvb/audio.h) \
101 $(shell perl -ne 'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree)/include/uapi/linux/dvb/ca.h) \
102 $(shell perl -ne 'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree)/include/uapi/linux/dvb/dmx.h) \
103 $(shell perl -ne 'print "$$1 " if (!/dtv\_cmds\_h/ && /^struct\s+([^\s]+)\s+/)' $(srctree)/include/uapi/linux/dvb/frontend.h) \
104 $(shell perl -ne 'print "$$1 " if (/^struct\s+([^\s]+)\s+/ && !/_old/)' $(srctree)/include/uapi/linux/dvb/net.h) \
105 $(shell perl -ne 'print "$$1 " if (/^struct\s+([^\s]+)\s+/)' $(srctree)/include/uapi/linux/dvb/video.h) \
106 $(shell perl -ne 'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree)/include/uapi/linux/media.h) \
107 $(shell perl -ne 'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree)/include/uapi/linux/v4l2-subdev.h) \
108 $(shell perl -ne 'print "$$1 " if /^struct\s+([^\s]+)\s+/' $(srctree)/include/uapi/linux/v4l2-mediabus.h)
179 # Generate references to these structs in videodev2.h.xml.
181 -e "s/\(enum *\)v4l2_mpeg_cx2341x_video_\([a-z]*_spatial_filter_type\)/\1<link linkend=\"\2\">v4l2_mpeg_cx2341x_video_\2<\/link>/g" \
182 -e "s/\(\(enum\|struct\) *\)\(v4l2_[a-zA-Z0-9_]*\)/\1<link linkend=\"\3\">\3<\/link>/g" \
183 -e "s/\(V4L2_PIX_FMT_[A-Z0-9_]\+\)\(\s\+v4l2_fourcc\)/<link linkend=\"\1\">\1<\/link>\2/g" \
184 -e ":a;s/\(linkend=\".*\)_\(.*\">\)/\1-\2/;ta" \
185 -e "s/v4l2\-mpeg\-vbi\-ITV0/v4l2-mpeg-vbi-itv0-1/g"
188 -e "s,\(struct\s\+\)\([a-z0-9_]\+\)\(\s\+{\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
189 -e "s,\(}\s\+\)\([a-z0-9_]\+_t\+\),\1\<link linkend=\"\2\">\2\<\/link\>,g" \
190 -e "s,\(define\s\+\)\(DTV_[A-Z0-9_]\+\)\(\s\+[0-9]\+\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
191 -e "s,<link\s\+linkend=\".*\">\(DTV_IOCTL_MAX_MSGS\|dtv_cmds_h\|__.*_old\)<\/link>,\1,g" \
192 -e ":a;s/\(linkend=\".*\)_\(.*\">\)/\1-\2/;ta" \
193 -e "s,\(audio-mixer\|audio-karaoke\|audio-status\|ca-slot-info\|ca-descr-info\|ca-caps\|ca-msg\|ca-descr\|ca-pid\|dmx-filter\|dmx-caps\|video-system\|video-highlight\|video-spu\|video-spu-palette\|video-navi-pack\)-t,\1,g" \
194 -e "s,DTV-ISDBT-LAYER[A-C],DTV-ISDBT-LAYER,g" \
195 -e "s,\(define\s\+\)\([A-Z0-9_]\+\)\(\s\+_IO\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
196 -e "s,\(define\s\+\)\(DTV_[A-Z0-9_]\+\)\(\s\+\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
197 -e "s,<link\s\+linkend=\".*\">\(__.*_OLD\)<\/link>,\1,g" \
198 -e "s/\(linkend\=\"\)FE_SET_PROPERTY/\1FE_GET_PROPERTY/g" \
199 -e "s,<link\s\+linkend=\".*\">\(DTV_ISDBS_TS_ID_LEGACY\|DTV_MAX_COMMAND\|DTV_IOCTL_MAX_MSGS\)<\/link>,\1,g" \
202 # Media targets and dependencies
205 install_media_images = \
206 $(Q)-cp $(OBJIMGFILES) $(MEDIA_SRC_DIR)/*.svg $(MEDIA_SRC_DIR)/v4l/*.svg $(MEDIA_OBJ_DIR)/media_api
208 $(MEDIA_OBJ_DIR)/%: $(MEDIA_SRC_DIR)/%.b64
211 $(MEDIA_OBJ_DIR)/v4l2.xml: $(OBJIMGFILES)
213 @(ln -sf `cd $(MEDIA_SRC_DIR) && /bin/pwd`/v4l/*xml $(MEDIA_OBJ_DIR)/)
214 @(ln -sf `cd $(MEDIA_SRC_DIR) && /bin/pwd`/dvb/*xml $(MEDIA_OBJ_DIR)/)
216 $(MEDIA_OBJ_DIR)/videodev2.h.xml: $(srctree)/include/uapi/linux/videodev2.h $(MEDIA_OBJ_DIR)/v4l2.xml
219 echo "<programlisting>") > $@
221 expand --tabs=8 < $< | \
222 sed $(ESCAPE) $(DOCUMENTED) | \
223 sed 's/i\.e\./&ie;/') >> $@
225 echo "</programlisting>") >> $@
227 $(MEDIA_OBJ_DIR)/audio.h.xml: $(srctree)/include/uapi/linux/dvb/audio.h $(MEDIA_OBJ_DIR)/v4l2.xml
230 echo "<programlisting>") > $@
232 expand --tabs=8 < $< | \
233 sed $(ESCAPE) $(DVB_DOCUMENTED) | \
234 sed 's/i\.e\./&ie;/') >> $@
236 echo "</programlisting>") >> $@
238 $(MEDIA_OBJ_DIR)/ca.h.xml: $(srctree)/include/uapi/linux/dvb/ca.h $(MEDIA_OBJ_DIR)/v4l2.xml
241 echo "<programlisting>") > $@
243 expand --tabs=8 < $< | \
244 sed $(ESCAPE) $(DVB_DOCUMENTED) | \
245 sed 's/i\.e\./&ie;/') >> $@
247 echo "</programlisting>") >> $@
249 $(MEDIA_OBJ_DIR)/dmx.h.xml: $(srctree)/include/uapi/linux/dvb/dmx.h $(MEDIA_OBJ_DIR)/v4l2.xml
252 echo "<programlisting>") > $@
254 expand --tabs=8 < $< | \
255 sed $(ESCAPE) $(DVB_DOCUMENTED) | \
256 sed 's/i\.e\./&ie;/') >> $@
258 echo "</programlisting>") >> $@
260 $(MEDIA_OBJ_DIR)/frontend.h.xml: $(srctree)/include/uapi/linux/dvb/frontend.h $(MEDIA_OBJ_DIR)/v4l2.xml
263 echo "<programlisting>") > $@
265 for ident in $(ENUM_DEFS) ; do \
266 entity=`echo $$ident | tr _ -` ; \
267 r="$$r s/([^\w\-])$$ident([^\w\-])/\1\&$$entity\;\2/g;";\
269 expand --tabs=8 < $< | \
270 sed $(ESCAPE) $(DVB_DOCUMENTED) | \
271 sed 's/i\.e\./&ie;/' | \
272 perl -ne "$$r print $$_;") >> $@
274 echo "</programlisting>") >> $@
276 $(MEDIA_OBJ_DIR)/net.h.xml: $(srctree)/include/uapi/linux/dvb/net.h $(MEDIA_OBJ_DIR)/v4l2.xml
279 echo "<programlisting>") > $@
281 expand --tabs=8 < $< | \
282 sed $(ESCAPE) $(DVB_DOCUMENTED) | \
283 sed 's/i\.e\./&ie;/') >> $@
285 echo "</programlisting>") >> $@
287 $(MEDIA_OBJ_DIR)/video.h.xml: $(srctree)/include/uapi/linux/dvb/video.h $(MEDIA_OBJ_DIR)/v4l2.xml
290 echo "<programlisting>") > $@
292 expand --tabs=8 < $< | \
293 sed $(ESCAPE) $(DVB_DOCUMENTED) | \
294 sed 's/i\.e\./&ie;/') >> $@
296 echo "</programlisting>") >> $@
298 $(MEDIA_OBJ_DIR)/media-entities.tmpl: $(MEDIA_OBJ_DIR)/v4l2.xml
301 echo "<!-- Generated file! Do not edit. -->") >$@
303 echo -e "\n<!-- Functions -->") >>$@
305 for ident in $(FUNCS) ; do \
306 entity=`echo $$ident | tr _ -` ; \
307 echo "<!ENTITY func-$$entity \"<link" \
308 "linkend='func-$$entity'><function>$$ident()</function></link>\">" \
312 echo -e "\n<!-- Ioctls -->") >>$@
314 for ident in `echo $(IOCTLS) | sed -e "s,VIDIOC_RESERVED,,"`; do\
315 entity=`echo $$ident | tr _ -` ; \
316 id=`grep -e "<refname>$$ident" -e "<section id=\"$$ident\"" $$(find $(MEDIA_SRC_DIR) -name *.xml -type f)| sed -r s,"^.*/(.*).xml.*","\1",` ; \
317 if [ "$$id" != "" ]; then echo "<!ENTITY $$entity \"<link" \
318 "linkend='$$id'><constant>$$ident</constant></link>\">" \
320 echo "Warning: undocumented ioctl: $$ident. Please document it at the media DocBook!" >&2; \
324 echo -e "\n<!-- Defines -->") >>$@
326 for ident in $(DEFINES) ; do \
327 entity=`echo $$ident | tr _ -` ; \
328 echo "<!ENTITY $$entity \"<link" \
329 "linkend='$$entity'><constant>$$ident</constant></link>\">" \
333 echo -e "\n<!-- Types -->") >>$@
335 for ident in $(TYPES) ; do \
336 entity=`echo $$ident | tr _ -` ; \
337 echo "<!ENTITY $$entity \"<link" \
338 "linkend='$$entity'>$$ident</link>\">" >>$@ ; \
341 echo -e "\n<!-- Enums -->") >>$@
343 for ident in $(ENUMS) ; do \
344 entity=`echo $$ident | sed -e "s/v4l2_mpeg_cx2341x_video_\([a-z]*_spatial_filter_type\)/\1/" | tr _ -` ; \
345 echo "<!ENTITY $$entity \"enum <link" \
346 "linkend='$$entity'>$$ident</link>\">" >>$@ ; \
349 echo -e "\n<!-- Enum definitions -->") >>$@
351 for ident in $(ENUM_DEFS) ; do \
352 entity=`echo $$ident | tr _ -` ; \
353 echo "<!ENTITY $$entity \"<link" \
354 "linkend='$$entity'><constant>$$ident</constant></link>\">" \
358 echo -e "\n<!-- Structures -->") >>$@
360 for ident in $(STRUCTS) ; do \
361 entity=`echo $$ident | tr _ - | sed s/v4l2-mpeg-vbi-ITV0/v4l2-mpeg-vbi-itv0-1/g` ; \
362 echo "<!ENTITY $$entity \"struct <link" \
363 "linkend='$$entity'>$$ident</link>\">" >>$@ ; \
366 echo -e "\n<!-- Error Codes -->") >>$@
368 for ident in $(ERRORS) ; do \
369 echo "<!ENTITY $$ident \"<errorcode>$$ident</errorcode>" \
370 "error code\">" >>$@ ; \
373 echo -e "\n<!-- Subsections -->") >>$@
375 for file in $(MEDIA_SGMLS) ; do \
376 entity=`echo "$$file" | sed $(FILENAME) -e s/"^([^-]*)"/sub\1/` ; \
377 if ! echo "$$file" | \
378 grep -q -E -e '^(func|vidioc|pixfmt)-' ; then \
379 echo "<!ENTITY sub-$$entity SYSTEM \"$$file\">" >>$@ ; \
383 echo -e "\n<!-- Function Reference -->") >>$@
385 for file in $(MEDIA_SGMLS) ; do \
387 grep -q -E -e '(func|vidioc|pixfmt)-' ; then \
388 entity=`echo "$$file" |sed $(FILENAME)` ; \
389 echo "<!ENTITY $$entity SYSTEM \"$$file\">" >>$@ ; \
393 # Jade can auto-generate a list-of-tables, which includes all structs,
394 # but we only want data types, all types, and sorted please.
395 $(MEDIA_OBJ_DIR)/media-indices.tmpl: $(MEDIA_OBJ_DIR)/v4l2.xml
398 echo "<!-- Generated file! Do not edit. -->") >$@
400 echo -e "\n<index><title>List of Types</title>") >>$@
402 for ident in $(TYPES) ; do \
403 id=`echo $$ident | tr _ -` ; \
404 echo "<indexentry><primaryie><link" \
405 "linkend='$$id'>$$ident</link></primaryie></indexentry>" >>$@ ; \
408 for ident in $(ENUMS) ; do \
409 id=`echo $$ident | sed -e "s/v4l2_mpeg_cx2341x_video_\([a-z]*_spatial_filter_type\)/\1/" | tr _ -`; \
410 echo "<indexentry><primaryie>enum <link" \
411 "linkend='$$id'>$$ident</link></primaryie></indexentry>" >>$@ ; \
414 for ident in $(STRUCTS) ; do \
415 id=`echo $$ident | tr _ - | sed s/v4l2-mpeg-vbi-ITV0/v4l2-mpeg-vbi-itv0-1/g` ; \
416 echo "<indexentry><primaryie>struct <link" \
417 "linkend='$$id'>$$ident</link></primaryie></indexentry>" >>$@ ; \
420 echo "</index>") >>$@