Bug 24877 - Включить Help-index в пакет
: Включить Help-index в пакет
Status: CLOSED FIXED
: Sisyphus
(All bugs in Sisyphus/fpc-docs)
: unstable
: all Linux
: P3 normal
Assigned To:
:
:
:
:
:
  Show dependency tree
 
Reported: 2011-01-09 07:51 by
Modified: 2011-01-13 14:52 (History)


Attachments
Help index для fpc-docs-2.4.2 (796.34 KB, application/octet-stream)
2011-01-09 08:00, AEN
no flags Details


Note

You need to log in before you can comment on or make changes to this bug.


Description From 2011-01-09 07:51:37
Для использования онлайн-подсказки в FPC IDE необходимо проиндексировать файлы
в /usr/share/doc/fpc-docs-<version>. Это можно сделать из IDE (Help->Files), но
только с правами root, так как индекс хранится вместе с файлами помощи.
Прошу включить индекс в пакет, в корень каталога fpc-docs-<version>, создавая
его в процессе сборки или вручную из IDE.
Прошу также сделать то же для p5/5.1
------- Comment #1 From 2011-01-09 08:00:04 -------
Created an attachment (id=4741) [details]
Help index для fpc-docs-2.4.2
------- Comment #2 From 2011-01-09 08:01:37 -------
*** Bug 22581 has been marked as a duplicate of this bug. ***
------- Comment #3 From 2011-01-09 08:04:52 -------
Приложил индекс для fpc-docs-2.4.2 из p5. Сизифа под рукой нет.
Желательно собрать fpc-docs для p5 asap, сейчас это можно сделать очень просто.
------- Comment #4 From 2011-01-11 09:36:51 -------
Для p5 думаю стоит именно подложить соответствующий htx-файл.
Для сизифа надо поискать способ построения индексного файла при сборке пакета.
А так же способ интеграции в fp "из коробки", не зависимо от версий fpc &
fpc-docs.
------- Comment #5 From 2011-01-11 09:44:52 -------
(В ответ на комментарий №4)
> Для p5 думаю стоит именно подложить соответствующий htx-файл.
> Для сизифа надо поискать способ построения индексного файла при сборке пакета.
> А так же способ интеграции в fp "из коробки", не зависимо от версий fpc &
> fpc-docs.

Согласен. Сделаете?
------- Comment #6 From 2011-01-11 09:56:49 -------
Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
cas@ сделаешь?
Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно
ли это сделать вызовом fpc или fpdoc; 2) как индексный файл интегрируется в
оболочку.
------- Comment #7 From 2011-01-11 14:22:09 -------
(В ответ на комментарий №6)
> Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> cas@ сделаешь?
> Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно
> ли это сделать вызовом fpc или fpdoc; 2) как индексный файл интегрируется в
> оболочку.
Пожалуйста, пришлите ссылку на репозиторий или патч для git am.
------- Comment #8 From 2011-01-11 14:30:57 -------
(В ответ на комментарий №7)
> (В ответ на комментарий №6)
> > Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> > cas@ сделаешь?
> Пожалуйста, пришлите ссылку на репозиторий или патч для git am.
Дык aen@ в багрепорте вложил уже готовый fpctoc.ru.htx
------- Comment #9 From 2011-01-11 17:04:59 -------
(В ответ на комментарий №6)
> Для p5 просто положить fpctoc.ru.htx рядом с fpctoc.ru.html.
> cas@ сделаешь?
> Для сизифа буду разбираться: 1) как генерируется индексный файл в ide и можно
> ли это сделать вызовом fpc или fpdoc; 
> 2) как индексный файл интегрируется в оболочку.
Я когда-то пытался это сделать и пришел к выводу что проще сгенерить локально и
подложить. При этом подкладывать нужно каждому пользователю в хомяк, т.к.
именно от туда берется этот индекс. Из-за этого дальше и заглохло.
------- Comment #10 From 2011-01-12 15:18:47 -------
(В ответ на комментарий №9)
> (В ответ на комментарий №6)
> > 2) как индексный файл интегрируется в оболочку.
> Я когда-то пытался это сделать и пришел к выводу что проще сгенерить локально и
> подложить. При этом подкладывать нужно каждому пользователю в хомяк, т.к.
> именно от туда берется этот индекс. Из-за этого дальше и заглохло.

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

Вот теперь вопрос, как пользователям нужное подсовывать?
------- Comment #11 From 2011-01-12 15:29:55 -------
ну при первом запуске то понятно, дописать нужную проверку в скрипте fp.
------- Comment #12 From 2011-01-12 15:35:05 -------
(В ответ на комментарий №11)
> ну при первом запуске то понятно, дописать нужную проверку в скрипте fp.

А нельзя глобальное умолчание сделать?
------- Comment #13 From 2011-01-12 15:50:25 -------
(В ответ на комментарий №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 не сломают
такую интеграцию.
------- Comment #14 From 2011-01-12 16:15:17 -------
(В ответ на комментарий №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 не сломают
> такую интеграцию.

Да. Сделаете?
------- Comment #15 From 2011-01-12 16:28:49 -------
постараюсь в ближайшие дни.
------- Comment #16 From 2011-01-13 13:03:54 -------
(В ответ на комментарий №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
------- Comment #17 From 2011-01-13 14:52:06 -------
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@