README: Update to the current state of affairs (pip-micropython -> upip, etc.)

README.md

@@ -1,53 +1,55 @@
 micropython-lib
 ===============
 micropython-lib is a project to develop a non-monolothic standard library
-for MicroPython. Each module or package is available as a separate
-distribution package from PyPI. Each module is either written from scratch or
-ported from CPython. 
+for MicroPython (https://github.com/micropython/micropython). Each module
+or package is available as a separate distribution package from PyPI. Each
+module is either written from scratch or ported from CPython.
 
-Note that the main target of micropython-lib is a "Unix" port of MicroPython
-(additional ports to support are to be determined). Actual system requirements
-vary per module. Though if a module is not related to I/O, the module should
-work without problem on bare-metal ports too (e.g. pyboard).
+Note that the main target of micropython-lib is a "Unix" port of MicroPython.
+Actual system requirements vary per module. Though if a module is not related
+to I/O, the module should work without problems on bare-metal ports too (e.g.
+pyboard).
 
 
 Usage
 -----
 micropython-lib packages are published on PyPI (Python Package Index),
 the standard Python community package repository: http://pypi.python.org/ .
-On PyPi, you can search for MicroPython related packages and read
+On PyPI, you can search for MicroPython related packages and read
 additional package information.
 
 To install packages from PyPI for usage on your local system, use the
-`pip-micropython` tool, which is a simple wrapper around the standard
-`pip` tool, which is used to install packages for CPython.
-The `pip-micropython` tool can be found in `tools` subdirectory 
-of the main MicroPython repository (https://github.com/micropython/micropython).
-Just install the `pip-micropython` script somewhere on your `PATH`.
-
-Afterwards, just use `pip-micropython` in a way similar to `pip`:
+`upip` tool, which is MicroPython's native package manager, similar to
+`upip`, which is used to install packages for CPython. `upip` is bundled
+with MicroPython "Unix" port (i.e. if you build "Unix" port, you
+automatically have `upip` tool). Following examples assume that
+`micropython` binary is available on your `PATH`:
 
 ~~~~
-$ pip-micropython install micropython-copy
+$ micropython -m upip install micropython-pystone
+...
 $ micropython
->>> import copy
->>> copy.copy([1, 2, 3])
-[1, 2, 3]
+>>> import pyston
+>>> pystone.main()
+Pystone(1.2) time for 50000 passes = 0.534
+This machine benchmarks at 93633 pystones/second
 ~~~~
 
-Review the `pip-micropython` source code for more info.
+Run `micropython -m upip --help` for more information about `upip`.
 
 
 Development
 -----------
 To install modules during development, use `make install`. By default, all
-available packages will be installed. To install a specific module, add the 
+available packages will be installed. To install a specific module, add the
 `MOD=<module>` parameter to the end of the `make install` command.
 
 
 Links
 -----
-More information is on GitHub and in the MicroPython forums:
+If you would like to trace evolution of MicroPython packaging support,
+you may find following links useful (note that they may contain outdated
+information):
 
  * https://github.com/micropython/micropython/issues/405
  * http://forum.micropython.org/viewtopic.php?f=5&t=70