Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Tue, 20 Jul 2021 13:18:23 +0100
From:   Chris Down <chris@chrisdown.name>
To:     Stephen Rothwell <sfr@canb.auug.org.au>
Cc:     Petr Mladek <pmladek@suse.com>,
        Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
        Linux Next Mailing List <linux-next@vger.kernel.org>
Subject: Re: linux-next: build warning after merge of the printk tree
Message-ID: <YPa/D8tSyk7dw1/l@chrisdown.name>
References: <20210720162423.75f61ce0@canb.auug.org.au>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
        protocol="application/pgp-signature"; boundary="1KxdTYZBrk6pcvz6"
Content-Disposition: inline
In-Reply-To: <20210720162423.75f61ce0@canb.auug.org.au>
User-Agent: Mutt/2.1 (4b100969) (2021-06-12)
Precedence: bulk


--1KxdTYZBrk6pcvz6
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

+Cc: Jonathan Corbet <corbet@lwn.net>, linux-doc@vger.kernel.org

Stephen Rothwell writes:
>After merging the printk tree, today's linux-next build (htmldocs)
>produced this warning:
>
>kernel/printk/printk.c:1: warning: 'printk' not found
>
>Introduced by commit
>
>  337015573718 ("printk: Userspace format indexing support")
>
>I presume that "printk" is referred to elsewhere in the documentation
>as being in this file.

Hmm, this is an interesting one, because I think we still generally just wa=
nt=20
to refer to the API as being `printk()`. Changing it all over the place see=
ms=20
wrong. As you'd imagine, there are quite a few references to this name, so =
it=20
requires a lot of noise all over the docs and inline comments.

Jonathan and other docs folks, how can one tell Sphinx that when it sees=20
printk() it's referring to a function-like macro, or otherwise squelch this=
=20
reasonably? :-)

--1KxdTYZBrk6pcvz6
Content-Type: application/pgp-signature; name="signature.asc"

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

iQKTBAEBCgB9FiEECEkprPvCOwsaJqhB340hthYRgHAFAmD2vw9fFIAAAAAALgAo
aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDA4
NDkyOUFDRkJDMjNCMEIxQTI2QTg0MURGOEQyMUI2MTYxMTgwNzAACgkQ340hthYR
gHD6Ug//WlpWID3GVcxKVK3fh7gHsKjYBgxXYkdVQnF8KTuQZAvYm/hvkKOMcheS
RV30K9xfK1CzS9FVbgQIFQSO2DO0Ygm6LYu6vEjs0z0FMMv8K3JqxhZvRNkUQSz6
0PP+guHIClMKWRx69UcoWbaz/rF5SGKoajfoJfr6z7FSSuMoQOODsXyQs7FyS59W
63Bb2DwWtn4QxENxoNH1YltpGfUz0GxayYTlOyH5L4xxnJuXzgtrr+dawyDgYjHi
rLegnA0Z6Kd43ovAR0GAmb4Xvpk27qsBaOnpeu/n3C9Zt0yPsmE8f2Yb1uvlAAG+
GgKBimPARAREllwiHYhyGDu8RC7yTkY3RsDpLPCpKvAgSgig+NBo9uvY7oszVVYE
mv8XZDGH1u7Qe+QmF5JWKYHbYmNY3QFaKjnov52Jdt3noaWTBWesg82/1OYa6svP
H/U1GIqak8JYK2N25Wnwa+q4RYr1mXdxukBqsJajgDlSXibQFT1MqD4tywA+TFAq
szdzxJEG5rtXvfz9Z9/UZoMmHFu+mjh8V83Tip3CjTFVKkIxy9ZMzeWleDBSd8Rb
ZxdaCFfH4+Go30EZRdo1HaaPwRfGaIg+CtYxlHzJq1T6LFBd6p8bAubeJjXruFeF
8QhbJm13Shfgo2skhrBWjYaE+e4k0TdFZVOt1s48FJXxic2ETKI=
=QxWM
-----END PGP SIGNATURE-----

--1KxdTYZBrk6pcvz6--