On Sat, Nov 23, 2013 at 8:27 PM, Keith Irwin <ke...@devtrope.com> wrote: > Personally, the DSL doesn’t bother me at all. (Just a data point.) I get > where you’re going with it, and support the idea, FWIW, but if it were gone, > I wouldn’t notice. My needs are 1) so simple, strings work, or 2) so > complicated, a (or any) DSL is just extra headache. (Reading them out of a > separately maintained data file, for instance, is one way to go.)
Thank you. > The mixture of the old API and the new API is problematic, mainly because > it’s difficult for me (anyway) to look down the list of functions and figure > out which are old and which are new. I agree. > Might you be able to publish a parallel version of the API *documentation* > with all the deprecated stuff removed for those folks new to the library who > are uninterested in the old API? Even users of the old API might appreciate > it for the same reasons. I think, given that I am retiring the DSL namespaces and making them available in a separate project (that change is already committed, although the docstrings have yet to catch up), the least confusing thing to do at this point for 0.3.0-beta2 onward will be to create a java.jdbc.deprecated namespace containing the entirety of the 0.2.3 API and remove all of the deprecated functions from java.jdbc itself? That would clearly separate the API documentation into two namespaces: one the modern API going forward, one the deprecated API provided for backward compatibility. -- Sean A Corfield -- (904) 302-SEAN An Architect's View -- http://corfield.org/ World Singles, LLC. -- http://worldsingles.com/ "Perfection is the enemy of the good." -- Gustave Flaubert, French realist novelist (1821-1880) -- -- 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/groups/opt_out.