TODO List

Yuriy V. Vorontsov (Че) 24.04.2004 22:55 / 24.04.2004 23:11

Подумал над комментированием статических полей класса... (Точнее сходил попил кофе с друзьями :))

Наверное, не стоит пороть горячку и:
1ое) Вспомнить как это сделано в Perl’е, т.к. возможности для самодокументации в нём заложены просто превосходные, надо хорошо подумать может подобное прикрутить к parser3

2ое) Просто автоматически составлять список статических полей и описывать его отдельно... Хотя вопрос, что делать, если имя объекта создаётся динамически:

$[$form:object_name][Ну и какое у меня имя? :)]

3ье) Сделать возможность изменить написанное в комментарии перед сохранением в документационный файл, хотябы простой textarea’ей. Хотя тоже вопрос с составлением файла документации: набрёл на тред PAFа (http://www.parser.ru/forum/?id=7835), рассинхронизировать всё-таки не хочется, хотя можно сделать простой механизм кэширования... Таким образом можно просто докомментировать исходник, дописывать в него какое-то описание, или примеры работы...

4ое) Кэшировать всё tab-delimited файл

5ое) Написать нормальный viewer из кэш файла!

Друзья, кто знает как работают всякого рода javadocи или другие средства анализирующие комментарии (в виде обычного текста, а не XMLя), дайте свой авторитетный совет по этому вопросу.

Такое вот TODO...

В принципе, если есть желание с п. 4 может кто-нибудь помочь... ;)
Хотя многие уже подобное сделали, но не решились выложить: возможно толкнёте мне пару своих НОУ-ХАУ и идей :)))

---