README: More instructions.

README.md

@@ -1,21 +1,58 @@
 ~~~~
-!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 micropython-lib is highly experimental community project.
 
-Please help to drive it to just "expiremental" state by testing provided
+Please help to drive it to just "expiremental" state by testing
-packages with MicroPython.
+provided packages with MicroPython.
-!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 ~~~~
 
 micropython-lib
 ===============
-
 micropython-lib is a project to develop non-monolothic standard library
 for MicroPython. Each module or package is available as a seprate
 distribution package from PyPI. Modules either written from scratch or
-ported from CPython.
+ported from CPython. Note that main target of micropython-lib is so
+far "Unix" port of MicroPython. Actual requirements vary per module
+(basicly, if module is not related to I/O, it should work without
+problem on baremetal ports too).
 
+Usage
+-----
+micropython-lib packages are published on PyPI (Python Package Index),
+standard Python community package repository: http://pypi.python.org/ .
+You can search for MicroPython related packages, read additional info,
+etc.
+
+To install packages from PyPI for usage on your local system, use
+"pip-micropython" tool, which is a simple wrapper around a standard
+"pip" tool, which is used to install package for CPython.
+"pip-micropython" tool can be found in "tools" subdirectory of the main
+MicroPython repository (https://github.com/micropython/micropython).
+Just install "pip-micropython" script somewhere on your PATH.
+
+Afterwards, just use pip-micropython in a way similar to pip:
+
+~~~~
+$ pip-micropython install micropython-copy
+$ micropython
+>>> import copy
+>>> copy.copy([1, 2, 3])
+[1, 2, 3]
+~~~~
+
+Review pip-micropython source code for more info.
+
+Development
+-----------
+To install modules during development, use "make install". By default, it
+will install all available packages. You can pass MOD=<module> parameter
+to install specific module.
+
+Links
+-----
 More info:
+
  * https://github.com/micropython/micropython/issues/405
  * http://forum.micropython.org/viewtopic.php?f=5&t=70