summaryrefslogtreecommitdiffstatshomepage
path: root/docs/esp8266/general.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/esp8266/general.rst')
-rw-r--r--docs/esp8266/general.rst13
1 files changed, 8 insertions, 5 deletions
diff --git a/docs/esp8266/general.rst b/docs/esp8266/general.rst
index 3ffb2ff339..04afed46ed 100644
--- a/docs/esp8266/general.rst
+++ b/docs/esp8266/general.rst
@@ -71,13 +71,16 @@ and developers, who can diagnose themselves any issues arising from
modifying the standard process).
Once the filesystem is mounted, ``boot.py`` is executed from it. The standard
-version of this file is created during first-time module set up and by
-default starts up a WebREPL daemon to handle incoming connections. This
-file is customizable by end users (for example, you may want to disable
-WebREPL for extra security, or add other services which should be run on
+version of this file is created during first-time module set up and has
+commands to start a WebREPL daemon (disabled by default, configurable
+with ``webrepl_setup`` module), etc. This
+file is customizable by end users (for example, you may want to set some
+parameters or add other services which should be run on
a module start-up). But keep in mind that incorrect modifications to boot.py
may still lead to boot loops or lock ups, requiring to reflash a module
-from scratch.
+from scratch. (In particular, it's recommended that you use either
+``webrepl_setup`` module or manual editing to configure WebREPL, but not
+both).
As a final step of boot procedure, ``main.py`` is executed from filesystem,
if exists. This file is a hook to start up a user application each time