After installing pdoc with pip it not recognised as an executable on Windows

[epogrebnyak]

Tried navigating to \Scripts, same result.

[BurntSushi]

I don't understand Python on Windows, so you're probably on your own. I doubt pdoc is itself installed as a real executable. Maybe you need to run it with the Python interpreter? e.g., python path/to/pdoc.py or python -m pdoc?

[epogrebnyak]

So far my best case for Windows is below:

1. Download package from Github (e.g. download zip and unpack)
2. In pdoc root directory run python setup.py install (as described in manual)
3. Use python interpreter to run pdoc:
   python <your python install path>\Scripts\pdoc <package_or_file_path>

This got pdoc going for me on Windows.

Remaining question for me: can pdoc document a non-installed package, just a folder with __init__.py inside and several *.py files? I get an empty listing here:

>python D:\Continuum\Anaconda3\Scripts\pdoc kep2
Module kep2
-----------

[stevebrasier]

I think this is easy to fix; the script pdoc installs just needs to have a .py extension and the user needs to right-click a *.py file and set "open with.." to their Python executable.