From: David G. <go...@us...> - 2002-08-02 03:31:18
|
Update of /cvsroot/docutils/web In directory usw-pr-cvs1:/tmp/cvs-serv23205/web Modified Files: rst.txt Log Message: Added quote from Eric Jones. Minor edits. Index: rst.txt =================================================================== RCS file: /cvsroot/docutils/web/rst.txt,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 *** rst.txt 1 Jul 2002 13:59:11 -0000 1.6 --- rst.txt 2 Aug 2002 03:31:15 -0000 1.7 *************** *** 83,87 **** Thanks to reST/DPS [now Docutils --ed], I'll soon be able to go ahead and apply the same tools for extracting documentation out of ! my python code. Hey, that's a printable and a browsable version *for free*! Personally, I consider this a large benefit. --- 83,87 ---- Thanks to reST/DPS [now Docutils --ed], I'll soon be able to go ahead and apply the same tools for extracting documentation out of ! my Python code. Hey, that's a printable and a browsable version *for free*! Personally, I consider this a large benefit. *************** *** 157,170 **** And it really is very very easy to write documents in it. I do ! belive that if I where ever to write a book (again) i would write it in ReST. And as far as I can tell from the specs, ReST solves most of the ! problems I have had with structured text. A few things gets a ! little more complicated and some get simpler. All in all a good bargain. ! I would certainly use it. I also hope that it gets integrated into ! Zope. `David Abrahams on Python-Dev, 2002-04-06`__: --- 157,170 ---- And it really is very very easy to write documents in it. I do ! belive that if I were ever to write a book (again) I would write it in ReST. And as far as I can tell from the specs, ReST solves most of the ! problems I have had with structured text. A few things gets a ! little more complicated and some get simpler. All in all a good bargain. ! I would certainly use it. I also hope that it gets integrated ! into Zope. `David Abrahams on Python-Dev, 2002-04-06`__: *************** *** 172,178 **** __ http://mail.python.org/pipermail/python-dev/2002-April/022443.html ! Incidentally, I'm really excited about reST. I've been looking for ! a tolerable markup for C++ comments, and reST looks like it might ! fit the bill. This being the Internet, there were plenty of people opposed to the --- 172,189 ---- __ http://mail.python.org/pipermail/python-dev/2002-April/022443.html ! Incidentally, I'm really excited about reST. I've been looking ! for a tolerable markup for C++ comments, and reST looks like it ! might fit the bill. ! ! `Eric Jones on Python-Dev, 2002-08-01`__: ! ! __ http://mail.python.org/pipermail/python-dev/2002-August/027198.html ! ! I would very much like to see reStructuredText, or some minor ! variation on it, move forward as a "standard" for doc-strings very ! soon. I have long lamented not having a prescribed format *and* ! an associated processing tool suite included in the standard ! library. Even if the format isn't perfect (I think it looks very ! good), it is time to pick a reasonable candidate and go. This being the Internet, there were plenty of people opposed to the |