From 09f764dc04699f4c4feb497c8ef88399ed7cf099 Mon Sep 17 00:00:00 2001 From: Paul Sokolovsky Date: Thu, 2 Jun 2016 00:08:07 +0300 Subject: [PATCH] docs/library/index: Add intro paragraph regarding availability of modules. This introductions makes explicit the fact that whenever possible, the documentation describes full MicroPython functionality, and arbitrary functions/classes/modules may be missing in a paricular port or build. --- docs/library/index.rst | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) diff --git a/docs/library/index.rst b/docs/library/index.rst index b997318cea..2e8064c8e9 100644 --- a/docs/library/index.rst +++ b/docs/library/index.rst @@ -1,9 +1,33 @@ MicroPython libraries ===================== -The following standard Python libraries are built in to MicroPython. - -For additional libraries, please download them from the `micropython-lib repository +This chapter described modules (function and class libraries) which are built +into MicroPython. There are few categories of modules: + +* Modules which implement subset of standard Python functionality and are not + intended to be extended by a user. +* Modules which are implement subset of Python functionality, with a provision + for extension by a user (via Python code). +* Modules which implement MicroPython extensions to Python standard libraries. +* Modules specific to a particular port and thus not portable. + +Note about the availability of modules and their contents: This documentation +in general aspires to describe all modules and functions/classes which are +implemented in MicroPython. However, MicroPython is highly configurable, and +each port to a particular board/embedded system makes available only a subset +of MicroPython libraries. For officially supported ports, there is an effort +to either filter out non-applicable items, or mark individual descriptions +with "Availability:" clauses describing which ports provide a given feature. +With that in mind, please still be ready to a fact that some function/class +in a module, or even entire module, described in this documentation, may be +not available in a particular build of MicroPython on a particular board. The +best place to find a general information of the availability/non-availability +of a particular feature is "General Information" secton which contains +information pertaining to a specific port. + +Beyond the built-in libraries described in this documentation, many more +modules from the Python standard library, as well as further MicroPython +extensions to it, can be found in the `micropython-lib repository `_. Python standard libraries and micro-libraries