Monitor source files that may contain documentation update

[mertzjames]

When running sphinxserve it'd be nice to have the ability to update documentation within the source code and that update within sphinxserve.

[mzdaniel]

Certainly would be. The issue is that modules can be loader from anywhere in the python sys.path. watchdog only looks in the directory (and subdirectories) where the conf.py lives.

[mertzjames]

perhaps you can monitor the same paths that are appended within the conf.py?

[mertzjames]

Or is there a way to monitor the files that are specified within the conf.py and other associated doc files. For example:

.. automodule:: <file>
   :members:

Couldn't you extract the from there?

[mzdaniel]

There is an open issue sphinx-doc/sphinx#1031 similar to this one.
Python modules usually have dependencies that don't live in the same path.
Did you try using PYTHONPATH?

[mertzjames]

This is more for you server rather than sphinx. What I'm saying is that somehow your server could monitor source files that are called out in the doc files so that we their documentation changes, it would automatically update as well.

[mzdaniel]

I understand that and would be great to implement something that monitor modules too. If you can think in a simple solution for this issue, PR's are welcome! One idea could be to add a cli switch specifying paths to look for modules? What do you think?