Pydoc对-*- coding: utf-8 -*-的处理出了问题

Question

我使用Emacs编辑Python脚本，我总是在我的脚本开头添加这个：

#!/usr/bin/env python
# -*- coding: utf-8 -*-

在PEP 0236中，建议（至少不要反对）使用中文。

然而，我发现pydoc无法正确识别（忽略）它：

$ pydoc myscript.py
Help on module myscript:

NAME
    myscript - # -*- coding: utf-8 -*-

有没有修复这个问题的方法？或者有没有使用-*- coding: utf-8 -*-的好替代方法？

我正在使用Python 2.6。

- Frank

---

这对我来说看起来像是一个bug。你在pydoc上检查过它了吗？ - Burhan Khalid

@BurhanKhalid：我对Python比较新，我该如何检查呢？ - Frank

Answer 1

看起来如果您实际提供文档字符串，则编码行将被跳过。

文件内容：

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Documentation for myscript"""

pydoc输出：

$ pydoc myscript.py
Help on module myscript:

NAME
    myscript - Documentation for myscript

- Andrew Clark