git 1.0.2 → 1.0.3

data/doc/classes/Git/Path.html

@@ -88,9 +88,10 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000119">new</a>&nbsp;&nbsp;
-      <a href="#M000120">readable?</a>&nbsp;&nbsp;
-      <a href="#M000121">writable?</a>&nbsp;&nbsp;
+      <a href="#M000145">new</a>&nbsp;&nbsp;
+      <a href="#M000146">readable?</a>&nbsp;&nbsp;
+      <a href="#M000148">to_s</a>&nbsp;&nbsp;
+      <a href="#M000147">writable?</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -125,19 +126,19 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000119" class="method-detail">
-        <a name="M000119"></a>
+      <div id="method-M000145" class="method-detail">
+        <a name="M000145"></a>
 
         <div class="method-heading">
-          <a href="#M000119" class="method-signature">
+          <a href="#M000145" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(path, check_path = true)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000119-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000119-source">
+            onclick="toggleCode('M000145-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000145-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/path.rb, line 6</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">check_path</span> = <span class="ruby-keyword kw">true</span>)
@@ -154,19 +155,19 @@
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000120" class="method-detail">
-        <a name="M000120"></a>
+      <div id="method-M000146" class="method-detail">
+        <a name="M000146"></a>
 
         <div class="method-heading">
-          <a href="#M000120" class="method-signature">
+          <a href="#M000146" class="method-signature">
           <span class="method-name">readable?</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000120-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000120-source">
+            onclick="toggleCode('M000146-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000146-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/path.rb, line 14</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">readable?</span>
@@ -177,19 +178,42 @@
         </div>
       </div>
 
-      <div id="method-M000121" class="method-detail">
-        <a name="M000121"></a>
+      <div id="method-M000148" class="method-detail">
+        <a name="M000148"></a>
 
         <div class="method-heading">
-          <a href="#M000121" class="method-signature">
+          <a href="#M000148" class="method-signature">
+          <span class="method-name">to_s</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000148-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000148-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/git/path.rb, line 22</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
+      <span class="ruby-ivar">@path</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000147" class="method-detail">
+        <a name="M000147"></a>
+
+        <div class="method-heading">
+          <a href="#M000147" class="method-signature">
           <span class="method-name">writable?</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000121-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000121-source">
+            onclick="toggleCode('M000147-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000147-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/path.rb, line 18</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">writable?</span>

data/doc/classes/Git/Remote.html

@@ -88,13 +88,13 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000153">branch</a>&nbsp;&nbsp;
-      <a href="#M000151">fetch</a>&nbsp;&nbsp;
-      <a href="#M000152">merge</a>&nbsp;&nbsp;
-      <a href="#M000149">new</a>&nbsp;&nbsp;
-      <a href="#M000150">remove</a>&nbsp;&nbsp;
-      <a href="#M000154">remove</a>&nbsp;&nbsp;
-      <a href="#M000155">to_s</a>&nbsp;&nbsp;
+      <a href="#M000202">branch</a>&nbsp;&nbsp;
+      <a href="#M000200">fetch</a>&nbsp;&nbsp;
+      <a href="#M000201">merge</a>&nbsp;&nbsp;
+      <a href="#M000198">new</a>&nbsp;&nbsp;
+      <a href="#M000199">remove</a>&nbsp;&nbsp;
+      <a href="#M000203">remove</a>&nbsp;&nbsp;
+      <a href="#M000204">to_s</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -139,19 +139,19 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000149" class="method-detail">
-        <a name="M000149"></a>
+      <div id="method-M000198" class="method-detail">
+        <a name="M000198"></a>
 
         <div class="method-heading">
-          <a href="#M000149" class="method-signature">
+          <a href="#M000198" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(base, name)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000149-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000149-source">
+            onclick="toggleCode('M000198-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000198-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 8</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">base</span>, <span class="ruby-identifier">name</span>)
@@ -168,19 +168,19 @@
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000153" class="method-detail">
-        <a name="M000153"></a>
+      <div id="method-M000202" class="method-detail">
+        <a name="M000202"></a>
 
         <div class="method-heading">
-          <a href="#M000153" class="method-signature">
+          <a href="#M000202" class="method-signature">
           <span class="method-name">branch</span><span class="method-args">(branch = 'master')</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000153-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000153-source">
