Кто отвечает за документацию и реализацию JavaDoc-инструмента?
Этот вопрос связан с проблемой, поднятой для Maven, которая, похоже, не содержит путей, перенаправляемых в файлы аргументов, поддерживаемые инструментом JavaDoc в Windows. Проблема в том, что из документации самого JavaDoc неясно, как в этих файлах должны быть указаны пути под Windows.
Следующее для Java 7:
Если имя файла содержит встроенные пробелы, поместите все имя файла в двойные кавычки и удвойте каждый обратный слеш ("Мои файлы \ Stuff.java").
https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html
Следующее из Java 8:
Если имя файла содержит встроенные пробелы, поместите все имя файла в двойные кавычки.
https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html
В документации по Java 11 эта часть полностью отсутствует, больше не упоминаются кавычки, пробелы или обратные слэши:
https://docs.oracle.com/en/java/javase/11/javadoc/javadoc-command.html
Если вы посмотрите на URI, в предыдущих версиях Java они были специфичны для Windows, а последняя - нет. Так что я думаю, что вещи были реорганизованы, и некоторые детали файлов аргументов были просто потеряны.
Итак, мне нужно место, где я мог бы поговорить с людьми об этих различиях в документации И, в конце концов, как все должно работать в Windows. Если обратный слеш является escape-символом только в путях и тому подобном. Я просто хотел бы получить некоторую осведомленность от людей, которые могут знать, почему в документах сейчас нет некоторых деталей, и, возможно, даже предоставить эти детали снова.
Так кому / куда мне писать? Я не знаю, Oracle это или проект OpenJDK или кто-то совсем другой. Спасибо!
2 ответа
Я думаю, но не слишком авторитетно, что инструмент javadoc - это просто дополнительный инструмент (может ли кто-нибудь показать формальное обязательство для любого JDK включить реализацию инструмента javadoc?) С неким стандартом де-факто, установленным Первоначальные владельцы, Sun оттуда Oracle.
Но де-факто это только де-факто. Формально и строго говоря, это означает, что ни один из разработчиков JDK не обязан заставлять свой инструмент javadoc вести себя так, как все остальные.
Я думаю, что два лучших места - это список рассылки javadoc-dev и база данных ошибок. Начиная с некоторого момента времени (я думаю, что 9) объединили разбор @files через инструменты. В прошлый раз мне не удалось найти код в репозитории Mercurial.