some text amendments in docs

Author: popravich

docs/abc.rst

@@ -22,7 +22,7 @@ aiohttp.web is built on top of few concepts: *application*, *router*,
 from scratch, all other parts should work with new router seamlessly.
 
 :class:`AbstractRouter` has the only mandatory method:
-:meth:`AbstractRouter.resolve` coroutine. It should return an
+:meth:`AbstractRouter.resolve` coroutine. It must return an
 :class:`AbstractMatchInfo` instance.
 
 If the requested URL handler is found

docs/client.rst

@@ -452,7 +452,7 @@ Resolving using custom nameservers
 ----------------------------------
 
 In order to specify the nameservers to when resolving the hostnames,
-aiodns is required::
+:term:`aiodns` is required::
 
     from aiohttp.resolver import AsyncResolver
 

docs/glossary.rst

@@ -8,6 +8,13 @@
 .. if you add new entries, keep the alphabetical sorting!
 
 .. glossary::
+   :sorted:
+
+   aiodns
+
+      DNS resolver for asyncio.
+
+      https://pypi.python.org/pypi/aiodns
 
    asyncio
 

docs/web_reference.rst

@@ -43,6 +43,8 @@ like one using :meth:`Request.copy`.
 
       Read-only :class:`str` property.
 
+      .. seealso:: :meth:`Application.make_handler`
+
    .. attribute:: method
 
       *HTTP method*, read-only property.
@@ -1095,6 +1097,13 @@ duplicated like one using :meth:`Application.copy`.
          await loop.create_server(app.make_handler(),
                                   '0.0.0.0', 8080)
 
+      ``secure_proxy_ssl_header`` keyword parameter
+      can be used to detect request scheme::
+
+         await loop.create_server(app.make_handler(
+            secure_proxy_ssl_header='X-Forwarded-Proto'),
+            '0.0.0.0', 8080)
+
    .. coroutinemethod:: shutdown()
 
       A :ref:`coroutine<coroutine>` that should be called on