linux-next: build warnings after merge of the net-next tree

From: Stephen Rothwell <sfr@canb.auug.org.au>
To: David Miller <davem@davemloft.net>,
	Jakub Kicinski <kuba@kernel.org>, Paolo Abeni <pabeni@redhat.com>,
	Networking <netdev@vger.kernel.org>
Cc: Arkadiusz Kubalewski <arkadiusz.kubalewski@intel.com>,
	Bagas Sanjaya <bagasdotme@gmail.com>,
	Jiri Pirko <jiri@nvidia.com>,
	Vadim Fedorenko <vadim.fedorenko@linux.dev>,
	Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
	Linux Next Mailing List <linux-next@vger.kernel.org>
Subject: linux-next: build warnings after merge of the net-next tree
Date: Mon, 18 Sep 2023 13:15:21 +1000	[thread overview]
Message-ID: <20230918131521.155e9e63@canb.auug.org.au> (raw)

[-- Attachment #1: Type: text/plain, Size: 2564 bytes --]

Hi all,

After merging the net-next tree, today's linux-next build (htmldocs)
produced these warnings:

Documentation/driver-api/dpll.rst:427: ERROR: Error in "code-block" directive:
maximum 1 argument(s) allowed, 18 supplied.

.. code-block:: c
        static const struct dpll_device_ops dpll_ops = {
                .lock_status_get = ptp_ocp_dpll_lock_status_get,
                .mode_get = ptp_ocp_dpll_mode_get,
                .mode_supported = ptp_ocp_dpll_mode_supported,
        };

        static const struct dpll_pin_ops dpll_pins_ops = {
                .frequency_get = ptp_ocp_dpll_frequency_get,
                .frequency_set = ptp_ocp_dpll_frequency_set,
                .direction_get = ptp_ocp_dpll_direction_get,
                .direction_set = ptp_ocp_dpll_direction_set,
                .state_on_dpll_get = ptp_ocp_dpll_state_get,
        };
Documentation/driver-api/dpll.rst:444: ERROR: Error in "code-block" directive:
maximum 1 argument(s) allowed, 21 supplied.

.. code-block:: c
        clkid = pci_get_dsn(pdev);
        bp->dpll = dpll_device_get(clkid, 0, THIS_MODULE);
        if (IS_ERR(bp->dpll)) {
                err = PTR_ERR(bp->dpll);
                dev_err(&pdev->dev, "dpll_device_alloc failed\n");
                goto out;
        }

        err = dpll_device_register(bp->dpll, DPLL_TYPE_PPS, &dpll_ops, bp);
        if (err)
                goto out;

        for (i = 0; i < OCP_SMA_NUM; i++) {
                bp->sma[i].dpll_pin = dpll_pin_get(clkid, i, THIS_MODULE, &bp->sma[i].dpll_prop);
                if (IS_ERR(bp->sma[i].dpll_pin)) {
                        err = PTR_ERR(bp->dpll);
                        goto out_dpll;
                }

                err = dpll_pin_register(bp->dpll, bp->sma[i].dpll_pin, &dpll_pins_ops,
                                        &bp->sma[i]);
                if (err) {
                        dpll_pin_put(bp->sma[i].dpll_pin);
                        goto out_dpll;
                }
        }
Documentation/driver-api/dpll.rst:474: ERROR: Error in "code-block" directive:
maximum 1 argument(s) allowed, 12 supplied.

.. code-block:: c
        while (i) {
                --i;
                dpll_pin_unregister(bp->dpll, bp->sma[i].dpll_pin, &dpll_pins_ops, &bp->sma[i]);
                dpll_pin_put(bp->sma[i].dpll_pin);
        }
        dpll_device_put(bp->dpll);

Introduced by commit

  dbb291f19393 ("dpll: documentation on DPLL subsystem interface")

-- 
Cheers,
Stephen Rothwell

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 488 bytes --]