[ncl-talk] NCL and Sphinx?

[Walton, Jeremy]

Hello everyone,

I'm working with colleagues at DLR on ESMValTool<http://www.pa.op.dlr.de/ESMValTool/>, a package for evaluating the output of Earth System Models.  Many of its diagnostics are written in NCL (as well as Python and R), and I'm currently exploring the possibility of using the Sphinx<http://sphinx-doc.org/> documentation tool to document those functions - perhaps using Sphinx's ability to pull out marked-up comments from the code and translate them to pdf, linked webpages, etc.  There are lots of examples on the web of Sphinx being used in this way for Python scripts, but I was wondering if anyone had ever tried it for NCL scripts?

Any ideas or pointers elsewhere would be much appreciated - many thanks indeed.

Jeremy

++++++++++++++++
Dr Jeremy Walton
Scientific Systems Manager
UK Earth System Model Core Group
Met Office, Exeter EX1 3PB, U.K.
T: +44 (0)1392 885244
F: +44 (0)1392 885681
E: jeremy.walton at metoffice.gov.uk<mailto:jeremy.walton at metoffice.gov.uk>
W: www.metoffice.gov.uk<http://www.metoffice.gov.uk>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mailman.ucar.edu/pipermail/ncl-talk/attachments/20150709/a64a6f60/attachment.html