Javado c поддерживает файлы опций, которые будут использоваться следующим образом:
javadoc @optsFile1 @optsFile2 @optsFile3
Формат этих файлов не выглядит как задокументированный слишком много:
Аргументы в файле могут быть разделены пробелом или символом новой строки. Если имя файла содержит встроенные пробелы, поместите все имя файла в двойные кавычки.
Дополнительно я нашел следующее предложение:
Используется опция -encoding для кодирования файлов, читаемых инструментом javado c, а параметры -docencoding и -charset используются для кодирования файлов, написанных инструментом.
Это читается как значение, указанное для параметра -encoding - то же самое, что используется для чтения файлов опций. Но -encoding сам документирует следующее:
Указывает имя кодировки исходных файлов, например EUCJIS / SJIS.
В этом предложении явно упоминаются только исходные файлы, файлы опций не обязательно должны учитываться. Другая проблема заключается в том, что этот аргумент может быть доступен только в файле опций, поэтому Javado c может не знать в теории.
Я бы вместо этого ожидал, что эти файлы опций всегда читаются с некоторой кодировкой, чтобы конечно, что-то вроде UTF-8 или кодировка платформы по умолчанию, используемая как запасной вариант в других местах, связанных с набором символов. Но, в конце концов, это нигде явно не задокументировано, даже если кодировка по умолчанию платформы может отличаться в разных случаях использования.
Итак, какую кодировку символов необходимо использовать для Javado c файлов опций?
Спасибо!