From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.gentoo.org (smtp.gentoo.org [134.68.220.30]) by robin.gentoo.org (8.13.4/8.13.4) with ESMTP id j4J3igRT003460 for ; Thu, 19 May 2005 03:44:42 GMT Received: from [62.254.189.226] (helo=snowdrop) by smtp.gentoo.org with esmtpa (Exim 4.43) id 1DYbxj-00061j-Uu for gentoo-dev@lists.gentoo.org; Thu, 19 May 2005 03:44:44 +0000 Received: from localhost ([127.0.0.1] helo=snowdrop) by snowdrop with esmtp (Exim 4.43) id 1DYbxU-0003MG-KS for gentoo-dev@lists.gentoo.org; Thu, 19 May 2005 04:44:28 +0100 Date: Thu, 19 May 2005 04:44:25 +0100 From: Ciaran McCreesh To: gentoo-dev@lists.gentoo.org Subject: [gentoo-dev] Unofficial Gentoo Development Guide and Autotools Message-ID: <20050519044425.549e1f64@snowdrop> X-Mailer: Sylpheed-Claws 1.0.4a (GTK+ 1.2.10; i686-pc-linux-gnu) X-Message-Flag: It's a feature, not a bug Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary=Signature_Thu__19_May_2005_04_44_25_+0100_L.HzULdKqWHzjEx6; protocol="application/pgp-signature"; micalg=pgp-sha1 X-Archives-Salt: 940a097f-2845-4119-a991-0da594ed888f X-Archives-Hash: 6c4a4ba34d143276ea7b125294a0684f --Signature_Thu__19_May_2005_04_44_25_+0100_L.HzULdKqWHzjEx6 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable It came to my attention during a recent discussion on -core that a significant number of devs don't have a clue how autotools work and find any kind of patching that involves tinkering with configure.ac / Makefile.am level stuff to be very tricky. Clearly, this isn't good, because a significant number of upstream devs don't have a clue what they're doing either. There was already a small autotools explanation in The Doc, but it was very general. I've added substantially more content to it. Or, at least, as much as I could think of from my limited experience with autotools. The results: http://www.firedrop.org.uk/devmanual/general-concepts/autotools/ What more would people like to see explained? Is there anything in there that needs changing or clarifying? Anything that's just plain wrong? Does it need a section on libtool and if so does someone want to explain to me how the heck it works? Are there good examples of ebuilds which make understandable changes to these things that I should be adding as illustrations? Do you like the picture? Feedback please. I've added, improved and fixed a fair number of other things in other sections too (some of these thanks to content I've received from other devs and not-yet-devs), so if your favourite section had a big fat TODO on it last time you looked it may be worth checking again. And if it still has a big fat TODO, feel free to contribute :) http://www.firedrop.org.uk/devmanual/ If anyone wants me to stop talking about my unofficial developer manual on the official gentoo mailing lists, feel free to say so. Or just procmail anything containing 'devmanual' in the body. --=20 Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron) Mail : ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm --Signature_Thu__19_May_2005_04_44_25_+0100_L.HzULdKqWHzjEx6 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) iD8DBQFCjAub96zL6DUtXhERAh6zAKC2X+OQe51SlZlhVd0pahTv0LKb9ACfZZ/v Re+T6R2QtgSM7jPYxRIOW3o= =ZLLR -----END PGP SIGNATURE----- --Signature_Thu__19_May_2005_04_44_25_+0100_L.HzULdKqWHzjEx6-- -- gentoo-dev@gentoo.org mailing list