[nylug-talk] inline documentation of software which is portable

[Ajay Gautam]

On Jan 21, 2008 10:18 PM, Clark Sims <clark_sims2 at yahoo.com> wrote:
[...snip...]
>
> I understand that Java has inline documentation functionality, similar to what doxygen offers. Does anyone know how does Java doc documentation look when it is put into html format?

Here is Java's source code documentation generated by javadoc:
http://java.sun.com/j2se/1.5.0/docs/api/index.html

(Its very useful to me, as a java programmer)

> Does anyone have an opinion about what is the best way to port software to hand held computers?
>
> Ideally I would like to choose a language that:
>     1) can write web applications
>     2) can write console mode applications
>     3) supports in source documentation, which can be parsed to HTML format
>     4) is portable between all the different hardware I just mentioned

Being a java programmer, I am a little biased towards Java.
The main benefit is that write-once-run-anywhere does actually work
(of course you have to be a bit careful).
The disadvantage is that you need to have a JVM for each target
platform, but I guess these days, all platforms already have a JVM.

I used to be a C/C++ programmer. So I can tell you this from
experience: Java is much easier (for the developer). If you can, I
would highly recommend Java. Its supported on virtually all platforms.

Ajay


-- 
Talk is cheap, show me the code.
http://www.ajaygautam.com