If you want to try the Sims docs at the REPL, you'll need to checkout that
package and enter "using Sims, Sims.Lib, Lexicon". Then you can do
?Resistor or ?"Capacitor.

Note that the question mark doesn't work in ESS.



On Tue, Jan 13, 2015 at 5:21 PM, Tom Short <tshort.rli...@gmail.com> wrote:

> 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 <dmba...@gmail.com> 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 <dmb...@gmail.com> 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