Groups > comp.lang.java.programmer > #21435

Javadoc rethinking?

Newsgroups	comp.lang.java.programmer
Date	2013-01-16 07:38 -0800
Message-ID	<3b10d0bb-0307-4365-b762-d619fd3c608b@googlegroups.com> (permalink)
Subject	Javadoc rethinking?
From	bob smith <bob@coolfone.comze.com>

Show all headers | View raw

Am I the only one who thinks that maybe there ought to be some improvements to the Javadoc process?

I was just looking at a Javadoc for a DatePickerDialog, and it seemed like it was missing something…  that something was an image of an example of the dialog.  I think that would have been very helpful.

However, Javadocs don't support images, and it is not necessarily good for the crucial documentation to be mingled with the code.  

Does anyone else think the Javadoc idea could perhaps use some rethinking?

Back to comp.lang.java.programmer | Previous | Next — Next in thread | Find similar | Unroll thread

Thread

Javadoc rethinking? bob smith <bob@coolfone.comze.com> - 2013-01-16 07:38 -0800
  Re: Javadoc rethinking? Arne Vajhøj <arne@vajhoej.dk> - 2013-01-16 11:00 -0500
    Re: Javadoc rethinking? Martin Gregorie <martin@address-in-sig.invalid> - 2013-01-16 20:14 +0000
      Re: Javadoc rethinking? Martin Gregorie <martin@address-in-sig.invalid> - 2013-01-16 22:11 +0000
        Re: Javadoc rethinking? Lew <lewbloch@gmail.com> - 2013-01-16 17:00 -0800
          Re: Javadoc rethinking? Martin Gregorie <martin@address-in-sig.invalid> - 2013-01-17 01:25 +0000
  Re: Javadoc rethinking? Steven Simpson <ss@domain.invalid> - 2013-01-16 18:49 +0000
    Re: Javadoc rethinking? "John B. Matthews" <nospam@nospam.invalid> - 2013-01-17 00:35 -0500
  Re: Javadoc rethinking? Jukka Lahtinen <jtfjdehf@hotmail.com.invalid> - 2013-01-16 21:18 +0200
  Re: Javadoc rethinking? Roedy Green <see_website@mindprod.com.invalid> - 2013-01-16 23:33 -0800

csiph-web