Re: "Some people don't like the native approach to private vars since 
anyone who wants to override it can do so anyway, so they go with a purely 
conventional and unenforced approach: delineate the boundaries of API vs 
internal using :internal or :impl and/or put the internal bits in an impl 
namespace."

Yes. I've used this approach myself sometimes.

Function metadata can also enhance documentation generation. Functions with 
^:internal metadata could be treated and presented as "internal API" 
only. I don't know if codox or marginalia are customizable in this way.

On Monday, May 11, 2015 at 8:35:06 PM UTC-4, Mischov wrote:
>
> To answer your question, ^:internal is shorthand meaning "set the 
> :internal key of the object's metadata to true".
>
> You can read more about metadata here <http://clojure.org/metadata>.
>
> On Sunday, May 10, 2015 at 2:00:10 PM UTC-5, piast...@gmail.com wrote:
>>
>>
>> What does ^:internal mean in this context? 
>>
>>
>>
>>
>>
>>
>>
>>

-- 
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your 
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to