The source with doc strings was only recently merged into master. They
should be there now (but it's not in METADATA, yet). Compare the input and
output for one of the source files:

* https://github.com/tshort/Sims.jl/blob/master/examples/lib/electrical.jl

* https://tshort.github.io/Sims.jl/examples/lib/#electrical

On Tue, Jan 13, 2015 at 5:14 PM, Douglas Bates <[email protected]> wrote:

> Actually the first place I looked was in your Sims package but I didn't
> see any documentation strings, of either form, in the Julia sources.  Am I
> missing something very basic here?
>
> On Tuesday, January 13, 2015 at 4:06:44 PM UTC-6, tshort wrote:
>>
>> It's still a bit in flux as the old style is:
>>
>> @doc """
>> my docs...
>> """ ->
>> myfun(x) = ...
>>
>> The new style is:
>>
>> """
>> my docs...
>> """
>> myfun(x) = ...
>>
>> The new style is in Docile but not in v"0.4-", yet.
>>
>> The documentation inside Docile is a good start. It uses the new style.
>> Some other notable packages include:
>>
>> * https://github.com/johnmyleswhite/CSVReaders.jl
>>
>> * https://tshort.github.io/Sims.jl/
>>
>> In Sims.jl, I used Mkdocs (mkdocs.org) along with Docile/Lexicon to
>> create that documentation site.
>>
>>
>>
>>
>>
>>
>> On Tue, Jan 13, 2015 at 4:59 PM, Douglas Bates <[email protected]> wrote:
>>
>>> I'm having difficulty navigating my way around documentation standards
>>> for v"0.4-", and whether the Docile or Lexicon or Markdown packages are
>>> needed.  What would be a good package to study to see how @doc, etc. should
>>> be used?
>>>
>>
>>

Reply via email to