On Mon, 2006-07-17 at 05:35 +1000, skaller wrote: > The homepage has changed .. click the 'docs' link!
There is a general difficulty for Felix users that much of both the language syntax and libraries just isn't documented in a suitable form. We have source code listings, and doxygen for C++, but I don't really consider either the same standard as say the Python or Ocaml docs. Writing docs is a pain. There needs to be some way to keep them in sync with the code and to ensure 'everything' is actually documented. I am not yet sure how to do this.. but I plan to 'enforce' documentation somehow, for example, provide something in the spkg file that indicates the docs, and automatically gather these docs into some kind of manual. Interscript was designed to do this, but it may need some changes. -- John Skaller <skaller at users dot sf dot net> Felix, successor to C++: http://felix.sf.net ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Felix-language mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/felix-language
