Кто отвечает за документацию и реализацию JavaDoc-инструмента? - PullRequest
0 голосов
/ 27 декабря 2018

Этот вопрос связан с проблемой, поднятой для Maven , которая, похоже, не содержит путей, перенаправляемых в файлы аргументов, поддерживаемые инструментом JavaDoc в Windows.Проблема заключается в том, что из документации самого JavaDoc неясно, как в этих файлах следует указывать пути под Windows.

Для Java 7 следующее:

Если имя файла содержит встроенныйпробелы, поместите все имя файла в двойные кавычки и удвойте каждую обратную косую черту («Мои файлы \ Stuff.java»).

https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#argumentfiles

Следующие из 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#GUID-EFE927BC-DB00-4876-808C-ED23E1AAEF7D

Если вы посмотрите на URI, в предыдущих версиях Java они были специфичны для Windowsпока последнего нет.Поэтому я думаю, что вещи были реорганизованы, и некоторые детали файлов аргументов были просто потеряны.

Итак, мне нужно место, где я мог бы поговорить с людьми об этих различиях в документации И, в конце концов, как обстоят деладолжен работать на Windows.Если обратный слеш является escape-символом только в путях и тому подобном.Я просто хотел бы получить некоторую осведомленность от людей, которые могут знать, почему в документах сейчас не хватает некоторых деталей, и, возможно, даже предоставить эти подробности снова.

Так кому / куда я пишу?Я не знаю, Oracle это или проект OpenJDK или кто-то совсем другой.Спасибо!

Ответы [ 2 ]

0 голосов
/ 27 декабря 2018

Я думаю, но не слишком авторитетно, что инструмент javadoc - это просто дополнительный инструмент (может ли кто-нибудь продемонстрировать формальное обязательство для любого JDK включить реализацию инструмента javadoc?) С неким фактическимстандарт, установленный первоначальными владельцами, Sun от Oracle.

Но де-факто это только де-факто.Формально и строго говоря, это означает, что ни один из разработчиков JDK не обязан заставлять свой инструмент javadoc вести себя так, как все остальные.

0 голосов
/ 27 декабря 2018

Я думаю, что лучшие два места - это список рассылки javadoc-dev , а также база данных ошибок .Начиная с некоторого момента времени (я полагаю, 9) унифицировано разбор @files между инструментами.В прошлый раз мне не удалось найти код в репозитории Mercurial.

...