У меня есть файл с именем MyFile.java, и он содержит несколько классов (ни один из них не является общедоступным). Обратите внимание, что файл не содержит класс MyFile. Очевидно, Javadoc недоволен этим и выдает предупреждение «1001 *». Несколько решений, которые я изучил:
- Перемещение классов в свои файлы. Это похоже на правильный способ исправления предупреждений, но новые файлы, очевидно, не будут иметь историю управления исходным кодом, поэтому я стараюсь ее избегать.
- Создать пустой класс MyFile. Это безобразно
- Скрыть предупреждения Javadoc, желательно для каждого файла. Существует высокая вероятность того, что это невозможно.
Несколько вопросов, которые у меня есть:
- Почему Javadoc жалуется? Я не смог найти никакой документации, пожалуйста, укажите мне одну. Я думаю, что совершенно нормально не иметь класс с тем же именем, что и у файла.
- Любые другие предложения, которые я могу рассмотреть?
- Можно ли как-то скрыть предупреждения?
additionalparam="-Xdoclint:none"
не работает.
Спасибо всем заранее