Help entries for some builtins

[joehuchette]

When queried with help?> foo, the following builtins lead to syntax errors:

• abstract basedocs #12438: abstract, bitstype, module, baremodule, macro #13177
• baremodule basedocs #12438: abstract, bitstype, module, baremodule, macro #13177
• bitstype basedocs #12438: abstract, bitstype, module, baremodule, macro #13177
• for
• global basedocs #12438 part 4 #13217
• if
• importall basedocs #12438 part 4 #13217
• let basedocs #12438 part 4 #13217
• local basedocs #12438 part 4 #13217
• macro basedocs #12438: abstract, bitstype, module, baremodule, macro #13177
• module basedocs #12438: abstract, bitstype, module, baremodule, macro #13177
• quote basedocs #12438 part 4 #13217
• try
• typealias
• while
• ' (ctranspose); interestingly .' is a valid identifier, but not used in the .' syntax. It also needs documentation. basedocs #12438 part 4 #13217
• catch
• else
• elseif
• end
• finally

[MichaelHatherly]

Keywords are being documented at the top of base/docs/basedocs.jl. Until we've covered all of them a nicer error message for this would be great to have for this.

[sbromberger]

Semi-related but not included above:

help?> ?
search:

  Welcome to Julia 0.4.0-dev+6817. The full manual is available at

  http://docs.julialang.org/

  as well many great tutorials and learning resources:

  http://julialang.org/learning/

  For help on a specific function or macro, type ? followed by its name, e.g. ?fft, ?@time or ?html, and press enter.

# ok, let's try the last one:

help?> html
search: HTML @html_str gethostname

Couldn't find html
Perhaps you meant htol, hton, hcat, hist, hash, hex, chol, chomp, ltoh, ntoh, call, eval, @cmd, @time, Cmd, Dims, Val, all or atan

[mbauman]

@joehuchette I hope you don't mind that I edited your list to add ' and make it a checklist. I can revert it back if you'd prefer.

[yuyichao]

FWIW, stagedfunction also give a syntax error.... Probably not worth documenting but no error would be nice...

[hayd]

@generated could do with a docstring. I'm not sure where/whether deprecated syntax help should be added (maybe it could just say "Deprecated. See @generated."), but IMO it's fine without...