是否可以在 Python 中使用 POD（普通旧文档）？

Question

我想知道是否可以在 Python 中使用 POD（普通旧文档）？ 我该怎么做？

Answer 1

似乎没有直接支持的方式在 Python 文件中使用 POD 内联。 但是，Python 模块（包括 Python 标准库）是使用reStructuredText记录的。 这通常使用Sphinx完成，它从 reStructuredText 格式的文档字符串生成文档。 Sphinx 和 rst 专门设计用于填补与 POD 类似的利基市场。

Answer 2

是的。 利用 '''。

#!/usr/bin/python3                                                                       

'''
=pod
                                                                                     
=head1 NAME
...
=cut
'''

import sys