blob: 063560e7ee1cedc8c0a6aa1fb7240ef696b0180e (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
// a2x: --dblatex-opts "-P latex.output.revhistory=0 -P doc.publisher.show=0 -P index.numbered=0"
// a2x: --dblatex-opts "-s cowboy"
// a2x: -d book --attribute tabsize=4
= Cowboy User Guide
// REST: where should i handle bindings? init, probably. qs? in media type functions
// REST: explain how a module per media type is good; module may be shared between client/server
// @todo Put the list of RFCs and other documents supported somewhere.
= Rationale
include::modern_web.asciidoc[The modern Web]
include::erlang_web.asciidoc[Erlang and the Web]
= Introduction
include::introduction.asciidoc[Introduction]
include::getting_started.asciidoc[Getting started]
include::flow_diagram.asciidoc[Flow diagram]
= Configuration
include::listeners.asciidoc[Listeners]
include::routing.asciidoc[Routing]
include::constraints.asciidoc[Constraints]
= Handlers
include::handlers.asciidoc[Handlers]
include::loop_handlers.asciidoc[Loop handlers]
include::static_files.asciidoc[Static files]
= Request and response
include::req.asciidoc[Request details]
include::req_body.asciidoc[Reading the request body]
include::resp.asciidoc[Sending a response]
include::cookies.asciidoc[Using cookies]
include::multipart.asciidoc[Multipart]
= REST
include::rest_principles.asciidoc[REST principles]
include::rest_handlers.asciidoc[Handling REST requests]
include::rest_flowcharts.asciidoc[REST flowcharts]
include::resource_design.asciidoc[Designing a resource handler]
= Websocket
include::ws_protocol.asciidoc[The Websocket protocol]
include::ws_handlers.asciidoc[Websocket handlers]
= Advanced
include::streams.asciidoc[Streams]
include::middlewares.asciidoc[Middlewares]
// @todo Rather have two chapters, custom handlers and custom protocol upgrades
include::sub_protocols.asciidoc[Sub protocols]
= Additional information
include::migrating_from_1.0.asciidoc[Migrating from Cowboy 1.0 to 2.0]
// @todo Maybe history? Could take info from architecture also.
include::specs.asciidoc[HTTP and other specifications]
= Deprecated chapters
== About the deprecated chapters
The following chapters were relevant in Cowboy 1.0. They have
not been updated for Cowboy 2.0 yet. The information in these
chapters may or may not be useful.
include::architecture.asciidoc[Architecture]
include::broken_clients.asciidoc[Dealing with broken clients]
include::overview.asciidoc[Overview]
|
