From: "Mauricio Fernández" <batsman.geo@...>
Date: 2004-10-12T03:58:44+09:00
Subject: Re: [ANN] dev-utils v1.0

On Mon, Oct 11, 2004 at 02:35:36PM +0900, Gavin Sinclair wrote:
> 
> > Plz find below a minor patch I had to apply to make the documentation
> > generator work (I have removed the RPA specific part).
> 
> This makes me curious.  Reading through the RPA transcript, it's not
> clear that the non-RDoc documentation is actually built.  There's
> copious details of everything else, yet no mention of that.  Yet the
> dev-utils RPA, as opposed to the dev-utils gem, specifies a dependency
> on cstemplate and redcloth.  Are they actually used?

They are :) The generation of the other docs isn't reported because...
well, I just didn't add anything to report it in the associated task *g*.
Note that redcloth and cstemplate are "build dependencies", i.e. only
needed to build the package. rpa-base knows that and can remove them
afterwards since they are no longer needed.

> This is interesting as a matter of packaging policy.  I'd like to
> assist users in building local documentation, but in this era of
> universal Internet access, people (I think) tend to just hit the
> website, which has exactly the same information.

rpa-base can be used to install from local repositories (will have to
document this though :) when the user has got no internet connection...

> BTW, I can't install dev-utils with rpa-base 0.2.2.  

Thank you for reporting the problem.
I had failed to declare the "build dependency" on 'extensions'. 

I believe the issue is solved in the newly uploaded dev-utils 1.0-2. I
also solved the 'Win32 error 5', so the following should work:

   rpa clean
   rpa update
   rpa install dev-utils

Please report any other problem you might experience; it is hard to
get all details right, even when you've packaged quite some libs/apps
before...

-- 
Running Debian GNU/Linux Sid (unstable)
batsman dot geo at yahoo dot com