summaryrefslogtreecommitdiff
path: root/sandbox/rstdiff/README.txt
blob: 0d7c42fec2ccb0b937c5a47f321c4ad3bea661d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
==============
rstdiff README
==============

Overview
========

`rstdiff.py` takes two reStructuredText documents as input, does a
structural comaprison on them and produces an annotated result
highlighting the changes. `rstdiff.py` "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.

Installation
============

`rstdiff.py` uses the standard Distutils package. Thus the
installation is done with something like::

  python setup.py install