[devel] Q: ruby и ri

[Alexey I. Froloff]

Собирал я тут log4r и задумался...

Почему у нас отсутствуют мекросы для ri и rdoc?  И почему модули
не генерят документацию для ri?  Например так (макросы
экранированы для использования в ruby.spec):

/etc/rpm/macros.d/ruby:
...
%%ruby_ri_systemdir	%_datadir/ri/%subver
...
%%rdoc	DESTDIR="%%buildroot" rdoc --ri-system
...

ruby-*.spec:
...
%install
%make_install DESTDIR="%buildroot" install
%rdoc .
...
%files
...
%doc %ruby_ri_systemdir/*
...


Второй вопрос - чем отличатся rdoc --ri-system от rdoc --ri-site
кроме того, что --ri-system утитывает $DESTDIR?  Может оставить
--ri-system для самого ruby, а во всех сторонних модулях
использовать --ri-site (попутно научив его понимать $DESTDIR)?

Кстати, rdoc создаёт документацию для класса (в виде "пустого"
Klass/cdesc-Klass.yaml) даже если в описании класса есть
директива :nodoc:...

-- 
Regards,
Sir Raorn.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.altlinux.ru/pipermail/devel/attachments/20040904/5051f6bf/attachment.bin