Add doc_str and doc macros, to support Base.Docs/Docile syntax.

[hayd]

fix #56.

[MichaelHatherly]

@docmstr -> @doc_mstr

[hayd]

fixed, thanks!

[MichaelHatherly]

The version condition should probably be a bit more specific since @doc didn't get added until later during 0.4.

[hayd]

Hmmm, it's been a long time > 6 months I think? Happy to tweak this if it's easy to work out.

Edit: JuliaLang/julia#8791 (November)

[MichaelHatherly]

0.4.0-dev+1501 I think.

[hayd]

okey dokey, let's go with that. :)

[stevengj]

Needs a test.

[hayd]

Added test. locally this works on 0.3 both with and without Docile.

[hayd]

@MichaelHatherly actually when I look at this, help doesn't seem to work for me on 0.3 (before this PR). I was under the impression that

help> func # would not show doc
julia> using Docile
help> func  # would show doc

Maybe there is something funky about my 0.3 install.

Should this work?

[MichaelHatherly]

Should this work?

To get help in 0.3 for packages you need to import Lexicon first. Docile only provides the docstrings while Lexicon hooks into the base help system.

[hayd]

I think it would be nice to merge this soon...

One potential issue is this may cause some warnings where libraries have already tried to import Docile ? The trick being, remove the using/import of Docile and let Compat do the work. ?
(Perhaps this could be solved by moving the export into the catch block?)

[hayd]

I'm going to pull the trigger on this in the next few days unless there's any more comments.

[MichaelHatherly]

@hayd, this is causing failures for packages on 0.3 that import Docile after Compat, https://github.com/JuliaGraphics/ColorTypes.jl/blob/a8dd9a3834b76e48db138141ab586325cd4efaa6/src/ColorTypes.jl#L5-L8.

This probably needs to be reverted unless there's a way to avoid the imports clashing.

First see here https://groups.google.com/forum/#!topic/julia-users/rsM4hxdkAxg.