Skip to contentSkip to conversation

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

PATCH In review Jonas Fonseca 3 participants 4 messages Jun 15, 2016 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Add git-annotate(1) and git-blame(1)

---

 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

Documentation/git-annotate.txt new file +44 -0
new file mode 100644
index 0000000..1cfc3e3
@@ -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 <[email protected]>.
+
+GIT
+---
+Part of the gitlink:git[7] suite
Documentation/git-blame.txt new file +31 -0
new file mode 100644
index 0000000..bdf28d9
@@ -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 <[email protected]>.
+
+GIT
+---
+Part of the gitlink:git[7] suite
Signature · 4 lines
1.2.4.g9201

-- 
Jonas Fonseca
#2 lore raw

Junio C Hamano <[email protected]> wrote Sun, Mar 05, 2006:

Quoted 7 lines
Quoted 1 line · Jonas Fonseca

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.

Signature · 1 line
Jonas Fonseca
#3 lore raw
In reply to Junio C Hamano
Quoted 4 lines · Junio C Hamano

Jonas Fonseca <[email protected]> writes:

Quoted 9 lines
Quoted 3 lines

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.

Signature · 2 lines
Ryan Anderson
  sometimes Pug Majere