Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

drm/amd/display: dc_hw_sequencer.c: remove kernel-doc comments

Change comments from kernel-doc style "/**" to normal C comments
"/*" since the comments are not in kernel-doc format.
This fixes around 39 kernel-doc warnings like this one:

drivers/gpu/drm/amd/display/dc/core/dc_hw_sequencer.c:1322: warning:
This comment starts with '/**', but isn't a kernel-doc comment.
Refer Documentation/doc-guide/kernel-doc.rst

Reported-by: kernel test robot <lkp@intel.com>
Closes: https://lore.kernel.org/oe-kbuild-all/202511062036.Ry8Z2APc-lkp@intel.com/
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>

authored by

Randy Dunlap and committed by
Alex Deucher
7203fa78 c58b5d82

+40 -40
+40 -40
drivers/gpu/drm/amd/display/dc/core/dc_hw_sequencer.c
··· 265 265 black_color_format[BLACK_COLOR_FORMAT_RGB_LIMITED]; 266 266 break; 267 267 268 - /** 268 + /* 269 269 * Remove default and add case for all color space 270 270 * so when we forget to add new color space 271 271 * compiler will give a warning ··· 1318 1318 } 1319 1319 } 1320 1320 1321 - /** 1321 + /* 1322 1322 * Helper function to add OPTC pipe control lock to block sequence 1323 1323 */ 1324 1324 void hwss_add_optc_pipe_control_lock(struct block_sequence_state *seq_state, ··· 1335 1335 } 1336 1336 } 1337 1337 1338 - /** 1338 + /* 1339 1339 * Helper function to add HUBP set flip control GSL to block sequence 1340 1340 */ 1341 1341 void hwss_add_hubp_set_flip_control_gsl(struct block_sequence_state *seq_state, ··· 1350 1350 } 1351 1351 } 1352 1352 1353 - /** 1353 + /* 1354 1354 * Helper function to add HUBP program triplebuffer to block sequence 1355 1355 */ 1356 1356 void hwss_add_hubp_program_triplebuffer(struct block_sequence_state *seq_state, ··· 1367 1367 } 1368 1368 } 1369 1369 1370 - /** 1370 + /* 1371 1371 * Helper function to add HUBP update plane address to block sequence 1372 1372 */ 1373 1373 void hwss_add_hubp_update_plane_addr(struct block_sequence_state *seq_state, ··· 1382 1382 } 1383 1383 } 1384 1384 1385 - /** 1385 + /* 1386 1386 * Helper function to add DPP set input transfer function to block sequence 1387 1387 */ 1388 1388 void hwss_add_dpp_set_input_transfer_func(struct block_sequence_state *seq_state, ··· 1399 1399 } 1400 1400 } 1401 1401 1402 - /** 1402 + /* 1403 1403 * Helper function to add DPP program gamut remap to block sequence 1404 1404 */ 1405 1405 void hwss_add_dpp_program_gamut_remap(struct block_sequence_state *seq_state, ··· 1412 1412 } 1413 1413 } 1414 1414 1415 - /** 1415 + /* 1416 1416 * Helper function to add DPP program bias and scale to block sequence 1417 1417 */ 1418 1418 void hwss_add_dpp_program_bias_and_scale(struct block_sequence_state *seq_state, struct pipe_ctx *pipe_ctx) ··· 1424 1424 } 1425 1425 } 1426 1426 1427 - /** 1427 + /* 1428 1428 * Helper function to add OPTC program manual trigger to block sequence 1429 1429 */ 1430 1430 void hwss_add_optc_program_manual_trigger(struct block_sequence_state *seq_state, ··· 1437 1437 } 1438 1438 } 1439 1439 1440 - /** 1440 + /* 1441 1441 * Helper function to add DPP set output transfer function to block sequence 1442 1442 */ 1443 1443 void hwss_add_dpp_set_output_transfer_func(struct block_sequence_state *seq_state, ··· 1454 1454 } 1455 1455 } 1456 1456 1457 - /** 1457 + /* 1458 1458 * Helper function to add MPC update visual confirm to block sequence 1459 1459 */ 1460 1460 void hwss_add_mpc_update_visual_confirm(struct block_sequence_state *seq_state, ··· 1471 1471 } 1472 1472 } 1473 1473 1474 - /** 1474 + /* 1475 1475 * Helper function to add MPC power on MPC mem PWR to block sequence 1476 1476 */ 1477 1477 void hwss_add_mpc_power_on_mpc_mem_pwr(struct block_sequence_state *seq_state, ··· 1488 1488 } 1489 1489 } 1490 1490 1491 - /** 1491 + /* 1492 1492 * Helper function to add MPC set output CSC to block sequence 1493 1493 */ 1494 1494 void hwss_add_mpc_set_output_csc(struct block_sequence_state *seq_state, ··· 1507 1507 } 1508 1508 } 1509 1509 1510 - /** 1510 + /* 1511 1511 * Helper function to add MPC set OCSC default to block sequence 1512 1512 */ 1513 1513 void hwss_add_mpc_set_ocsc_default(struct block_sequence_state *seq_state, ··· 1526 1526 } 1527 1527 } 1528 1528 1529 - /** 1529 + /* 1530 1530 * Helper function to add DMUB send DMCUB command to block sequence 1531 1531 */ 1532 1532 void hwss_add_dmub_send_dmcub_cmd(struct block_sequence_state *seq_state, ··· 1543 1543 } 1544 1544 } 1545 1545 1546 - /** 1546 + /* 1547 1547 * Helper function to add DMUB SubVP save surface address to block sequence 1548 1548 */ 1549 1549 void hwss_add_dmub_subvp_save_surf_addr(struct block_sequence_state *seq_state, ··· 1560 1560 } 1561 1561 } 1562 1562 1563 - /** 1563 + /* 1564 1564 * Helper function to add HUBP wait for DCC meta propagation to block sequence 1565 1565 */ 1566 1566 void hwss_add_hubp_wait_for_dcc_meta_prop(struct block_sequence_state *seq_state, ··· 1575 1575 } 1576 1576 } 1577 1577 1578 - /** 1578 + /* 1579 1579 * Helper function to add HUBP wait pipe read start to block sequence 1580 1580 */ 1581 1581 void hwss_add_hubp_wait_pipe_read_start(struct block_sequence_state *seq_state, ··· 1588 1588 } 1589 1589 } 1590 1590 1591 - /** 1591 + /* 1592 1592 * Helper function to add HWS apply update flags for phantom to block sequence 1593 1593 */ 1594 1594 void hwss_add_hws_apply_update_flags_for_phantom(struct block_sequence_state *seq_state, ··· 1601 1601 } 1602 1602 } 1603 1603 1604 - /** 1604 + /* 1605 1605 * Helper function to add HWS update phantom VP position to block sequence 1606 1606 */ 1607 1607 void hwss_add_hws_update_phantom_vp_position(struct block_sequence_state *seq_state, ··· 1618 1618 } 1619 1619 } 1620 1620 1621 - /** 1621 + /* 1622 1622 * Helper function to add OPTC set ODM combine to block sequence 1623 1623 */ 1624 1624 void hwss_add_optc_set_odm_combine(struct block_sequence_state *seq_state, ··· 1636 1636 } 1637 1637 } 1638 1638 1639 - /** 1639 + /* 1640 1640 * Helper function to add OPTC set ODM bypass to block sequence 1641 1641 */ 1642 1642 void hwss_add_optc_set_odm_bypass(struct block_sequence_state *seq_state, ··· 1659 1659 dc_wake_and_execute_dmub_cmd(ctx, cmd, wait_type); 1660 1660 } 1661 1661 1662 - /** 1662 + /* 1663 1663 * Helper function to add TG program global sync to block sequence 1664 1664 */ 1665 1665 void hwss_add_tg_program_global_sync(struct block_sequence_state *seq_state, ··· 1682 1682 } 1683 1683 } 1684 1684 1685 - /** 1685 + /* 1686 1686 * Helper function to add TG wait for state to block sequence 1687 1687 */ 1688 1688 void hwss_add_tg_wait_for_state(struct block_sequence_state *seq_state, ··· 1697 1697 } 1698 1698 } 1699 1699 1700 - /** 1700 + /* 1701 1701 * Helper function to add TG set VTG params to block sequence 1702 1702 */ 1703 1703 void hwss_add_tg_set_vtg_params(struct block_sequence_state *seq_state, ··· 1714 1714 } 1715 1715 } 1716 1716 1717 - /** 1717 + /* 1718 1718 * Helper function to add TG setup vertical interrupt2 to block sequence 1719 1719 */ 1720 1720 void hwss_add_tg_setup_vertical_interrupt2(struct block_sequence_state *seq_state, ··· 1728 1728 } 1729 1729 } 1730 1730 1731 - /** 1731 + /* 1732 1732 * Helper function to add DPP set HDR multiplier to block sequence 1733 1733 */ 1734 1734 void hwss_add_dpp_set_hdr_multiplier(struct block_sequence_state *seq_state, ··· 1742 1742 } 1743 1743 } 1744 1744 1745 - /** 1745 + /* 1746 1746 * Helper function to add HUBP program DET size to block sequence 1747 1747 */ 1748 1748 void hwss_add_hubp_program_det_size(struct block_sequence_state *seq_state, ··· 1785 1785 } 1786 1786 } 1787 1787 1788 - /** 1788 + /* 1789 1789 * Helper function to add HUBP program DET segments to block sequence 1790 1790 */ 1791 1791 void hwss_add_hubp_program_det_segments(struct block_sequence_state *seq_state, ··· 1802 1802 } 1803 1803 } 1804 1804 1805 - /** 1805 + /* 1806 1806 * Helper function to add OPP set dynamic expansion to block sequence 1807 1807 */ 1808 1808 void hwss_add_opp_set_dyn_expansion(struct block_sequence_state *seq_state, ··· 1821 1821 } 1822 1822 } 1823 1823 1824 - /** 1824 + /* 1825 1825 * Helper function to add OPP program FMT to block sequence 1826 1826 */ 1827 1827 void hwss_add_opp_program_fmt(struct block_sequence_state *seq_state, ··· 1852 1852 } 1853 1853 } 1854 1854 1855 - /** 1855 + /* 1856 1856 * Helper function to add ABM set pipe to block sequence 1857 1857 */ 1858 1858 void hwss_add_abm_set_pipe(struct block_sequence_state *seq_state, ··· 1867 1867 } 1868 1868 } 1869 1869 1870 - /** 1870 + /* 1871 1871 * Helper function to add ABM set level to block sequence 1872 1872 */ 1873 1873 void hwss_add_abm_set_level(struct block_sequence_state *seq_state, ··· 1882 1882 } 1883 1883 } 1884 1884 1885 - /** 1885 + /* 1886 1886 * Helper function to add TG enable CRTC to block sequence 1887 1887 */ 1888 1888 void hwss_add_tg_enable_crtc(struct block_sequence_state *seq_state, ··· 1895 1895 } 1896 1896 } 1897 1897 1898 - /** 1898 + /* 1899 1899 * Helper function to add HUBP wait flip pending to block sequence 1900 1900 */ 1901 1901 void hwss_add_hubp_wait_flip_pending(struct block_sequence_state *seq_state, ··· 1912 1912 } 1913 1913 } 1914 1914 1915 - /** 1915 + /* 1916 1916 * Helper function to add TG wait double buffer pending to block sequence 1917 1917 */ 1918 1918 void hwss_add_tg_wait_double_buffer_pending(struct block_sequence_state *seq_state, ··· 3270 3270 } 3271 3271 } 3272 3272 3273 - /** 3273 + /* 3274 3274 * Helper function to add MPC update blending to block sequence 3275 3275 */ 3276 3276 void hwss_add_mpc_update_blending(struct block_sequence_state *seq_state, ··· 3287 3287 } 3288 3288 } 3289 3289 3290 - /** 3290 + /* 3291 3291 * Helper function to add MPC insert plane to block sequence 3292 3292 */ 3293 3293 void hwss_add_mpc_insert_plane(struct block_sequence_state *seq_state, ··· 3312 3312 } 3313 3313 } 3314 3314 3315 - /** 3315 + /* 3316 3316 * Helper function to add MPC assert idle MPCC to block sequence 3317 3317 */ 3318 3318 void hwss_add_mpc_assert_idle_mpcc(struct block_sequence_state *seq_state, ··· 3327 3327 } 3328 3328 } 3329 3329 3330 - /** 3330 + /* 3331 3331 * Helper function to add HUBP set blank to block sequence 3332 3332 */ 3333 3333 void hwss_add_hubp_set_blank(struct block_sequence_state *seq_state,