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

----- Original Message ----
From: Shawn O. Pearce <redacted>
To: J. Bruce Fields <redacted>
Cc: Steffen Prohaska <redacted>; 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" [off-list ref] wrote:

quoted

On Thu, Aug 02, 2007 at 11:04:59PM -0400, Shawn O. Pearce wrote:

quoted

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