I'll try to give this ago, its a nice idea. I've don't believe I've ever
worked on a project that actually used "docstrings" in a formalized way
(to, i.e. generate HTML documentation), but I can see how it'd be very
useful for some Julia packages.
Cheers,
Iain
On Thursday, August 14, 2014 5:01:31 PM UTC-4, Michael Hatherly wrote:
>
> I’ve added some new functionality in the form of @doc docstrings for:
>
> - methods
> - functions
> - globals
> - macros
> - types
> - modules
>
> The YAML metadata has been replaced with a Dict{Symbol, Any}, resulting
> in quite a large improvement in load times.
> Documentation can also be included from external files if a docstring
> becomes too large. String interpolation into docstrings
> is supported, as well as a string macro (tex_mstr) for writing LaTeX
> equations without needing to use escape characters.
>
> I’m in the process of getting Docile included in METADATA so hopefully
> it’ll be ready for general use quite soon.
>
> — Mike
>
>
