[Numpy-discussion] reshape docstrings conflicting

Pauli Virtanen pav at iki.fi
Sat Apr 26 15:01:09 EDT 2008


Hi Chuck,

Charles R Harris wrote:
[clip]
> I noticed that you removed the ReST markup of the tables in sort
> documentation. I think you should leave it in.

Also the simplified table syntax

======== ======== ========
header 1 header 2 header 3
======== ======== ========
line 1a  line 1b  line 1c
line 2a  line 2b  line 2c
======== ======== ========

is valid ReST [1], and easier to type and IMHO to read than the gridded
tables:

+----------+----------+----------+
| header 1 | header 2 | header 3 |
+==========+==========+==========+
| line 1a  | line 1b  | line 1c  |
| line 2a  | line 2b  | line 2c  |
+----------+----------+----------+

If you strongly prefer the gridded syntax, I can revert it back.

	Pauli

.. [1]
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables




More information about the NumPy-Discussion mailing list