1. 22 Aug, 2015 21 commits
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-ctls: don't document v4l2_ctrl_fill() · 276ce3a8
      Mauro Carvalho Chehab authored
      This is an obsolete function that has several missing
      arguments:
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'id'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'name'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'type'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'min'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'max'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'step'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'def'
      	Warning(.//include/media/v4l2-ctrls.h:340): No description found for parameter 'flags'
      
      However, this is an obsolete function that should be
      removed soon. And are not meant to be used anymore. So,
      instead of documenting those stuff, let's just make
      DocBook to not handle it, by replacing "/**" by "/*".
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      276ce3a8
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-ctrls.h: add to device-drivers DocBook · 8c2721d5
      Mauro Carvalho Chehab authored
      The comments there are using a wrong format. Due to that,
      DocBook were unable to parse it.
      
      Fix the tags format, and add it to device-drivers.xml.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      8c2721d5
    • Mauro Carvalho Chehab's avatar
      [media] DocBook: add dvb_ringbuffer.h to documentation · 2a86e373
      Mauro Carvalho Chehab authored
      There are already some comments at dvb_ringbuffer.h that are ready
      for DocBook, although not properly formatted.
      
      Convert them, fix some issues and add this file to
      the device-drivers DocBook.
      
      While here, put multi-line comments on the right format.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      2a86e373
    • Mauro Carvalho Chehab's avatar
      [media] DocBook: add dvb_math.h to documentation · e08bb6f7
      Mauro Carvalho Chehab authored
      There are already some comments at dvb_math.h that are ready
      for DocBook, although not properly formatted.
      
      Convert them, fix some issues and add this file to
      the device-drivers DocBook.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      e08bb6f7
    • Mauro Carvalho Chehab's avatar
      [media] DocBook: add dvb_frontend.h to documentation · 4f1c1868
      Mauro Carvalho Chehab authored
      There are already some comments at dvb_frontend.h that are ready
      for DocBook, although not properly formatted.
      
      Convert them, and add this file to the device-drivers DocBook.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      4f1c1868
    • Mauro Carvalho Chehab's avatar
      [media] DocBook: add dvb_ca_en50221.h to documentation · fbefb1a8
      Mauro Carvalho Chehab authored
      There are already some tags at dvb_ca_en50221.h, but using a
      different format. Convert them, fix a few entries and add
      to the device-drivers DocBook.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      fbefb1a8
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-subdev: add remaining argument descriptions · 1d8955b2
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-subdev.h:203): No description found for parameter 'ioctl'
      Warning(.//include/media/v4l2-subdev.h:203): No description found for parameter 'compat_ioctl32'
      Warning(.//include/media/v4l2-subdev.h:203): No description found for parameter 'subscribe_event'
      Warning(.//include/media/v4l2-subdev.h:203): No description found for parameter 'unsubscribe_event'
      Warning(.//include/media/v4l2-subdev.h:273): No description found for parameter 's_stream'
      Warning(.//include/media/v4l2-subdev.h:407): No description found for parameter 's_stream'
      Warning(.//include/media/v4l2-subdev.h:623): No description found for parameter 'link_validate'
      Warning(.//include/media/v4l2-subdev.h:623): No description found for parameter 'set_frame_desc'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      1d8955b2
    • Mauro Carvalho Chehab's avatar
      [media] v4l2_subdev: describe ioctl parms at the remaining structs · e44cc20a
      Mauro Carvalho Chehab authored
      Fixes the following warnings:
      
      Warning(.//include/media/v4l2-subdev.h:445): No description found for parameter 'g_sliced_vbi_cap'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'enum_mbus_code'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'enum_frame_size'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'enum_frame_interval'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'get_fmt'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'set_fmt'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'get_selection'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'set_selection'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'get_edid'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'set_edid'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'dv_timings_cap'
      Warning(.//include/media/v4l2-subdev.h:589): No description found for parameter 'enum_dv_timings'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      e44cc20a
    • Mauro Carvalho Chehab's avatar
      [media] v4l2_subdev: describe ioctl parms at v4l2_subdev_video_ops · 914728ab
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'g_std'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 's_std'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'querystd'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'cropcap'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'g_crop'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 's_crop'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'g_parm'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 's_parm'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'g_frame_interval'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 's_frame_interval'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 's_dv_timings'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'g_dv_timings'
      Warning(.//include/media/v4l2-subdev.h:381): No description found for parameter 'query_dv_timings'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      914728ab
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-subdev: reorder the v4l2_subdev_video_ops comments · b84aeb03
      Mauro Carvalho Chehab authored
      The comments for struct v4l2_subdev_video_ops are out of the
      order as the parameter would appear at struct. This is not
      a problem for DocBook, but humans find harder to mentally
      reorder ;)
      
      So, put them at the right order. That makes easier to check
      what's missing, and to put the comments in the right place.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      b84aeb03
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-subdev: Add description for radio ioctl handlers · 91963aae
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-subdev.h:224): No description found for parameter 's_radio'
      Warning(.//include/media/v4l2-subdev.h:224): No description found for parameter 's_frequency'
      Warning(.//include/media/v4l2-subdev.h:224): No description found for parameter 'enum_freq_bands'
      Warning(.//include/media/v4l2-subdev.h:224): No description found for parameter 'g_tuner'
      Warning(.//include/media/v4l2-subdev.h:224): No description found for parameter 'g_modulator'
      Warning(.//include/media/v4l2-subdev.h:224): No description found for parameter 's_modulator'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      91963aae
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-subdev: Add description for core ioctl handlers · 783001ad
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 'queryctrl'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 'g_ctrl'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 's_ctrl'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 'g_ext_ctrls'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 's_ext_ctrls'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 'try_ext_ctrls'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 'querymenu'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 'g_register'
      Warning(.//include/media/v4l2-subdev.h:183): No description found for parameter 's_register'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      783001ad
    • Mauro Carvalho Chehab's avatar
      [media] v4l2-subdev: convert documentation to the right format · 5c662984
      Mauro Carvalho Chehab authored
      struct v4l2_subdev_core_ops has some kernel-doc-nano documentation
      using a wrong format, with affects the number of stuff reported at
      the DocBook device-drivers.xml.
      
      Properly mark the such comment blocks using the right notation.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      5c662984
    • Mauro Carvalho Chehab's avatar
      [media] Docbook: Fix comments at v4l2-mem2mem.h · 62c0d016
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-mem2mem.h:50): No description found for parameter 'lock'
      Warning(.//include/media/v4l2-mem2mem.h:50): No description found for parameter 'unlock'
      Warning(.//include/media/v4l2-mem2mem.h:167): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:177): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:188): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:197): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:206): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:215): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:226): No description found for parameter 'm2m_ctx'
      Warning(.//include/media/v4l2-mem2mem.h:235): No description found for parameter 'm2m_ctx'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      62c0d016
    • Mauro Carvalho Chehab's avatar
      [media] Docbook: fix comments at v4l2-flash-led-class.h · 62ba6b22
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-flash-led-class.h:51): bad line: 				unique in the system
      Warning(.//include/media/v4l2-flash-led-class.h:56): bad line: 				definitions are available in the header file
      Warning(.//include/media/v4l2-flash-led-class.h:57): bad line: 				<linux/led-class-flash.h>
      Warning(.//include/media/v4l2-flash-led-class.h:122): No description found for parameter 'ops'
      Warning(.//include/media/v4l2-flash-led-class.h:122): Excess function parameter 'flash_ops' description in 'v4l2_flash_init'
      Warning(.//include/media/v4l2-flash-led-class.h:130): No description found for parameter 'v4l2_flash'
      Warning(.//include/media/v4l2-flash-led-class.h:130): Excess function parameter 'flash' description in 'v4l2_flash_release'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      62ba6b22
    • Mauro Carvalho Chehab's avatar
      [media] Docbook: Fix s_rx_carrier_range parameter description · fa810845
      Mauro Carvalho Chehab authored
      Warning(.//include/media/rc-core.h:178): No description found for parameter 's_rx_carrier_range'
      Warning(.//include/media/rc-core.h:178): Excess struct/union/enum/typedef member 's_rx_carrier' description in 'rc_dev'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      fa810845
    • Mauro Carvalho Chehab's avatar
      [media] Docbook: Fix comments at v4l2-async.h · f8b27377
      Mauro Carvalho Chehab authored
      Warning(.//include/media/v4l2-async.h:62): No description found for parameter 'match_type'
      Warning(.//include/media/v4l2-async.h:62): Excess struct/union/enum/typedef member 'bus_type' description in 'v4l2_async_subdev'
      Warning(.//include/media/v4l2-async.h:76): cannot understand function prototype: 'struct v4l2_async_notifier '
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      f8b27377
    • Mauro Carvalho Chehab's avatar
      [media] DocBook/media/Makefile: Avoid make htmldocs to fail · 5240f4e6
      Mauro Carvalho Chehab authored
      If make is called twice like that:
      	make V=1 DOCBOOKS=device-drivers.xml htmldocs
      
      Make will fail with:
      
      	make -f ./scripts/Makefile.build obj=scripts/basic
      	rm -f .tmp_quiet_recordmcount
      	make -f ./scripts/Makefile.build obj=scripts build_docproc
      	make -f ./scripts/Makefile.build obj=Documentation/DocBook htmldocs
      	rm -rf Documentation/DocBook/index.html; echo '<h1>Linux Kernel HTML Documentation</h1>' >> Documentation/DocBook/index.html && echo '<h2>Kernel Version: 4.2.0-rc2</h2>' >> Documentation/DocBook/index.html && cat Documentation/DocBook/device-drivers.html >> Documentation/DocBook/index.html
      	cp ./Documentation/DocBook//bayer.png ./Documentation/DocBook//constraints.png ./Documentation/DocBook//crop.gif ./Documentation/DocBook//dvbstb.png ./Documentation/DocBook//fieldseq_bt.gif ./Documentation/DocBook//fieldseq_tb.gif ./Documentation/DocBook//nv12mt.gif ./Documentation/DocBook//nv12mt_example.gif ./Documentation/DocBook//pipeline.png ./Documentation/DocBook//selection.png ./Documentation/DocBook//vbi_525.gif ./Documentation/DocBook//vbi_625.gif ./Documentation/DocBook//vbi_hsync.gif ./Documentation/DocBook/media/*.svg ./Documentation/DocBook/media/v4l/*.svg ./Documentation/DocBook//media_api
      	cp: target './Documentation/DocBook//media_api' is not a directory
      	Documentation/DocBook/Makefile:53: recipe for target 'htmldocs' failed
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      5240f4e6
    • Mauro Carvalho Chehab's avatar
      [media] Docbook: Fix description of struct media_devnode · ec0255ca
      Mauro Carvalho Chehab authored
      Warning(.//include/media/media-devnode.h:80): No description found for parameter 'fops'
      Warning(.//include/media/media-devnode.h:80): No description found for parameter 'dev'
      Warning(.//include/media/media-devnode.h:80): No description found for parameter 'cdev'
      Warning(.//include/media/media-devnode.h:80): No description found for parameter 'release'
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      ec0255ca
    • Mauro Carvalho Chehab's avatar
      [media] DocBook/device-drivers: Add drivers/media core stuff · dc2c8bd3
      Mauro Carvalho Chehab authored
      There are lots of docbook marks at the media subsystem, but
      those aren't used.
      
      Add the core headers/code in order to start generating docs.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      dc2c8bd3
    • Mauro Carvalho Chehab's avatar
      [media] DocBook: fix an unbalanced <para> tag · 88c25dcb
      Mauro Carvalho Chehab authored
      The </para> got lost on some change at the DVB docbook, making
      the tag unbalanced and causing a warning. Fix it.
      Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
      Acked-by: default avatarJonathan Corbet <corbet@lwn.net>
      88c25dcb
  2. 17 Aug, 2015 1 commit
  3. 16 Aug, 2015 14 commits
  4. 11 Aug, 2015 4 commits