[SciPy-user] examples in docs
Tue May 5 13:43:20 CDT 2009
That looks good. I apologize for not adding the documentation myself.
On Tue, May 5, 2009 at 2:17 PM, <firstname.lastname@example.org> wrote:
> On Tue, May 5, 2009 at 12:27 PM, Pauli Virtanen <email@example.com> wrote:
> > Tue, 05 May 2009 11:46:01 -0400, josef.pktd wrote:
> >> Rob Falck just pointed out a nice set of examples for fmin_slsqp at
> >> http://projects.scipy.org/scipy/attachment/ticket/570/slsqp_test.py.
> >> What's the best way to include them in the docs? the tutorial?
> > The tutorial, I'd say.
> >> Is there a way to include or link to examples that are too long for a
> >> docstring?
> > Add a label like
> > .. _tutorial-sqlsp:
> > at the relevant point in the tutorial, and refer it to as
> > More examples :ref:`in the tutorial <tutorial-sqlsp>`
> > or :ref:`tutorial-sqlsp` in the docstring, or something along these
> I did this, but mostly cut and paste:
> Maybe someone who knows more about fmin_slsqp can edit it.
> One more question:
> does a literal include of some files in the examples subdirectory. I
> didn't find a way to display and edit them in the docs editor.
> If we include more sample scripts, it might be good, to find a way to
> add and edit them through the doc editor. Right now the relatively
> long example script that I pasted looks a bit ugly in the tutorial
> SciPy-user mailing list
- Rob Falck
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the SciPy-user