On Mon, Feb 19, 2001 at 02:27:06PM +0000, Simon Cozens wrote:
> On Mon, Feb 19, 2001 at 08:17:17AM -0600, Jarkko Hietaniemi wrote:
> > I would define a relatively strict and standard way to do this so that
> > the documentation can be extracted out.
>
> I'd like to see Perl 6 written as a literate program, but that's probably
> the axe I need to grind. :) Seriously, the apidoc is a really good thing,
> but it needs to be made more extensible; at the moment it only really works
> for documenting functions. I think we'll need a more general "structural"
> documentation on the source; RFC281 was an initial set of thoughts on this
Some sort of simple markup embedded within the C comments. Hey, let's
extend pod! Hey, let's use XML! Hey, let's use SGML! Hey, let's use
XHTML! Hey, let's use lout! Hey, ...
--
$jhi++; # http://www.iki.fi/jhi/
# There is this special biologist word we use for 'stable'.
# It is 'dead'. -- Jack Cohen
