From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) by sourceware.org (Postfix) with ESMTP id 98155385841F for ; Thu, 24 Feb 2022 03:20:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 98155385841F Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gentoo.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gentoo.org Received: by smtp.gentoo.org (Postfix, from userid 559) id 36C9B342DD9; Thu, 24 Feb 2022 03:20:53 +0000 (UTC) Date: Wed, 23 Feb 2022 22:20:52 -0500 From: Mike Frysinger To: newlib@sourceware.org Subject: Re: [PATCH/RFC] newlib: update build system generation documentation Message-ID: Mail-Followup-To: newlib@sourceware.org References: <20220217055229.11529-1-vapier@gentoo.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="4ic6M6wNlGDSgllT" Content-Disposition: inline In-Reply-To: X-Spam-Status: No, score=-5.5 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_PASS, SPF_PASS, 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 03:20:58 -0000 --4ic6M6wNlGDSgllT Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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: > > =20 > > -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-chan= ge > > +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 >=20 > 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 w= as already there. 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 --4ic6M6wNlGDSgllT Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEuQK1JxMl+JKsJRrUQWM7n+g39YEFAmIW+ZQACgkQQWM7n+g3 9YEgSBAA0gTyaDd7NQG+PE3JMB0ozqC79d9Axp75eR/jhEh8hWa9ZL3382ZI0W5b 58CYe4bEGiP6S4aL/Kt6TRJPRijdNDH12Tj+2Mp+sgjz7KRKzrzc5J+wpK80aliz E8IspNwRvlEYsspvDTLkbaeZ2IJQWbqHKZ5y3BvSKanJiZW2WpUaA6DZEIhm1Aa0 r/jdL0hpqyYh77hO8W/TXyOfnz9zEfICtAVVJZr0Y9l34okuJTIuoURsYV6INdjU tSA3yA6EOeIp6hTtFv7WsJHstCLPOv2VtYVEekQV0ergkCV8CdAi/MuwN4SCEZxg QTUMs3exmQf27y2Zsk38m2G+O5aZHzbcxN8IbOVRG65ZLxbnDgr2aU4eTiOs5Nob CGYA9EPMuuvH+zzGM9nXPMLMEx2xhSmgDkyTSP4PPlPnunjIxzDGvi6NJNiYHviz HlmCIuAjs3LhvkpKiwADQ19HbhDc4/FNObUM+Oru5jMXG58HfMadSA8mmK+yf030 pkXR70rpTug6N8nWG+1FsKpn5HP3LqH+xmUrmgszCslKgUNm+fjNTWKMh4Hqw21m rMA4C5RSF1UFC5+M3mRB4+D9OEKixXsoQ8GcHq2B0Ax/jXTNTB+YhPMWI+O5RlAM 9kBB3ibrqJgPYrf48CyR3nGm5ORZ97eT5fqSS8X7/MoOgBY5jP0= =Ppei -----END PGP SIGNATURE----- --4ic6M6wNlGDSgllT--