как вы читаете javadoc?

<p>какие инструменты/сайты вы используете для чтения javadocs? </p><p>в настоящее время я использую firefox с 20+ открытыми вкладками при работе над проектом j2ee, чтобы иметь всю доступную документацию, которая не очень удобна, потребляет слишком много памяти и не доступна для поиска.</p><p>что бы я ожидал от такого инструмента/веб-сайта:</p><ul> <li>агрегировать javadocs из разных мест</li> <li>прямой доступ к типам, таким как ctrl + t в eclipse или аналогичным</li> <li>полнотекстовый поиск</li> <li>перекрестные ссылки между всеми библиотеками java, которые я выбрал</li> <li>для инструмента: поддержка в автономном режиме</li> <li>скорость</li> </ul><p>не обязательно: </p><ul> <li>возможность комментировать вещи</li> <li>поддержка разных версий библиотеки (+ diffing?)</li> <li>интеграция с ide</li> </ul><p>правка:</p><p>спасибо за ваши ответы. я знал большинство сайтов, но дал им еще одну попытку. вот мое мнение:</p><ul> <li>встроенные функции eclipse/ide <ul> <li>тесно интегрированы</li> <li>оффлайн/онлайн поддержка</li> </ul></li> <li> <a href="http://www.javadoconline.com"> <strike>javadoconline.com</strike> </a> (больше не поддерживается) <ul> <li>работает</li> <li>чистота выглядит</li> <li>находит совпадения в нескольких версиях api и позволяет легко переключаться</li> <li>просто но работает</li> <li>быстро</li> </ul></li> <li> <a href="http://www.jdocs.com/"> <strike>jdocs</strike> </a> (не в сети) <ul> <li>кажется очень сложным</li> <li>иногда медленно</li> <li>некоторые недавние версии библиотек отсутствуют (seam 2.0.0, hibernate validators), но, похоже, вы можете добавить их самостоятельно</li> <li>интеграция с ide (не тестировалась)</li> <li>комментарии в стиле вики к каждому элементу</li> </ul></li> <li> <a href="http://www.docjar.com/">docjar.com</a> <ul> <li>работает</li> <li>быстро</li> <li>загроможденный интерфейс</li> </ul></li> <li> <a href="http://www.teria.com/~koseki/tools/gm/javadoc\_isearch/">javadoc\_isearch</a> <ul> <li>скрипт greasemonkey для firefox, который облегчает навигацию по javadocs</li> <li>работает плавно и отлично</li> </ul></li> </ul>

<p>если вы используете eclipse, он предлагает поддержку javadocs. например, при наведении курсора мыши на вызов метода отобразится всплывающая подсказка, показывающая javadoc для этого метода. документация для основных классов java поддерживается "из коробки". однако, если ваш проект использует какие-либо дополнительные библиотеки (файлы jar), требуется некоторая конфигурация для подключения их javadoc в eclipse.</p><ol> <li>перейдите в раздел «путь сборки java» свойств вашего проекта.</li> <li>перейдите на вкладку «библиотеки» и щелкните значок «плюс» рядом с файлом jar.</li> <li>нажмите «местоположение javadoc», затем кнопку «изменить ...».</li> </ol><p>это позволит вам указать, где находятся javadoc для этого jar. он даже позволит вам указать url-адрес веб-сайта, поэтому вам не нужно загружать javadocs самостоятельно!</p>

<p>я написал свой собственный инструмент для этого. по словам моих коллег, это лучшее, что они видели.</p><p>он индексирует lucene один раз и запускает небольшой сервер в фоновом режиме, поэтому вы можете просматривать javadocs (pydocs, perldocs ..), как в браузере. он также позволяет разделять библиотеки на каждый язык, поэтому поисковые запросы, такие как "biginteger" или simialr, не ошибаются.</p><p> <a href="https://github.com/judovana/javadocofflinesearch/releases">https://github.com/judovana/javadocofflinesearch/releases</a> </p>

<p>вы можете найти javadoc стэнфордского университета <a href="http://www.stanford.edu/class/cs108/javadocfast.html">здесь</a> .</p>

<p>кувшин javadoc можно распаковать напрямую. теоретически любой выпущенный javadocs можно скачать и просмотреть в автономном режиме. </p><ol> <li><p>скачать напрямую из репозитория maven. например: <a href="http://central.maven.org/maven2/com/googlecode/objectify/objectify/5.0.3/objectify-5.0.3-javadoc.jar">http://central.maven.org/maven2/com/googlecode/objectify/objectify/5.0.3/objectify-5.0.3-javadoc.jar</a> </p></li> <li><p>теперь вы получаете <code>objectify-5.0.3-javadoc.jar</code>, переименовываете файл в <code>objectify-5.0.3-javadoc.zip</code></p></li> <li><p>используйте ваш любимый инструмент для распаковки, чтобы распаковать его, теперь у вас есть папка <code>objectify-5.0.3-javadoc</code></p></li> <li><p>двойной щелчок <code>index.html</code> откроет страницу индекса в браузере по умолчанию. </p></li> </ol>

<p>я использую <a href="http://www.teria.com/~koseki/tools/gm/javadoc\_isearch/">http://www.teria.com/~koseki/tools/gm/javadoc\_isearch/</a> для ff. позволяет мне легко просматривать другие библиотеки.</p>

<p>этот плагин для firefox и chrome полезен для быстрого поиска имен пакетов и классов, хотя это не полнотекстовый поиск: <a href="https://code.google.com/p/javadoc-search-frame/">https://code.google.com/p/javadoc-search-frame/</a> </p>

<p>eclipse хорошо интегрируется с javadoc и имеет html-подобную программу просмотра. вы можете прикрепить исходный код и javadoc к двоичным файлам, которые будут отображаться при выборе класса.</p>

<p>что-то подобное может быть полезным?</p><p> <a href="http://www.docjar.com/">http://www.docjar.com/</a> </p>

<p>лично у меня никогда не было проблем со встроенными инструментами просмотра javadoc, предлагаемыми моей ide.</p><p>в настоящее время я использую intellij idea - ctl-q вызывает javadoc для метода под курсором с гиперссылками на другие части функционала документации. </p><p>я бы предположил, что netbeans и eclipse предлагают аналогичную функциональность.</p>

<p>хм ... как насчет:</p><ul> <li> <a href="http://edu.netbeans.org/quicktour/javadoc.html">http://edu.netbeans.org/quicktour/javadoc.html</a> - netbeans поддерживает стандарт javadoc для документации java - как для просмотра, так и для генерации.</li> <li> <a href="http://globaldocs.zeevbelkin.com/">http://globaldocs.zeevbelkin.com/</a> - это приложение позволяет удобно просматривать через интернет и локальную файловую систему несколько наборов javadoc, используя единое дерево иерархии пакетов/классов и индекс с возможностью поиска. программа просмотра поддерживает локальные и удаленные наборы документов (также поддерживаются локальные наборы документов, упакованные в jar/zip-файлы).</li> </ul><p>я предпочитаю netbeans, поскольку он автоматически получает <strong>javadoc</strong> из каталога <strong>maven</strong> <code>~/.m2</code> ...</p>

<p>doxygen ( <a href="http://www.doxygen.nl/">http://www.doxygen.nl/</a> ) может отвечать всем требованиям. </p><p>правка: возможно, я неправильно понял ваш вопрос, doxygen - это инструмент для генерации документации и моделей на основе вашего кода и javadoc. </p>

<p>eclipse - лучший способ увидеть javadocs. наведя указатель мыши на метод или любое объявление, вы получите автоматически сгенерированные javadocs eclipse.</p>