From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1NIqO8-0003hG-SG for mharc-grub-devel@gnu.org; Thu, 10 Dec 2009 16:17:28 -0500 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NIqO6-0003gg-NY for grub-devel@gnu.org; Thu, 10 Dec 2009 16:17:26 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NIqO2-0003gE-BV for grub-devel@gnu.org; Thu, 10 Dec 2009 16:17:26 -0500 Received: from [199.232.76.173] (port=51241 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NIqO1-0003gB-VX for grub-devel@gnu.org; Thu, 10 Dec 2009 16:17:22 -0500 Received: from mail-yw0-f177.google.com ([209.85.211.177]:58177) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NIqO1-0005cd-PN for grub-devel@gnu.org; Thu, 10 Dec 2009 16:17:21 -0500 Received: by ywh7 with SMTP id 7so279468ywh.24 for ; Thu, 10 Dec 2009 13:17:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=+JpfIRL4KutCPgk8sg+EPVP+Gqr61m8ShlWT+eEtaOQ=; b=T5i57WJTUp3JwjyOcJ8+4mHYyiU9vynPdwFu2yo1ktRIY5WwqEfYVI1oDPQo1cz60P m8tXn7Svu3m7jczqMg2oRj08o3tEiLC1R4AUui5Tq1BIiHoOSL22xPMTMV0pu0NAm/0T 6KV2MJbG3t0zYgO7aP0fUzzJOhtlt7lBYf2AY= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; b=VFouOAfzDxa5oEIwOhG2c2diVtAAM5B4TwLstvexfTbaBV42N1HtRlgC7zAliElSoH e/YjsUk3o3d8AONnKduBqw/sFxsDMxGZLkk8ZVjxK5Phpt0vsGu3v3M46kZhJ2ppEc2r n3I/OSZRHTxhmB9a1Sxpc0QBDZRK1XXqqrdGo= Received: by 10.151.88.42 with SMTP id q42mr1106572ybl.75.1260479840807; Thu, 10 Dec 2009 13:17:20 -0800 (PST) Received: from ?192.168.0.75? (cpe-66-69-97-231.satx.res.rr.com [66.69.97.231]) by mx.google.com with ESMTPS id 8sm553782yxg.60.2009.12.10.13.17.19 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 10 Dec 2009 13:17:19 -0800 (PST) Message-ID: <4B21655E.1050902@gmail.com> Date: Thu, 10 Dec 2009 15:17:18 -0600 From: Bruce Dubbs User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.1.16) Gecko/20080722 SeaMonkey/1.1.11 MIME-Version: 1.0 To: The development of GNU GRUB References: <4B19BB70.8010509@gmail.com> <20091205204327.GE32638@thorin> <4B1AD3C0.1070302@gmail.com> <20091210011529.GE15546@thorin> In-Reply-To: <20091210011529.GE15546@thorin> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Subject: Re: Documenting the GRUB configure (during build) X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: The development of GNU GRUB List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Dec 2009 21:17:26 -0000 Robert Millan wrote: > On Sat, Dec 05, 2009 at 03:42:24PM -0600, Bruce Dubbs wrote: >> I'm afraid I don't agree that the solution to documenting changes is not >> to document anything. That may be a little harsh, but I firmly believe >> that documentation is key to acceptance. > > It's OK. Well my concern is about long-term maintainability. We're very > busy all the time, and redundancy in our codebase often results in birot. > > Can I count on your commitment that you'll be around to adjust this > documentation if it gets out of sync, etc? Yes, I think you can. I've always been interested in the boot process. I remember disassembling the boot sector back in the late '80s to see what was going on. That was before I knew about open source and the use of the internet became generally available (I didn't have it). I went back to school late in life (91-93) and my dissertation was on the effects of comments on the maintainability of source code. :) Now I'm semi-retired and I think I can commit to a few years. I don't think my interest will wane. :) -- Bruce