Forth и другие саморасширяющиеся системы программирования Locations of visitors to this page
Текущее время: Пт мар 29, 2024 03:23

...
Google Search
Forth-FAQ Spy Grafic

Часовой пояс: UTC + 3 часа [ Летнее время ]




Начать новую тему Ответить на тему  [ Сообщений: 4 ] 
Автор Сообщение
 Заголовок сообщения: Системы автодокументации для форта
СообщениеДобавлено: Вс июл 26, 2009 09:36 
Не в сети

Зарегистрирован: Вс июн 21, 2009 19:11
Сообщения: 81
Откуда: Н.Новгород
Благодарил (а): 0 раз.
Поблагодарили: 0 раз.
При рассмотрении различных фортов в одном заметил подобие Doxygen - то есть возможность генерации сводной документации проекта по тегам, размещённым в исходном тексте.
А я вот что подумал: неплохо было бы иметь такие слова, которые могут парсить исходники на предмет определений и комментариев.
Фактически, эту работу может выполнить штатный интерпретатор входного потока, только результатом будет не компилированное слово в словаре, а текстовый вывод (на экран или в файл) определения и сопутствующих комментариев. Можно в зависимости от настроек только комментариев.

Какие у кого есть идеи, может быть, наработки по этой теме?
Конечно, в идеале это должно быть так: пишем в специальной среде, подводим курсор к слову - над ним всплывает подсказка со стековым комментарием.
Но для начала неплохо бы просто определить какое-нибудь слово, например, doxy, чтобы выводить информацию по конкретному слову или файлу
Типа такого:
doxy MyWord <Enter>

: MyWord ( a b c -- d )
(! Делает то-то и то-то, возвращает нечто)
ok

Это я всё на тему "как нам обустроить форт" :)


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения:
СообщениеДобавлено: Вс июл 26, 2009 11:21 
Не в сети
Аватара пользователя

Зарегистрирован: Вт мар 20, 2007 23:39
Сообщения: 1261
Благодарил (а): 3 раз.
Поблагодарили: 19 раз.
MrYuran писал(а):
пишем в специальной среде, подводим курсор к слову - над ним всплывает подсказка со стековым комментарием.

Такой возможностью обладает редактор SciTE, описания слов он берет из *.api. Можно в реальном времени таким образом сканировать каталог с исходниками и генерировать апи-файлы. Честно говоря, я уже давно хотел сделать такую задачку для ннкрона - да все руки не доходят.

_________________
Cтоимость сопровождения программного обеспечения пропорциональна квадрату творческих способностей программиста.
Роберт Д. Блисc


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения:
СообщениеДобавлено: Вс июл 26, 2009 12:58 
Не в сети

Зарегистрирован: Вс июн 21, 2009 19:11
Сообщения: 81
Откуда: Н.Новгород
Благодарил (а): 0 раз.
Поблагодарили: 0 раз.
Вот, кое-что сам нашёл, буду разбираться
~ygrek/doc/docbook/


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
 Заголовок сообщения:
СообщениеДобавлено: Пн авг 17, 2009 08:57 
Не в сети
Moderator
Moderator
Аватара пользователя

Зарегистрирован: Чт май 04, 2006 00:53
Сообщения: 5062
Откуда: был Крым, теперь Новосибирск
Благодарил (а): 23 раз.
Поблагодарили: 63 раз.
MrYuran писал(а):
А я вот что подумал: неплохо было бы иметь такие слова, которые могут парсить исходники на предмет определений и комментариев.
Фактически, эту работу может выполнить штатный интерпретатор входного потока, только результатом будет не компилированное слово в словаре, а текстовый вывод (на экран или в файл) определения и сопутствующих комментариев. Можно в зависимости от настроек только комментариев.
Какие у кого есть идеи, может быть, наработки по этой теме?

в некотором роде похожая вещь есть в форке, а именно при сборке системы создается names.xrf файл. Кусочек оттуда:
<pre>
.\kernel\compiler\print.f
PAD# 05C6F7C Cons 9 ( --> const )
BASE 05C6F9E User 9 ( --> addr )
always 05C7011 : 21 ( --> )
HEX 05C7041 : 20 ( --> )
</pre>
так вот, стековый коментарий в конце выдирается из исходного текста.
аналогичным образом можно поступать и с коментариями, однако, смысла в этом мало.
Имхо, черезмерное загромождение исходного текста коментариями тоже очень плохо. К тому же коментарии пишутся для программиста(самого себя в первую очередь), а не для пользователя!!! А это значит, что собранный таким образом коментарий будет не очень полезен.

_________________
Мне бы только мой крошечный вклад внести,
За короткую жизнь сплести
Хотя бы ниточку шёлка.
fleur


Вернуться к началу
 Профиль Отправить личное сообщение  
Ответить с цитатой  
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему  [ Сообщений: 4 ] 

Часовой пояс: UTC + 3 часа [ Летнее время ]


Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 10


Вы не можете начинать темы
Вы можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения

cron
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
phpBB сборка от FladeX // Русская поддержка phpBB