[devel] Q: ruby и ri

Alexey I. Froloff =?iso-8859-1?q?raorn_=CE=C1_immo=2Eru?=
Сб Сен 4 20:47:32 MSD 2004


Собирал я тут 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.
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/devel/attachments/20040904/5051f6bf/attachment-0001.bin>


Подробная информация о списке рассылки Devel