From c6698ec90629bafae3929d2bec11885c14c0382b Mon Sep 17 00:00:00 2001
From: Alex Reisner <alex@alexreisner.com>
Date: Sat, 29 Sep 2012 14:43:25 -0400
Subject: [PATCH] Rename methods and add descriptive comments.

---
 lib/geocoder/stores/active_record.rb | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/lib/geocoder/stores/active_record.rb b/lib/geocoder/stores/active_record.rb
index 84498be1..4d4acfd2 100644
--- a/lib/geocoder/stores/active_record.rb
+++ b/lib/geocoder/stores/active_record.rb
@@ -73,7 +73,7 @@ module Geocoder::Store
       def distance_from_sql(location, *args)
         latitude, longitude = Geocoder::Calculations.extract_coordinates(location)
         if Geocoder::Calculations.coordinates_present?(latitude, longitude)
-          distance_from_sql_options(latitude, longitude, *args)
+          distance_sql(latitude, longitude, *args)
         end
       end
 
@@ -99,8 +99,8 @@ module Geocoder::Store
       #
       def near_scope_options(latitude, longitude, radius = 20, options = {})
         options[:units] ||= (geocoder_options[:units] || Geocoder::Configuration.units)
-        bearing = bearing_from_sql_options(latitude, longitude, options)
-        distance = distance_from_sql_options(latitude, longitude, options)
+        bearing = bearing_sql(latitude, longitude, options)
+        distance = distance_sql(latitude, longitude, options)
         if using_sqlite?
           b = Geocoder::Calculations.bounding_box([latitude, longitude], radius, options)
           args = b + [
@@ -118,7 +118,11 @@ module Geocoder::Store
         }
       end
 
-      def distance_from_sql_options(latitude, longitude, options = {})
+      ##
+      # SQL for calculating distance based on the current database's
+      # capabilities (trig functions?).
+      #
+      def distance_sql(latitude, longitude, options = {})
         method_prefix = using_sqlite? ? "approx" : "full"
         Geocoder::Sql.send(
           method_prefix + "_distance",
@@ -129,7 +133,11 @@ module Geocoder::Store
         )
       end
 
-      def bearing_from_sql_options(latitude, longitude, options = {})
+      ##
+      # SQL for calculating bearing based on the current database's
+      # capabilities (trig functions?).
+      #
+      def bearing_sql(latitude, longitude, options = {})
         if !options.include?(:bearing)
           options[:bearing] = Geocoder::Configuration.distances
         end
-- 
GitLab