From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1LzKrC-0001Ub-Ac for garchives@archives.gentoo.org; Thu, 30 Apr 2009 01:14:34 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 03974E0253; Thu, 30 Apr 2009 01:14:33 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id B4C6EE0253 for ; Thu, 30 Apr 2009 01:14:32 +0000 (UTC) Received: from [192.168.1.116] (ip72-220-190-13.sd.sd.cox.net [72.220.190.13]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id EA86764F75; Thu, 30 Apr 2009 01:14:31 +0000 (UTC) Message-ID: <49F8FB73.7050308@gentoo.org> Date: Wed, 29 Apr 2009 18:14:27 -0700 From: Josh Saddler User-Agent: Thunderbird 2.0.0.21 (X11/20090330) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-doc@lists.gentoo.org Reply-to: gentoo-doc@lists.gentoo.org MIME-Version: 1.0 To: gentoo-doc@lists.gentoo.org CC: gentoo-lists@allenjb.me.uk Subject: Re: [gentoo-doc] Handbooks / Autobuilds: What needs to be done? References: <49F58781.9090606@allenjb.me.uk> In-Reply-To: <49F58781.9090606@allenjb.me.uk> X-Enigmail-Version: 0.95.7 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enigDF13A30BDF2386CC304B3307" X-Archives-Salt: 1d79e458-cd9d-4f3c-8d07-7848fcebc2c7 X-Archives-Hash: 3bd50f99c4ac9e5f60a9b2407653a681 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enigDF13A30BDF2386CC304B3307 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable AllenJB wrote: > Hi all, >=20 > Is there a breakdown of tasks for updating the handbooks for autobuilds= ? > I looked at bug #260403 but it doesn't seem to say what actually needs > to be done (I also browsed through the other open docs bugs and there's= > barely anything related to the user handbook there). This is something that I've brought up on this list all the way back at the beginning of March[1]. Someone else raised the issue earlier this month[2]. As of right now, no one's bothered to reply on the list, nor respond when I jump on to our IRC channel. For the record, I have updated /main/en/where.xml for bug 266464[3]. But as I'm the only one doing any work these days, I have no idea when the rest might be completed. As far as I know I'm the only one to even start to consider all the things that need to be changed. A few off the top of my head: 1. Keys in handbook-$arch.xml files - No longer need paths to point releases. Update paths to install media on the mirrors. - Kernel versions will change fairly rapidly with the autobuilds, even though the stages only have stable kernels. - Keep monitoring ISO/stage size, or else discard keeping this information, which is already present in /main/en/where.xml. I'm in favor of just using a range of MB, rather than a specific size. Means less constant updating. - Recommended CFLAGS, especially now that GCC 4.3 is stable. Includes new arches for e.g. C2D, new arches that superset things. Better yet, what about just using -march=3Dnative? Native detects what you have and sets based on that. 2. Various renames that have happened now that we no longer do point releases. 3. Handbook restructuring proposal. I've sent some variants to the list a few times now, what with the lack of point releases for networked and networkless media. Needs some rethinking, and though I could just unilaterally *do something* (again, no one else is doing work), I need the rest of the team involved. Plus our leader should sign off on any big changes. - Maybe just provide some kind of current-networked and current-networkless link/symlink/directory? Similar to what the autobuilds have. There's no longer a need to track a specific networkless revision, not even as an archive, as the old files are not preserved past a certain point. - Some arches have build trouble at the moment, and do not provide updated CDs (yet). This may require mixing and matching directions and install media. - More arches are adding autobuilds, including ARM, alpha, hppa. Must update as these become available. 4. ??? 5. Profit. That's it for now, I guess. [1] http://archives.gentoo.org/gentoo-doc/msg_4db815c5379134f5047b268361977b3= d.xml [2] http://archives.gentoo.org/gentoo-doc/msg_498f230e6f69df9091b8b2b1d39ce0f= b.xml [3] http://bugs.gentoo.org/266464 --------------enigDF13A30BDF2386CC304B3307 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.11 (GNU/Linux) iEYEARECAAYFAkn4+3YACgkQxPWMzpKk6kMXgwCgmF87rEFcWMkrvcAo5XruEdv5 kFEAn3HJ9WqIhUa2300BwgjVpagGxFe5 =nziP -----END PGP SIGNATURE----- --------------enigDF13A30BDF2386CC304B3307--