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.