[Date Prev][Date Next][Thread Prev][Thread Next]
- Subject: Re: [ANN] LuaDoc 3.0 Released
- From: Miles Bader <miles.bader@...>
- Date: Wed, 15 Aug 2007 09:55:44 +0900
Javier Guerra Giraldez <email@example.com> writes:
> that's what i _hate_ of Java: everybody uses JavaDoc... and nothing
> else! the result is not a documentation, it's only a list of things.
I've noticed that a lot of these "automatic" doc systems seem to yield
similar results, e.g., doxygen "docs" which exhaustively "document"
every function, class, and variable, but give no useful information
`...the Soviet Union was sliding in to an economic collapse so comprehensive
that in the end its factories produced not goods but bads: finished products
less valuable than the raw materials they were made from.' [The Economist]