Commit Graph

52 Commits

Author SHA1 Message Date
Dave Hylands
a9f3030371 docs: Add docs about REPL paste-mode and Control-C 2015-11-03 23:28:53 +00:00
Dave Hylands
98fb0bf68a docs: Move instructions on generating the documentation to docs/README.md 2015-11-03 23:28:27 +00:00
Mike Bryant
1bfa6ae6e4 README: Fix typo in package name. 2015-11-04 00:54:56 +03:00
Paul Sokolovsky
3833d3846d README: Adjust suggested path for generated docs. 2015-10-31 01:32:48 +03:00
Paul Sokolovsky
9d7ef05caf README: Document how to enable/build external dependencies. 2015-10-21 02:56:42 +03:00
nyov
fccbe9aa4d README.md: Document "Ctrl+D" shell exit. 2015-10-12 00:15:41 +01:00
Damien George
0334058fa4 Rename "Micro Python" to "MicroPython" in REPL, help, readme's and misc. 2015-10-12 00:06:25 +01:00
Paul Sokolovsky
5ab0a4a671 README: Add hint about "micropython --help".
Also, hint about possibility to adjust heap size.
2015-08-22 23:56:28 +03:00
Damien George
65dc960e3b unix-cpy: Remove unix-cpy. It's no longer needed.
unix-cpy was originally written to get semantic equivalent with CPython
without writing functional tests.  When writing the initial
implementation of uPy it was a long way between lexer and functional
tests, so the half-way test was to make sure that the bytecode was
correct.  The idea was that if the uPy bytecode matched CPython 1-1 then
uPy would be proper Python if the bytecodes acted correctly.  And having
matching bytecode meant that it was less likely to miss some deep
subtlety in the Python semantics that would require an architectural
change later on.

But that is all history and it no longer makes sense to retain the
ability to output CPython bytecode, because:

1. It outputs CPython 3.3 compatible bytecode.  CPython's bytecode
changes from version to version, and seems to have changed quite a bit
in 3.5.  There's no point in changing the bytecode output to match
CPython anymore.

2. uPy and CPy do different optimisations to the bytecode which makes it
harder to match.

3. The bytecode tests are not run.  They were never part of Travis and
are not run locally anymore.

4. The EMIT_CPYTHON option needs a lot of extra source code which adds
heaps of noise, especially in compile.c.

