QUERY · ISSUE

Copy code-emitter documentation from Kickstarter to docs.micropython.org

openby adritiumopened 2018-08-20updated 2024-07-27

docs

There is documentation of the different emitters at micropython.org but I still find myself going back to the Kickstarter page because there is a nice comparison between the 3 different emitters.

Someone should copy-paste from Kickstarter to docs.micropython.org

CANDIDATE · ISSUE

docs: Update native emitter limitations

closedby AmirHmZzopened 2023-01-12updated 2026-03-21

docs

According to docs native emitter has some limitations:

Context managers are not supported (the with statement).

Generators are not supported.

If raise is used an argument must be supplied.

But I've tested context managers and generators and they worked with native emitter correctly. As what @jimmo told me on discord:

I think these docs are out of date. the one thing that i know that isn't supported is "async with" but regular "with" works, as do generators

It would be better to update limitations of native emitter on docs.

Assessment

Q Qwen · high

Both issues concern documentation about the native code emitter in MicroPython. Issue #4066 requests adding a comparison of the three emitters (bytecode, native, and optimized) to the official docs. Issue #10476 requests updating the limitations section of the native emitter documentation to reflect current capabilities. While they both relate to the same documentation file (speed_python.rst) and the same component (native emitter), they address different specific documentation needs: one is about adding a comparison feature, the other is about correcting outdated limitation information. Neither resolves the other.

Suggested action

Keep both issues open as they address distinct documentation improvements. The maintainer may consider addressing both in a single documentation update PR if convenient.

Copy code-emitter documentation from Kickstarter to docs.micropython.org

docs: Update native emitter limitations

Keyboard