fix error thrown, and example comments

[Tieske]

replaces #143

please review with whitespace changes turned off.

@laulin please check the updates based on your work

[Tieske]

@EvandroLG a nice side effect of the close method is that we can get rid of the ugly stop pattern;

instead of:

    local stop = false
    ...
    if something then
      ...
      stop = true
    end
    return stop

this will work:

    ...
    if something then
      ...
      return response:close()
    end

Let me know if you want me to update the other examples with that pattern as well.

[EvandroLG]

I liked it, @Tieske
Can I merge it, and then you open a new PR with the other changes?

[Tieske]

@EvandroLG Please merge, I'll follow up later