Jason S writes: > Never mind, I figured something out. > > In my source .rst file, I changed > > .. literalinclude:: tennis.espdf > > to > > .. include:: tennis.espdf > :literal: > :tab-width: 3 > > Is "literalinclude" a sphinx convenience directive? Because it's not > mentioned > in http://docutils.sf.net/docs/ref/rst/directives.html, and if > literalinclude just > saves you one line but leads to problems / lack of documentation, then > I don't > see the point in using it.
It is documented in the sphinx manual, and the reason for it seems to be that if include points to a missing file it fails, while literalinclude just gives a warning If you can live with that, use include instead. -- 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.