#NEWLINE# def _getDeprecationDocstring( version , replacement = None ) : #NEWLINE# #INDENT# '\n    Generate an addition to a deprecated object\'s docstring that explains its\n    deprecation.\n\n    @param version: the version it was deprecated.\n    @type version: L{Version}\n\n    @param replacement: The replacement, if specified.\n    @type replacement: C{str} or callable\n\n    @return: a string like "Deprecated in Twisted 27.2.0; please use\n        twisted.timestream.tachyon.flux instead."\n    ' #NEWLINE# doc = ( 'Deprecated in %s' % ( version , ) ) #NEWLINE# if replacement : #NEWLINE# #INDENT# doc = ( '%s; %s' % ( doc , _getReplacementString ( replacement ) ) ) #NEWLINE# #UNINDENT# return ( doc + '.' )