Thanks. I do plan to keep moving with this. Over the summer most likely. If I can stay away until then.
>From the little investigation into the string issue I did it may have been to do with this [1] line. Perhaps the eval should be taking into account the module the function comes from? Since everything in help is in Base as well, it doesn't seem to be a problem currently. I'll take another look when I get a chance. [1] https://github.com/JuliaLang/julia/blob/master/base/help.jl#L102 On Sunday, 8 June 2014 21:32:36 UTC+2, Tim Holy wrote: > > I agree with Daniel. We just need _something_, and on this issue the > diversity > of tastes seems to make consensus impossible. So kudos to you. I really > hope > this keeps moving forward. > > What prevents it from working with functions rather than strings? > > --Tim > > > On Saturday, June 07, 2014 02:16:11 PM Daniel Jones wrote: > > A good way of documenting packages is one of the biggest gaps in the > > julia ecosystem right now. Part of the reason why is evinced in the > > issues you cite: no matter what the system is, someone is going to hate > > it. At this point, I'm sort of hoping someone will just ignore all > > feedback and build whatever they want. > > > > > > > > That said, I think this is a pretty elegant solution. Just relying on > > markdown h1 and h2 headers leaves open the possibility of generating > > html documentation from the same source. That's something I appreciate, > > since I'd also want to generate html docs with example plots rendered > > for gadfly. > > > > > > > > With Jake Bolewski's julia parser, I hope it will become easier to > > extract documentation from source code, either from comments or > > something like docstrings. Have you given any though to that? > > > > > > > > > > > > On Thu, Jun 5, 2014, at 03:13 PM, Michael Hatherly wrote: > > > > Hi all, > > > > > > > > I've just put up a rough prototype for package documentation at > > [1]https://github.com/MichaelHatherly/Docile.jl. This is not meant to > > be a solution to the documentation problem, but rather to start some > > fresh discussion on the matter. > > > > > > > > Any feedback would be great. There's more details in the readme. > > > > > > > > Regards, > > > > Mike > > > > References > > > > 1. https://github.com/MichaelHatherly/Docile.jl >
