Re: [PATCH] Add help details to git help command. (This time with Perl)

From: David Greaves <david@dgreaves.com>
Date: Apr 19, 2005, 19:04 UTC
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 <elenstev@mesatop.com> 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