9.0.4: sphinx warnings `reference target not found` about pyee HOT 6 CLOSED

I don't believe these changes are necessary.

To build the documentation, you're supposed to use the Makefile - make setup to create the virtualenv and make build_docs to build the docs. make serve_docs will serve them with http.server. You shouldn't, in fact, need sphinx-build at all.

But either way, I don't want to make these changes because they depend on paths. Instead, I want to depend on the module being installed into the current environment.

If you have some particular reason to use sphinx-build over make build_docs and can convince me, then we can work together to migrate. But you shouldn't need to mess with sys.path if pyee is installed in your env.

from pyee.

As long as in your Makefile to the sphinx-build parameters will be added -n option you will be able to see the same warning.
That patch which alters sys.path guaranteees that documentation will be generated against code from source tree and not against installed pyee.
If you don't care about such detail that is fine. I'll keep that patch in build procedure.

If you have some particular reason to use sphinx-build over make build_docs and can convince me,

Reason is that this Makefile is not needed .. in other words that reason it is just KISS pronciple.

from pyee.

In that case, I'm going to close this issue, as I have no intention of accepting a patch like this.

from pyee.

In that case, I'm going to close this issue, as I have no intention of accepting a patch like this.

Reported warnings have nothing to do with reported warnings. That patch only improves the copy.py file to guarantee that it will produce ALWAYS documentation not out of installed module but out of code in source tree.

Did you ever try to use that -n switch to reproduce the issue? 🤔

from pyee.

from pyee.

Wrong references are mot about paths ..

from pyee.