Re: [PATCH] user-manual: mention git gui citool (commit, amend)

From: Brett Schwarz <brett_schwarz@yahoo.com>
Date: Aug 6, 2007, 03:33 UTC
Message-ID: <608102.66070.qm@web38905.mail.mud.yahoo.com>

Show 33 quoted lines

> 
> ----- Original Message ----
> From: Shawn O. Pearce <spearce@spearce.org>
> To: J. Bruce Fields <bfields@fieldses.org>
> Cc: Steffen Prohaska <prohaska@zib.de>; git@vger.kernel.org
> Sent: Friday, August 3, 2007 11:20:10 PM
> Subject: Re: [PATCH] user-manual: mention git gui citool (commit, amend)
> 
> "J. Bruce Fields" <bfields@fieldses.org> wrote:
> > On Thu, Aug 02, 2007 at 11:04:59PM -0400, Shawn O. Pearce wrote:
> > > Online help?  In git-gui?  :-)
> > >
> > > We don't have an online help system yet.
> >
> > Fair enough.
> >
> > Though I'd like to keep the main body of the manual focused on the major
> > command line tools, I'd have no objection to a separate chapter (or
> > appendix?) devoted to git-gui; then you could point directly at that.
> > Would that make sense?
> 
> Yea, that makes a lot of sense.  git-gui isn't a full replacement
> for the command line anyway, so I would never suggest a wholesale
> rewrite of the user manual to slant the entire thing towards git-gui.
> Doing so would only point out the many shortcomings in git-gui.  :)
> 
> I haven't explored any in-Tk rendering options yet, been too busy
> with other projects.  Ideally I'd like to just render the asciidoc
> markup directly, but I don't think anyone has done an asciidoc
> viewer for Tk.  I can't imagine it would be that difficult to get
> some sort of parser working though...
> 
>

So, I took a stab at this earlier today, and it is fairly straight forward. I have something that is semi working (I haven't tested all the scenarios yet), but the rest is just really filling in the blanks.

Question though: I was going to have a index tree on a side panel...but do
 you want this thing to only bring up the git-gui.txt file, and show the table 
of contents, or do you want all *.txt files in the index? Or .... ?

Thanks,
    --brett

       
____________________________________________________________________________________
Be a better Globetrotter. Get better travel answers from someone who knows. Yahoo! Answers - Check it out.
http://answers.yahoo.com/dir/?link=list&sid=396545469