CircuitPython - a Python implementation for teaching coding with microcontrollers https://git.suspectdevices.com/suspect-devices/circuitpython/atom?h=v1.9.4 2018-05-11T06:39:59+00:00 2018-05-11T06:39:59+00:00 Damien George damien.p.george@gmail.com 2018-05-11T06:39:59+00:00 urn:sha1:421b84af9968e582f324899934f52b3df60381ee 2017-12-15T23:22:46+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-11-07T18:04:18+00:00 urn:sha1:02d2a0fb3a004238b5c15e02b0699824b385ee96 CPython 3.6 contains some backward incompatible changes, and further version(s) are expected to have more. As we anyway implemente 3.4 with some features of 3.5, refer to 3.5 docs to avoid confusion. Examples of 3.6 backward incompatibilities: https://docs.python.org/3.6/library/json.html#json.dump https://docs.python.org/3.6/library/json.html#json.load > Changed in version 3.6: All optional parameters are now keyword-only. https://docs.python.org/3.6/library/functions.html#type > Changed in version 3.6: Subclasses of type which don’t override > type.__new__ may no longer use the one-argument form to get the > type of an object. https://docs.python.org/3.6/library/collections.html#collections.namedtuple > Changed in version 3.6: The verbose and rename parameters became > keyword-only arguments. 2017-11-01T00:19:56+00:00 Damien George damien.p.george@gmail.com 2017-11-01T00:19:56+00:00 urn:sha1:fe45d78b1edd6d2202c3544797885cb0b12d4f03 2017-08-23T01:46:35+00:00 Damien George damien.p.george@gmail.com 2017-08-23T01:46:35+00:00 urn:sha1:1f78e7a43130acfa4bedf16c1007a1b0f37c75c3 2017-07-02T12:50:22+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-07-02T12:50:22+00:00 urn:sha1:90c1d54464498237912476d1f02b55b457575105 We don't use alpha/beta/RC, so for us version and release should be the same, or it leads to confusion (for example, current, 1.9.1 docs are marked as 1.9 at places). 2017-07-02T12:15:31+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-07-02T12:15:31+00:00 urn:sha1:ebce7984c66b4d977f4540506e243cf65a80db2f The idea is to allow to define a kind of "macros" for repeatitive text, so all occurrances can be updated in one place. Unfortunately, RST doesn't support replacements with arguments, which limits usefulness of them and should be taken into account. 2017-07-02T11:35:52+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-07-02T11:34:20+00:00 urn:sha1:5f0c56bcf1fcb7f2d36a0c420b4681a812047c59 As described at http://www.sphinx-doc.org/en/stable/ext/intersphinx.html#confval-intersphinx_mapping This will allow to explicitly refer to CPython docs for cross-references. 2017-07-01T17:01:05+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-07-01T17:01:05+00:00 urn:sha1:ef47dee4bfacaaff507775b7d4739a7901e8d352 It's useful to try different Sphinx versions using virtualenv/venv, so exclude a common venv dir name from Sphinx processing. 2017-06-24T21:57:44+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-06-24T21:57:44+00:00 urn:sha1:ba33c544bb9b5bd0476e07a12a34d2f72579075e This causes `symbol` syntax to be equivalent to :any:`symbol`, which is in turn the easiest way to cross-reference an arbitrary symbol in the docs: http://www.sphinx-doc.org/en/stable/markup/inline.html#role-any :any: requires at least Sphinx 1.3 (for reference, Ubuntu 16.03 ships with 1.3.6, the latest 1.6.3). Any many of our docs, `symbol` is misused to specify arguments to functions, etc. Refactoring that is in progress. (CODECONVENTIONS already specify proper syntax for both arguments and xrefs, based on CPython conventions). 2017-06-23T21:25:29+00:00 Paul Sokolovsky pfalcon@users.sourceforge.net 2017-06-23T21:25:29+00:00 urn:sha1:b50659e13775fbf44c5b8f4b1261fc8f46635321 Instead of default 2. 3 are required to access description of individual library modules.