   # (for interpolations). When the next token has been recorded, we move forward
   # within the code past the token, and begin again.
   #
-  # Each tokenizing method is responsible for incrementing `@i` by the number of
-  # characters it has consumed. `@i` can be thought of as our finger on the page
-  # of source.
+  # Each tokenizing method is responsible for returning the number of characters
+  # it has consumed.
   #
   # Before returning the token stream, run it through the [Rewriter](rewriter.html)
   # unless explicitly asked not to.

      @indebt = 0
      @outdentToken @indent - size, noNewlines
    @indent = size
    true

  # Record an outdent token or multiple tokens, if we happen to be moving back
  # inwards past several recorded indents.

  # definitions versus argument lists in function calls. Walk backwards, tagging
  # parameters specially in order to make things easier for the parser.
  tagParameters: ->
    return this if @tag() isnt ')'
    i = @tokens.length
    while tok = @tokens[--i]
      switch tok[0]
        when 'IDENTIFIER'       then tok[0] = 'PARAM'
        when ')'                then tok[0] = 'PARAM_END'
        when '(', 'CALL_START'  then tok[0] = 'PARAM_START'; return true
    this

  # Close up all remaining open blocks at the end of the file.
  closeIndentation: ->
