Return Styles: Pseud0ch, Terminal, Valhalla, NES, Geocities, Blue Moon. Entire thread

Java needs better Javadoc

Name: Anonymous 2008-09-05 4:50

What the deal with Javadoc?

That shit is non-semantic and non-standard and totally needs a revamp!

Who's with me.

Name: Anonymous 2008-09-05 5:32

the real answer to all of these kind of problems is to stop using Java

Name: Anonymous 2008-09-05 5:54

>>2

          .'"".      I LIKE PYTHON BECAUSE I ENJOY HOMOSEXUAL
         c' )"/      S/M. OH GUIDO MAKE ME USE THAT FUCKING
        __>  /_      INDENTATION. OH BABY I'M CUMMING.
     .-`_    ._'-.
    ( -' \  :/  )/   THERE IS ONLY ONE WAY TO DO IT: GUIDO'S
     \\._|  (  //    WAY! THAT MEANS YOU CAN'T USE ALL
      '-/)   \(,     CONTROL STRUCTURES. IF YOU NEED A DO-
         /  ) )      WHILE LOOP, A SWITCH OR BREAK OUT OF A
        / .'\ |      NESTED LOOP, TOO BAD. GUIDO SAYS IT'S TO
       /.'   \|      KEEP THE LANGUAGE CLEAN, BUT IT'S ACTUALLY
      ||     ||      TO PUNISN HIS SLAVES. THIS DOESN'T MEAN
    __|/     |/__    THAT PYTHON IS FLAWED, JUST WORK AROUND IT.
    _._)     (,__;                       FUCK I'M CUMMING AGAIN.

Name: Anonymous 2008-09-05 5:58

>>3
yea python rocks.

Name: Anonymous 2008-09-05 6:08

Java should take a look at MSDN and see how real documentation should be. Who's with me

Name: Anonymous 2008-09-05 6:11

>>5
Fuck MSDN documentation right up its faggot AJAX asshole.

Name: Anonymous 2008-09-05 6:13

>>6
Haskell the dog
http://i31.tinypic.com/9atmqo.jpg

Name: Anonymous 2008-09-05 6:13

>>6
http://i31.tinypic.com/mltk5w.jpg
Has enough yet?

Name: Anonymous 2008-09-05 11:39

Awesome dog

Name: Anonymous 2008-09-05 12:16

>>9
ghey dog

Name: Anonymous 2008-09-05 12:36

>>5
MSDN should take a look at UNIX man pages and see how real documentation should be. Who's with me

Name: Anonymous 2008-09-05 13:40

>>11
fail. GTFO

Name: Anonymous 2008-09-05 15:02

>>12
No u

Name: Anonymous 2008-09-05 15:04

>>12
Back to /b/, please

Name: Anonymous 2008-09-05 16:36

>>11
I'm with Anonymous

Name: Anonymous 2008-09-05 16:37

>>11
Fuck man pages right up their non-hyperlinked faggot chapter numbered asshole.

Name: Anonymous 2008-09-05 17:11

>>16
non-hyperlinked faggot chapter numbered asshole.
ttp://linux.die.net/man/
No, John. You are the faggots.

Name: Anonymous 2008-09-05 17:30

We don't do hyperlinks in 70's abandonware OS.

Name: Anonymous 2008-09-05 17:31

>>18
GNU Info is the official standard documentation format.

Name: Anonymous 2008-09-05 17:36

Code should be self-explanatory.

Who's with me.

Name: Anonymous 2008-09-05 17:50

>>20
I think my opinion is self-explanatory.

Name: Anonymous 2008-09-05 19:19

http://java.sun.com/j2se/1.5.0/docs/api/

What the fuck is this shit?

Name: Anonymous 2008-09-05 20:53

Javadocs are still the best organized, easy to use, and more importantly easy to create documentation system around, and I've used/made man pages, used MSDN's shit, and various others that fail even harder.

Name: Anonymous 2008-09-05 20:54

>>23
Oh, and I have no idea why Doxygen even exists.  The vomit it produces is absolutely useless.

Name: Anonymous 2008-09-05 21:49

>>22
javadocs fag

Name: Anonymous 2008-09-06 3:15

>>23
Apple's HeaderDoc produces pretty nice results too, even though anything involving Apple is a controversial opinion on here.

Name: Anonymous 2008-09-06 4:06

>>26
Macfag apologists and people who see through Apple's bullshit seem to be present in roughly equal amounts on /prog/.

Name: Anonymous 2008-09-06 4:28

>>27
yhbt

Name: Anonymous 2008-09-06 6:28

>>23
Can't find shit in a javadoc cap'n.

Name: Anonymous 2008-09-06 7:12

Javadoc sucks. Haven't used Apple's HeaderDoc because I'm not a macfag, but I bet it blows and tries to install a DRM service that will control how many times you can check the help for a function before paying.

Name: Anonymous 2008-09-06 9:52

>>30
Yup.
http://developer.apple.com/opensource/tools/headerdoc.html

Name: Anonymous 2008-09-07 14:53

The Python stuff is good for what it does, but it needs to come with a full-text search client. And it's horrible when you want to know how a function will react in edge cases, like what exceptions a function will cast. Javadoc is much better here of course, because of their Forced Handling of Exceptions, but at what cost?

I wish they'd do some static inference of this, with an option to supplement/override it in the doc.

Name: Anonymous 2008-09-07 15:04

>>33
One word: The forced handling of exceptions. Thread over.

Name: Anonymous 2008-09-07 15:13

Java needs less javadoc and more literate programming. If the person consuming the API docs can't read code, then what the hell are they going to do with the API docs in the first place?

Name: Anonymous 2008-09-07 15:58

>>33
full-text search client
grep -r

Name: Anonymous 2008-09-07 17:01

>>36
Doesn't order hits on relevance, and is thus almost useless for finding the description of anything that is also used in a lot of example code elsewhere. And nice sage. Worst thread on the front page, I'm sure.

Name: Anonymous 2008-09-07 20:04

>>35
PROTIP: The code is not always available.

Name: Anonymous 2008-09-07 20:12

>>32
Butthurt jawafag

>>33
The Python stuff is good for what it does, but it needs to come with a full-text search client.
Make/adapt/use one yourself; it's not really realated to Python.

Javadoc is much better here of course, because of their Forced Handling of Exceptions, but at what cost?
At the cost of being a toy "best practices" enterprise language for morons and bad programmers, so it's a bad idea.

I wish they'd do some static inference of this, with an option to supplement/override it in the doc.
You can't trust static inference in a dynamic language.

>>36
Enjoy your O(1) search. Though nowadays it's fast enough for small and medium projects.

>>38
Wait, what? How so?

Name: Anonymous 2008-09-07 20:16

>>35
I know I'd rather read thousands of lines of Java than a few lines of Javadoc when all I want to know is the syntax for a goddamn hashmap.

Don't be a moron.
Newer Posts
Don't change these.
Name: Email:
Entire Thread Thread List
All trademarks and copyrights on this site are owned by their respective parties. All comments and posts are the responsibility of their own posters.
- Tinychan + 2ch Mode -