Are test files documentation?

Michael Stahnke mastahnke at
Wed Aug 11 22:58:49 UTC 2010

On Wed, Aug 11, 2010 at 12:41 PM, Mamoru Tasaka
<mtasaka at> wrote:
> Michael Stahnke wrote, at 08/12/2010 01:02 AM +9:00:
>> Ok, I see your point.  I am normally developing with ruby, so I didn'
>> think about the normal application install.
>> Should we then say that ri/rdoc/examples/test/spec go into a -doc
>> package when they are over a certain size or always?
> My opinion is we should create -doc subpackage when they
> are large to some extent, especially when such files have compatible
> or larger size than those of files needed for runtime.
>> I'd just like to get some consistency here.
>> Also when we decide we should work with the packaging guys to get the
>> wiki page updated for ruby packages.
>> stahnma
> Something like the following proposal
> * Creating -doc subpackage
>   - Usually ruby gem based rpm installs rdoc/ri document files under %{gemdir}/doc/%{gemname}-%{version}.
>     Also many ruby gem based rpm installs some additional files under %{geminstdir}
>     which are not needed on runtime and are needed for development purpose only or checking the gem like:
>     - Rakefile
>     - spec/ directory
>     - test/ directory
>     - examples/ directory
>   If the total size of these files is compatible or enough larger than that of the files needed
>   for runtime, -doc subpackage should be created and these files should be moved into -doc subpackage.
> Any comments welcome.

I like the proposal, but would like a definitive way to know when to
make a -doc package or not to.

It would be spectacular if we could make some edits to gem2rpm to do
this by default.


More information about the ruby-sig mailing list