From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 013FD3948024 for ; Wed, 23 Feb 2022 09:22:08 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 013FD3948024 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1645608128; h=from:from:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references; bh=wlxbxfYyplN0W26BX/BgTIqq+YktNNFThewvnZDpaEE=; b=JMjCLsf14+IhcySQsYMDs6dzLOzlzgeQgS/wJaUo39kIZEdzNxTpDVQwFKM9Te/lqLCKDL kZhCIePAZ3qvqJa3DcLLZpbLR1naFhuoneDcKSLxzezfp4BcbScgU0ERHLosDMORliKSPA NGjiPtZu/CUPGC9g2iNcy4dhhYsOctc= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-381-cGVmHKLIP92CdeLSfzufpA-1; Wed, 23 Feb 2022 04:21:55 -0500 X-MC-Unique: cGVmHKLIP92CdeLSfzufpA-1 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 5CC26425CD for ; Wed, 23 Feb 2022 09:21:54 +0000 (UTC) Received: from calimero.vinschen.de (unknown [10.36.112.2]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 2D52A8319C for ; Wed, 23 Feb 2022 09:21:54 +0000 (UTC) Received: by calimero.vinschen.de (Postfix, from userid 500) id A1810A80D52; Wed, 23 Feb 2022 10:21:52 +0100 (CET) Date: Wed, 23 Feb 2022 10:21:52 +0100 From: Corinna Vinschen To: newlib@sourceware.org Subject: Re: [PATCH/RFC] newlib: update build system generation documentation Message-ID: Reply-To: newlib@sourceware.org Mail-Followup-To: newlib@sourceware.org References: <20220217055229.11529-1-vapier@gentoo.org> MIME-Version: 1.0 In-Reply-To: <20220217055229.11529-1-vapier@gentoo.org> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=vinschen@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=utf-8 Content-Disposition: inline X-Spam-Status: No, score=-12.3 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H5, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: newlib@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Newlib mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Feb 2022 09:22:10 -0000 On Feb 17 00:52, Mike Frysinger wrote: > Replace all of the individual autotool steps with a single autoreconf. > This simplifies the documentation greatly, and in the current system, > only takes ~10 seconds to regenerate everything. > > Update the developer documentation to cover all the major components > of the current build system. Hopefully this is a fairly complete road > map to everything. I tried to include everything that I wish I knew > when I started hacking on this :P. > --- > NB: this requires a few more patches i have pending/waiting review, so it > isn't ready to merge just yet, but assuming the libm.a up-merging is OK > (and it sounds like it is), i think this is ready for review. > > newlib/HOWTO | 161 ++++++++++++++++++++++++++++++++++++++++++++++++++ > newlib/NEWS | 1 + > newlib/README | 94 ++++++++--------------------- > 3 files changed, 186 insertions(+), 70 deletions(-) > [...] > diff --git a/newlib/README b/newlib/README > index aa48b246f968..a6645504cba9 100644 > --- a/newlib/README > +++ b/newlib/README > @@ -23,13 +23,18 @@ Unpacking and Installation -- quick overview > When you unpack the newlib-4.2.0.tar.gz file, you'll find a directory > called `newlib-4.2.0', which contains: > > -COPYING config/ install-sh* mpw-configure > -COPYING.LIB config-ml.in libgloss/ mpw-install > -COPYING.NEWLIB config.guess* mkinstalldirs* newlib/ > -CYGNUS config.sub* move-if-change* symlink-tree* > -ChangeLog configure* mpw-README texinfo/ > -Makefile.in configure.in mpw-build.in > -README etc/ mpw-config.in > +COPYING README-maintainer-mode include/ mkdep > +COPYING.LIB compile install-sh mkinstalldirs > +COPYING.LIBGLOSS config/ libgloss/ move-if-change > +COPYING.NEWLIB config-ml.in libtool.m4 newlib/ > +COPYING3 config.guess ltgcc.m4 setup.com > +COPYING3.LIB config.rpath ltmain.sh src-release > +ChangeLog config.sub ltoptions.m4 symlink-tree > +MAINTAINERS configure ltsugar.m4 texinfo/ > +Makefile.def configure.ac ltversion.m4 ylwrap > +Makefile.in depcomp lt~obsolete.m4 > +Makefile.tpl djunpack.bat makefile.vms > +README etc/ missing Seeing this, I wonder why we are documenting a list of top-level files, most of which are of no further interest to the user anyway. Maybe it would make more sense to just mention a few of them, like, say, "configure"? Other than that, LGTM. Thanks, Corinna