Fix rendering issues in the guide and manual

doc/src/guide/getting_started.asciidoc

@@ -64,7 +64,7 @@ handler.
 We will modify the 'Makefile' to tell the build system it needs to
 fetch and compile Cowboy:
 
-[source,make]
+[source,makefile]
 ----
 PROJECT = hello_erlang
 

doc/src/guide/rest_handlers.asciidoc

@@ -62,7 +62,8 @@ if it is undefined, moving directly to the next step. Similarly,
 | allow_missing_post     | `true`
 | charsets_provided      | skip
 | content_types_accepted | none
-| content_types_provided | `$$[{{<<"text">>, <<"html">>, '*'}, to_html}]$$`
+// @todo Space required for the time being: https://github.com/spf13/hugo/issues/2398
+| content_types_provided | `[{{ <<"text">>, <<"html">>, '*'}, to_html}]`
 | delete_completed       | `true`
 | delete_resource        | `false`
 | expires                | `undefined`

doc/src/manual/cowboy_req.asciidoc

@@ -326,7 +326,7 @@ Return the extra tokens from matching against `...` during routing.
 
 === peer(Req) -> Peer
 
-Peer = {inet:ip_address(), inet:port_number()}:: Peer IP address and port number.
+Peer = `{inet:ip_address(), inet:port_number()}`:: Peer IP address and port number.
 
 Return the client's IP address and port number.
 

doc/src/manual/cowboy_rest.asciidoc

@@ -171,7 +171,8 @@ and `language`. The body can be set using `cowboy_req:set_resp_body/2`.
 
 Methods:: GET, HEAD, POST, PUT, PATCH, DELETE
 Value type:: [{binary() | {Type, SubType, Params}, ProvideResource}]
-Default value:: `[{{<<"text">>, <<"html">>, '*'}, to_html}]`
+// @todo Space required for the time being: https://github.com/spf13/hugo/issues/2398
+Default value:: `[{{ <<"text">>, <<"html">>, '*'}, to_html}]`
 
 With types: