python教程（八）函數文檔和標註

文檔字符串 以下是有關文檔字符串的內容和格式的一些約定。第一行應該是對象目的的簡要概述。爲簡潔起見，它不應顯式聲明對象的名稱或類型，因爲這些可通過其他方式獲得（除非名稱恰好是描述函數操作的動詞）。這一行應以大寫字母開頭，以句點結尾。   如果文檔字符串中有更多行，則第二行應爲空白，從而在視覺上將摘要與其餘描述分開。後面幾行應該是一個或多個段落，描述對象的調用約定，它的副作用等。   Python解

>>阅读原文<<