Build instructions

[Daniel Augot]

Provide build instructions ! Remember that the first months I had no clue of what was going on because I could not see or run anything. It is very important for a beginner not to be stuck when trying the examples page, which will of course not run in standard sage, This difficulty could drive interested people away.

[Daniel Augot]

At home, using a wireless connextion and a SSD disk, and a powerful laptop, the full install procedure goes as follows:

• git clone takes 6m13s.
• time make fails at some point with

[coercion ] reading sources... [ 50%] sage/structure/coerce
Error building the documentation.
Traceback (most recent call last):
  File "/home/augot/tmp/sage_coding_project/src/doc/common/builder.py", line 1618, in <module>
    getattr(get_builder(name), type)()
  File "/home/augot/tmp/sage_coding_project/src/doc/common/builder.py", line 292, in _wrapper
    getattr(get_builder(document), 'inventory')(*args, **kwds)
  File "/home/augot/tmp/sage_coding_project/src/doc/common/builder.py", line 503, in _wrapper
    x.get(99999)
  File "/home/augot/tmp/sage_coding_project/local/lib/python/multiprocessing/pool.py", line 558, in get
    raise self._value
OSError: [coding   ] /home/augot/tmp/sage_coding_project/local/lib/python2.7/site-packages/sage/coding/linear_code.py:docstring of sage.coding.linear_code.LinearCode.decode_to_code:6: WARNING: Bullet list ends without a blank line; unexpected unindent.

Makefile:60: recipe for target 'doc-html' failed
make: *** [doc-html] Error 1

real    136m53.558s
user    109m13.893s
sys 8m19.088s

• A second time make succeeds with

Done building the documentation!

real    6m17.404s
user    5m53.241s
sys 0m16.503s

• the required disk space is 5,3 Gbytes

[David Lucas]

Done, see : https://bitbucket.org/lucasdavid/sage_coding_project/wiki/Installation_guide