Gentoo Archives: gentoo-dev

From: Joshua Nichols <nichoj@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] merging man page documentation into eclasses
Date: Mon, 11 Jun 2007 12:43:25
Message-Id: 466D42F7.5030400@gentoo.org
In Reply to: [gentoo-dev] merging man page documentation into eclasses by Mike Frysinger
1 Mike Frysinger wrote:
2 > keeping documentation of functions in a separate file (man pages in this case)
3 > has obvious bit rot problems written all over it, so i'd like to merge the
4 > documentation into the respective eclasses so that the man pages can be
5 > automatically generated
6 >
7
8 For the Java eclasses, we've been marking them up with something akin to
9 javadoc. We never did get around to writting something that actually
10 parses it though, but I wouldn't imagine it to be difficult.
11
12 See java-utils-2.eclass for what it looks like.
13
14 --
15 Joshua Nichols
16 Gentoo/Java Secondary Project Lead
17 Gentoo/Xfce Project Lead
18 Gentoo/Ruby Developer
19
20 --
21 gentoo-dev@g.o mailing list