 # Get the current language we're documenting, based on the extension.
 getLanguage = (source) -> languages[path.extname(source)]
 
-# Compute the destination HTML path for an input source file path.
-# If the source is `lib/example.coffee`,
-# the HTML will be at `docs/example.html`
+# Compute the destination HTML path for an input source file path. If the source
+# is `lib/example.coffee`, the HTML will be at `docs/example.html`
 destination = (filepath) ->
   basename = path.basename filepath, path.extname filepath
   "docs/#{basename}.html"

    pygments.stdin.end()
  
# Once all of the code is finished highlighting, we can generate the HTML file
# and write out the documentation. Pass the completed sections
# into the template found in `resources/docco.jst`
generateHtml = (sources, source, sections) ->
  title = path.basename source
  dest  = destination source

  save docsText, codeText
  sections

# Highlights a single chunk of CoffeeScript code, using **Pygments** over stdio,
# and runs the text of its corresponding comment through **Markdown**, using
# [Showdown.js](http://attacklab.net/showdown/).
#
# We process the entire file in a single call to Pygments by inserting little
# marker comments between each section and then splitting the result string
