Hi Jani, [auto build test WARNING on v4.4-rc8] [also build test WARNING on next-20160120] [if your patch is applied to the wrong git tree, please drop us a note to help improving the system] url: https://github.com/0day-ci/linux/commits/Jani-Nikula/drm-i915-doc-add-power-management-section-to-documentation/20160120-180543 reproduce: make htmldocs All warnings (new ones prefixed by >>): drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt' include/drm/drm_crtc.h:310: warning: No description found for parameter 'mode_blob' include/drm/drm_crtc.h:737: warning: No description found for parameter 'tile_blob_ptr' include/drm/drm_crtc.h:776: warning: No description found for parameter 'rotation' include/drm/drm_crtc.h:872: warning: No description found for parameter 'mutex' include/drm/drm_crtc.h:872: warning: No description found for parameter 'helper_private' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tile_idr' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'delayed_event' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'edid_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dpms_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'path_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tile_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'plane_type_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'rotation_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_x' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_y' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_w' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_src_h' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_x' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_y' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_w' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_h' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_fb_id' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_crtc_id' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_active' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'prop_mode_id' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dvi_i_subconnector_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dvi_i_select_subconnector_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_subconnector_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_select_subconnector_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_mode_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_left_margin_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_right_margin_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_top_margin_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_bottom_margin_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_brightness_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_contrast_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_flicker_reduction_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_overscan_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_saturation_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'tv_hue_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'scaling_mode_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'aspect_ratio_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'dirty_info_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'suggested_x_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'suggested_y_property' include/drm/drm_crtc.h:1157: warning: No description found for parameter 'allow_fb_modifiers' include/drm/drm_fb_helper.h:148: warning: No description found for parameter 'connector_info' include/drm/drm_dp_helper.h:713: warning: No description found for parameter 'i2c_nack_count' include/drm/drm_dp_helper.h:713: warning: No description found for parameter 'i2c_defer_count' drivers/gpu/drm/drm_dp_mst_topology.c:2227: warning: No description found for parameter 'connector' include/drm/drm_dp_mst_helper.h:97: warning: No description found for parameter 'cached_edid' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'max_dpcd_transaction_bytes' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'sink_count' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'total_slots' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'avail_slots' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'total_pbn' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'qlock' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_msg_downq' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_msg_upq' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_down_in_progress' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_up_in_progress' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'payload_lock' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'proposed_vcpis' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'payloads' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'payload_mask' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'vcpi_mask' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_waitq' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'work' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'tx_work' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'destroy_connector_list' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'destroy_connector_lock' include/drm/drm_dp_mst_helper.h:472: warning: No description found for parameter 'destroy_connector_work' drivers/gpu/drm/drm_dp_mst_topology.c:2227: warning: No description found for parameter 'connector' drivers/gpu/drm/drm_irq.c:173: warning: No description found for parameter 'flags' include/drm/drmP.h:168: warning: No description found for parameter 'fmt' include/drm/drmP.h:184: warning: No description found for parameter 'fmt' include/drm/drmP.h:202: warning: No description found for parameter 'fmt' include/drm/drmP.h:247: warning: No description found for parameter 'dev' include/drm/drmP.h:247: warning: No description found for parameter 'data' include/drm/drmP.h:247: warning: No description found for parameter 'file_priv' include/drm/drmP.h:280: warning: No description found for parameter 'ioctl' include/drm/drmP.h:280: warning: No description found for parameter '_func' include/drm/drmP.h:280: warning: No description found for parameter '_flags' include/drm/drmP.h:358: warning: cannot understand function prototype: 'struct drm_lock_data ' include/drm/drmP.h:411: warning: cannot understand function prototype: 'struct drm_driver ' include/drm/drmP.h:661: warning: cannot understand function prototype: 'struct drm_info_list ' include/drm/drmP.h:671: warning: cannot understand function prototype: 'struct drm_info_node ' include/drm/drmP.h:681: warning: cannot understand function prototype: 'struct drm_minor ' include/drm/drmP.h:729: warning: cannot understand function prototype: 'struct drm_device ' >> drivers/gpu/drm/i915/intel_pm.c:560: warning: No description found for parameter 'fifo_size' >> drivers/gpu/drm/i915/intel_pm.c:4128: warning: No description found for parameter 'crtc' >> drivers/gpu/drm/i915/intel_pm.c:4153: warning: No description found for parameter 'mchdev_lock' >> drivers/gpu/drm/i915/intel_pm.c:1: warning: no structured comments found Was looking for 'RC6'. >> drivers/gpu/drm/i915/intel_pm.c:560: warning: No description found for parameter 'fifo_size' >> drivers/gpu/drm/i915/intel_pm.c:4128: warning: No description found for parameter 'crtc' >> drivers/gpu/drm/i915/intel_pm.c:4153: warning: No description found for parameter 'mchdev_lock' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'wedged' drivers/gpu/drm/i915/i915_irq.c:2584: warning: No description found for parameter 'fmt' drivers/gpu/drm/i915/i915_gem.c:421: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:421: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:421: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:686: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:686: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:686: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'args' drivers/gpu/drm/i915/i915_gem.c:767: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:1029: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:1029: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:1029: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:1245: warning: No description found for parameter 'rps' drivers/gpu/drm/i915/i915_gem.c:1459: warning: No description found for parameter 'req' drivers/gpu/drm/i915/i915_gem.c:1494: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:1494: warning: No description found for parameter 'readonly' drivers/gpu/drm/i915/i915_gem.c:1617: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:1617: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:1617: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:1680: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:1680: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:1680: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:1725: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:1725: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:1725: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'size' drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'tiling_mode' drivers/gpu/drm/i915/i915_gem.c:2013: warning: No description found for parameter 'fenced' drivers/gpu/drm/i915/i915_gem.c:2013: warning: Excess function parameter 'obj' description in 'i915_gem_get_gtt_alignment' drivers/gpu/drm/i915/i915_gem.c:2876: warning: No description found for parameter 'ring' drivers/gpu/drm/i915/i915_gem.c:3005: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:3055: warning: No description found for parameter 'dev' drivers/gpu/drm/i915/i915_gem.c:3055: warning: No description found for parameter 'data' drivers/gpu/drm/i915/i915_gem.c:3055: warning: No description found for parameter 'file' drivers/gpu/drm/i915/i915_gem.c:3055: warning: Excess function parameter 'DRM_IOCTL_ARGS' description in 'i915_gem_wait_ioctl' drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'vm' drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'ggtt_view' drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'alignment' drivers/gpu/drm/i915/i915_gem.c:3424: warning: No description found for parameter 'flags' drivers/gpu/drm/i915/i915_gem.c:3659: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:3659: warning: No description found for parameter 'write' drivers/gpu/drm/i915/i915_gem.c:3734: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:3734: warning: No description found for parameter 'cache_level' drivers/gpu/drm/i915/i915_gem.c:4014: warning: No description found for parameter 'obj' drivers/gpu/drm/i915/i915_gem.c:4014: warning: No description found for parameter 'write' drivers/gpu/drm/i915/intel_lrc.c:871: warning: No description found for parameter 'params' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dev' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'file' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ring' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ctx' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'batch_obj' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'exec_start' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dispatch_flags' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: No description found for parameter 'params' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dev' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'file' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ring' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'ctx' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'batch_obj' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'exec_start' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_lrc.c:871: warning: Excess function parameter 'dispatch_flags' description in 'intel_execlists_submission' drivers/gpu/drm/i915/intel_guc_loader.c:1: warning: no structured comments found Was looking for 'GuC-specific firmware loader'. drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: No description found for parameter 'rq' drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ctx' description in 'i915_guc_submit' drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ring' description in 'i915_guc_submit' drivers/gpu/drm/i915/i915_guc_submission.c:741: warning: No description found for parameter 'ctx' drivers/gpu/drm/i915/i915_guc_submission.c:1: warning: no structured comments found Was looking for 'GuC-based command submissison'. drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: No description found for parameter 'rq' drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ctx' description in 'i915_guc_submit' drivers/gpu/drm/i915/i915_guc_submission.c:598: warning: Excess function parameter 'ring' description in 'i915_guc_submit' drivers/gpu/drm/i915/i915_guc_submission.c:741: warning: No description found for parameter 'ctx' Warning: didn't use docs for i915_hotplug_interrupt_update Warning: didn't use docs for ilk_update_display_irq Warning: didn't use docs for ilk_update_gt_irq Warning: didn't use docs for snb_update_pm_irq Warning: didn't use docs for bdw_update_port_irq Warning: didn't use docs for ibx_display_interrupt_update Warning: didn't use docs for i915_enable_asle_pipestat Warning: didn't use docs for ivybridge_parity_work Warning: didn't use docs for i915_reset_and_wakeup Warning: didn't use docs for i915_handle_error Warning: didn't use docs for intel_irq_install Warning: didn't use docs for intel_irq_uninstall vim +/fifo_size +560 drivers/gpu/drm/i915/intel_pm.c b445e3b0 Eugeni Dodonov 2012-04-16 544 * Calculate the watermark level (the level at which the display plane will b445e3b0 Eugeni Dodonov 2012-04-16 545 * start fetching from memory again). Each chip has a different display b445e3b0 Eugeni Dodonov 2012-04-16 546 * FIFO size and allocation, so the caller needs to figure that out and pass b445e3b0 Eugeni Dodonov 2012-04-16 547 * in the correct intel_watermark_params structure. b445e3b0 Eugeni Dodonov 2012-04-16 548 * b445e3b0 Eugeni Dodonov 2012-04-16 549 * As the pixel clock runs, the FIFO will be drained at a rate that depends b445e3b0 Eugeni Dodonov 2012-04-16 550 * on the pixel size. When it reaches the watermark level, it'll start b445e3b0 Eugeni Dodonov 2012-04-16 551 * fetching FIFO line sized based chunks from memory until the FIFO fills b445e3b0 Eugeni Dodonov 2012-04-16 552 * past the watermark point. If the FIFO drains completely, a FIFO underrun b445e3b0 Eugeni Dodonov 2012-04-16 553 * will occur, and a display engine hang could result. b445e3b0 Eugeni Dodonov 2012-04-16 554 */ b445e3b0 Eugeni Dodonov 2012-04-16 555 static unsigned long intel_calculate_wm(unsigned long clock_in_khz, b445e3b0 Eugeni Dodonov 2012-04-16 556 const struct intel_watermark_params *wm, b445e3b0 Eugeni Dodonov 2012-04-16 557 int fifo_size, b445e3b0 Eugeni Dodonov 2012-04-16 558 int pixel_size, b445e3b0 Eugeni Dodonov 2012-04-16 559 unsigned long latency_ns) b445e3b0 Eugeni Dodonov 2012-04-16 @560 { b445e3b0 Eugeni Dodonov 2012-04-16 561 long entries_required, wm_size; b445e3b0 Eugeni Dodonov 2012-04-16 562 b445e3b0 Eugeni Dodonov 2012-04-16 563 /* b445e3b0 Eugeni Dodonov 2012-04-16 564 * Note: we need to make sure we don't overflow for various clock & b445e3b0 Eugeni Dodonov 2012-04-16 565 * latency values. b445e3b0 Eugeni Dodonov 2012-04-16 566 * clocks go from a few thousand to several hundred thousand. b445e3b0 Eugeni Dodonov 2012-04-16 567 * latency is usually a few thousand b445e3b0 Eugeni Dodonov 2012-04-16 568 */ :::::: The code at line 560 was first introduced by commit :::::: b445e3b013adfcb05322ebde7fb16488f0644579 drm/i915: move watermarks settings into intel_pm module :::::: TO: Eugeni Dodonov :::::: CC: Daniel Vetter --- 0-DAY kernel test infrastructure Open Source Technology Center https://lists.01.org/pipermail/kbuild-all Intel Corporation