Received-SPF: pass (google.com: domain of linux-kernel+bounces-98031-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
Date: Sat, 9 Mar 2024 21:24:42 +0100
From: Nicolas Schier <nicolas@fjasle.eu>
To: Masahiro Yamada <masahiroy@kernel.org>
Cc: Sergey Senozhatsky <senozhatsky@chromium.org>,
 linux-kbuild@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCHv2] kconfig: add some Kconfig env variables to make help
Message-ID: <ZezFirN5okYdhL1U@fjasle.eu>
References: <CAK7LNAQ8OyNMeGzVoTRg-sHDZ4YK0EKY_eEWNepekaibO_ZKwg@mail.gmail.com>
 <20240229021010.GM11972@google.com>
 <CAK7LNASujf8m4PpMyoCC1cTN_YGeG1HVaOR+3pZx5=3OJp=85A@mail.gmail.com>
 <20240229034739.GN11972@google.com>
 <CAK7LNAS-mOxY884pLEMwWaX+wgzXdc6+=vqN=wfHBekuKL5ryA@mail.gmail.com>
 <20240301043316.GO11972@google.com>
 <ZeG2PRYmdO0r44kS@buildd.core.avm.de>
 <20240301142844.GP11972@google.com>
 <ZeVtIwua9T5prwUl@buildd.core.avm.de>
 <CAK7LNAT7+GbXaF6MW18YvEeF4ZZLrn6sOutHPNxcoL_RD1Utyw@mail.gmail.com>
Precedence: bulk
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
 protocol="application/pgp-signature"; boundary="nQS4gEj3tiVtUJKn"
Content-Disposition: inline
In-Reply-To: <CAK7LNAT7+GbXaF6MW18YvEeF4ZZLrn6sOutHPNxcoL_RD1Utyw@mail.gmail.com>
Feedback-ID: 1174286m:1174286a9YXZ7r:1174286sP8TmRGQtl


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

On Wed, Mar 06, 2024 at 01:46:35AM +0900 Masahiro Yamada wrote:
> On Mon, Mar 4, 2024 at 3:41=E2=80=AFPM Nicolas Schier <n.schier@avm.de> w=
rote:
> >
> > On Fri, Mar 01, 2024 at 11:28:44PM +0900, Sergey Senozhatsky wrote:
> > > On (24/03/01 12:04), Nicolas Schier wrote:
> > > > Perhaps it might be a compromise to let 'make help' point to the
> > > > kbuild/kconfig documentation?
> > >
> > > Yes, I was thinking the same. A one-liner description per-env var
> > > and point to documentation if one-liner is not enough
> > >
> > >       KCONFIG_BARREL_ROLL     - kconfig does a barrel roll
> > >       KCONFIG_FOO_BAR         - kconfig does foo and then bar (see
> > >       documentation for details)
> >
> > No, I thought about leaving out any concrete examples but just adding a
> > sentence like:
> >
> >   kconfig and kbuild allow tuning and checks by settings various
> >   environment variables, cp. Documentation/kbuild/ for details.
> >
> > Then there is no need to re-document each variable in 'make help' but
> > those who are new are explicitly pointed to the maintained
> > documentation.
>=20
>=20
> That can be a compromised way, but it sounds silly...
>=20
> Is it helpful at least for people who know 'make help'
> but do not know Documentation/kbuild/?

Touch=C3=A9, that's probably right.

Kind regards,
Nicolas

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

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

iQIzBAABCAAdFiEEh0E3p4c3JKeBvsLGB1IKcBYmEmkFAmXsxX4ACgkQB1IKcBYm
EmnwBhAAht/u1aC8A5IC+/JVNytMj45JZ2OmKLjf1CWbxsZAx4eF0oFpxul4vOyJ
gqu5nPoC5A/oUSi/l6HQtwctj57NV1i+VNkQk+r7rEdBvb6hmo5pAfgpJNPmIVIx
gv/lL8XB0tJ26NcGv83kMIfH/3XOcedNrMO1969SQ4yz53Kdb4JwSURZfAQtVWIi
PT5ktVrpC48f+5WEfY4lAxELgkO57QoYTUNs1xeQhsecTpHkb4t6kRUNoKYIRR5I
zvMoV5rHk1gtiUmaZg0+0XS+K040VUdluQnXtDx1E1e1O5cXac27dpkLeUzElSXU
rJw7FL83bafFwWlXDGM47jmM6sL2F3ugE0vtRqKeMkxXFFOjF/lGhaIKKgD73QtM
AOxMyRLt+B48myvkYaToisDieXDw5EQCCmqcrgrEtRAJlcCJBW2S+GNbNMKc9R23
uTJP+iag6p1zubKjUldFyeXl1vtCpqia5Y9FrPatX+FzF/5x8Oo/GjkvYqhjxTYh
mu1W+Qx6y7A2xcbiiG+RiQN3nHC9pOD4kl+JzIUu3oIl8tmgpfyuNPvvk6Zp1uic
owlJammmvdFjd02be5dF04tOOT+LLoihGy52kedAsN1TRdkrIiTqBDWccTzLabeq
sJF3wdVozxezi2dcvQhyWNxVVuN5MM9SSSPZGF9rRFFx3GW4hGE=
=ELdL
-----END PGP SIGNATURE-----

--nQS4gEj3tiVtUJKn--