質問: 1 `:param [変数名]:` はコード中でどんな役割をするのでしょうか? 日本語サイトであれば、 ()(python paramで検索しヒット) が、おそらく参考になると思うのですが、読んでもいまいちつかめません。 少しかみ砕いた説明が欲しいです。 文脈として全コードを以下に掲載します。 ``` def bottles_of_beer(bob): """ Prints Bottle of Beer on the Wall lyrics. :param bob: Must be a positive integer. """ if bob<1: print("""No more bottle of beer on the wall. No more bottles of beer.""") return tmp=bob bob-=1 print("""{} bottles of beer on the wall. {} bottles of beer. Take one down,pass it around, {} bottles of beer on the wall. """.format(tmp,tmp,bob)) bottles_of_beer(bob) bottles_of_beer(99) ``` 2また、このコードでreturn以下が空白となっていますが、デフォルト(?)では何を実行すべきという意味になるのでしょうか?
回答: `:param : ` はSphinxで処理されるドキュメントの記法で、情報フィールドリストと言います。 Pythonの多くのライブラリはSphinxでドキュメント生成を行っているため、docstringの書き方の中にも情報フィールドリストが広く使われています。また、PyCharmなどのIDEもこの情報フィールドリストを解釈してくれます。このような理由から、Sphinxを使わないプロジェクトのdocstringであっても情報フィールドリストの書き方を踏襲しているプロジェクトもあります。