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.

Reply via email to