+            onclick="toggleCode('M000202-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000202-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 29</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">branch</span>(<span class="ruby-identifier">branch</span> = <span class="ruby-value str">'master'</span>)
@@ -191,19 +191,19 @@
         </div>
       </div>
 
-      <div id="method-M000151" class="method-detail">
-        <a name="M000151"></a>
+      <div id="method-M000200" class="method-detail">
+        <a name="M000200"></a>
 
         <div class="method-heading">
-          <a href="#M000151" class="method-signature">
+          <a href="#M000200" class="method-signature">
           <span class="method-name">fetch</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000151-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000151-source">
+            onclick="toggleCode('M000200-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000200-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 20</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fetch</span>
@@ -214,11 +214,11 @@
         </div>
       </div>
 
-      <div id="method-M000152" class="method-detail">
-        <a name="M000152"></a>
+      <div id="method-M000201" class="method-detail">
+        <a name="M000201"></a>
 
         <div class="method-heading">
-          <a href="#M000152" class="method-signature">
+          <a href="#M000201" class="method-signature">
           <span class="method-name">merge</span><span class="method-args">(branch = 'master')</span>
           </a>
         </div>
@@ -228,8 +228,8 @@
 merge this remote locally
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000152-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000152-source">
+            onclick="toggleCode('M000201-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000201-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 25</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge</span>(<span class="ruby-identifier">branch</span> = <span class="ruby-value str">'master'</span>)
@@ -240,19 +240,19 @@ merge this remote locally
         </div>
       </div>
 
-      <div id="method-M000150" class="method-detail">
-        <a name="M000150"></a>
+      <div id="method-M000199" class="method-detail">
+        <a name="M000199"></a>
 
         <div class="method-heading">
-          <a href="#M000150" class="method-signature">
+          <a href="#M000199" class="method-signature">
           <span class="method-name">remove</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000150-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000150-source">
+            onclick="toggleCode('M000199-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000199-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 16</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove</span>
@@ -263,19 +263,19 @@ merge this remote locally
         </div>
       </div>
 
-      <div id="method-M000154" class="method-detail">
-        <a name="M000154"></a>
+      <div id="method-M000203" class="method-detail">
+        <a name="M000203"></a>
 
         <div class="method-heading">
-          <a href="#M000154" class="method-signature">
+          <a href="#M000203" class="method-signature">
           <span class="method-name">remove</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000154-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000154-source">
+            onclick="toggleCode('M000203-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000203-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 33</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove</span>
@@ -286,19 +286,19 @@ merge this remote locally
         </div>
       </div>
 
-      <div id="method-M000155" class="method-detail">
-        <a name="M000155"></a>
+      <div id="method-M000204" class="method-detail">
+        <a name="M000204"></a>
 
         <div class="method-heading">
-          <a href="#M000155" class="method-signature">
+          <a href="#M000204" class="method-signature">
           <span class="method-name">to_s</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000155-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000155-source">
+            onclick="toggleCode('M000204-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000204-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git/remote.rb, line 37</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>

data/doc/created.rid

@@ -1 +1 @@
-Mon Nov 12 11:08:01 PST 2007
+Fri Nov 16 12:12:50 PST 2007

data/doc/files/README.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Mon Nov 12 11:07:58 PST 2007</td>
+      <td>Fri Nov 16 11:43:31 PST 2007</td>
     </tr>
     </table>
   </div>
@@ -95,6 +95,55 @@ eventually I&#8217;ll replace that with either C bindings to libgit or
 libgit-thin, or I&#8217;ll write pure ruby handlers for at least some of
 the <a href="../classes/Git.html">Git</a> stuff.
 </p>
+<h1>Major Objects</h1>
+<p>
+<a href="../classes/Git/Base.html">Git::Base</a> - this is the object
+returned from a <a href="../classes/Git.html#M000002">Git.open</a> or <a
+href="../classes/Git.html#M000004">Git.clone</a>. Most major actions are
+called from this object.
+</p>
+<p>
+<a href="../classes/Git/Object.html">Git::Object</a> - this is the base
+object for your tree, blob and commit objects, returned from @git.gtree or
+@git.object calls. the Git::AbstractObject will have most of the calls in
+common for all those objects.
+</p>
+<p>
+<a href="../classes/Git/Diff.html">Git::Diff</a> - returns from a @git.diff
+command. It is an Enumerable that returns <a
+href="../classes/Git/Diff.html">Git::Diff</a>:DiffFile objects from which
+you can get per file patches and insertion/deletion statistics. You can
+also get total statistics from the <a
+href="../classes/Git/Diff.html">Git::Diff</a> object directly.
+</p>
+<p>
+<a href="../classes/Git/Status.html">Git::Status</a> - returns from a
+@git.status command. It is an Enumerable that returns <a
+href="../classes/Git.html">Git</a>:Status::StatusFile objects for each
+object in git, which includes files in the working directory, in the index
+and in the repository. Similar to running &#8216;git status&#8217; on the
+command line to determine untracked and changed files.
+</p>
+<p>
+<a href="../classes/Git/Branches.html">Git::Branches</a> - Enumerable
+object that holds <a href="../classes/Git/Branch.html">Git::Branch</a>
+objects. You can call .local or .remote on it to filter to just your local
+or remote branches.
+</p>
+<p>
+<a href="../classes/Git/Remote.html">Git::Remote</a> - A reference to a
+remote repository that is tracked by this repository.
+</p>
+<p>
+<a href="../classes/Git/Log.html">Git::Log</a> - An Enumerable object that
+references all the <a
+href="../classes/Git/Object/Commit.html">Git::Object::Commit</a> objects
+that encompass your log query, which can be constructed through methods on
+the <a href="../classes/Git/Log.html">Git::Log</a> object, like:
+</p>
+<pre>
+ @git.log(20).object(&quot;HEAD^&quot;).since(&quot;2 weeks ago&quot;).between('v2.6', 'v2.7').each { |commit| [block] }
+</pre>
 <h1>Examples</h1>
 <p>
 Here are a bunch of examples of how to use the Ruby/<a
@@ -136,6 +185,22 @@ Here are the operations that need read permission only.
    g.gblob(treeish)
    g.gcommit(treeish)
 
+   commit = g.gcommit('1cc8667014381')
+    commit.gtree
+    commit.parent.sha
+    commit.parents.size
+    commit.author.name
+    commit.author.email
+    commit.author.date.strftime(&quot;%m-%d-%y&quot;)
+    commit.committer.name
+    commit.date.strftime(&quot;%m-%d-%y&quot;)
+    commit.message
+
+  tree = g.gtree(&quot;HEAD^{tree}&quot;)
+    tree.blobs
+    tree.subtrees
+    tree.children # blobs and subtrees
+
    g.revparse('v2.5:Makefile')
 
    g.branches # returns Git::Branch objects
@@ -240,6 +305,46 @@ And here are the operations that will need to write to your git repository.
    g.push
    g.push(g.remote('name'))
 </pre>
+<p>
+Some examples of more low-level index and tree operations
+</p>
+<pre>
+   g.with_temp_index do
+
+     g.read_tree(tree3) # calls self.index.read_tree
+     g.read_tree(tree1, :prefix =&gt; 'hi/')
+
+     c = g.commit_tree('message')
+     # or #
+     t = g.write_tree
+     c = g.commit_tree(t, :message =&gt; 'message', :parents =&gt; [sha1, sha2])
+
+     g.branch('branch_name').update_ref(c)
+     g.update_ref(branch, c)
+
+     g.with_temp_working do # new blank working directory
+       g.checkout
+       g.checkout(another_index)
+       g.commit # commits to temp_index
+     end
+   end
+
+   g.set_index('/path/to/index')
+
+   g.with_index(path) do
+     # calls set_index, then switches back after
+   end
+
+   g.with_working(dir) do
+   # calls set_working, then switches back after
+   end
+
+   g.with_temp_working(dir) do
+     g.checkout_index(:prefix =&gt; dir, :path_limiter =&gt; path)
+     # do file work
+     g.commit # commits to index
+   end
+</pre>
 
     </div>
 

data/doc/files/lib/git/author_rb.html

@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>File: author.rb</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+  <div id="fileHeader">
+    <h1>author.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/git/author.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Nov 12 17:21:28 PST 2007</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+
+
+   </div>
+
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>