Python的官方文件

做為一個成功的程式語言，良好的文件是必不可少的，拜內建文件機制的功勞，Python的文件做得相當完備，我們在此介紹如何使用Python的官方文件。

首先要介紹的是Python官方文件的網站

Python官方文件

各種文件的種類

在該網站的頁面中，總共有以下的文件

• What's New in Python 2.5 (changes since previous major release)
  

• Tutorial (start here)
  

• Global Module Index (for quick access to all modules)
  

• Library Reference (keep this under your pillow)
  

• Macintosh Library Modules (this too, if you use a Macintosh)
  

• Language Reference (for language lawyers)
  

• Extending and Embedding (tutorial for C/C++ programmers)
  

• Python/C API (reference for C/C++ programmers)

• Documenting Python (information for documentation authors)
  

• Installing Python Modules (information for installers & sys-admins)
  

• Distributing Python Modules (sharing modules with others)

我們在下面一一介紹各種文件的用途

文件的用途

What's New in Python 2.5

在此文件中說明新版的Python到底做了什麼樣的改版，如果你之前曾學過較先前版本的Python，你會對此文件有興趣

Tutorial

Python官方版本的教學文件，做為學習Python的目的而言，這也是相當值得參考的一份教學

Global Module Index

瀏覽在Python中所有標準的全域Modules的索引

Library Reference

這是所有Python文件中最常被用到的一個，如同它上面所寫的"keep this under your pillow"(把這個放在你的枕頭下)，幾乎每當你要使用Python標準函式庫，及內建的物件和函數時，你就會需要查詢這份文件

Macintosh Library Modules

如果你使用的是蘋果電腦的麥金塔系統，你會需要這份針對麥金塔的Module的索引

Language Reference

這是Python語言的參考文件，說明Python的語法和一些規則，當你想用到某些語言特性時你可能會需要參考這個，例如class的特殊方法，__init__、__cmp__、__getattr__等等的定義

Extending and Embedding

當你需要用C/C++語言擴充Python(寫給Python用的C語言module)，或是將Python直譯器嵌在你的C/C++語言程式裡，你需要參考這份文件

Python/C API

Python的C語言API參考手冊

Documenting Python

說明Python文件的一些語法與格式

Installing Python Modules (information for installers & sys-admins)

安裝Python Module的相關文件

Distributing Python Modules

有關發佈Python Module的文件