diff --git a/src/atom-application.coffee b/src/atom-application.coffee
index 491b9650e..354e3d202 100644
--- a/src/atom-application.coffee
+++ b/src/atom-application.coffee
@@ -251,7 +251,11 @@ class AtomApplication
             console.log("Killing process #{pid} failed: #{error.code}")
         delete @pidsToOpenWindows[pid]
 
-  # Private: Handles an atom:// url.
+  # Private: Open an atom:// url.
+  #
+  # The host of the URL being opened is assumed to be the package name
+  # responsible for opening the URL.  A new window will be created with
+  # that package's `urlMain` as the bootstrap script.
   #
   # * options
   #    + urlToOpen: