Python はまだ非常に新しいので、これが明らかな場合はご容赦ください。ただし、argparse がスクリプトで pydoc を実行できないことがわかりました。
"""
Script to blah blah blah
"""
import argparse
parser = argparse.ArgumentParser(description='Script to do something useful')
# If I uncomment this line, pydoc fails !
#args = parser.parse_args()
最後の行のコメントを外してpydoc scriptnameを実行すると、pydoc は書式設定された docstring を表示するだけでなく、何らかの方法でスクリプトを実行しようとしているように見えます ??
どこが間違っていますか?