Scala4Ant wishlist, was Re: CVSgrab (Was RE: cvsroot)
Burak Emir <Burak.Emir <at> epfl.ch>
2004-11-08 10:22:07 GMT
Lucky you!
We disabled CVSview a couple of days ago (we are
reorganizing our infrastructure these days).
I agree completely that using make is anachronistic, but as you might
have noticed our Makefile has grown into a very sophisticated things
that is hard to replace. To some extent, one can also blame the ant
inertia of the ant fanatics here (such as myself), which use ant for
basic development tasks and lack knowledge and resources to explore
more sophisticated uses of Ant.
We certainly appreciate help that could lead to gradual replacement of
the Makefile, for instance,
1. more ant tasks for scala (scaladoc), more consequent handling of
compiler options in ant tasks
2. a tool for single-source documentation of ant tasks
Here the idea is that there is a tool (of course with its own ant task)
that retrieves XML documentation from the end of a file and formats in
nicely in HTML (ideally without using any non Scala programs or libraries).
For some classes (like ant tasks), having the documentation in the
source file is the only sane thing to do, because this lets you easily
keep things up to date. It is not a replacement for good Java doc,
rather for hand-crafted, unmaintainable HTML documenation pages like
this one http://scala.epfl.ch/docu/ant.html
In a first approximation the documentation format can be specific for
ant tasks (we really need this).
Does anything like this already exist?
(Continue reading)