On 14/12/2015 12:37, Nick Wellnhofer wrote:
Lucifers,
I'm mostly done with the things I wanted to get in the 0.5 release:
- Review the Clownfish runtime API.
- Document the C API.
- Document the Clownfish header file language.
- Document the cfc compiler for C projects.
Other things that should be done:
- Clownfish tutorial, see CLOWNFISH-43:
https://issues.apache.org/jira/browse/CLOWNFISH-43
Still TODO. Any takers?
- Review and add missing DocuComments.
Completed.
- Add a Clownfish page and the HTML documentation to lucy.apache.org.
I just added a simple Clownfish page to lucy.apache.org. The documentation can
be added after the release.
I'd also like to improve the presentation of our online documentation (see
https://issues.apache.org/jira/browse/LUCY-225). A long time ago, I created a
script to convert POD to "mdtext" files used by the Apache CMS:
https://git-wip-us.apache.org/repos/asf?p=lucy.git;a=blob;f=devel/bin/pod2mdtext.pl;h=3eb7462174e4c9b8606aade006fb2f56f4749150;hb=HEAD
This makes it possible to put the documentation pages within the site template:
http://lucy.apache.org/docs/test/Lucy.html
Unless someone has a better idea, I'll continue with this approach.
- Check for incompatible versions of Perl modules (see below).
Completed.
Before cutting the 0.5 release, I'd like to upload a CPAN developer release
based on the 0.5 branch to get feedback from CPAN Testers. The version number
will probably be something like 0.4.99_1.
Nick