threads / discuss / 1575

patchSubject: [PATCH] Updates to glossary

Subject: Subject: [PATCH] Updates to glossary

## tl;dr

5 messages between Aug 18, 2005 and Aug 18, 2005. Diffs are folded; open one to read it.

replies: 4people: 3as markdown or json

Johannes Schindelin· Aug 18, 2005, 19:17 UTC · lore

Changes to the descriptions of tree and tag objects, a link for ent, and descriptions for rewind, rebase and core git were added.

Signed-off-by: Johannes Schindelin <Johannes.Schindelin@gmx.de>
---
 Documentation/glossary.txt |   28 ++++++++++++++++++++++------
 1 files changed, 22 insertions(+), 6 deletions(-)
83d69aaac371160ea0da0a6de6c9898c8f6915b2
Show changes to Documentation/glossary.txt +22 −6
diff --git a/Documentation/glossary.txt b/Documentation/glossary.txt
--- a/Documentation/glossary.txt
+++ b/Documentation/glossary.txt
@@ -26,9 +26,9 @@ blob object::
 	Untyped object, e.g. the contents of a file.
 
 tree object::
-	An object containing a list of blob and/or tree objects.
-	(A tree usually corresponds to a directory without
-	subdirectories).
+	An object containing a list of file names and modes along with refs
+	to the associated blob and/or tree objects. A tree object is
+	equivalent to a directory.
 
 tree::
 	Either a working tree, or a tree object together with the
@@ -118,11 +118,14 @@ tree-ish::
 	tag object pointing to a tag or commit or tree object.
 
 ent::
-	Favorite synonym to "tree-ish" by some total geeks.
+	Favorite synonym to "tree-ish" by some total geeks. See
+	http://en.wikipedia.org/wiki/Ent_(Middle-earth) for an in-depth
+	explanation.
 
 tag object::
-	An object containing a ref pointing to another object. It can
-	contain a (PGP) signature, in which case it is called "signed
+	An object containing a ref pointing to another object, which can
+	contain a message just like a commit object. It can also
+	contain a (PGP) signature, in which case it is called a "signed
 	tag object".
 
 tag::
@@ -143,6 +146,15 @@ resolve::
 	The action of fixing up manually what a failed automatic merge
 	left behind.
 
+rewind::
+	To throw away part of the development, i.e. to assign the head to
+	an earlier revision.
+
+rebase::
+	To clean a branch by starting from the head of the main line of
+	development ("master"), and reapply the (possibly cherry-picked)
+	changes from that branch.
+
 repository::
 	A collection of refs together with an object database containing
 	all objects, which are reachable from the refs, possibly accompanied
@@ -196,6 +208,10 @@ pack index::
 	The list of identifiers, and other information, of the objects in a
 	pack, to assist in efficiently accessing the contents of a pack. 
 
+core git::
+	Fundamental data structures and utilities of git. Exposes only
+	limited source code management tools.
+
 plumbing::
 	Cute name for core git.
 
Matthias Urlichs· Aug 18, 2005, 21:15 UTC · re: Johannes Schindelin · lore

Re: Subject: [PATCH] Updates to glossary

Hi, Johannes Schindelin wrote:
> Subject: Subject: [PATCH] Updates to glossary
Something is stuttering here -- one "Subject:" is quite sufficient.
-- 
Matthias Urlichs   |   {M:U} IT Design @ m-u-it.de   |  smurf@smurf.noris.de
Disclaimer: The quote was selected randomly. Really. | http://smurf.noris.de
 - -
Harris's Lament:
	All the good ones are taken.
Johannes Schindelin· Aug 18, 2005, 21:35 UTC · re: Matthias Urlichs · lore

Re: Subject: [PATCH] Updates to glossary

Hi,
On Thu, 18 Aug 2005, Matthias Urlichs wrote:
Show 5 quoted lines
> Hi, Johannes Schindelin wrote:
> 
> > Subject: Subject: [PATCH] Updates to glossary
> 
> Something is stuttering here -- one "Subject:" is quite sufficient.
Subject! Subject! Subject! ;-)

My bad. Dscho

Daniel Barkalow· Aug 18, 2005, 21:17 UTC · re: Johannes Schindelin · lore

Re: Subject: [PATCH] Updates to glossary

On Thu, 18 Aug 2005, Johannes Schindelin wrote:
Show 7 quoted lines
>  tree object::
> -	An object containing a list of blob and/or tree objects.
> -	(A tree usually corresponds to a directory without
> -	subdirectories).
> +	An object containing a list of file names and modes along with refs
> +	to the associated blob and/or tree objects. A tree object is
> +	equivalent to a directory.

Actually, it contains object names, not refs, to be completely precise. (refs would imply an additional indirection.)

	-Daniel
*This .sig left intentionally blank*
Johannes Schindelin· Aug 18, 2005, 21:36 UTC · re: Daniel Barkalow · lore

Re: Subject: [PATCH] Updates to glossary

Hi,
On Thu, 18 Aug 2005, Daniel Barkalow wrote:
Show 12 quoted lines
> On Thu, 18 Aug 2005, Johannes Schindelin wrote:
> 
> >  tree object::
> > -	An object containing a list of blob and/or tree objects.
> > -	(A tree usually corresponds to a directory without
> > -	subdirectories).
> > +	An object containing a list of file names and modes along with refs
> > +	to the associated blob and/or tree objects. A tree object is
> > +	equivalent to a directory.
> 
> Actually, it contains object names, not refs, to be completely precise.
> (refs would imply an additional indirection.)

Agree. Dscho

← back to recent threads