From 8fc1371df8e11074496b8cdc27363ad7e4f88934 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Tue, 30 Aug 2016 14:18:14 +0200 Subject: Minor documentation fixes "make docs" should now work again. --- README.md | 6 +++--- doc/src/guide/book.asciidoc | 1 + doc/src/guide/cowboy.sty | 8 ++++++++ doc/src/guide/flow_diagram.asciidoc | 1 + doc/src/guide/req.asciidoc | 8 ++------ 5 files changed, 15 insertions(+), 9 deletions(-) create mode 100644 doc/src/guide/cowboy.sty diff --git a/README.md b/README.md index 4c62e96..bb2ea24 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ to handlers written in Erlang. Because it uses Ranch for managing connections, Cowboy can easily be **embedded** in any other application. -No parameterized module. No process dictionary. **Clean** Erlang code. +Cowboy is **clean** and **well tested** Erlang code. Sponsors -------- @@ -31,8 +31,8 @@ It has since been superseded by HTTP/2. Online documentation -------------------- - * [User guide](http://ninenines.eu/docs/en/cowboy/HEAD/guide) - * [Function reference](http://ninenines.eu/docs/en/cowboy/HEAD/manual) + * [User guide](http://ninenines.eu/docs/en/cowboy/2.0/guide) + * [Function reference](http://ninenines.eu/docs/en/cowboy/2.0/manual) Offline documentation --------------------- diff --git a/doc/src/guide/book.asciidoc b/doc/src/guide/book.asciidoc index b1c54d8..9c5f49e 100644 --- a/doc/src/guide/book.asciidoc +++ b/doc/src/guide/book.asciidoc @@ -1,4 +1,5 @@ // 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 diff --git a/doc/src/guide/cowboy.sty b/doc/src/guide/cowboy.sty new file mode 100644 index 0000000..d5e0d3b --- /dev/null +++ b/doc/src/guide/cowboy.sty @@ -0,0 +1,8 @@ +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{asciidoc-dblatex}[2012/10/24 AsciiDoc DocBook Style] + +%% Just use the original package and pass the options. +\RequirePackageWithOptions{docbook} + +%% Define an alias for make snippets to be compatible with source-highlighter. +\lstalias{makefile}{make} diff --git a/doc/src/guide/flow_diagram.asciidoc b/doc/src/guide/flow_diagram.asciidoc index 93e9051..1095404 100644 --- a/doc/src/guide/flow_diagram.asciidoc +++ b/doc/src/guide/flow_diagram.asciidoc @@ -1,3 +1,4 @@ +[[flow_diagram]] == Flow diagram Placeholder chapter. diff --git a/doc/src/guide/req.asciidoc b/doc/src/guide/req.asciidoc index 39cd1b6..5bd6701 100644 --- a/doc/src/guide/req.asciidoc +++ b/doc/src/guide/req.asciidoc @@ -1,7 +1,3 @@ -+++ -title = "The Req object" -+++ - [[req]] == The Req object @@ -160,8 +156,8 @@ The scheme and host are lowercased case insensitive binary strings. The port is an integer representing the port number. The path and query string are case sensitive binary strings. -Cowboy defines only the <<"http">> and <<"https">> schemes. -They are chosen so that the scheme will only be <<"https">> +Cowboy defines only the `<<"http">>` and `<<"https">>` schemes. +They are chosen so that the scheme will only be `<<"https">>` for requests on secure HTTP/1.1 or HTTP/2 connections. // @todo Is that tested well? -- cgit v1.2.3