From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dedi548.your-server.de (dedi548.your-server.de [85.10.215.148]) by sourceware.org (Postfix) with ESMTPS id 48B6C3858C5F for ; Wed, 13 Sep 2023 09:00:31 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 48B6C3858C5F Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=embedded-brains.de Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=embedded-brains.de Received: from sslproxy05.your-server.de ([78.46.172.2]) by dedi548.your-server.de with esmtpsa (TLS1.3) tls TLS_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qgLjY-00012x-Us for newlib@sourceware.org; Wed, 13 Sep 2023 11:00:28 +0200 Received: from [82.100.198.138] (helo=mail.embedded-brains.de) by sslproxy05.your-server.de with esmtpsa (TLSv1.3:TLS_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qgLjY-000R9C-Rs for newlib@sourceware.org; Wed, 13 Sep 2023 11:00:28 +0200 Received: from localhost (localhost [127.0.0.1]) by mail.embedded-brains.de (Postfix) with ESMTP id 79735480080 for ; Wed, 13 Sep 2023 11:00:28 +0200 (CEST) Received: from mail.embedded-brains.de ([127.0.0.1]) by localhost (zimbra.eb.localhost [127.0.0.1]) (amavis, port 10032) with ESMTP id q4iLtDOaoLM6 for ; Wed, 13 Sep 2023 11:00:28 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by mail.embedded-brains.de (Postfix) with ESMTP id 3D13948018D for ; Wed, 13 Sep 2023 11:00:28 +0200 (CEST) X-Virus-Scanned: amavis at zimbra.eb.localhost Received: from mail.embedded-brains.de ([127.0.0.1]) by localhost (zimbra.eb.localhost [127.0.0.1]) (amavis, port 10026) with ESMTP id uTvCFC2FhBT3 for ; Wed, 13 Sep 2023 11:00:28 +0200 (CEST) Received: from zimbra.eb.localhost (unknown [10.10.171.34]) by mail.embedded-brains.de (Postfix) with ESMTPSA id 1305F480080 for ; Wed, 13 Sep 2023 11:00:28 +0200 (CEST) From: Sebastian Huber To: newlib@sourceware.org Subject: [PATCH] newlib: Clarify regeneration of config files Date: Wed, 13 Sep 2023 11:00:24 +0200 Message-Id: <20230913090024.28951-1-sebastian.huber@embedded-brains.de> X-Mailer: git-send-email 2.35.3 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Authenticated-Sender: smtp-embedded@poldi-networks.de X-Virus-Scanned: Clear (ClamAV 0.103.8/27030/Wed Sep 13 09:38:36 2023) X-Spam-Status: No, score=-11.3 required=5.0 tests=BAYES_00,GIT_PATCH_0,KAM_DMARC_STATUS,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --- newlib/README | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/newlib/README b/newlib/README index 1b2c16cd4..234666e19 100644 --- a/newlib/README +++ b/newlib/README @@ -525,6 +525,20 @@ steps, add the -v option. It is strongly advised that you use an adequate version of autotools. F= or this latest release, the following were used: autoconf 2.69 and automake 1.15= .1. =20 +Running autoreconf in the newlib directory may produce changes in newlib= .hin. +Usually, these changes need to be reverted manually and should not be ch= ecked +in. The changes result from the very unusual way newlib handles configu= ration +headers. You will find that the new elements in newlib.hin are instead = defined +in the other checked-in file _newlib_version.hin. Newlib splits the aut= oheader +definitions into these two separate files, and then includes the +configure-generated _newlib_version.h into the generated newlib.h. +Unfortunately, autoreconf does not really understand this rather convolu= ted +scheme. While it allows for more than one call to AC_CONFIG_HEADER(), t= o +configure more than one *.hin file, it does not recognize the idea that +autoheader should put any less than all of the entries defined by AC_DEF= INE() +into its output file (newlib.hin). So, this needs some extra, manual +post-processing after running autoreconf, to remove the duplicate defini= tions. + Reporting Bugs =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 --=20 2.35.3