POD vs. reST for standalone writing?

David Abrahams dave at boost-consulting.com
Tue Apr 29 21:55:12 EDT 2003


> Now I start seeing mention of reStructuredText (especially in comments
> about pyCon.)  reST files look very "ascii art" on the input side, but
> after a little experiment, that seems to make them *harder* to write,
> if somewhat (and I think only a little) easier to read. 
>
> Am I missing something?  Is there actually a reST clear short hand,
> and a tool that expands it to full-blown ascii-art?  Or is at least
> fuzzy in the counting of dashes and other punctuation for marking
> different levels?

ReST rocks.  I'm using it to write a book, and think that it comes
out very readably and is miles easier to write than any tweaky **ML
or TeX.

An example of something recent (not from the book):
http://www.boost-consulting.com/writing/new-iter-concepts.html

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com




More information about the Python-list mailing list