docs: Change "Micro Python" to "MicroPython" in all places in docs.

This commit is contained in:
Damien George 2015-06-04 23:53:26 +01:00
parent 601cfea6a3
commit 3eece29807
17 changed files with 47 additions and 47 deletions

View File

@ -1,7 +1,7 @@
#!/usr/bin/env python3 #!/usr/bin/env python3
# -*- coding: utf-8 -*- # -*- coding: utf-8 -*-
# #
# Micro Python documentation build configuration file, created by # MicroPython documentation build configuration file, created by
# sphinx-quickstart on Sun Sep 21 11:42:03 2014. # sphinx-quickstart on Sun Sep 21 11:42:03 2014.
# #
# This file is execfile()d with the current directory set to its # This file is execfile()d with the current directory set to its
@ -50,7 +50,7 @@ source_suffix = '.rst'
master_doc = 'index' master_doc = 'index'
# General information about the project. # General information about the project.
project = 'Micro Python' project = 'MicroPython'
copyright = '2014, Damien P. George' copyright = '2014, Damien P. George'
# The version info for the project you're documenting, acts as replacement for # The version info for the project you're documenting, acts as replacement for
@ -213,7 +213,7 @@ latex_elements = {
# (source start file, target name, title, # (source start file, target name, title,
# author, documentclass [howto, manual, or own class]). # author, documentclass [howto, manual, or own class]).
latex_documents = [ latex_documents = [
('index', 'MicroPython.tex', 'Micro Python Documentation', ('index', 'MicroPython.tex', 'MicroPython Documentation',
'Damien P. George', 'manual'), 'Damien P. George', 'manual'),
] ]
@ -243,7 +243,7 @@ latex_documents = [
# One entry per manual page. List of tuples # One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section). # (source start file, name, description, authors, manual section).
man_pages = [ man_pages = [
('index', 'micropython', 'Micro Python Documentation', ('index', 'micropython', 'MicroPython Documentation',
['Damien P. George'], 1), ['Damien P. George'], 1),
] ]
@ -257,7 +257,7 @@ man_pages = [
# (source start file, target name, title, author, # (source start file, target name, title, author,
# dir menu entry, description, category) # dir menu entry, description, category)
texinfo_documents = [ texinfo_documents = [
('index', 'MicroPython', 'Micro Python Documentation', ('index', 'MicroPython', 'MicroPython Documentation',
'Damien P. George', 'MicroPython', 'One line description of project.', 'Damien P. George', 'MicroPython', 'One line description of project.',
'Miscellaneous'), 'Miscellaneous'),
] ]

View File

@ -1,5 +1,5 @@
Micro Python documentation contents MicroPython documentation contents
=================================== ==================================
.. only:: port_pyboard .. only:: port_pyboard

View File

@ -1,5 +1,5 @@
Micro Python documentation and references MicroPython documentation and references
========================================= ========================================
.. only:: port_pyboard .. only:: port_pyboard

View File

@ -1,7 +1,7 @@
Micro Python libraries MicroPython libraries
====================== =====================
Functionality specific to the Micro Python implementation is available in Functionality specific to the MicroPython implementation is available in
the following library. the following library.
.. toctree:: .. toctree::
@ -12,7 +12,7 @@ the following library.
Python standard libraries Python standard libraries
------------------------- -------------------------
The following standard Python libraries are built in to Micro Python. The following standard Python libraries are built in to MicroPython.
For additional libraries, please download them from the `micropython-lib repository For additional libraries, please download them from the `micropython-lib repository
<https://github.com/micropython/micropython-lib>`_. <https://github.com/micropython/micropython-lib>`_.
@ -33,7 +33,7 @@ Python micro-libraries
---------------------- ----------------------
The following standard Python libraries have been "micro-ified" to fit in with The following standard Python libraries have been "micro-ified" to fit in with
the philosophy of Micro Python. They provide the core functionality of that the philosophy of MicroPython. They provide the core functionality of that
module and are intended to be a drop-in replacement for the standard Python module and are intended to be a drop-in replacement for the standard Python
library. library.

View File

@ -1,8 +1,8 @@
:mod:`micropython` -- access and control Micro Python internals :mod:`micropython` -- access and control MicroPython internals
=============================================================== ==============================================================
.. module:: micropython .. module:: micropython
:synopsis: access and control Micro Python internals :synopsis: access and control MicroPython internals
Functions Functions
--------- ---------

View File

@ -38,7 +38,7 @@ To check if there is anything to be read, use::
uart.any() # returns True if any characters waiting uart.any() # returns True if any characters waiting
*Note:* The stream functions ``read``, ``write``, etc. are new in Micro Python v1.3.4. *Note:* The stream functions ``read``, ``write``, etc. are new in MicroPython v1.3.4.
Earlier versions use ``uart.send`` and ``uart.recv``. Earlier versions use ``uart.send`` and ``uart.recv``.
Constructors Constructors

View File

@ -39,7 +39,7 @@ Constants
.. data:: platform .. data:: platform
The platform that Micro Python is running on. This is "pyboard" on the The platform that MicroPython is running on. This is "pyboard" on the
pyboard and provides a robust way of determining if a script is running pyboard and provides a robust way of determining if a script is running
on the pyboard or not. on the pyboard or not.

View File

@ -1,5 +1,5 @@
Micro Python license information MicroPython license information
================================ ===============================
The MIT License (MIT) The MIT License (MIT)

View File

@ -1,12 +1,12 @@
Inline assembler Inline assembler
================ ================
Here you will learn how to write inline assembler in Micro Python. Here you will learn how to write inline assembler in MicroPython.
**Note**: this is an advanced tutorial, intended for those who already **Note**: this is an advanced tutorial, intended for those who already
know a bit about microcontrollers and assembly language. know a bit about microcontrollers and assembly language.
Micro Python includes an inline assembler. It allows you to write MicroPython includes an inline assembler. It allows you to write
assembly routines as a Python function, and you can call them as you would assembly routines as a Python function, and you can call them as you would
a normal Python function. a normal Python function.
@ -23,7 +23,7 @@ Let's start with the simplest example::
You can enter this in a script or at the REPL. This function takes no You can enter this in a script or at the REPL. This function takes no
arguments and returns the number 42. ``r0`` is a register, and the value arguments and returns the number 42. ``r0`` is a register, and the value
in this register when the function returns is the value that is returned. in this register when the function returns is the value that is returned.
Micro Python always interprets the ``r0`` as an integer, and converts it to an MicroPython always interprets the ``r0`` as an integer, and converts it to an
integer object for the caller. integer object for the caller.
If you run ``print(fun())`` you will see it print out 42. If you run ``print(fun())`` you will see it print out 42.

View File

@ -1,7 +1,7 @@
.. _tutorial-index: .. _tutorial-index:
Micro Python tutorial MicroPython tutorial
===================== ====================
This tutorial is intended to get you started with your pyboard. This tutorial is intended to get you started with your pyboard.
All you need is a pyboard and a micro-USB cable to connect it to All you need is a pyboard and a micro-USB cable to connect it to

View File

@ -24,7 +24,7 @@ As long as you take care of the hardware, you should be okay. It's almost
impossible to break the software on the pyboard, so feel free to play around impossible to break the software on the pyboard, so feel free to play around
with writing code as much as you like. If the filesystem gets corrupt, see with writing code as much as you like. If the filesystem gets corrupt, see
below on how to reset it. In the worst case you might need to reflash the below on how to reset it. In the worst case you might need to reflash the
Micro Python software, but that can be done over USB. MicroPython software, but that can be done over USB.
Layout of the pyboard Layout of the pyboard
--------------------- ---------------------

View File

@ -23,7 +23,7 @@ For circuit schematics and datasheets for the components on the skin see :ref:`h
Using the LCD Using the LCD
------------- -------------
To get started using the LCD, try the following at the Micro Python prompt. To get started using the LCD, try the following at the MicroPython prompt.
Make sure the LCD skin is attached to the pyboard as pictured at the top of this page. :: Make sure the LCD skin is attached to the pyboard as pictured at the top of this page. ::
>>> import pyb >>> import pyb

View File

@ -44,7 +44,7 @@ Next we will set up an infinite loop that cycles through each of the LEDs turnin
Here, n keeps track of the current LED and every time the loop is executed we cycle to the next n (the % sign is a modulus operator that keeps n between 0 and 3.) Then we access the nth LED and toggle it. If you run this you should see each of the LEDs turning on then all turning off again in sequence. Here, n keeps track of the current LED and every time the loop is executed we cycle to the next n (the % sign is a modulus operator that keeps n between 0 and 3.) Then we access the nth LED and toggle it. If you run this you should see each of the LEDs turning on then all turning off again in sequence.
One problem you might find is that if you stop the script and then start it again that the LEDs are stuck on from the previous run, ruining our carefully choreographed disco. We can fix this by turning all the LEDs off when we initialise the script and then using a try/finally block. When you press CTRL-C, Micro Python generates a VCPInterrupt exception. Exceptions normally mean something has gone wrong and you can use a try: command to "catch" an exception. In this case it is just the user interrupting the script, so we don't need to catch the error but just tell Micro Python what to do when we exit. The finally block does this, and we use it to make sure all the LEDs are off. The full code is:: One problem you might find is that if you stop the script and then start it again that the LEDs are stuck on from the previous run, ruining our carefully choreographed disco. We can fix this by turning all the LEDs off when we initialise the script and then using a try/finally block. When you press CTRL-C, MicroPython generates a VCPInterrupt exception. Exceptions normally mean something has gone wrong and you can use a try: command to "catch" an exception. In this case it is just the user interrupting the script, so we don't need to catch the error but just tell MicroPython what to do when we exit. The finally block does this, and we use it to make sure all the LEDs are off. The full code is::
leds = [pyb.LED(i) for i in range(1,5)] leds = [pyb.LED(i) for i in range(1,5)]
for l in leds: for l in leds:

View File

@ -1,8 +1,8 @@
Getting a Micro Python REPL prompt Getting a MicroPython REPL prompt
================================== =================================
REPL stands for Read Evaluate Print Loop, and is the name given to the REPL stands for Read Evaluate Print Loop, and is the name given to the
interactive Micro Python prompt that you can access on the pyboard. Using interactive MicroPython prompt that you can access on the pyboard. Using
the REPL is by far the easiest way to test out your code and run commands. the REPL is by far the easiest way to test out your code and run commands.
You can use the REPL in addition to writing scripts in ``main.py``. You can use the REPL in addition to writing scripts in ``main.py``.
@ -59,11 +59,11 @@ or use sudo).
Using the REPL prompt Using the REPL prompt
--------------------- ---------------------
Now let's try running some Micro Python code directly on the pyboard. Now let's try running some MicroPython code directly on the pyboard.
With your serial program open (PuTTY, screen, picocom, etc) you may see a blank With your serial program open (PuTTY, screen, picocom, etc) you may see a blank
screen with a flashing cursor. Press Enter and you should be presented with a screen with a flashing cursor. Press Enter and you should be presented with a
Micro Python prompt, i.e. ``>>>``. Let's make sure it is working with the obligatory test:: MicroPython prompt, i.e. ``>>>``. Let's make sure it is working with the obligatory test::
>>> print("hello pyboard!") >>> print("hello pyboard!")
hello pyboard! hello pyboard!
@ -93,7 +93,7 @@ Resetting the board
------------------- -------------------
If something goes wrong, you can reset the board in two ways. The first is to press CTRL-D If something goes wrong, you can reset the board in two ways. The first is to press CTRL-D
at the Micro Python prompt, which performs a soft reset. You will see a message something like :: at the MicroPython prompt, which performs a soft reset. You will see a message something like ::
>>> >>>
PYB: sync filesystems PYB: sync filesystems

View File

@ -101,5 +101,5 @@ on the right edge.
When you press RST the green LED will flash quickly, and then the blue When you press RST the green LED will flash quickly, and then the blue
LED should turn on and stay on. LED should turn on and stay on.
Congratulations! You have written and run your very first Micro Python Congratulations! You have written and run your very first MicroPython
program! program!

View File

@ -1,4 +1,4 @@
/* custom CSS for Micro Python docs /* custom CSS for MicroPython docs
*/ */
.admonition-difference-to-cpython { .admonition-difference-to-cpython {

View File

@ -1,10 +1,10 @@
{% extends "defindex.html" %} {% extends "defindex.html" %}
{% block body %} {% block body %}
<h1>Micro Python documentation</h1> <h1>MicroPython documentation</h1>
<p> <p>
{{ _('Welcome! This is the documentation for Micro Python') }} {{ _('Welcome! This is the documentation for MicroPython') }}
v{{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}. v{{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}.
</p> </p>
@ -21,7 +21,7 @@
{% endfor %}. {% endfor %}.
</p--> </p-->
<p><strong>Documentation for Micro Python and the pyboard:</strong></p> <p><strong>Documentation for MicroPython and the pyboard:</strong></p>
<table class="contentstable"><tr> <table class="contentstable"><tr>
<td width="40%" style="padding-left:2em;"> <td width="40%" style="padding-left:2em;">
@ -41,7 +41,7 @@
{% endif %} {% endif %}
<p class="biglink"> <p class="biglink">
<a class="biglink" href="{{ pathto("library/index") }}">Library Reference</a><br/> <a class="biglink" href="{{ pathto("library/index") }}">Library Reference</a><br/>
<span class="linkdescr">Micro Python libraries, including the <a href="{{ pathto("library/pyb") }}">pyb module</a></span> <span class="linkdescr">MicroPython libraries, including the <a href="{{ pathto("library/pyb") }}">pyb module</a></span>
</p> </p>
</td> </td>
<td width="40%" style="padding-left:2em;"> <td width="40%" style="padding-left:2em;">
@ -57,7 +57,7 @@
{% endif %} {% endif %}
<p class="biglink"> <p class="biglink">
<a class="biglink" href="{{ pathto("license") }}">License</a><br/> <a class="biglink" href="{{ pathto("license") }}">License</a><br/>
<span class="linkdescr">Micro Python license information</span> <span class="linkdescr">MicroPython license information</span>
</p> </p>
</td> </td>
</tr></table> </tr></table>
@ -87,17 +87,17 @@
<table class="contentstable"><tr> <table class="contentstable"><tr>
<td width="40%" style="padding-left:2em;"> <td width="40%" style="padding-left:2em;">
<p class="biglink"> <p class="biglink">
<a class="biglink" href="http://micropython.org">Micro Python homepage</a><br/> <a class="biglink" href="http://micropython.org">MicroPython homepage</a><br/>
<span class="linkdescr">the official Micro Python site</span> <span class="linkdescr">the official MicroPython site</span>
</p> </p>
<p class="biglink"> <p class="biglink">
<a class="biglink" href="http://forum.micropython.org">Micro Python forum</a><br/> <a class="biglink" href="http://forum.micropython.org">MicroPython forum</a><br/>
<span class="linkdescr">community discussion for all things related to Micro Python</span> <span class="linkdescr">community discussion for all things related to MicroPython</span>
</p> </p>
</td> </td>
<td width="40%" style="padding-left:2em;"> <td width="40%" style="padding-left:2em;">
<p class="biglink"> <p class="biglink">
<a class="biglink" href="https://github.com/micropython">Micro Python on GitHub</a><br/> <a class="biglink" href="https://github.com/micropython">MicroPython on GitHub</a><br/>
<span class="linkdescr">contribute to the source code on GitHub</span> <span class="linkdescr">contribute to the source code on GitHub</span>
</p> </p>
</td> </td>