query.rb in gcloud-0.1.1

- old
+ new

@@ -1,5 +1,6 @@
+#--
 # Copyright 2014 Google Inc. All rights reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
@@ -17,12 +18,14 @@
 require "gcloud/datastore/proto"
 
 module Gcloud
   module Datastore
     ##
-    # Query represents a query to be made to the Datastore.
+    # = Query
     #
+    # Represents the search criteria against a Datastore.
+    #
     #   query = Gcloud::Datastore::Query.new
     #   query.kind("Task").
     #     where("completed", "=", true)
     #
     #   entities = dataset.run query
@@ -176,14 +179,11 @@
         @_query.group_by ||= []
         @_query.group_by += Proto.new_property_references(*names)
         self
       end
 
-      # rubocop:disable Style/TrivialAccessors
       def to_proto #:nodoc:
-        # Disabled rubocop because this implementation will most likely change.
         @_query
       end
-      # rubocop:enable Style/TrivialAccessors
     end
   end
 end