SPF Help

[Yuriy Zhilovets]

Привет всем!

Вот обещанный интерфейс к файлу spfhelp.xml. Тут все файлы, кроме самого
spfhelp.xml. Он есть где-то у Якимова.
Использовать так:

1) Распаковать в отдельный каталог.
2) Открыть в Firefox (1.5 или 2.0) файл spfhelp.xul

Поскольку применяется XSLT, то интерфейс подтормаживает.

Поиск регистрозависимый, ищет по всем модулям имена слов, в которых есть
указанная подстрока.

В процессе написания заметил, что многие форт-слова в файле SPFHELP.XML
не относятся ни к каким модулям, а сами комментарии написаны вразнобой и
очень небрежно.
Стандартные слова прокомментированы хорошо, а нестандартные - информация
по которым как раз и нужна, если разбираться в исходниках, - обычно
вообще не прокомментированы.

Ю. Жиловец

[Dmitry Yakimov-2]

Привет,

Хорошо получилось!
spfhelp.xml формируется автоматически при компиляции форт системы если
включена опция CREATE-XML-HELP в spf_compileoptions.f

кстати начиная с FF 3.0 который не за горами XUL Runner будет
поставляться отдельным пакетом, и на его базе можно будет строить
совершенно независимые от FF приложения (одним из них и будет FF 3.0).

Yuriy Zhilovets пишет:

> Привет всем!
>
> Вот обещанный интерфейс к файлу spfhelp.xml. Тут все файлы, кроме
> самого spfhelp.xml. Он есть где-то у Якимова.
> Использовать так:
>
> 1) Распаковать в отдельный каталог.
> 2) Открыть в Firefox (1.5 или 2.0) файл spfhelp.xul
>
> Поскольку применяется XSLT, то интерфейс подтормаживает.
>
> Поиск регистрозависимый, ищет по всем модулям имена слов, в которых
> есть указанная подстрока.
>
> В процессе написания заметил, что многие форт-слова в файле
> SPFHELP.XML не относятся ни к каким модулям, а сами комментарии
> написаны вразнобой и очень небрежно.
> Стандартные слова прокомментированы хорошо, а нестандартные -
> информация по которым как раз и нужна, если разбираться в исходниках,
> - обычно вообще не прокомментированы.
>
> Ю. Жиловец
>

Best Regards,
Dmitry Yakimov

[Andrey Cherezov]

Some javascript/style in this post has been disabled (why?)

Добрый день, Yuriy Zhilovets!

Ваше сообщение от 16.01.2007 19:05:

Вот обещанный интерфейс к файлу spfhelp.xml. Тут все файлы, кроме самого spfhelp.xml. Он есть где-то у Якимова.

http://www.activekitten.com/pbc_download/spfhelp.zip
Но сам activekitten.com сейчас не работает. Так что лучше закачай на forth.org.ru на всякий случай.

А вот, кстати, первая (?) попытка форматирования документации в chm (7 лет назад делал ~byka):
http://www.forth.org.ru/~byka/rus/forth/SPF_HELP.chm (и этот файл под вистой работает)

В процессе написания заметил, что многие форт-слова в файле SPFHELP.XML не относятся ни к каким модулям, а сами комментарии написаны вразнобой и очень небрежно.

Так ведь это программно из исходников выдиралось, насколько я понимаю.
Авторы либ не расчитывали на такое использование своих комментариев,
и поэтому никаких соглашений о форматах не придерживались. К тому же
у нас таких соглашений вроде и нет...

[Andrey Cherezov]

Добрый день, Dmitry Yakimov!

Ваше сообщение от 16.01.2007 19:18:
> кстати начиная с FF 3.0 который не за горами XUL Runner будет
> поставляться отдельным пакетом, и на его базе можно будет строить
> совершенно независимые от FF приложения (одним из них и будет FF 3.0).
>  
Они это уже три года обещают (см. http://wiki.forth.org.ru/XulRunner ),
так что обещанного три года ждут - в прямом смысле :) Я там угадал
насчет сроков.

[Dmitry Yakimov-2]

Andrey Cherezov пишет:
> Добрый день, Yuriy Zhilovets!
>
> Ваше сообщение от 16.01.2007 19:05:
>> Вот обещанный интерфейс к файлу spfhelp.xml. Тут все файлы, кроме
>> самого spfhelp.xml. Он есть где-то у Якимова.
> http://www.activekitten.com/pbc_download/spfhelp.zip
> Но сам activekitten.com сейчас не работает. Так что лучше закачай на
> forth.org.ru на всякий случай.
>
spf_compileoptions.f
0 CONSTANT CREATE-XML-HELP \ generate spfhelp.xml file

> А вот, кстати, первая (?) попытка форматирования документации в chm (7
> лет назад делал ~byka):
> http://www.forth.org.ru/~byka/rus/forth/SPF_HELP.chm (и этот файл под
> вистой работает)
>> В процессе написания заметил, что многие форт-слова в файле
>> SPFHELP.XML не относятся ни к каким модулям, а сами комментарии
>> написаны вразнобой и очень небрежно.
> Так ведь это программно из исходников выдиралось, насколько я понимаю.
> Авторы либ не расчитывали на такое использование своих комментариев,
> и поэтому никаких соглашений о форматах не придерживались. К тому же
> у нас таких соглашений вроде и нет...

src/spf_xmlhelp.f это соглашения создает.

Best Regards,
Dmitry Yakimov

[Andrey Cherezov]

Сообщение от 16.01.2007 19:50:
>> Так что лучше закачай на
>> forth.org.ru на всякий случай.
>>    
http://www.forth.org.ru/spf/spfhelp.xul
(работает из Firefox, без локального скачивания)