From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.62) (envelope-from ) id 1HxjEy-0001ue-AD for garchives@archives.gentoo.org; Mon, 11 Jun 2007 12:43:25 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l5BCgRbo008911; Mon, 11 Jun 2007 12:42:27 GMT Received: from alnrmhc14.comcast.net (alnrmhc14.comcast.net [204.127.225.94]) by robin.gentoo.org (8.14.0/8.14.0) with ESMTP id l5BCeYkT006687 for ; Mon, 11 Jun 2007 12:40:35 GMT Received: from [192.168.1.100] (c-71-192-52-252.hsd1.ma.comcast.net[71.192.52.252]) by comcast.net (alnrmhc14) with ESMTP id <20070611124028b140041lsce>; Mon, 11 Jun 2007 12:40:28 +0000 Message-ID: <466D42F7.5030400@gentoo.org> Date: Mon, 11 Jun 2007 08:41:27 -0400 From: Joshua Nichols User-Agent: Thunderbird 2.0.0.0 (X11/20070519) 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 To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] merging man page documentation into eclasses References: <200706110205.01904.vapier@gentoo.org> In-Reply-To: <200706110205.01904.vapier@gentoo.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Archives-Salt: f161c48d-2b06-4ee3-b8f4-a2e4a3855a54 X-Archives-Hash: 299c96949088d02e0cf1c0f48b79f1f2 Mike Frysinger wrote: > keeping documentation of functions in a separate file (man pages in this case) > has obvious bit rot problems written all over it, so i'd like to merge the > documentation into the respective eclasses so that the man pages can be > automatically generated > For the Java eclasses, we've been marking them up with something akin to javadoc. We never did get around to writting something that actually parses it though, but I wouldn't imagine it to be difficult. See java-utils-2.eclass for what it looks like. -- Joshua Nichols Gentoo/Java Secondary Project Lead Gentoo/Xfce Project Lead Gentoo/Ruby Developer -- gentoo-dev@gentoo.org mailing list