Bug #31204 for CPANPLUS-Dist-Deb: Documentation deficiencies

Tue Dec 04 12:55:07 2007 abuse [...] cabal.org.uk - Ticket created

Subject:	Documentation deficiencies
Date:	Tue, 4 Dec 2007 17:54:16 +0000
To:	bug-CPANPLUS-Dist-Deb [...] rt.cpan.org
From:	Peter Corlett <abuse [...] cabal.org.uk>

Hi, There seem to be a number of deficiencies in the documentation for CPANPLUS::Dist::Deb 0.10 that made it harder than it needed to be for me to work out how to use it to create packages. The example cpan2dist command line of "cpan2dist -f CPANPLUS::Dist::Deb Some::Module" does not work because cpan2dist (as of CPANPLUS 0.82) now has multiple options starting with -f and it is ambiguous. It would be useful if the options to $dist->prepare() were better-documented as it's not obvious what I might like to frob to customise package generation. Some more examples of how to use cpan2dist would be nice too. I eventually figured out that I wanted this, for example: yes '' | cpan2dist --format CPANPLUS::Dist::Deb Annoying::Module \ --dist-opts prefix='' --dist-opts distdir=$(pwd)

Fri Jun 12 17:06:42 2009 hdp [...] cpan.org - Correspondence added

On Tue Dec 04 12:55:07 2007, abuse@cabal.org.uk wrote: Show quoted text

> The example cpan2dist command line of "cpan2dist -f CPANPLUS::Dist::Deb > Some::Module" does not work because cpan2dist (as of CPANPLUS 0.82)

now has Show quoted text

> multiple options starting with -f and it is ambiguous.

This is fixed now (0.12). Show quoted text

> It would be useful if the options to $dist->prepare() were

better-documented Show quoted text

> as it's not obvious what I might like to frob to customise package > generation. > > Some more examples of how to use cpan2dist would be nice too. I eventually > figured out that I wanted this, for example: > > yes '' | cpan2dist --format CPANPLUS::Dist::Deb Annoying::Module \ > --dist-opts prefix='' --dist-opts distdir=$(pwd)

Patches welcome. It's hard to come up with this kind of stuff when you've read the source and know how it works -- it all seems pretty clear already.

Fri Jun 12 17:06:43 2009 The RT System itself - Status changed from 'new' to 'open'