2009/9/4 Burak Gürsoy <[email protected]>: >> -----Original Message----- >> From: Shlomi Fish [mailto:[email protected]] >> Sent: Friday, September 04, 2009 8:25 AM >> To: [email protected] >> Subject: What Would you like to see in a CPAN Distro Manager? > > I think that I don't want one :) (I didn't say don't write it) > >> Hi all! >> >> I posted an entry to my weblog about "What would you like to see in a >> CPAN >> distribution manager"? >> >> http://community.livejournal.com/shlomif_tech/32348.html > > [2. POD at the end] > > I was doing that before PBP, it's beter to leave the code alone and send the > docs after end IMHO. Since I know that Pod is after that I can get it without > parsing with Pod::Simple or I can just do [SHIFT]+[PgDown] to get all of it. > Or maybe I just want to add something before "=cut" (which I do when building > distros) and I stil don't need to parse Pod to do that. Inline Pod is evil. I > hate it everytime I see it. Makes it hard ro read code too. But again, just > IMHO & $0.02. I think the problem with doing that, for me, is that I'd forget to update stuff and then my docs would become even more out of sync with my code, which is a pretty bad thing. It's bad enough people don't update comments that are right next to the code in question; when it comes to docs... I imagine it'd get even worse.
Redoing stuff for the purposes of making things easier for a computer seems backwards to me. After all, computers are supposed to do work for /us/ -- they're faster, more consistent, etc. So leave programmers to do what programmers do, and let the computers worry about extracting inline POD. :-) > > [5 Support for more software licences] > > I think leaving this to Software::License is a better choice. > > [7 Good integration with the underlying version control system] > > I don't usually add everything in the repo to MANIFEST. So, unwanted stuff > does not goto CPAN until I want them to. I also don't add revision comments > automatically to the Changes file since it'll include a lot of unnecessary > noise. > >> I cover there the introduction of Dist-Man (short for Dist-Manager), >> some >> ideas I have for its future, and request further ideas and insights. >> >> I should note that Dist-Man takes a different approach from Dist-Zilla. >> While >> Dist-Zilla removes redundant code from the ultimate sources and inserts >> it >> automatically before the release (which may skew the line numbers), >> Dist-Man >> will manipulate actual lib/**/*.pm, etc. sources in-place, which will >> allow >> them to be modified and corrected. >> >> Have a nice weekend. >> >> Regards, >> >> Shlomi Fish >> >> -- >> ----------------------------------------------------------------- >> Shlomi Fish http://www.shlomifish.org/ >> Parody on "The Fountainhead" - http://shlom.in/towtf >> >> Chuck Norris read the entire English Wikipedia in 24 hours. Twice. > >
