[PATCH] Add git-annotate(1) and git-blame(1)

Jonas Fonseca· Mar 6, 2006, 05:24 UTC · lore

Signed-off-by: Jonas Fonseca <fonseca@diku.dk>

---

 Documentation/git-annotate.txt |   44 ++++++++++++++++++++++++++++++++++++++++
 Documentation/git-blame.txt    |   31 ++++++++++++++++++++++++++++
 2 files changed, 75 insertions(+), 0 deletions(-)
 create mode 100644 Documentation/git-annotate.txt
 create mode 100644 Documentation/git-blame.txt

c280414507b072689afd3061a2d43527ebab292e

Show changes to 2 files +75 −0

Documentation/git-annotate.txt, Documentation/git-blame.txt

diff --git a/Documentation/git-annotate.txt b/Documentation/git-annotate.txt
new file mode 100644
index 0000000..1cfc3e3
--- /dev/null
+++ b/Documentation/git-annotate.txt
@@ -0,0 +1,44 @@
+git-annotate(1)
+===============
+
+NAME
+----
+git-annotate - annotate file lines with commit info
+
+SYNOPSIS
+--------
+git-annotate [options] file [revision]
+
+DESCRIPTION
+-----------
+Annotates each line in the given file with information from the commit
+which introduced the line. Optionally annotate from a given revision.
+
+OPTIONS
+-------
+-l, --long::
+	Show long rev (Defaults off).
+
+-t, --time::
+	Show raw timestamp (Defaults off).
+
+-r, --rename::
+	Follow renames (Defaults on).
+
+-S, --rev-file <revs-file>::
+	Use revs from revs-file instead of calling git-rev-list.
+
+-h, --help::
+	Show help message.
+
+SEE ALSO
+--------
+gitlink:git-blame[1]
+
+AUTHOR
+------
+Written by Ryan Anderson <ryan@michonline.com>.
+
+GIT
+---
+Part of the gitlink:git[7] suite
diff --git a/Documentation/git-blame.txt b/Documentation/git-blame.txt
new file mode 100644
index 0000000..bdf28d9
--- /dev/null
+++ b/Documentation/git-blame.txt
@@ -0,0 +1,31 @@
+git-blame(1)
+============
+
+NAME
+----
+git-blame - blame file lines on commits
+
+SYNOPSIS
+--------
+git-blame revision file
+
+DESCRIPTION
+-----------
+Annotates each line in the given file with information from the commit
+which introduced the line. Start annotation from the given revision.
+
+OPTIONS
+-------
+No options.
+
+SEE ALSO
+--------
+gitlink:git-annotate[1]
+
+AUTHOR
+------
+Written by Fredrik Kuivinen <freku045@student.liu.se>.
+
+GIT
+---
+Part of the gitlink:git[7] suite

-- 
1.2.4.g9201

-- 
Jonas Fonseca

Junio C Hamano· Mar 6, 2006, 05:35 UTC · re: Jonas Fonseca · lore

Re: [PATCH] Add git-annotate(1) and git-blame(1)

Jonas Fonseca <fonseca@diku.dk> writes:

> Signed-off-by: Jonas Fonseca <fonseca@diku.dk>

Wonderful, but I was hoping the "deathmatch" would leave only one that needs to be documented and we could wait documenting until then ;-).

Ryan Anderson· Mar 6, 2006, 06:30 UTC · re: Junio C Hamano · lore

Re: [PATCH] Add git-annotate(1) and git-blame(1)

Junio C Hamano wrote:

Show 13 quoted lines

>Jonas Fonseca <fonseca@diku.dk> writes:
>
>  
>
>>Signed-off-by: Jonas Fonseca <fonseca@diku.dk>
>>    
>>
>
>Wonderful, but I was hoping the "deathmatch" would leave only
>one that needs to be documented and we could wait documenting
>until then ;-).
>  
>

heh. If I'm not mistaken, blame is still lacking rename following (at least, in master), and annotate is still misrepresenting things on merges, so we've got a bit of a ways to go still.

-- 
Ryan Anderson
  sometimes Pug Majere

Jonas Fonseca· Mar 6, 2006, 11:40 UTC · re: Junio C Hamano · lore

Re: [PATCH] Add git-annotate(1) and git-blame(1)

Junio C Hamano <junkio@cox.net> wrote Sun, Mar 05, 2006:

Show 7 quoted lines

> Jonas Fonseca <fonseca@diku.dk> writes:
> 
> > Signed-off-by: Jonas Fonseca <fonseca@diku.dk>
> 
> Wonderful, but I was hoping the "deathmatch" would leave only
> one that needs to be documented and we could wait documenting
> until then ;-).

Why not let them compete on providing the best documentation as well? ;) But ok, I can understand your point.

-- 
Jonas Fonseca

patchAdd git-annotate(1) and git-blame(1)