[newbies] советы по мотивам spec-файла

[Michael Shigorin]

On Sat, Oct 10, 2009 at 09:05:05PM +0300, Artem Zolochevskiy wrote:
> 2. Вопрос по установке документации. [...]
>   * какие-то может я ещё варианты упустил?

Можно смотреть в libalsa.spec, там документация из libalsa-docs
складывается в каталог /usr/share/doc/libalsa-%version/ (и точно
так же можно из нескольких подпакетов, как рядом и расписано --
просто сам обычно в таких случаях помню, что "libalsa", и лезу
посмотреть туда):

%define pkgdocdir %_docdir/%name-%version

[...]

%install
#...
mkdir -p %buildroot%pkgdocdir
install -pm644 NOTES MEMORY-LEAK TODO %buildroot%pkgdocdir/
cp -a doc/doxygen/html %buildroot%pkgdocdir/

[...]

%files docs
%dir %pkgdocdir
%pkgdocdir/[D-Z]*
%pkgdocdir/html

> 3. Вопрос по именованию. Я уже говорил, что asciidoc распилен
> на подпакеты. Это ПО содержит две большие утилиты: asciidoc и
> a2x.

Они настолько велики сами по себе или различны по наборам
зависимостей, что в распиле пакета есть реальный смысл?

[посмотрел: asciidoc тащит только питон с кучкой модулей,
a2x -- вдобавок lynx xsltproc docbook-style-xsl dblatex;
пожалуй, оправданно, хотя размер подпакета -a2x минимален]

>   * стоит ли ставить зависимость: пакет документации зависит от
>     пакета самой программы? Каковы тут правила/традиция?

По-моему, хорошая традиция -- это знать меру и не доходить
до оверинжиниринга. :)  А вообще документацию порой ставят
и без программы -- на почитать.  Сейчас это скорее редкость,
но раз уж ты спрашиваешь...


On Sun, Oct 11, 2009 at 03:18:15AM +0400, Alexey I. Froloff wrote:
> >   * не использовать ли имя пакета asciidoc для именования пакета,
> > устанавливающего _все_ компоненты? (надо, конечно будет тогда
> > придумать имя для пакета, который сейчас именуется asciidoc)
> Это сложный философский вопрос.  Кто пользуется asciidoc ради
> a2x?  Если количество таких пользователей пренебрежимо мало, то
> можно и не напрягаться.  В противном случае надо обеспечить
> присутствие a2x после обновления основного пакета.

Насколько понимаю, можно не напрягаться.  Если всё-таки ошибся
и вылезут недовольные пользователи сизифа, то ради избежания
недовольства обновляющих дистрибутивы можно и сделать.

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/