Clojure revision 1193 introduces metadata handling for namespaces and
other Reference types. I was thinking this could be used to add
support for ns-level docstrings such as we currently have for vars.
Such support would allow programatic access to namespace
documentation.
I was thinking of something like:
(ns clojure.zip
(:refer-clojure :exclude (replace remove))
(:doc "Functional hierarchical zipper, with navigation, editing and
enumeration. See Huet."))
Which would eventually allow:
(doc clojure.zip)
as well as access to these docstrings by programatic documentation
generators like clj-doc.
Is anyone else interested in namespace-level docstrings? Any thoughts
on what the interface might look like?
- Mark
--~--~---------~--~----~------------~-------~--~----~
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
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
-~----------~----~----~----~------~----~------~--~---
