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

4 messages from 2006-03-06 to 2006-03-06. Participants: Jonas Fonseca, Junio C Hamano, Ryan Anderson.
Thread: https://gitlist.dev/t/3580

## Jonas Fonseca, 2006-03-06 05:24

Subject: [PATCH] Add git-annotate(1) and git-blame(1)
Message-ID: <20060306052444.GC6487@diku.dk>
URL: https://gitlist.dev/e/20060306052444.GC6487%40diku.dk

```
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
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, 2006-03-06 05:35

Subject: Re: [PATCH] Add git-annotate(1) and git-blame(1)
Message-ID: <7v3bhwcezy.fsf@assigned-by-dhcp.cox.net>
URL: https://gitlist.dev/e/7v3bhwcezy.fsf%40assigned-by-dhcp.cox.net
In-Reply-To: <20060306052444.GC6487@diku.dk>

```
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, 2006-03-06 06:30

Subject: Re: [PATCH] Add git-annotate(1) and git-blame(1)
Message-ID: <440BD716.4010400@michonline.com>
URL: https://gitlist.dev/e/440BD716.4010400%40michonline.com
In-Reply-To: <7v3bhwcezy.fsf@assigned-by-dhcp.cox.net>

```
Junio C Hamano wrote:

>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, 2006-03-06 11:40

Subject: Re: [PATCH] Add git-annotate(1) and git-blame(1)
Message-ID: <20060306114007.GA12576@diku.dk>
URL: https://gitlist.dev/e/20060306114007.GA12576%40diku.dk
In-Reply-To: <7v3bhwcezy.fsf@assigned-by-dhcp.cox.net>

```
Junio C Hamano <junkio@cox.net> wrote Sun, Mar 05, 2006:
> 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

```