マークアップは空白行なしで終了します。しかし、マークアップはコメント内のものだけです

Question

私のpythonコードを文書化するときに、私はデコレータをマークして、docstringも更新することにしました。関数にドキュメントがあるのに、スフィンクスが文句を言わずにdeprecatedのドキュメントが正しく表示されない場合、これはうまく動作します。

私は同等のコードにまで問題を縮小している：スフィンクスはWARNING: Explicit markup ends without a blank line; unexpected unindent.と文句を言い、この場合

def func(): 
    """.. deprecated:: 0.1.0 
    Please use :func:`func_new` 

    """ 

def func(): 
    """ 
    .. deprecated:: 0.1.0 
     Please use :func:`func_new` 

    """ 

：

def func(): 
    """.. deprecated:: 0.1.0 
    Please use :func:`func_new` 

    """ 

これらは、私は成功せずしようとしているすべてのバリエーションです。最後に何本の空行があるか、行の前に空白があるかどうかは関係ありません。

私はドキュメントがOKだった場合には警告を気に代わり、私は任意の（目に見える）を追加することなく、これを解決するにはどうすればよい

Module.func(): 
    Deprecated since version 0.1.0: Please use :func:`func_new` 

出力は

Module.func(): 
    Deprecated since version 0.1.0. 

    Please use :func:`func_new` 

で生産するのではないでしょうdocstringへのテキスト？

Answer 1

jonrsharpeは、献身的に正しい方向に私を指摘しました。

説明文字列は、まさにこのようにする必要があります

def func(): 
    """ 
    .. deprecated:: 0.1.0 
     Please use :func:`func_new` 

    """ 

二次の行にスペース、および.. deprecatedが開始"""ブロックと一致する必要があります。 """と同じ行で開始することはできません。

の前に文章献立を添付して.. deprecatedの前に問題を修正しました。