From 17af50812c47f5dec7e02e443c551b9697715729 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= <essen@ninenines.eu>
Date: Wed, 26 Mar 2014 19:05:59 +0100
Subject: Remove outdated comments, all edoc, plus a few minor tweaks

---
 src/cowboy_handler.erl | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

(limited to 'src/cowboy_handler.erl')

diff --git a/src/cowboy_handler.erl b/src/cowboy_handler.erl
index ac95de5..7780e20 100644
--- a/src/cowboy_handler.erl
+++ b/src/cowboy_handler.erl
@@ -12,7 +12,7 @@
 %% ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 %% OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-%% @doc Handler middleware.
+%% Handler middleware.
 %%
 %% Execute the handler given by the <em>handler</em> and <em>handler_opts</em>
 %% environment values. The result of this execution is added to the
@@ -27,8 +27,6 @@
 %% by default. This can be configured through the <em>loop_max_buffer</em>
 %% environment value. The request will be terminated with an
 %% <em>{error, overflow}</em> reason if this threshold is reached.
-%%
-%% @see cowboy_http_handler
 -module(cowboy_handler).
 -behaviour(cowboy_middleware).
 
@@ -45,7 +43,6 @@
 	resp_sent = false :: boolean()
 }).
 
-%% @private
 -spec execute(Req, Env)
 	-> {ok, Req, Env} | {error, 500, Req}
 	| {suspend, ?MODULE, handler_loop, [any()]}
@@ -148,8 +145,6 @@ handler_after_callback(Req, State=#state{resp_sent=false}, Handler,
 handler_after_callback(Req, State, Handler, HandlerState) ->
 	handler_before_loop(Req, State, Handler, HandlerState).
 
-%% We don't listen for Transport closes because that would force us
-%% to receive data and buffer it indefinitely.
 -spec handler_before_loop(Req, #state{}, module(), any())
 	-> {ok, Req, cowboy_middleware:env()}
 	| {error, 500, Req} | {suspend, module(), atom(), [any()]}
@@ -177,7 +172,6 @@ handler_loop_timeout(State=#state{loop_timeout=Timeout,
 	TRef = erlang:start_timer(Timeout, self(), ?MODULE),
 	State#state{loop_timeout_ref=TRef}.
 
-%% @private
 -spec handler_loop(Req, #state{}, module(), any())
 	-> {ok, Req, cowboy_middleware:env()}
 	| {error, 500, Req} | {suspend, module(), atom(), [any()]}
-- 
cgit v1.2.3