= can: fix PipelineLimiter which only worked for chunked requests, fix #414

Some things to keep in mind:
  * It may take quite a while until Tcp.SuspendReading gets to the networking part. In
    this time quite a bit of data may already be in queues to be processed.
  * PipelineLimiting doesn't work at all with fast-path because all the request processing is done instantly,
    i.e. during the `eventPL` call in handleEvent the complete request is handled and already sent
    out so that the openRequests counter is never increased.
! testkit: in RouteTests always convert URIs into absolute ones, fixes #464

This is to mirror the behavior of spray-can / spray-servlet which make
request URIs always absolute (using the supplied `Host` header).
= docs: also regard methods with type parameters in `includecode` and re.escape strange method names
+ routing: add scheme directives
Merge pull request #417 from agemooij/routing-scheme-directives

+ routing: add scheme directives
Merge pull request #465 from jrudolph/i/464/absolute-URIs-in-tests

! testkit: in RouteTests always convert URIs into absolute ones, fixes #464
Merge pull request #457 from jrudolph/i/414/fix-pipeline-limiter

= can: fix PipelineLimiter which only worked for chunked requests, fix #414
= docs: add documentation for SecurityDirectives, refs #442
= util: fix warning
Merge pull request #466 from jrudolph/doc/security-directives

add documentation for SecurityDirectives
= docs: fix small issues in documentation examples
= io: quiet down exceptions from `Socket.shutdownOutput()`, fixes #468

It seems older versions (< 7) of the JDK have a condition where
`shutdownOutput` can fail:

http://bugs.sun.com/view_bug.do?bug_id=4516760

This is a workaround that catches the exception and views the connection
as closed if the exception occurs.
Merge pull request #469 from jrudolph/i/468/quiet-shutdownOutput

= io: quiet down exceptions from `Socket.shutdownOutput()`, fixes #468
Added support to play-json with basic error handling.