<?xml version="1.0" encoding="UTF-8"?>
<commit>
  <added type="array"/>
  <modified type="array">
    <modified>
      <diff>@@ -1,6 +1,6 @@
-
 require 'ambition'
 
+# stub out rails stuff enough so that ultrasphinx will be happy
 RAILS_ROOT = &quot;./&quot; unless defined? RAILS_ROOT 
 RAILS_ENV = &quot;development&quot; unless defined? RAILS_ENV
 
@@ -12,21 +12,10 @@ module Ambition::Adapters
   end
 end
 
-%w(base page query select sort slice).each do |base|
-  require &quot;ambition/adapters/ambitious_sphinx/#{base}&quot;
+%w(base page query select sort slice).each do |f|
+  require &quot;ambition/adapters/ambitious_sphinx/#{f}&quot;
 end
 
-##
-# This is where you inject Ambition into your target.
-#
-# Use `extend' if you are injecting a class, `include' if you are
-# injecting instances of that class.
-#
-# You must also set the `ambition_adapter' class variable on your target
-# class, regardless of whether you are injecting instances or the class itself.
-#
-# You probably want something like this:
-#
 ActiveRecord::Base.extend Ambition::API
 ActiveRecord::Base.ambition_adapter = Ambition::Adapters::AmbitiousSphinx
 </diff>
      <filename>lib/ambition/adapters/ambitious_sphinx.rb</filename>
    </modified>
    <modified>
      <diff>@@ -1,17 +1,23 @@
 module Ambition::Adapters::AmbitiousSphinx
+  # Helper for the other
   class Base
+    # Does the string have an Ultrasphinx field?
     def has_field? str
       str =~ /:/
     end
     
+    # Does the string have any Ultrasphinx operators?
     def has_operator? str
       str =~ /(AND|OR|NOT)/
     end
     
+    # Should this string be quotified? It needs to happen if the string doesn't
+    # have an operator or a field.
     def needs_quoting? str
       not (has_operator?(str) or has_field?(str))
     end
     
+    # Quote the string if it needs it.
     def quotify str
       if needs_quoting?(str)
         %Q(&quot;#{str}&quot;)</diff>
      <filename>lib/ambition/adapters/ambitious_sphinx/base.rb</filename>
    </modified>
    <modified>
      <diff>@@ -6,7 +6,7 @@ module Ambition::Adapters::AmbitiousSphinx
       Ultrasphinx::Search.new(to_hash).results
     end
 
-    # Some magic to add pagination. this gets called if you were to do:
+    # Some magic to add pagination. This gets called if you were to do:
     #
     #   Meal.select {'bacon'}.page(5)
     #
@@ -18,7 +18,7 @@ module Ambition::Adapters::AmbitiousSphinx
       context
     end
 
-    # Not entirely sure what this is for, so unimplemented so far.
+    # Not entirely sure when this is used, so unimplemented so far.
     def size
       raise &quot;Not implemented yet.&quot;
     end</diff>
      <filename>lib/ambition/adapters/ambitious_sphinx/query.rb</filename>
    </modified>
    <modified>
      <diff>@@ -1,13 +1,7 @@
 module Ambition::Adapters::AmbitiousSphinx
+  # Slice would normally handle slicing, but we don't support it yet.
   class Slice &lt; Base
-    # &gt;&gt; User.first(5)
-    # =&gt; #slice(0, 5)
-    #
-    # &gt;&gt; User.first
-    # =&gt; #slice(0, 1)
-    #
-    # &gt;&gt; User[10, 20]
-    # =&gt; #slice(10, 20)
+    # Not implemented
     def slice(start, length)
       raise &quot;Not implemented.&quot;
     end</diff>
      <filename>lib/ambition/adapters/ambitious_sphinx/slice.rb</filename>
    </modified>
    <modified>
      <diff>@@ -1,37 +1,32 @@
 module Ambition::Adapters::AmbitiousSphinx
+  # +Sort+ would normally handle sorting, but we don't support it yet.
   class Sort &lt; Base
-    # &gt;&gt; sort_by { |u| u.age }
-    # =&gt; #sort_by(:age)
+    # Not implemented
     def sort_by(method)
       raise &quot;Not implemented.&quot;
     end
 
-    # &gt;&gt; sort_by { |u| -u.age }
-    # =&gt; #reverse_sort_by(:age)
+    # Not implemented
     def reverse_sort_by(method)
       raise &quot;Not implemented.&quot;
     end
 
-    # &gt;&gt; sort_by { |u| u.profile.name }
-    # =&gt; #chained_sort_by(:profile, :name)
+    # Not implemented
     def chained_sort_by(receiver, method)
       raise &quot;Not implemented.&quot;
     end
 
-    # &gt;&gt; sort_by { |u| -u.profile.name }
-    # =&gt; #chained_reverse_sort_by(:profile, :name)
+    # Not implemented
     def chained_reverse_sort_by(receiver, method)
       raise &quot;Not implemented.&quot;
     end
 
-    # &gt;&gt; sort_by(&amp;:name)
-    # =&gt; #to_proc(:name)
+    # Not implemented
     def to_proc(symbol)
       raise &quot;Not implemented.&quot;
     end
 
-    # &gt;&gt; sort_by { rand }
-    # =&gt; #rand
+    # Not implemented
     def rand
       raise &quot;Not implemented.&quot;
     end</diff>
      <filename>lib/ambition/adapters/ambitious_sphinx/sort.rb</filename>
    </modified>
  </modified>
  <removed type="array"/>
  <parents type="array">
    <parent>
      <id>c1588c2424dbf9b47f16ef40bde58d34ce0ac6a6</id>
    </parent>
  </parents>
  <author>
    <name>Josh Nichols</name>
    <email>josh@technicalpickles.com</email>
  </author>
  <url>http://github.com/technicalpickles/ambitious-sphinx/commit/753416af4550d0bc834f7891526e128d16c116d6</url>
  <id>753416af4550d0bc834f7891526e128d16c116d6</id>
  <committed-date>2008-02-29T16:19:36-08:00</committed-date>
  <authored-date>2008-02-29T16:19:36-08:00</authored-date>
  <message>More rdoc improvements</message>
  <tree>04f695b5f7a0f280f6006af27dc68f599e0de575</tree>
  <committer>
    <name>Josh Nichols</name>
    <email>josh@technicalpickles.com</email>
  </committer>
</commit>
