Re: Meaning of part of the doc string for `ns-resolve`

2015-04-25 Thread Fluid Dynamics
On Saturday, April 25, 2015 at 1:47:27 AM UTC-4, Mike Rodriguez wrote: I agree about wanting to use the explicit argument name surrounded by markdown quotes in docs. I've definitely started adopting this practice and wish there were conventions around this sort of thing. Without it, doc

Re: Meaning of part of the doc string for `ns-resolve`

2015-04-25 Thread Mike Rodriguez
I have found long docs like that to be useful in some major top-level function if it has a large sort of input and configuration parameters to pass in. Markdown I believe means with back ticks around the symbol to make it stand out as an actual art name vs some other word in the sentence. I

Re: Meaning of part of the doc string for `ns-resolve`

2015-04-24 Thread Brian Marick
Nicola Mometto wrote: It's talking about fully qualified symbols that map to an actual var. E.g user= (ns-resolve *ns* 'clojure.string/join) #'clojure.string/join Ah. Thank you. Ambrose Bonnaire-Sergeant wrote: Could you clarify why you expect that? Thanks, Ambrose Because the

Re: Meaning of part of the doc string for `ns-resolve`

2015-04-24 Thread Mike Rodriguez
I agree about wanting to use the explicit argument name surrounded by markdown quotes in docs. I've definitely started adopting this practice and wish there were conventions around this sort of thing. Without it, doc strings can easily get ambiguous and confusing in how they relate the the

Meaning of part of the doc string for `ns-resolve`

2015-04-23 Thread Brian Marick
The last sentence of the `ns-resolve` documentation reads: Note that if the symbol is fully qualified, the var/Class to which it resolves need not be present in the namespace. What does that mean? I would expect something like the following to produce a non-nil value: user=

Re: Meaning of part of the doc string for `ns-resolve`

2015-04-23 Thread Ambrose Bonnaire-Sergeant
Could you clarify why you expect that? Thanks, Ambrose On Thu, Apr 23, 2015 at 6:43 PM, Brian Marick mar...@exampler.com wrote: The last sentence of the `ns-resolve` documentation reads: Note that if the symbol is fully qualified, the var/Class to which it resolves need not be

Re: Meaning of part of the doc string for `ns-resolve`

2015-04-23 Thread Nicola Mometto
It's talking about fully qualified symbols that map to an actual var. E.g user= (ns-resolve *ns* 'clojure.string/join) #'clojure.string/join Brian Marick writes: The last sentence of the `ns-resolve` documentation reads: Note that if the symbol is fully qualified, the var/Class to

Re: Meaning of part of the doc string for `ns-resolve`

2015-04-23 Thread Atamert Ölçgen
This fails: (ns-resolve 'sumtin 'clecs.world/remove-entity) Exception No namespace: sumtin found clojure.core/the-ns (core.clj:3830) But this succeeds: (ns-resolve 'seesaw.core 'clecs.world/remove-entity) #'clecs.world/remove-entity It seems when the 2nd argument is fully qualified, first