Пишу комментарии к своей программе, и хочу чтобы они появились в сгенерированом javadoc HTML файле

@simplepilot · Регистрация: 22.07.2007

Студворк — интернет-сервис помощи студентам

Пишу комментарии к своей программе и хочу что бы они появилсь в сгенирированом javadoc HTML файле. Всё вроде просто но вот если в коментарии встречается образцы html/xml тагов для того что бы они попали в javadoc надо вместо открывающихся и закрывающихся скобок ствить &lt и &gt. Но от этого тереятся наглядность коментариев если смотреть их внутри программы. Нельзя ли как то сделать что бы определённые фрагменты копировались в javadoc как просто строка без анализа есть там таги или нет. Вот пример
* <B>Example of source XML string:</B>

* <pre>
* &ltextreqctrin&gt
* &lt/extreqctrin&gt
* </pre>
*/

@McVillain · 05.02.2008, 13:03

Если я правильно ошибаюсь, javadoc копирует комментарии в html 'как есть', за исключением спецтэгов самого javadoc. Так что -- учитесь читать html 'на языке оригинала', это по-любому не будет ненужным навыком.

@simplepilot · 05.02.2008, 14:24 **[ТС]**

Ошибаетесь неправильно если вместо указаного выше написать

Code
1
2
3
4
5
6
7
8
<B>Example of source XML string:</B>
 
/*
* <pre>
* <extextreqctrin>
* </extreqctrin>
* </pre>
*/

В резульирующем документе фрагмент

Code
1
2
* <extextreqctrin>
* </extreqctrin>

отображаться не будет

07.02.2008, 10:14

Попробуй написать собственный doclet (jdk_dirdocs ooldocsjavadocoverview.html)

Новые блоги и статьи Все статьи Все блоги /
BOINC: 22 года — и всё ещё работает Programma_Boinc 12.03.2026 BOINC: 22 года — и всё ещё работает Дэвид Андерсон написал ретроспективу. Кратко: в 2001 году он ушёл из United Devices, где был CTO, и за несколько месяцев написал ядро BOINC — клиент, сервер,. . .	SDL3 для Desktop (MinGW): Создаём пустое окно с нуля для 2D-графики на SDL3, Си и C++ 8Observer8 10.03.2026 Содержание блога Финальные проекты на Си и на C++: hello-sdl3-c. zip hello-sdl3-cpp. zip Результат:	Установка CMake и MinGW 13.1 для сборки С и C++ приложений из консоли и из Qt Creator в EXE 8Observer8 10.03.2026 Содержание блога MinGW - это коллекция инструментов для сборки приложений в EXE. CMake - это система сборки приложений. Здесь описаны базовые шаги для старта программирования с помощью CMake и. . .	Как дизайн сайта влияет на конверсию: 7 решений, которые реально повышают заявки Neotwalker 08.03.2026 Многие до сих пор воспринимают дизайн сайта как “красивую оболочку”. На практике всё иначе: дизайн напрямую влияет на то, оставит человек заявку или уйдёт через несколько секунд. Даже если у вас. . .
Модульная разработка через nuget packages DevAlt 07.03.2026 Сложившийся в . Net-среде способ разработки чаще всего предполагает монорепозиторий в котором находятся все исходники. При создании нового решения, мы просто добавляем нужные проекты и имеем. . .	Модульный подход на примере F# DevAlt 06.03.2026 В блоге дяди Боба наткнулся на такое определение: В этой книге («Подход, основанный на вариантах использования») Ивар утверждает, что архитектура программного обеспечения — это структуры,. . .	Управление камерой с помощью скрипта OrbitControls.js на Three.js: Вращение, зум и панорамирование 8Observer8 05.03.2026 Содержание блога Финальная демка в браузере работает на Desktop и мобильных браузерах. Итоговый код: orbit-controls-threejs-js. zip. Сканируйте QR-код на мобильном. Вращайте камеру одним пальцем,. . .	SDL3 для Web (WebAssembly): Синхронизация спрайтов SDL3 и тел Box2D 8Observer8 04.03.2026 Содержание блога Финальная демка в браузере. Итоговый код: finish-sync-physics-sprites-sdl3-c. zip На первой гифке отладочные линии отключены, а на второй включены:. . .

@simplepilot 1 / 1 / 5 Регистрация: 22.07.2007 Сообщений: 366

	Пишу комментарии к своей программе, и хочу чтобы они появились в сгенерированом javadoc HTML файле 05.02.2008, 11:02. Показов 1464. Ответов 3 Метки нет (Все метки) Пишу комментарии к своей программе и хочу что бы они появилсь в сгенирированом javadoc HTML файле. Всё вроде просто но вот если в коментарии встречается образцы html/xml тагов для того что бы они попали в javadoc надо вместо открывающихся и закрывающихся скобок ствить &lt и &gt. Но от этого тереятся наглядность коментариев если смотреть их внутри программы. Нельзя ли как то сделать что бы определённые фрагменты копировались в javadoc как просто строка без анализа есть там таги или нет. Вот пример * <B>Example of source XML string:</B> * <pre> * &ltextreqctrin&gt * &lt/extreqctrin&gt * </pre> */ 0

@McVillain 1 / 1 / 5 Регистрация: 30.04.2007 Сообщений: 225
	05.02.2008, 13:03
	Если я правильно ошибаюсь, javadoc копирует комментарии в html 'как есть', за исключением спецтэгов самого javadoc. Так что -- учитесь читать html 'на языке оригинала', это по-любому не будет ненужным навыком. 0

Sergey_
	07.02.2008, 10:14
	Попробуй написать собственный doclet (jdk_dirdocs ooldocsjavadocoverview.html)