Bug 24877 - Включить Help-index в пакет
Summary: Включить Help-index в пакет
Status: CLOSED FIXED
Alias: None
Product: Sisyphus
Classification: Development
Component: fpc-docs (show other bugs)
Version: unstable
Hardware: all Linux
: P3 normal
Assignee: Andrey Cherepanov
QA Contact: qa-sisyphus
URL:
Keywords:
: 22581 (view as bug list)
Depends on:
Blocks:
 
Reported: 2011-01-09 07:51 MSK by AEN
Modified: 2011-01-13 14:52 MSK (History)
5 users (show)

See Also:


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

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

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

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

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

А нельзя глобальное умолчание сделать?
Comment 13 ashen 2011-01-12 15:50:25 MSK
(В ответ на комментарий №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 AEN 2011-01-12 16:15:17 MSK
(В ответ на комментарий №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 ashen 2011-01-12 16:28:49 MSK
постараюсь в ближайшие дни.
Comment 16 Fr. Br. George 2011-01-13 13:03:54 MSK
(В ответ на комментарий №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 Repository Robot 2011-01-13 14:52:06 MSK
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@