Javadocs vs Doxygen

Discussion in 'Plugin Development' started by hawkfalcon, Jun 8, 2012.

Thread Status:
Not open for further replies.
  1. Offline

    hawkfalcon

    Which one do you use and which one is better?
     
  2. Offline

    Jacek

    They have the same information but Doxygen looks nicer.
     
  3. Offline

    Baba43

    I like the JavaDoc more.. better navigation for me.
     
  4. Offline

    Njol

    Doxygen does not have the Javadocs of enums and fails to link to their sources instead.
    True, but Doxygen wins for me because it lists all methods of a class including inherited ones in one list.
    The default Javadocs are actually better than Doxygen since they have all docs and link everything unlike Doxygen, but for finding the docs of a specific method Doxygen is faster.

    But personally I don't use any online javadocs for programming - I look up the Javadocs directly in Eclipse.
     
  5. Offline

    hawkfalcon

    Maybe I should explain. I am the author of BukkitSearch, a Google Chrome extention that lets you search bukkit dev and the forums. I am making a version for developers to search the jD site, and wanted to know which should be the default to search. I'm thinking doxygen.
     
  6. Offline

    Superkabii

    Completely opinion, I think the Javadocs look much nicer. Much more streamlined and easy to navigate. I think Doxygen looks messy.
     
  7. Offline

    hawkfalcon

    Great. So which should be default?
     
  8. Offline

    Sagacious_Zed Bukkit Docs

    There is no difference in information, only presentation, however I believe javadocs would be easier to parse, as ellipse itself uses javadoc as it is the standard for java.
     
  9. Offline

    hawkfalcon

    How is the search system for each?
     
  10. Offline

    Sagacious_Zed Bukkit Docs

    Javadocs has not built in search, use your browser, however since most users know what class they are looking for, you just navigate directly to the class to look up a method. You can also search through the index. Personally i find javadocs much easier to navigate because of that.

    Doxygen has a php search function
     
  11. Offline

    petteyg359

    Any so-called "developer" who would use Chrome rather than their IDE for looking up javadocs needs to find a new hobby.
     
    Sagacious_Zed likes this.
  12. Offline

    hawkfalcon

    petteyg359
    What is wrong with Chrome? I develop extensions for it as well as plugins for bukkit. I do use the IDE for documentation, but I wanted to extend my existing BukkitSearch extension so people could search the Doxygen documentation. Thanks everyone!
     
  13. I vote to javadocs, because its far more used than the other
     
Thread Status:
Not open for further replies.

Share This Page