Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-14 Thread Tom Short
It just hasn't been implemented, yet. Lexicon complains with "type BasicREPL has no field interface". I'm guessing that a simpler approach could be used in Lexicon, or it could be implemented in ESS (unfortunately, no ESS developers really use Julia). On Wed, Jan 14, 2015 at 4:23 AM, Tamas Papp w

Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-14 Thread Michael Hatherly
Just as a note regarding this new syntax for anyone reading: It’s still being experimented with in Docile/Lexicon, though so far I’ve found it much more enjoyable to use. Package load times aren’t affected nearly as much as with @doc since collection and parsing of docstrings only happens once

Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-14 Thread Tamas Papp
On Tue, Jan 13 2015, Tom Short wrote: > 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. Is that an intrinsic limitation

Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-13 Thread Tom Short
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 wrote: > The source with doc stri

Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-13 Thread Tom Short
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/examp

Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-13 Thread Douglas Bates
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:

Re: [julia-users] exemplar package for 0.4-style documentation

2015-01-13 Thread Tom Short
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 in

[julia-users] exemplar package for 0.4-style documentation

2015-01-13 Thread Douglas Bates
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?