 
 
 scraperwiki.url = (arg) ->
-  # [arg] should either be a string (to redirect the browser),
-  # a callback function (which will be passed the current url),
-  # or undefined, in which case a jQuery deferred object is
-  # returned, on which you can call .done() and .always()
+  ###
+  [arg] should either be a string (to redirect the browser),
+  a callback function (which will be passed the current url),
+  or undefined, in which case a jQuery deferred object is
+  returned, on which you can call .done() and .always()
+  ###
   if typeof(arg) is 'string'
     # they want to set the url (ie: redirect)
     parent.scraperwiki.xdm.redirect(arg)



scraperwiki.dataset.sql = (sql, success, error) ->
  # execute a SQL query on the main dataset.
  # [success] and [error] callbacks are optional,
  # since this returns a jQuery deferred object on which
  # you can chain .done() and .fail() handlers.
  settings = scraperwiki.readSettings()
  boxSettings = settings.target ? settings.source
  options =



scraperwiki.tool.sql.meta = (success, error) ->
  ###
  Get info about this tool's internal SQL database.
  [success] and [error] callbacks are optional,
  since this returns a jQuery deferred object on which
  you can chain .done() and .fail() handlers.
  ###
  settings = scraperwiki.readSettings()
  options =
    url: "#{settings.source.url}/sql/meta"
