'L{deprecated} takes an additional replacement parameter that can be used
to indicate the new, non-deprecated method developers should use.  If
the replacement parameter is a string, it will be interpolated directly
into the warning message.'

def test_deprecatedReplacement(self):

    version = Version('Twisted', 8, 0, 0)
    dummy = deprecated(version, 'something.foobar')(dummyCallable)
    self.assertEqual(dummy.__doc__, '\n                Do    nothing.\n\n                This    is    used    to    test    the    deprecation    decorators.\n\n                Deprecated    in    Twisted    8.0.0;    please    use    something.foobar    instead.\n                ')
