[devel] Q: ruby и ri

[devel] Q: ruby и ri

[Alexey I. Froloff]

[-- Attachment #1: Type: text/plain, Size: 903 bytes --]

Собирал я тут 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.

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]