Am 07.07.2009 3:08 Uhr schrieb "Gerry Weaver" unter <[email protected]>:
> 10. Generate documentation for the new APIs.
>
> Note1:
>
> A call tree and change log will be maintained throughout the process.
>
> Note2:
>
> The initial source file per function convention will allow us to work with
> self contained units of change. The analysis step would surely group these in
> ways that make sense. Once we have completed the analysis step, we could place
> the result under revision control.
>
> Note3:
>
> We are sure that the FLA APIs will continue to be refined over time. We are
> just trying to create the initial foundation to start building on.
Hi Gerry,
this all sounds like a great plan. Thanks for all the input.
I have a few comments:
1: please document as you go, not as a last step. Simply use the doxygen
format to type a few words while creating or changing a function. You'll
have saved a lot of work in the end, plus someone else might want to help
you with your implementation and would be thankful for docs from the start.
2: I really really would like to contribute to FLA. I know what I am talking
about: I initially ported FLTK from Irix to MSWindows, then later to MacOS
8, and somwhat recently to OS X. So trust me, I know pretty well what you
have ahead of you.
I plead for you to use our current Subversion and bug tracking setup. You
get two wonderful things for free: a nice straight line in development (no
risk of an untintional fork and a painful merge later on), and you would get
great peer review almost immediately - as long as FLTK remains compileable
on all platfomrs.
But that can be easily achieved: you were planning to introduce Cmake as a
first step. IIRC, Cmake can be instructed to create IDE support fles for
pretty much all IDEs which we support. That way, adding new source files
should be extremely simple, and the code can still be compiled on all
platforms.
Evrything else sounds great to me. I am looking forward to the step where
you will have all platform code seperated and will introduce a working
abstraction in a dynamically linkable libray. A great and worthy goal!
Cheers,
Matthias
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev
