[sphinx-dev] Re: Feature Request: Auto-Extracting Examples

2012-01-07 Thread Guenter Milde
On 2012-01-06, Bruce Eckel wrote: > I'd love to see some kind of tag that indicates that something is, or is > part of, a working example, so that Sphinx would automatically extract the > example and it could be downloaded, run, etc. > I ask for this because I see too much documentation where the

Re: [sphinx-dev] Re: Feature Request: Auto-Extracting Examples

2012-01-06 Thread Tony Vignaux
We use the literalinclude method for the examples in the Manual and Tutorials for the SimPy free simulation package built on Python. We test the examples separately. Tony Vignaux On Sat, Jan 7, 2012 at 5:57 PM, Roger Binns wrote: > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > >

[sphinx-dev] Re: Feature Request: Auto-Extracting Examples

2012-01-06 Thread Roger Binns
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 06/01/12 14:53, Bruce Eckel wrote: > I always have the first line of a code listing example as a comment > that gives the name of the file in the comment, but if you had a tag > that required the file name then you could use that to extract the code