Hi, Does Sphinx have support for multiple source directories? I can't see any documentation indicating this is the case and having this feature would greatly simplify what I'm trying to do. This feature might sound strange without context so here it is.
The LLVM/Clang project uses Sphinx to generate its documentation. Some of our ``*.rst`` documents are generated by our build system and we favor doing "out of source builds" so these files should end up in our build tree not in the source tree with the rest of the ``*.rst`` files. The problem now is that Sphinx expects all the ``*.rst`` files to be in the "source directory" which is not the case for the files generated by our build system. We could - Write the build files into the source tree but that's gross. A build system should not modify the source tree when doing an "out of source" build - Copy all *.rst files in the source tree into the build directory so there is a single "source directory" for *.rst files in the LLVM/Clang build tree Both of the above are unnecessarily complicated if Sphinx supports multiple "source directories". If this isn't a feature in Sphinx I'd like to suggest that an implementation of this feature would require a user to specify an ordered list of source directories. That way when searching for files the source directories can be tried in order which would resolve ambiguities where the same file exists in multiple source directories. Thanks, Dan. -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
