From: David Greaves Date: Tue, 19 Apr 2005 19:04:16 GMT Subject: Re: [PATCH] Add help details to git help command. (This time with Perl) Message-ID: <42655630.80207@dgreaves.com> In-Reply-To: <20050419175051.GK12757@pasky.ji.cz> Petr Baudis wrote: > Dear diary, on Tue, Apr 19, 2005 at 07:35:15PM CEST, I got a letter > where Steven Cole told me that... > I've been working on git.pl and getting help working nicely things to try: git.pl help git.pl add git.pl add --help git.pl add --man git.pl help add The main objectives: * get a reasonable perl code base in git.pl * provide some way to document WTF is going on :) * keep the docs near the developer * allow variations in verbosity * modularise * don't use modules outside the base perl set * allow a gentle migration (so start by calling the .sh's) I don't like the pod2usage calling convention but I use them for now. I don't love the 'require gitadd.pl' but it's a gradual start... Cogito.pm seems to be a good place for the library stuff. git.pl passes everything to scripts except gitadd.pl works when called from somewhere other than the git dir I don't feel 100% about the fixup ports gitadd.pl I thought I'd ask for comments before I spent too much time on this... David --