Forth http://www.fforum.winglion.ru/ |
|
Документация SPF http://www.fforum.winglion.ru/viewtopic.php?f=18&t=253 |
Страница 1 из 3 |
Автор: | ygrek [ Ср окт 04, 2006 17:12 ] |
Заголовок сообщения: | Документация SPF |
Чего не хватает в документации SP-Forth? Принимаются конструктивные предложения по организации, содержанию, оформлению. |
Автор: | chess [ Чт окт 05, 2006 16:57 ] |
Заголовок сообщения: | |
yGREK писал(а): Чего не хватает в документации SP-Forth?
Не хватает информации по организации словарной статьи и словарей. |
Автор: | mOleg [ Чт окт 05, 2006 20:27 ] |
Заголовок сообщения: | |
не плохо было бы описать принцип работы вызова функий ОС И еще немного не по теме. Вынеси пожалуйста в папку src все файлы, необходимые для сборки СПФа (я тебе присылал свой вариант) так чтобы просто копирование папки src позволяло собрать новый вариант СПФ. |
Автор: | ygrek [ Чт окт 05, 2006 23:25 ] |
Заголовок сообщения: | |
oleg писал(а): И еще немного не по теме. Вынеси пожалуйста в папку src все файлы, необходимые для сборки СПФа (я тебе присылал свой вариант) так чтобы просто копирование папки src позволяло собрать новый вариант СПФ.
ARGHHH!! Я сейчас занимаюсь(по мере возможностей) тупо дистрибутиво-организаторской работой - изменять исходники в src не могу, не хочу и не буду. С такими вопросами не ко мне, а в spf-dev. Тем более я лично с таким предложением не согласен. Зачем переносить в src файлы из lib (вы ведь это имеете ввиду?, кроме lib и src для компиляции spf ничего больше не надо) - это разделяемый код, по логике ему место в lib, тем более учтите вопрос совместимости. Плюс ещё наверное вопрос удобства, который рассчитывается для большинства, а не для kernel hacker'ов которые могут сами передвигать, что куда хотят |
Автор: | mOleg [ Пт окт 06, 2006 22:56 ] |
Заголовок сообщения: | |
yGREK писал(а): ARGHHH!! Спокойнее! все нормально! дышите глубоко и медленно yGREK писал(а): Я сейчас занимаюсь(по мере возможностей) тупо дистрибутиво-организаторской работой - изменять исходники в src не могу, не хочу и не буду.
я не сказал ни слова о том, чтобы менять исходники в предыдущем посте небыло. Я лишь предложил вложить все файлы, требуемые для сборки спфа в папку src, чтобы было их легче искать. Мне кажется, что так было бы удобнее. Причем не обязательно выносить их оттуда, где они сейчас находятся, а просто продублировать не смотря на то, что там разделяемый код. Потому что разбираться все же легче, когда все, что нужно лежит в одной папке. И еще раз, я не настаиваю, а высказываю собственное мнение так что кипятиться не надо |
Автор: | profiT [ Чт ноя 15, 2007 10:20 ] |
Заголовок сообщения: | |
--- |
Автор: | Kopa [ Чт ноя 15, 2007 11:33 ] |
Заголовок сообщения: | |
Интересует еще информация в срезе основных подкаталогов spf Например lib, samples, Предлагаю отдельно добавить информацию о возможных консолей в spf в частности определить состояние ( возможности, недоработки ) файла из lib/win/spfgui.f P.S. В подкаталог samples желательно перенести интересные примеры использования библиотек из devel. |
Автор: | profiT [ Пн ноя 26, 2007 11:27 ] |
Заголовок сообщения: | |
Реакции от целевой группы мега-ворчунов -- никакой. Ну-ну. "Как советовать -- так все чатлане..." (с) Кора писал(а): Интересует еще информация в срезе основных подкаталогов spf Например lib, samples, Дело не в том что кого интересует. Я например тоже про много хочу узнать. Дело в том кто что может описать или помочь исправить уже имеющееся (список дан выше). Цитата: В подкаталог samples желательно перенести интересные примеры
использования библиотек из devel. См. выше эту же тему. Зато makrus откликнулся и прислал готовую, обширную и конкретную инструкцию по настройке SciTe с SPF. Пожалуй, слегка даже слишком обширную, но это уже решаемо в рабочем порядке. А начало отличное. Я его присланный документ и файлы скомпилировал с уже имеющимися описаниями и пока положил на вику sourceforge (spf.wiki.sourceforge.net/spf_editors), но возможно позже перенесу (если не найду способа как сделать возможным редактирование статей вики анонимным пользователям -- чтобы сам автор мог иметь слово в обсуждении и правках своего же собственного текста; или если получится, makrus просто зарегистрирует аккаунт на sf.net). |
Автор: | Kopa [ Пн ноя 26, 2007 11:44 ] |
Заголовок сообщения: | |
profiT писал(а):
Подправить можно Регистро-зависимость Добавив описание слов включающих/отключающих ее и если есть, то возможные "грабли" Фразу "Надо также заметить что в SPF поддерживается префикс слов S- и окончание -ED." лучше заменить на более корректную, во избежание кривотолков. Описание Локальных и временных переменных - есть и другие их реализации, то чем они отличаются и степень их совместимости. |
Автор: | profiT [ Вт ноя 27, 2007 11:48 ] |
Заголовок сообщения: | |
Kopa писал(а): Подправить можно Регистро-зависимость. Добавив описание слов включающих/отключающих ее и если есть, то возможные "грабли". Расширил абзац про регистро-зависимость. Заодно добавил абзац про вещественные числа. Kopa писал(а): Описание Локальных и временных переменных - есть и другие их реализации, то чем они отличаются и степень их совместимости.
Нужна только одна реализация локальных переменных -- та что в lib/ext/locals.f. Остальные которые в папках devel -- это личные наработки которые со временем слились в lib/ext/locals.f (или не слились). Их лучше не упоминать -- чтобы не смущать. Единственно что ещё надо добавить к lib/ext/locals.f -- это реализация ANS-совместимых локальных переменных. Я пока вписал туда ~af/lib/locals-ans.f (хотя вообще-то есть ещё реализация от ~mak). Остальное -- чуть позже. |
Автор: | Kopa [ Вт ноя 27, 2007 13:14 ] |
Заголовок сообщения: | |
В intro "Подобного эффекта можно добиться и с помощью векторов, но так намного удобнее" стоит описать VECT и может дать сноску на аналог слово DEFER в других Форт системах |
Автор: | profiT [ Ср ноя 28, 2007 06:56 ] |
Заголовок сообщения: | |
Kopa писал(а): Фразу
"Надо также заметить что в SPF поддерживается префикс слов S- и окончание -ED." лучше заменить на более корректную, во избежание кривотолков. Описание Локальных и временных переменных - есть и другие их реализации, то чем они отличаются и степень их совместимости. Фраза про "S-" и "-ED", абзац про локальные переменные. PS. Оказывается у папки /docs есть таки лента RSS. |
Автор: | Kopa [ Ср ноя 28, 2007 08:54 ] |
Заголовок сообщения: | |
При обдумывании топика нашел несколько пожеланий, но сразу все не вспомнить. Чтобы не засорять форум могу писать в личку. В intro желательно указать способ регистрации пути к SPF. Упомянуть про слова WORD, VOCS, ORDER, BYE, QUIT и возможно у Михаила WDS. При описании мультизадачности описать все слова и упомянуть, что PAUSE останавливает поток, в котором выполняется. Добавить все слова работы с лог файлом. ( печати и вывода строки ) Упомянуть добавленные слова для форматного вывода HOLDS, и введенные важные системные переменные. Где AT-XY PAGE и слова работающие с консолью. Какой глубокий смысл слова SCREEN-LENGTH? P.S. Неплохо определить раздел для сносок на разработки для SPF, существующие на авторских страничках и возможно на данном форуме. Рассказать о возможных методах адаптации не родных Форт исходников. |
Автор: | profiT [ Ср ноя 28, 2007 12:16 ] |
Заголовок сообщения: | |
Кора писал(а): Чтобы не засорять форум могу писать в личку. Да я не против совершенно такого "засорения". Всяко лучше такое конструктивное обсуждение, нежели беседа вокруг конструктивных особенностей будущего терминатора о двух ногах. Кора писал(а): В intro желательно указать способ регистрации пути к SPF. А именно путь к SPF нигде не регистрируется. Корневая папка SPF (а значит -- и всего остального: /devel /src /lib /docs и т.д.) всегда определяется по расположению вызванного файла spf4.exe. Если вызовешь e:/spf/spf4.exe , то путь ~ac/lib/str5.f будет означать e:/spf/~ac/lib/str5.f, а если с:/lang/spf/spf4.exe то -- с:/lang/spf/~ac/lib/str5.f. Про это сказано в абзаце про пути. Если же хотим привязать расширение *.f к SPF то делаем это либо при установке (есть специальная галочка в инсталляторе), либо вручную (если файловый мэнеджер или редактор имеет отдельные для этого настройки, независимые от Windows'овских). Кора писал(а): Упомянуть про слова WORD, VOCS, ORDER, BYE, QUIT WORD, ORDER, BYE, QUIT -- вроде как не только стандартны, они даже есть в практически любых системах (даже в самых маргинальных и не-ANS94-ых). А цель документа intro: Цитата: Краткое вступление для тех, кто уже знаком с какой-либо Форт-системой и стандартом ANS'94. Впрочем, первое слово уже нарушено -- документ уже занимает добрые 27Кб. Про VOCS -- не знаю. Это так важно?.. Кора писал(а): у Михаила WDS Что и где это такое?.. Кора писал(а): .. и введенные важные системные переменные Ну опять же, это же не полный мануал (см. про цель документа). И если они были введены post-factum значит разницы по сравнению с другими системами они не играют. Кора писал(а): Добавить все слова работы с лог файлом. ( печати и вывода строки ) Насколько я понимаю "вывод в лог" ничем не отличается от "просто" вывода. То есть после вызова STARLOG обычный TYPE и . будут выводить нужное (и ненужное) в spf.log. С остальным -- если успею, сам буду в курсе и смогу сформулировать -- допишу. Кора писал(а): P.S. Неплохо определить раздел для сносок на разработки для SPF, существующие на авторских страничках и возможно на данном форуме. Это если будет, то будет отдельный документ. Можешь набросать примерно какие примеры ты видишь в этом документе? А вообще хотелось бы в описаниях ограничиваться только тем что человек получает непосредственно в дистре -- ведь там и так куча всего (больше тысячи исходников в SPF, я напомню). Это не только вопрос экономии трафика, но и часто вопрос потраченных часов на доводку исходников скаченных неведомо где, и написанных неведомо для какой версии SPF. При этом даже простейшие инструкции вида: "возьмите папку ~vasya из архива и положите в папку DEVEL" -- тоже доводка, так как движения надо делать лишние, вместо того чтобы просто тыкнуть мышкой в файл. А вообще -- всё хорошее так или иначе попадёт в дистр, не надо сумлеваться. Другое дело что SPF_DEVEL не описывает конечные программы, он описывает только библиотеки и наработки, пригодные для повторного использования. Но это вопрос другой. Кора писал(а): Рассказать о возможных методах адаптации не родных Форт исходников.
Это я боюсь слишком толстая тема, так как у каждой форт-системы набор инструментов свой и они почти не пересекаются... Но самая важная проблема уже описана -- регистро-зависимость и грабля c [IF] [THEN]. |
Автор: | in4 [ Ср ноя 28, 2007 12:16 ] |
Заголовок сообщения: | |
http://spf.sourceforge.net/docs/intro.ru.html писал(а): Коды ошибок, которые принимаются словом THROW и получаются на выходе CATCH, интерпретируются А не на входе?
На cvs нет intro.ru.html , есть intro.ru.md . Как получить .HTML по .MD ? В файле intro.ru.html (и, м. в других тоже) лучше сделать явное окончание. Типа ---конец файла--- . devel.ru.html тоже хорошо бы на cvs иметь (м. я не нашел? ) |
Страница 1 из 3 | Часовой пояс: UTC + 3 часа [ Летнее время ] |
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group http://www.phpbb.com/ |