2012-03-04 51 views
7

「新增功能」部分,留言板,社區等等都很棒,但是當我閱讀過的參考文獻,熟悉的文檔,可能永遠不會發生的情況再看一遍(或者認爲我不需要),獲得重大更新。我擔心當創建一些新的有見識的例子或更完整的文檔時,我可能會錯過一些有用的東西。也許,即使是刪除不正確或令人困惑的文檔(GASP!)。如何查看CPython文檔發生更改/增強的情況

不要誤解我的意思,在Google搜索,堆棧溢出,PEP和相互關聯的文檔之間,我通常能夠非常快速地得到儘可能多的細節。但是,當我熟悉該語言時,如果經常使用這些文檔,我肯定會審閱這些文檔的增強功能。

有沒有可用於查找此類信息的資源?

+0

我想說,密切關注PEP是保持與重大變化保持聯繫的最佳方式。 – 2012-03-05 09:52:17

+0

@Lattyware聽起來像一個合理的策略,但你能提供你的理由嗎? – 2012-03-05 15:49:28

回答

5

如果添加或更改了功能,我們會向文檔添加「版本更改」或「版本添加」條目。

如果您希望(聽起來像您一樣)監視我們改進文檔的位置,那麼一種方法是訂閱python-checkins郵件列表,然後在您的電子郵件程序中添加一個篩選器以僅捕獲檢查更新Doc子樹。

或者,您可以對項目進行hg檢出,並定期對Doc子樹運行'hg log',然後仔細查看任何對您感興趣的修訂。

或者,通過結賬,您可以定期在最後一次修訂版本和最新版本之間執行Doc目錄的'hg diff'。

2

要查看哪些文件和多少,因爲給定的修訂版已經改變:

$ hg diff --stat -r v3.3.0a1 Doc 
Doc/library/copyreg.rst | 8 ++++-- 
Doc/library/pickle.rst | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
2 files changed, 66 insertions(+), 3 deletions(-) 

要通過改變脫脂:

$ hg diff -r v3.3.0a1 Doc | less 

如果您發現感興趣的你可以view them online變化。

相關問題