Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) client-ip=23.128.96.32;
Date:   Mon, 18 Sep 2023 14:43:14 +0700
From:   Bagas Sanjaya <bagasdotme@gmail.com>
To:     Stephen Rothwell <sfr@canb.auug.org.au>,
        David Miller <davem@davemloft.net>,
        Jakub Kicinski <kuba@kernel.org>,
        Paolo Abeni <pabeni@redhat.com>,
        Linux Networking <netdev@vger.kernel.org>
Cc:     Arkadiusz Kubalewski <arkadiusz.kubalewski@intel.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: Re: linux-next: build warnings after merge of the net-next tree
Message-ID: <ZQf_kmZZYGFJFZMp@debian.me>
References: <20230918131521.155e9e63@canb.auug.org.au>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
        protocol="application/pgp-signature"; boundary="2HGzqmuLZ58rv3ET"
Content-Disposition: inline
In-Reply-To: <20230918131521.155e9e63@canb.auug.org.au>
Precedence: bulk


--2HGzqmuLZ58rv3ET
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Sep 18, 2023 at 01:15:21PM +1000, Stephen Rothwell wrote:
> Hi all,
>=20
> After merging the net-next tree, today's linux-next build (htmldocs)
> produced these warnings:
>=20
> Documentation/driver-api/dpll.rst:427: ERROR: Error in "code-block" direc=
tive:
> maximum 1 argument(s) allowed, 18 supplied.
>=20
> .. code-block:: c
>         static const struct dpll_device_ops dpll_ops =3D {
>                 .lock_status_get =3D ptp_ocp_dpll_lock_status_get,
>                 .mode_get =3D ptp_ocp_dpll_mode_get,
>                 .mode_supported =3D ptp_ocp_dpll_mode_supported,
>         };
>=20
>         static const struct dpll_pin_ops dpll_pins_ops =3D {
>                 .frequency_get =3D ptp_ocp_dpll_frequency_get,
>                 .frequency_set =3D ptp_ocp_dpll_frequency_set,
>                 .direction_get =3D ptp_ocp_dpll_direction_get,
>                 .direction_set =3D ptp_ocp_dpll_direction_set,
>                 .state_on_dpll_get =3D ptp_ocp_dpll_state_get,
>         };
> Documentation/driver-api/dpll.rst:444: ERROR: Error in "code-block" direc=
tive:
> maximum 1 argument(s) allowed, 21 supplied.
>=20
> .. code-block:: c
>         clkid =3D pci_get_dsn(pdev);
>         bp->dpll =3D dpll_device_get(clkid, 0, THIS_MODULE);
>         if (IS_ERR(bp->dpll)) {
>                 err =3D PTR_ERR(bp->dpll);
>                 dev_err(&pdev->dev, "dpll_device_alloc failed\n");
>                 goto out;
>         }
>=20
>         err =3D dpll_device_register(bp->dpll, DPLL_TYPE_PPS, &dpll_ops, =
bp);
>         if (err)
>                 goto out;
>=20
>         for (i =3D 0; i < OCP_SMA_NUM; i++) {
>                 bp->sma[i].dpll_pin =3D dpll_pin_get(clkid, i, THIS_MODUL=
E, &bp->sma[i].dpll_prop);
>                 if (IS_ERR(bp->sma[i].dpll_pin)) {
>                         err =3D PTR_ERR(bp->dpll);
>                         goto out_dpll;
>                 }
>=20
>                 err =3D 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" direc=
tive:
> maximum 1 argument(s) allowed, 12 supplied.
>=20
> .. 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);
>=20
>=20
> Introduced by commit
>=20
>   dbb291f19393 ("dpll: documentation on DPLL subsystem interface")
>=20

Oops, I forgot to review dpll series. Will fix.

Thanks for the report!

--=20
An old man doll... just what I always wanted! - Clara

--2HGzqmuLZ58rv3ET
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iHUEABYKAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCZQf/kQAKCRD2uYlJVVFO
owpFAQDeSFN9OdEsaDy/jOpQeC1tlHJPmMMw0OSh6ecH4jsgnwD/Wz8SwPC9Njxd
c/6VShwmyFiw0/K6EV85jAIXC7PqMgQ=
=u2w5
-----END PGP SIGNATURE-----

--2HGzqmuLZ58rv3ET--