[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2] docs: build-system: rename "default-configs" to "configs"
From: |
Kashyap Chamarthy |
Subject: |
Re: [PATCH v2] docs: build-system: rename "default-configs" to "configs" |
Date: |
Thu, 1 Jun 2023 10:17:08 +0200 |
On Wed, May 31, 2023 at 04:22:34PM +0200, Thomas Huth wrote:
> On 23/05/2023 15.31, Kashyap Chamarthy wrote:
> > Commit 812b31d3f9 (configs: rename default-configs to configs and
> > reorganise, 2021-07-07) did the rename.
> >
> > Reflect that update also in the documentation.
> >
> > Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
> > ---
> > docs/devel/build-system.rst | 12 +++++------
> > docs/devel/kconfig.rst | 40 ++++++++++++++++++++-----------------
> > 2 files changed, 28 insertions(+), 24 deletions(-)
> >
> > diff --git a/docs/devel/build-system.rst b/docs/devel/build-system.rst
> > index 1894721743..20ebcc9ac6 100644
> > --- a/docs/devel/build-system.rst
> > +++ b/docs/devel/build-system.rst
> ...
> > @@ -457,7 +457,7 @@ Built by Meson:
> > TARGET-NAME is again the name of a system or userspace emulator. The
> > config-devices.mak file is automatically generated by make using the
> > scripts/make_device_config.sh program, feeding it the
> > - default-configs/$TARGET-NAME file as input.
> > + configs/$TARGET-NAME file as input.
>
> This hunk does not apply anymore - but I think it can simply be dropped now.
Just for my own clarity, which precise part do you suggest to be
dropped?
> > ``config-host.h``, ``$TARGET_NAME-config-target.h``,
> > ``$TARGET_NAME-config-devices.h``
> > These files are used by source code to determine what features are
> > diff --git a/docs/devel/kconfig.rst b/docs/devel/kconfig.rst
> > index e3a544e463..73118e5106 100644
> > --- a/docs/devel/kconfig.rst
> > +++ b/docs/devel/kconfig.rst
> > @@ -38,11 +38,11 @@ originated in the Linux kernel, though it was heavily
> > simplified and
> > the handling of dependencies is stricter in QEMU.
> > Unlike Linux, there is no user interface to edit the configuration, which
> > -is instead specified in per-target files under the ``default-configs/``
> > +is instead specified in per-target files under the ``configs/target/``
>
> I think the Kconfig-related files are rather the ones in configs/devices/ ,
> so I'd use that directory here instead.
I see, will fix.
> > directory of the QEMU source tree. This is because, unlike Linux,
> > -configuration and dependencies can be treated as a black box when building
> > -QEMU; the default configuration that QEMU ships with should be okay in
> > -almost all cases.
> > +configuration and dependencies can be treated as a black box when
> > +building QEMU; the default configuration that QEMU ships with should be
> > +okay in almost all cases.
>
> Why did you change the above three lines?
Oops. Accidental bad habit of re-wrapping text in a paragraph. (When
editing a plain text file I periodically hit "gq}" -`vim` shortcut to
re-wrap text.)
[...]
> > They sometimes have ``select`` directives to bring in other required
> > subsystems or buses. For example, ``AUX`` (the DisplayPort auxiliary
> > @@ -229,7 +231,8 @@ declares its dependencies in different ways:
> > cannot be started at all without it. It should be listed under
> > ``imply`` if (depending on the QEMU command line) the board may or
> > may not be started without it. Boards also default to false; they are
> > - enabled by the ``default-configs/*.mak`` for the target they apply to.
> > + enabled by the ``configs/targets/TARGETNAME-softmmu/*.mak`` for the
>
> Should be configs/devices/... here, too, I think.
Yep; noted. Will fix.
Thanks for the review.
--
/kashyap
- Re: [PATCH v2] docs: build-system: rename "default-configs" to "configs",
Kashyap Chamarthy <=