Creates a diff highlighting changes between two reStructuredText inputs
rstdiff takes two reStructuredText documents as input, does a structural comaprison on them and produces an annotated result highlighting the changes. rstdiff “understands” reStructuredText and therefore is able to care for the subtleties of such a comparison the result is usually much more useful than a plain source diff.
The result is then written by a Docutils writer. Use the –writer option to select a writer for the result.
rstdiff uses the standard Distutils package. Thus the installation is done with something like:
python setup.py install
rstdiff.py [options]… old-reST [new-reST [diff-output]]
Generates a structural diff from two reStructuredText input documents and produces an annotated result.
--writer=WRITER Select writer to write output with (default "xml"). --old Following options apply to the old input document (default: both input documents). --new Following options apply to the new input document (default: both input documents). --both Following options apply to both input documents (default). --compare-sections-by-names Compare sections by comparing their names (default); useful when section titles are stable but sections change --compare-sections-normally Compare sections normally; useful when section titles change
- Original Source
rstdiff is available from
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.