Windows 7 - 来自 cmd 的 pydoc

Question

好吧，我正经历过这样的时刻，让我怀疑自己使用计算机的能力。这不是我想象中在我的第一篇 SO 帖子中提出的问题，但这里是。

自从我在中断 10 年之后一直想重新开始编程以来，我就开始学习 Zed 的新书《艰难地学习 Python》，而 Python 一直是我想要的。这本书确实对我说话了。话虽这么说，我在命令中遇到了 pydoc 的严重问题。我的系统路径中已包含 c:/python26 中的所有目录，并且无论密码如何，我都可以从命令行执行 pydoc - 但它不接受任何参数。无论我输入什么，我都会得到标准的 pydoc 输出，告诉我可接受的参数。

有什么想法吗？无论如何，我按照 Zed 的建议安装了 ActivePython。

C:\Users\Chevee>pydoc file
pydoc - the Python documentation tool

pydoc.py <name> ...
    Show text documentation on something.  <name> may be the name of a
    Python keyword, topic, function, module, or package, or a dotted
    reference to a class or function within a module or module in a
    package.  If <name> contains a '\', it is used as the path to a
    Python source file to document. If name is 'keywords', 'topics',
    or 'modules', a listing of these things is displayed.

pydoc.py -k <keyword>
    Search for a keyword in the synopsis lines of all available modules.

pydoc.py -p <port>
    Start an HTTP server on the given port on the local machine.

pydoc.py -g
    Pop up a graphical interface for finding and serving documentation.

pydoc.py -w <name> ...
    Write out the HTML documentation for a module to a file in the current
    directory.  If <name> contains a '\', it is treated as a filename; if
    it names a directory, documentation is written for all the contents.


C:\Users\Chevee>

编辑：新信息，pydoc 在 PowerShell 中工作得很好。作为一名 Linux 用户，我不知道为什么我要尝试使用 cmd ——但我仍然想弄清楚 pydoc 和 cmd 是怎么回事。

编辑2：更多新信息。在cmd...

c:\>python c:/python26/lib/pydoc.py file

...工作得很好。仅使用 PowerShell 中的 pydoc 一切就可以正常工作，无需担心 pwd、扩展名或路径。

Answer 1

在 Windows Powershell 中使用： python -m pydoc

示例：

python -m pydoc open

python -m pydoc raw_input

python -m pydoc argv

Answer 2

当您在Windows命令提示符下键入文件名时，cmd可以检查Windows注册表中的默认文件关联，并使用该程序打开它。因此，如果 Inkscape 安装程序将 .py 文件与其自己的 python 版本相关联，则 cmd 可能会优先运行该文件并完全忽略 PATH。请参阅此问题。

Answer 3

根据您的第二次编辑，您的路径中可能有多个 pydoc.py 副本，第一个是“错误”副本，这样当它启动时，它就没有正确的执行环境。

Answer 4

python -m pydoc -k/p/g/w <name>

Answer 5

Windows 上 pydoc 的语法：

alt1：

C:\path\PythonXX\python.exe C:\path\PythonXX\Lib\pydoc.py -k/p/g/w X:\path\file_to_doc.py

alt2:

python -m pydoc -k/p/g/w X:\path\file_to_doc.py

其中后者是首选，呵呵。但是，它要求您的 Windows 安装已将 python 注册到环境变量“Path”。

设置 Windows 环境变量：

请访问此站点获取指南关于在哪里可以找到它们。您要寻找的是“Path”。如果选择“路径”并单击“编辑”，您将看到一长排指向不同文件夹的路径。您在此处看到的路径基本上允许您通过输入程序名称而不是其整个路径来在命令行中访问各种程序。所以你要做的就是找到你的Python安装并复制它的完整路径，如下所示：X:\subfolders\PythonXX\ 然后你将它添加到长行路径的最末尾，就像这：

X:\earlier\path\to\something;X:\subfolders\PythonXX\

注意“;”分开不同的路径，请确保不要忘记它。完成后，单击确认/确定，然后您需要重新启动任何已打开的 cmd.exe。

pydoc.py

事实是，pydoc 是标准 python 库的一个模块，并且它也是由 python 提供支持的。据我了解，Windows 环境要求您指定要使用哪个程序来运行某个文件。因此，要运行 pydoc.py 文件，我们将使用：

在 Windows cmd.exe 中打开文件：

X:\subfolders\Python27\python.exe X:\subfolders\Python27\Lib\pydoc.py

pydoc.py 的参数：

pydoc.py 附带了一系列命令基于行的功能允许您输入某些参数：
-k/p/g/w 其中将触发 pydoc.py 程序的不同行为。

通过命令行向程序发送参数：

输入这些参数的语法是我所知道的，总是在x:\pathtofile\filename.suffix之后，用一个简单的分隔符分隔空间。这给了我们最终的：

alt1：

X:\subfolders\Python27\python.exe X:\subfolders\Python27\Lib\pydoc.py -w X:\path\file_to_doc.py

alt2 （将 python 注册到路径）：

python -m pydoc -w X:\path\file_to_doc.py

“w”选项将为您提供要运行文档的文件的 HTML 文档。请注意， pydoc.py 将（根据我的测试）在当前工作目录中创建文档文件。这意味着在实际运行命令之前，您需要将自己置于所选的文件夹中。

-m 的功能

据我所知，-m 似乎可以处理注册表项，至少在 msiexec.exe 中是这样。我想它可能会以这种方式用于一般程序。所以我的推测是，如果应用“-m”，后面的参数路径将被重写，以便 .exe 文件将用作路径引用。但正如所说，相当投机。

-m 重写所有必需的计算机特定注册表项。 （在 msiexec.exe 中）根据 Microsoft