On Tue, Sep 7, 2010 at 11:10 PM, Mark Engelberg
<mark.engelb...@gmail.com> wrote:
> Files:
> Many times there are dozens of functions that are interrelated.  Only
> one or two of them are the crucially important "entry points" that
> provide the high-level API.  The rest are mostly helper functions that
> implement the lower-level details.  They are made public because in
> some situations, you might want to have access to those lower-level
> details, but 99% of the time, you can ignore them.  By default, all of
> these functions will show up in an auto-generated API listing.

Full ack here. There are functions I want to mark private to protect
from external use, but I still want to be able to use from different
namespaces inside a given library. Perhaps we need a metadata key like
:internal to signify that a function should be considered private for
purposes of documentation?

-Phil

-- 
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

Reply via email to