5. Now that there is an extensive test suite (which tests functionality)
there is no need to match the bytecode.  Some very subtle behaviour is
tested with the test suite and passing these tests is a much better
way to stay Python-language compliant, rather than trying to match
CPy bytecode.
2015-08-17 12:51:26 +01:00
Paul Sokolovsky
fe99ea9aab README: Add quick information about builtin upip package manager.
Also, simplify dependencies info now that we no longer require GNU
readline.
2015-06-22 20:06:12 +03:00
Paul Sokolovsky
fb4b800820 README: Mention esp8266 port. 2015-06-18 11:44:04 +03:00
Daniel Campora
0a903be7d0 README.md: Correct port names in the documentation build command. 2015-06-11 09:15:07 +02:00
Daniel Campora
cfcf47c064 docs: Add initial draft documentation for the WiPy.
This makes all common files "port-aware" using the .. only directive.
2015-06-10 23:37:56 +02:00
Daniel Campora
23008db6e1 README.md: Add the CC3200 port to the list of additional components. 2015-04-18 19:49:00 +02:00
Damien George
c0dcf6e878 README: Add note about pic16bit port. 2015-04-03 14:16:49 +01:00
Damien George
2a68c2c21b README.md: Add issuestats badges for PRs and issues. 2015-03-03 21:53:35 +00:00
Damien George
18fd7e8305 README.md: Change coveralls badge from travis-testing to master branch. 2015-03-01 15:12:00 +00:00
Damien George
81e661f28b travis: Add automated coverage testing using coveralls. 2015-03-01 14:50:09 +00:00
Paul Sokolovsky
d155fecf9e README.md: Update subdir descriptions. 2015-02-26 21:51:25 +02:00
Paul Sokolovsky
2330fe08fe README.md: Update list of supported Python types. 2015-02-24 16:40:15 +02:00
Paul Sokolovsky
8c437f95fc README.md: Promote project status from "early beta" to just "beta".
Also, reword purpose to avoid impression that uPy supports just one
microcontroller.
2015-02-24 16:31:00 +02:00
Damien George
3bdb23d4d3 README: Update link to logo. 2014-11-17 00:41:54 +00:00
evildmp
aec189a5ba docs: Add optional sphinx_rtd_theme; add docs build instructions.
The sphinx_rtd_theme is used by ReadTheDocs to render a pretty looking
documentation.  If you have this theme installed locally then your
locally-compiled docs will look exactly like the published
documentation.   Otherwise it falls back to the default theme.
2014-11-15 19:01:19 +00:00
Paul Sokolovsky
945df4e564 README: Update "unix" section with more info/details. 2014-10-11 20:45:32 +03:00
Tom von Clef
2090a98e80 Updating README.md to include the fact that the Unix build requires pkg-config to build the FFI module. 2014-10-08 17:26:03 -04:00
Damien George
5aac6aa445 README: Add USB VID/PID to dfu-util command.
This reflects how it's done in stmhal/Makefile, via deploy.
2014-07-31 18:45:34 +01:00
Damien George
aa7cf6f72f stm: Remove long-obsolete stm/ port. 2014-05-21 20:14:27 +01:00
Damien George
65114ca015 README: Add articles, and update doc for deploying firmware. 2014-05-09 12:00:23 +01:00
Paul Sokolovsky
ad79ecdf96 README: Add short overview of Python features supported.
Also, "upgrade" project to "early beta", and elaborate pyboard description.
2014-05-09 04:15:24 +03:00
Jonathan Greig
e71311ed87 Fixed Travis-CI Build Status Link in README.md 2014-04-14 21:52:22 -05:00
Damien George
98bd4f24ff Fix README build status image. 2014-04-14 21:33:31 +01:00
Damien George
15bbd251f6 Update README to include build status from Travis CI. 2014-04-14 21:30:53 +01:00
Paul Sokolovsky
ef79a82cec README: Update for modffi being enabled by default for unix port. 2014-04-13 09:54:54 +03:00
Damien George
d6c5d398fe Updated README. 2014-04-12 14:06:50 +01:00
Paul Sokolovsky
2ee7304cb8 README: Python is required during build process unconditionally.
Fixes #449.
2014-04-09 01:39:50 +03:00
Paul Sokolovsky
98dd6d7712 README: Be specific that ARMv7 Linux is supported. 2014-04-07 23:46:08 +03:00
Paul Sokolovsky
6693e6c506 README: ARM Linux is supported.
Retested again on Ubuntu 12.04 armhf running in chroot on Samsung
ARM Chromebook (Cortex-A15).
2014-04-03 22:30:45 +03:00
Damien George
a8dda295c4 Fix part->port in README. 2014-03-31 18:09:39 +01:00
Damien George
840efe0661 Update README. 2014-03-24 12:47:37 +00:00
Paul Sokolovsky
c839584222 Update README to current state of affairs.
1. Invite x86 (32-bit) users.
2. Update interpreter name.
3. Update dependency install instructions.
2014-02-17 01:26:39 +02:00
Damien George
f438b936e0 Small changes to README. 2014-01-19 18:18:43 +00:00
Damien George
24224d7c72 Make GitHub logo/image a JPEG so it's smaller. 2014-01-14 23:55:53 +00:00
Metallicow
7ab9c21945 Add combined image to GitHub front page README.md 2014-01-12 19:21:02 -06:00
Damien George
cdb310982e Change README to reflect new pyboard repo; update dependencies. 2014-01-02 18:28:16 +00:00
Edd Barrett
33fefc74a5 Mention that GNU make is required.
Does not build with BSD make.
2014-01-01 23:30:15 +00:00
Damien George
8bbd112938 Update README with disclaimer for changing code; use gmake on BSD. 2014-01-01 21:52:35 +00:00
Dr-Syn
31aa47d56a Update README.md
Updated to reflect build requirements for Ubuntu/Mint linuxes
2013-12-31 17:35:09 -08:00
Damien
a1c8e5737c Update README.md. 2013-12-29 18:54:20 +00:00
Damien
d0cad1905a Small edits to main README. 2013-12-22 22:43:10 +00:00
Damien
ba66a8fc57 Small changes to README. 2013-12-20 13:04:40 +00:00