Deprecate transforms.writer_aux.Compound.

This transform is not used since the retirement of the
"newlatex" writer in Dec 2010.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@8913 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 11 insertions, 0 deletions

diff --git a/docutils/docutils/transforms/writer_aux.py b/docutils/docutils/transforms/writer_aux.py
index fa0df1c9f..b33e056d7 100644
--- a/docutils/docutils/transforms/writer_aux.py
+++ b/docutils/docutils/transforms/writer_aux.py
@@ -14,6 +14,8 @@ conflicting imports like this one::
 
 __docformat__ = 'reStructuredText'
 
+import warnings
+
 from docutils import nodes, utils, languages
 from docutils.transforms import Transform
 
@@ -21,6 +23,9 @@ from docutils.transforms import Transform
 class Compound(Transform):
 
     """
+    .. warning:: This transform is not used by Docutils since Dec 2010
+                 and will be removed in Docutils 1.2 (or later).
+    
     Flatten all compound paragraphs.  For example, transform ::
 
         <compound>
@@ -36,6 +41,12 @@ class Compound(Transform):
     """
 
     default_priority = 910
+    
+    def __init__(self, document, startnode=None):
+        warnings.warn('docutils.transforms.writer_aux.Compound is deprecated'
+                      ' and will be removed in Docutils 1.2 or later.',
+                      DeprecationWarning, stacklevel=2)
+        super(Compound, self).__init__(document, startnode)
 
     def apply(self):
         for compound in self.document.findall(nodes.compound):