Paul Sokolovsky
2146cdab5e
docs/esp8266/tutorial/pins: Fix typo in commands for pin input mode.
2016-08-09 21:13:27 +03:00
Damien George
e4e4526954
docs: Bump version to 1.8.3.
2016-08-09 23:49:25 +10:00
Paul Sokolovsky
5c73de0337
docs/uio: Mention seek()/flush() support for io.BytesIO.
2016-08-09 01:52:56 +03:00
Paul Sokolovsky
3e5534caf7
docs/esp8266/intro: Focus on hazards of unearthed power wrt electronics.
2016-08-07 22:41:34 +03:00
Paul Sokolovsky
d2cab0b7be
docs/esp8266/tutorial/intro: Add anchor for link from quickeref.
2016-08-07 22:16:40 +03:00
Paul Sokolovsky
f84dda7111
docs/esp8266/quickref: Link to installation instructions.
2016-08-07 17:46:27 +03:00
Paul Sokolovsky
a9923d190e
docs/esp8266/intro: Add troubleshooting section.
...
Tries to summarize most of the issues we've seen so far.
2016-08-07 17:28:33 +03:00
Paul Sokolovsky
919c54f750
docs/esp8266/intro: Rename to "Getting started" from "Introduction".
...
People tend to skip introductions (everyone knows what esp8266 is, right?),
so try to do A/B testing with a title inviting to read it.
2016-08-07 17:28:23 +03:00
Paul Sokolovsky
1966745689
esp8266/tutorial/intro: Reword para abou -fm dio switch.
...
Not all NodeMCU boards require it.
2016-08-07 16:31:09 +03:00
Paul Sokolovsky
fdb411a8c5
docs/library/index: Include array module in ToC.
2016-08-07 00:16:41 +03:00
Paul Sokolovsky
8a0b6f561c
docs/array: Document array module.
2016-08-07 00:13:48 +03:00
Mike Causer
ce166e6b68
docs: Spelling mistakes
2016-08-02 11:17:46 +03:00
Mike Causer
b4564841b6
docs: Add DHT to ESP8266 Quick Ref and Tutorial
2016-08-01 14:39:57 +03:00
Damien George
1459a8d5c9
docs: Bump version to 1.8.2.
2016-07-10 12:46:50 +01:00
Martin Müller
047ac2044d
docs/library: Fix typo in docs for usocket.listen().
2016-06-26 12:38:20 +01:00
Paul Sokolovsky
b2641b53e0
docs/conf.py: Exclude cmath from modindex for wipy.
2016-06-19 19:17:42 +03:00
Paul Sokolovsky
2b6dcdd3e4
docs/sys: print_exception: Fixes/clarifications.
2016-06-18 19:06:53 +03:00
Paul Sokolovsky
617e033e2f
docs/select: Add an article.
2016-06-18 19:06:42 +03:00
Paul Sokolovsky
51805e4a3a
docs: Rebuild docs from scratch, as required for proper only:: handling.
...
Docs are now by default rebuilt from scratch, as required to build
conditionalized (i.e. using only:: directive) docs across different
output types. We have pretty small docset, so that's still rather fast.
However, if that's a concern, incremental rebuilds can be used by
passing "FORCE=" (nothing after =) as a make parameter. This will work
when using the same output type (e.g. only "html").
2016-06-14 00:23:33 +03:00
Paul Sokolovsky
91031b60dc
docs/conf.py: Active sphinx_selective_exclude extensions.
...
For modindex_exclude extension, per-port module excludes are also added.
With these changes, it's possible to generate docs for a particular port
devoid of any superfluous and unrelated content, including in indexes and
full-text search - with small caveat: when generating PDF docs after HTML,
or vice-versa cached internal doctree representation (build/*/doctrees/)
must be removed first.
2016-06-12 01:18:13 +03:00
Paul Sokolovsky
f6d01b8b67
docs: Add sphinx_selective_exclude extension suite.
...
Designed specifically to workaround issues we were facing with generating
multiple conditionalized output docsets from a single master doctree.
Extensions were factored out into a separate project, based on the fact
that many other Sphinx users experience similar or related problems:
https://github.com/pfalcon/sphinx_selective_exclude
Corresponds to the 182f4a8da57 upstream revision.
2016-06-12 01:13:39 +03:00
Paul Sokolovsky
9de5eb278d
docs/sys: Detailed description of print_exception() diff from traceback module.
2016-06-10 23:06:56 +03:00
Paul Sokolovsky
343b5c1081
docs/uctypes: Improve documentation.
...
Seealso and Limitations sectiosn added, better formatting and grammar.
2016-06-09 05:02:55 +03:00
Paul Sokolovsky
79b40d1127
docs/machine*: Remove explicit targets and "machine." prefixes on classes.
...
With currentmodule:: set properly, none are needed. Extra "machine." prefix
produces wrong indexing data.
2016-06-09 03:03:53 +03:00
Paul Sokolovsky
a0c296f6d5
docs/machine.Pin: Disambiguate object call method.
2016-06-09 02:58:15 +03:00
Paul Sokolovsky
1d3b903eb5
docs/library/index: Add builtins.rst.
2016-06-09 00:26:44 +03:00
Paul Sokolovsky
0cec4e9bb8
docs/builtins: Enumerate all builtin functions implemented.
...
Based on unix version. No descriptions so far.
2016-06-09 00:24:52 +03:00
Paul Sokolovsky
f1eb672d88
docs/pyb.Pin: Sort .af() and .af_list() methods together.
2016-06-08 16:36:22 +03:00
Paul Sokolovsky
a384a53130
docs/pyb.*: Use proper class case in method headers.
...
Class designator will be used as is in indexes, so must match actual class
name.
2016-06-08 16:21:28 +03:00
Paul Sokolovsky
585aafc27e
docs/pyb.ExtInt,pyb.Pin: Mark up class methods as such.
2016-06-08 16:00:12 +03:00
Paul Sokolovsky
0d8c22b122
docs/pyb.Pin: af_list() is a normal method, not a class method.
2016-06-08 15:57:46 +03:00
Paul Sokolovsky
8171995ee9
docs/pyb.CAN: Mark CAN.initfilterbanks() as classmethod explicitly.
2016-06-08 15:49:30 +03:00
Paul Sokolovsky
bba77a2d01
docs/machine.Pin: Add class designator to all constants.
...
This makes rendered docs to not provide incorrect information and
consistent with how it's down for other machine classes.
2016-06-08 01:37:03 +03:00
Paul Sokolovsky
7d7243f44c
docs/machine.*: Use proper class case in method headers.
...
Class designator will be used as is in indexes, so must match actual class
name.
2016-06-08 01:33:49 +03:00
Paul Sokolovsky
93968bd6fb
docs/machine.UART: Cleanup pyboard section.
2016-06-08 01:32:16 +03:00
Paul Sokolovsky
0a4361ca67
docs/machine.Pin: Remove explicit target.
...
With currentmodule:: support, all targets should be generated properly by
Sphinx.
2016-06-08 01:13:59 +03:00
Paul Sokolovsky
0a4cc24b2e
docs/pyb.*: Add "currentmodule:: pyb" directive.
...
Makes sure that classes described in these separate files are properly
designated as belonging to "pyb" module in indexes.
2016-06-08 00:57:41 +03:00
Paul Sokolovsky
c8b7628094
docs/machine.*: Add "currentmodule:: machine" directive.
...
Makes sure that classes described in these separate files are properly
designated as belonging to "machine" module in indexes.
2016-06-08 00:46:27 +03:00
Paul Sokolovsky
2c5fc681c8
docs/library/machine.Pin: Mention GPIO and cross-link .value() function.
2016-06-07 17:49:00 +03:00
Paul Sokolovsky
6e2fa5237d
docs/usocket: There must be empty line after .only:: .
2016-06-07 17:41:21 +03:00
Paul Sokolovsky
9b18811951
docs/ure: Typo fix.
2016-06-07 08:53:54 +03:00
Paul Sokolovsky
753a965363
docs/esp.socket: Remove unused file.
2016-06-07 02:40:05 +03:00
Paul Sokolovsky
9487b80666
docs/library/network: wipy: Fix literal block indentation.
2016-06-07 02:07:08 +03:00
Damien George
2bf6eb9fe2
docs: Add link to PDF version of docs in sidebar.
...
Requires a link of the form: <BASEURL>/<lang>/<ver>/micropython-<port>.pdf
2016-06-06 11:37:40 +01:00
Ben Hagen
0b913bd09f
docs/esp8266/tutorial/network_basics: Minor typo fix, ap becomes ap_if.
2016-06-06 10:08:30 +01:00
Damien George
9b39263b11
docs: Bump version to 1.8.1.
2016-06-03 15:45:43 +01:00
puuu
3f6ca4b22c
docs/esp8266/general: Add note about RTC overflow.
2016-06-03 14:37:49 +01:00
Paul Sokolovsky
d8cc51ea2b
docs/esp8266/quickref: Update WebREPL section for 1.8.1 release.
...
WebREPL is much more stable now.
2016-06-02 20:11:40 +03:00
Damien George
ed4e5d2583
docs/library/index: Fix grammar and spelling in intro paragraph.
2016-06-02 11:05:13 +01:00
Marcel Stör
0b9725812e
docs/wipy/tutorial: Add note about screen key bindings on OS X.
2016-06-02 00:13:21 +03:00
Paul Sokolovsky
e456b2cc94
docs/README: Add some hints for PDF docs generation.
2016-06-02 00:08:47 +03:00
Paul Sokolovsky
09f764dc04
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.
2016-06-02 00:08:07 +03:00
Paul Sokolovsky
9a1a49ceec
esp8266/general: Typo/grammar fixes.
2016-06-01 23:16:17 +03:00
Paul Sokolovsky
fdf45a718b
esp8266/quickref: Use local image of Adafruit Huzzah board.
...
Using remote image causes problems with tools (partly because the image
is semi-firewalled and can't be accessed by arbitrary tools).
2016-06-01 23:11:49 +03:00
Paul Sokolovsky
c4ab8895e8
docs: math, cmath: Add port availability information.
2016-06-01 22:12:39 +03:00
Paul Sokolovsky
1a05a59116
docs/math: Typo fix.
2016-06-01 22:09:51 +03:00
Damien George
93a9c2e840
docs/library/machine: Add documentation for machine.time_pulse_us.
2016-05-31 14:06:33 +01:00
Peter Hinch
641300dccb
stmhal/dac: DAC deinit() method added.
2016-05-31 13:10:35 +03:00
Tomas R
7d4fd8b6db
docs/esp8266/general: Remove duplicate phrase.
2016-05-30 19:20:11 +03:00
Damien George
a3dc2c6031
docs/machine: Make disable_irq and enable_irq docs available for all.
2016-05-26 15:47:47 +01:00
mad474
eaecc4c02e
docs/esp8266/general: Grammar fixes.
2016-05-23 23:33:23 +03:00
Paul Sokolovsky
3e33aeb0db
docs: esp8266: Include ussl module in the docs.
2016-05-22 23:57:26 +03:00
Paul Sokolovsky
bca4c9e465
docs/ussl: Add basic description of axTLS-based modussl.
...
In particular, disclose the fact that server certificates are not
validated.
2016-05-22 23:56:22 +03:00
misterdanb
a0a08b4be1
esp8266: Add APA102 serial individually controllable LEDs support.
...
APA102 is a new "smart LED", similar to WS2812 aka "Neopixel".
2016-05-19 22:29:11 +03:00
Paul Sokolovsky
ca63c77073
docs/ustruct: Describe supported type codes.
2016-05-14 20:48:43 +03:00
Radomir Dopieralski
ccb00b7724
docs/esp8266/quickstart: remove i2c examples with stop=False
...
Since the ``stop`` parameter has been dropped.
2016-05-14 00:02:02 +02:00
Damien George
9b4502b7e8
docs/esp8266/tutorial: Fix typo in do_connect() network example.
...
Fixes issue #2065 .
2016-05-11 13:40:28 +01:00
Radomir Dopieralski
e89413e9b0
docs/esp8266/quickref: New way to get MAC address
2016-05-10 00:31:57 +02:00
Paulus Schoutsen
c156e89379
Fix ESP8266 Network tutorial
...
The socket should either connect to `addr` or `addr_info[0][-1]`. Not to `addr[0][-1]`.
2016-05-07 23:24:24 -07:00
Radomir Dopieralski
0c86a9471a
docs/machine.UART: Filter out unimplemented UART methods from esp8266 docs.
2016-05-07 20:20:04 +03:00
Damien George
2c2fc070ec
docs: Bump version to 1.8.
2016-05-03 17:32:32 +01:00
Damien George
56fd33a6dd
docs/esp8266/tutorial: Change name of ESP8266 firmware to match actual.
2016-05-03 16:42:52 +01:00
Paul Sokolovsky
c68c327310
docs/esp8266/tutorial/repl: Reword description of initial WebREPL setup a bit.
2016-05-03 18:40:16 +03:00
Paul Sokolovsky
1f396c58d9
docs/esp8266/tutorial/repl: Suggest using hosted WebREPL client.
...
At http://micropython.org/webrepl .
2016-05-03 18:35:43 +03:00
Damien George
5d05993f10
esp8266/tutorial: Mention that esptool is available via pip.
2016-05-03 14:05:50 +01:00
Damien George
8af64bcf2b
docs/esp8266/tutorial: Update pins tutorial to reflect changes in API.
2016-05-03 13:56:15 +01:00
Damien George
5036b6ad18
docs/library/machine.Pin: Update pin docs to reflect ESP8266 support.
2016-05-03 13:55:37 +01:00
Paul Sokolovsky
81a99eb388
docs/machine: idle() description generalization.
2016-05-03 12:53:57 +03:00
Paul Sokolovsky
bb6458bf43
docs/machine: More generic description of sleep's, WiPy details to its genref.
2016-05-03 12:48:20 +03:00
Paul Sokolovsky
db99ae00a2
docs/machine: Move WiPy-specific hardware details to its general reference.
2016-05-03 12:26:55 +03:00
Paul Sokolovsky
06ec96b47b
docs/machine: Generalize docs from just WiPy to other ports.
2016-05-03 12:15:29 +03:00
Damien George
879bc4197a
docs/esp8266: Add ESP8266 tutorial.
2016-05-03 01:39:04 +01:00
Paul Sokolovsky
a6cf45864f
docs/network: esp8266: MAC address is set via .config() method.
2016-05-03 01:04:40 +03:00
Paul Sokolovsky
ae845f13de
docs: Use getaddrinfo() result in easy way.
...
Instead of extracting 4th element, extact last. Much easier to remember!
2016-05-03 00:48:04 +03:00
Paul Sokolovsky
5302c3e8c4
docs/esp8266_contents: Referebce general and tutorial docs.
2016-05-02 17:45:42 +03:00
Paul Sokolovsky
a22aa53ef1
docs/esp8266/general: Add "Boot process" section.
2016-05-02 17:41:08 +03:00
Paul Sokolovsky
12144e8fcd
docs/esp8266/general: Add techspec section.
...
Link to vendor forum with datasheets, etc. is provided, as well as inline
TTX.
2016-05-02 17:12:25 +03:00
Paul Sokolovsky
0f682f1ee1
docs/esp8266/general: Fix list formatting.
2016-05-02 16:10:48 +03:00
Paul Sokolovsky
5aa4db0505
docs/esp8266/general: Add more points to "Multitude of boards" section.
2016-05-02 16:00:44 +03:00
Paul Sokolovsky
74c6363b97
docs/esp8266/general: WebREPL is described in quickref for now.
2016-05-02 15:26:40 +03:00
Damien George
c816b89353
docs/library/machine.I2C: Update to reflect ESP8266 implementation.
...
This machine.I2C documentation is now closer to a more port-neutral
description, although there are still differences between WiPy and
ESP8266.
2016-05-02 12:31:17 +01:00
Paul Sokolovsky
621c644205
docs: _io and _collections were renamed to have standard "u" prefix.
2016-05-02 14:02:54 +03:00
Damien George
70ff7350e7
stmhal, cc3200: Change i2c.scan() method to scan addresses 0x08-0x77.
...
A standard I2C address is 7 bits but addresses 0b0000xxx and 0b1111xxx
are reserved. The scan() method is changed to reflect this, along with
the docs.
2016-05-02 11:15:36 +01:00
Paul Sokolovsky
8ebdbcfb27
docs: Add _io module reference.
2016-05-02 00:39:36 +03:00
Paul Sokolovsky
348caaf940
docs: Add _collections module reference.
2016-05-02 00:36:58 +03:00
Paul Sokolovsky
fd283eba64
docs/sys: Describe sys.platform is port-neutral manner.
2016-05-01 14:39:38 +03:00
Paul Sokolovsky
e9b7610748
docs/sys: Describe sys.maxsize.
2016-05-01 14:31:08 +03:00
Paul Sokolovsky
59603a2e89
docs/sys: Describe sys.implementation.
2016-05-01 13:59:34 +03:00
Paul Sokolovsky
4fb9452bff
docs/sys: Clean up print_exception() description.
2016-05-01 13:44:06 +03:00
Paul Sokolovsky
ad2889c141
docs/sys: Clarify description of sys.exit().
2016-05-01 13:42:36 +03:00