From b13c07932dfe76dfee29a0c5ce1166423faee77d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= <essen@ninenines.eu>
Date: Fri, 23 Dec 2016 15:33:21 +0100
Subject: Update the cowboy_handler manual

Also fixes a small mistake in cowboy_websocket.
---
 doc/src/manual/cowboy_handler.terminate.asciidoc | 64 ++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 doc/src/manual/cowboy_handler.terminate.asciidoc

(limited to 'doc/src/manual/cowboy_handler.terminate.asciidoc')

diff --git a/doc/src/manual/cowboy_handler.terminate.asciidoc b/doc/src/manual/cowboy_handler.terminate.asciidoc
new file mode 100644
index 0000000..f10d945
--- /dev/null
+++ b/doc/src/manual/cowboy_handler.terminate.asciidoc
@@ -0,0 +1,64 @@
+= cowboy_handler:terminate(3)
+
+== Name
+
+cowboy_handler:terminate - Terminate the handler
+
+== Description
+
+[source,erlang]
+----
+terminate(Reason, Req | undefined, State, Handler) -> ok
+
+Reason  :: any()
+Req     :: cowboy_req:req()
+State   :: any()
+Handler :: module()
+----
+
+Call the optional terminate callback if it is defined.
+
+Make sure to use this function at the end of the execution
+of modules that implement custom handler behaviors.
+
+== Arguments
+
+Reason::
+
+Reason for termination.
+
+Req::
+
+The Req object.
++
+It is possible to pass `undefined` if the handler has no concept
+of requests/responses and discarded the Req object before calling
+this function.
+
+State::
+
+Handler state.
+
+Handler::
+
+Handler module.
+
+== Return value
+
+The atom `ok` is always returned. It can be safely ignored.
+
+== Changelog
+
+* *2.0*: Function introduced.
+
+== Examples
+
+.Terminate a handler normally
+[source,erlang]
+----
+cowboy_handler:terminate(normal, Req, State, Handler).
+----
+
+== See also
+
+link:man:cowboy_handler(3)[cowboy_handler(3)]
-- 
cgit v1.2.3

