Comments on comments on comments

lib/dialects/abstract/query-generator.js

@@ -462,6 +462,8 @@ module.exports = (function() {
     */
 
     selectQuery: function(tableName, options, factory) {
+      // Enter and change at your own peril -- Mick Hansen
+
       options       = options || {}
 
       var table               = null
@@ -583,15 +585,21 @@ module.exports = (function() {
               mainAttributes = mainAttributes.concat(throughAttributes)
             }
 
+            // Filter statement for left side of through
+            // Used by both join and subquery where
             sourceJoinOn = self.quoteIdentifier(tableSource) + "." + self.quoteIdentifier(attrSource) + " = "
               sourceJoinOn += self.quoteIdentifier(throughAs) + "." + self.quoteIdentifier(identSource)
 
+            // Filter statement for right side of through
+            // Used by both join and subquery where
             targetJoinOn = self.quoteIdentifier(tableTarget) + "." + self.quoteIdentifier(attrTarget) + " = "
               targetJoinOn += self.quoteIdentifier(throughAs) + "." + self.quoteIdentifier(identTarget)
 
+            // Generate join SQL for left side of through
             joinQueryItem += joinType + self.quoteIdentifier(throughTable) + " AS " + self.quoteIdentifier(throughAs) + " ON "
               joinQueryItem += sourceJoinOn
 
+            // Generate join SQL for right side of through
             joinQueryItem += joinType + self.quoteIdentifier(table) + " AS " + self.quoteIdentifier(as) + " ON "
               joinQueryItem += targetJoinOn
 
@@ -621,9 +629,12 @@ module.exports = (function() {
               , attrRight       = association.identifier
               , where
 
+            // Filter statement
+            // Used by both join and subquery where
             where = self.quoteIdentifier(tableLeft) + "." + self.quoteIdentifier(attrLeft) + " = "
             where += self.quoteIdentifier(tableRight) + "." + self.quoteIdentifier(attrRight)
 
+            // Generate join SQL
             joinQueryItem += joinType + self.quoteIdentifier(table) + " AS " + self.quoteIdentifier(as) + " ON "
               joinQueryItem += where