ALT Linux Bugzilla – #24877

Created attachment 4741 [details]
Help index для fpc-docs-2.4.2

*** Bug 22581 has been marked as a duplicate of this bug. ***

Приложил индекс для fpc-docs-2.4.2 из p5. Сизифа под рукой нет.
Желательно собрать fpc-docs для p5 asap, сейчас это можно сделать очень просто.

Для p5 думаю стоит именно подложить соответствующий htx-файл.
Для сизифа надо поискать способ построения индексного файла при сборке пакета.
А так же способ интеграции в fp "из коробки", не зависимо от версий fpc & fpc-docs.

(В ответ на комментарий №4)
> Для p5 думаю стоит именно подложить соответствующий htx-файл.
> Для сизифа надо поискать способ построения индексного файла при сборке пакета.
> А так же способ интеграции в fp "из коробки", не зависимо от версий fpc &
> fpc-docs.

Согласен. Сделаете?

Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
cas@ сделаешь?
Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно ли это сделать вызовом fpc или fpdoc; 2) как индексный файл интегрируется в оболочку.

(В ответ на комментарий №6)
> Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> cas@ сделаешь?
> Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно
> ли это сделать вызовом fpc или fpdoc; 2) как индексный файл интегрируется в
> оболочку.
Пожалуйста, пришлите ссылку на репозиторий или патч для git am.

(В ответ на комментарий №7)
> (В ответ на комментарий №6)
> > Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> > cas@ сделаешь?
> Пожалуйста, пришлите ссылку на репозиторий или патч для git am.
Дык aen@ в багрепорте вложил уже готовый fpctoc.ru.htx

(В ответ на комментарий №6)
> Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> cas@ сделаешь?
> Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно
> ли это сделать вызовом fpc или fpdoc; 
> 2) как индексный файл интегрируется в оболочку.
Я когда-то пытался это сделать и пришел к выводу что проще сгенерить локально и подложить. При этом подкладывать нужно каждому пользователю в хомяк, т.к. именно от туда берется этот индекс. Из-за этого дальше и заглохло.

(В ответ на комментарий №9)
> (В ответ на комментарий №6)
> > 2) как индексный файл интегрируется в оболочку.
> Я когда-то пытался это сделать и пришел к выводу что проще сгенерить локально и
> подложить. При этом подкладывать нужно каждому пользователю в хомяк, т.к.
> именно от туда берется этот индекс. Из-за этого дальше и заглохло.

Берётся из ~/fpc/fp.ini 
Секция [HELP]
Параметр Files=_path_to_htx_

Вот теперь вопрос, как пользователям нужное подсовывать?

ну при первом запуске то понятно, дописать нужную проверку в скрипте fp.

(В ответ на комментарий №11)
> ну при первом запуске то понятно, дописать нужную проверку в скрипте fp.

А нельзя глобальное умолчание сделать?

(В ответ на комментарий №12)
> (В ответ на комментарий №11)
> > ну при первом запуске то понятно, дописать нужную проверку в скрипте fp.
> А нельзя глобальное умолчание сделать?
Думаю да.
1) реструктуризировать fpc-docs к виду: /usr/share/doc/%name/%version. 
В /usr/share/doc/%name/ сделать симлинки на текущию версию fpctoc.ru.html и на 
/usr/share/doc/fpc-docs/fpctoc.ru.htx

А в дефолтном fp.ini прописать такое:

[Help]
Files="/usr/share/doc/fpc-docs/fpctoc.ru.htx|HTML Index"

2) ну и пропатчить fpc соотвествующим образом, добавив нужные: fp.cfg, fp.dsk,  fp.ini; и изменить соответствующим образом /usr/bin/fp.

Тогда, да же если установлены разные версии fpc и fpc-docs документация будет всегда интегрирована в fp-ide. И ни обновление fpc, ни fpc-docs не сломают такую интеграцию.

(В ответ на комментарий №13)
> (В ответ на комментарий №12)
> > (В ответ на комментарий №11)
> > > ну при первом запуске то понятно, дописать нужную проверку в скрипте fp.
> > А нельзя глобальное умолчание сделать?
> Думаю да.
> 1) реструктуризировать fpc-docs к виду: /usr/share/doc/%name/%version. 
> В /usr/share/doc/%name/ сделать симлинки на текущию версию fpctoc.ru.html и на 
> /usr/share/doc/fpc-docs/fpctoc.ru.htx
> 
> А в дефолтном fp.ini прописать такое:
> 
> [Help]
> Files="/usr/share/doc/fpc-docs/fpctoc.ru.htx|HTML Index"
> 
> 2) ну и пропатчить fpc соотвествующим образом, добавив нужные: fp.cfg, fp.dsk, 
> fp.ini; и изменить соответствующим образом /usr/bin/fp.
> 
> Тогда, да же если установлены разные версии fpc и fpc-docs документация будет
> всегда интегрирована в fp-ide. И ни обновление fpc, ни fpc-docs не сломают
> такую интеграцию.

Да. Сделаете?

постараюсь в ближайшие дни.

(В ответ на комментарий №7)
> (В ответ на комментарий №6)
> > Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> > cas@ сделаешь?
> > Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно
> > ли это сделать вызовом fpc или fpdoc; 2) как индексный файл интегрируется в
> > оболочку.
> Пожалуйста, пришлите ссылку на репозиторий или патч для git am.
http://git.altlinux.org/people/george/packages/?p=fpc-docs.git;a=tree;h=refs/heads/p5;hb=p5

fpc-docs-2.4.2-alt0.M50P.2 -> p5:

* Thu Jan 13 2011 Fr. Br. George <george@altlinux> 2.4.2-alt0.M50P.2
- Add pre-generated russian help index (closes: #24877), thanks to aen@