http://sphinx.pocoo.org/rest.html#substitutions says:
"If you want to use some substitutions for all documents, put them into a separate file and include it into all documents you want to use them in, using the include directive. Be sure to give the include file a file name extension differing from that of other source files, to avoid Sphinx finding it as a standalone document." However, if you DO name your included file with an extension other than .rst (say .hr), it will NOT be copied over to the _build/html/_sources directory. Additionally, in the latest trunk revision, the unused_docs conf.py option no longer works, so if you change the name back to include .rst, you then get the "WARNING: document isn't included in any toctree" message. If instead you add the file to the new exclude_patterns option, then again it no longer gets copied to the _sources directory. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.