Попробовал создать документацию своего кода используя javadoc - все коменты на русском он отказался воспринимать. В настройках перепробовал все кодировки и ни как не смог добиться, чтобы русские буквы нормально отображались. Кто-нить знает как это победить?
alex
41 уровень
Документирование кода Javadoc
Комментарии (5)
- популярные
- новые
- старые
Для того, чтобы оставить комментарий Вы должны авторизоваться
Vitya
10 мая 2023, 12:20
Вопрос старый, но может ещё кто наткнётся)
Для комментариев на любом языке желательно для файлов проекта использовать кодировку utf-8.
А при генерации доков добавить опцию: -encoding utf8
Если в IDEA, то здесь: Tools -> Generate JavaDoc, поле: Command line arguments.
+3
alex
10 февраля 2020, 06:53
Спасибо за совет, но инглишь это не быстро, а с докой хочу разобраться в ближайшее время. Тем более документацию ты пишешь не только для себя, а и для других. Поэтому даже если и выушишь инглишь от русского совсем уйти не получится.
0
Justinian Judge в Mega City One Master
10 февраля 2020, 07:15
У меня большой вопрос для кого ты собрался писать документацию в принципе, и тем более на русском.
Пока что все указывает на то, что писать это ты собрался исключительно для себя, причем практический смысл затеи вылядит весьма сомнительным.
Разве что, тебе дали прямо задание для национального продукта возможно задокументировать код на русском. Если такого реального задания нет, то ты явно чем-то не тем занимаешься. Хотя у нас конечно свобода действий, и пока другие изучают джаву, ты вполне можешь заниматься чем угодно.
0
VladimirMaster
10 февраля 2020, 08:00
bro, брось ты это. Не нужно тебе это пока, прокачай лишний раз Java Core, если энергию девать некуда. Доку ты не будешь писать возможно, от слова никогда. Если хочешь доку, то качай Swagger - это то, что бабка прописала. Ну там вообще, как попрет, но пока точно не заморачивайся на это.
0
VladimirMaster
9 февраля 2020, 15:05
Еще один повод начать заниматься английским языком и пользоваться google search.
Прокачивай инглишь тут, тут, тут и тут
0