doc typo & update

Author: d-a-v

cores/esp8266/core_esp8266_main.cpp

@@ -159,29 +159,26 @@ void init_done() {
 /*
    A bit of explanation for this entry point:
 
-   SYS is the RTOS task/context used by the upperlying system to run its
+   SYS is the SDK task/context used by the upperlying system to run its
    administrative tasks (at least WLAN and lwip's receive callbacks and
-   Ticker).  NONOS-SDK is designed to run users's non-threaded code in
+   Ticker).  NONOS-SDK is designed to run user's non-threaded code in
    another specific task/context with its own stack in BSS.
 
    Some clever fellows found that the SYS stack was a large and quite unused
-   piece of ram that we could use for the user stack, and proposed to use it
-   to store the user stack instead of using the users' main memory, thus
-   saving around 4KB on ram/heap.
+   piece of ram that we could use for the user's stack instead of using user's
+   main memory, thus saving around 4KB on ram/heap.
 
-   A problem arose later, which is that this stack is heavily used by the
-   system for some features.  One of these features is WPS.  We still don't
+   A problem arose later, which is that this stack can heavily be used by
+   the SDK for some features.  One of these features is WPS.  We still don't
    know if other features are using this, or if this memory is going to be
-   used in future releases.
+   used in future SDK releases.
 
    WPS beeing flawed by its poor security, or not beeing used by lots of
    users, it has been decided that we are still going to use that memory for
-   the users's stack and disable the use of WPS, with an option to revert
-   that back at the user's discretion.  This selection can be done by using
-   the board generator script.  This could be also done by setting up a new
-   option in the IDE's Tools menu.
-
-   The behavior is controlled by the globally NO_EXTRA_4K_HEAP define below.
+   user's stack and disable the use of WPS, with an option to revert that
+   back at the user's discretion.  This selection can be done with the
+   global define NO_EXTRA_4K_HEAP.  An option has been added to the board
+   generator script.
 
    References:
    https://github.com/esp8266/Arduino/pull/4553

doc/faq/readme.rst

@@ -52,7 +52,7 @@ Why can't I use WPS ?
 ~~~~~~~~~~~~~~~~~~~~~
 
 WPS is disabled by default, this offers an extra 4KB in ram/heap.  To enable
-WPS (and loose 4KB of useable ram), use this boards generator option:
+WPS (and lose 4KB of useable ram), use this boards generator option:
 
 ``./tools/boards.txt.py --allowWPS --allgen``