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.133.124]) by sourceware.org (Postfix) with ESMTPS id 07E71385841F for ; Thu, 24 Feb 2022 09:22:08 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 07E71385841F 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=1645694527; 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: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=3oNfxBphpX7NPfsQtnXlDCQiyujPRUC/qfqPTN2NxeQ=; b=YkX9T9mrBXZBArcsb19QTTQTumlJiD4xIvssRLDGnCCikSMu2e6H7YfUxsBSRFVoHR30t7 MrK0AGPDEWc/9aBq+e0io/jZqfUBeXLSTiHGG4MklP+QdYYtZKf9IoDyuW5fXWvh4Z6NY6 s/W0secKpdEJXy0SOGJOZku6hHapDDY= 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-370-sauEspQMNfGxAj27Iz4t0A-1; Thu, 24 Feb 2022 04:22:03 -0500 X-MC-Unique: sauEspQMNfGxAj27Iz4t0A-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 7349F804313 for ; Thu, 24 Feb 2022 09:22:02 +0000 (UTC) Received: from calimero.vinschen.de (unknown [10.36.112.2]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 4237761B60 for ; Thu, 24 Feb 2022 09:22:02 +0000 (UTC) Received: by calimero.vinschen.de (Postfix, from userid 500) id AE3F2A807CF; Thu, 24 Feb 2022 10:22:00 +0100 (CET) Date: Thu, 24 Feb 2022 10:22:00 +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: X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 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 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-6.3 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, 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: Thu, 24 Feb 2022 09:22:13 -0000 On Feb 23 22:20, Mike Frysinger wrote: > On 23 Feb 2022 10:21, Corinna Vinschen wrote: > > On Feb 17 00:52, Mike Frysinger wrote: > > > --- 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"? > > i agree that i don't find much value in this, i was just maintaining what was > already there. I think this is so old that the expectation that people know how to use autotools at all was low. > how about: > > When you unpack the newlib-4.2.0.tar.gz file, you'll find a directory > called `newlib-4.2.0', which contains many files. Interesting ones: > COPYING* - License files for the sources > README - A common overview of all GNU development projects > configure - The build script for configuring the source tree > Makefile* - Inputs used by configure to generate the Makefile > libgloss/ - The libgloss project > newlib/ - The newlib project > -mike Yes, that sounds better, thanks! A few extra words about cloning the git repo per https://sourceware.org/newlib/download.html might be helpful, too. Unpacking tar archives seems a bit old-fashioned these days. Corinna