[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