Re: [ANN] Clojure 1.9.0-RC2

2017-11-29 Thread Khalid Jebbari 
Thanks for the pointers Alex. Hopefully the problems will be solved one day, 
most Clojure API will be spec'd and we'll be happy.

Keep up the good work.

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

Re: [ANN] Clojure 1.9.0-RC2

2017-11-28 Thread Alex Miller 
On Tue, Nov 28, 2017 at 3:22 PM, Khalid Jebbari 
wrote:

> Specs in docs are nice, great addition.
>
> 2 things related to them :
> - what is `quotable` ? Couldn't find its docs in the page
>

All of the core specs are defined in an external library (so we can update
it more frequently than Clojure):
https://github.com/clojure/core.specs.alpha

In this case, quotable is a helper function (refer-clojure and import are
particularly weird in source/spec as they are designed to be used both
directly at the repl and inside the ns macro):
https://github.com/clojure/core.specs.alpha/blob/master/src/main/clojure/clojure/core/specs/alpha.clj#L222

We use the short form description in the docs (s/describe) rather than the
long-form fully-qualified version (s/form) for readability. This is a
tradeoff as it omits information but I think usually wins. It would be
better if we could easily link to the definition of the spec source, which
is possible to add.


> - I suppose `:closure.core.spec.alpha/exclude` refers to a spec, but
> again it's absent from the docs.


As this is defined in another project you won't see it here. FYI, you can
use `doc` to look at any spec by name at the repl:

user=>  (doc :clojure.core.specs.alpha/exclude)
-
:clojure.core.specs.alpha/exclude
Spec
  (coll-of simple-symbol?)

A quick search in clojure.core and spec.alpha repos didn't reveal it. Where
> are they defined ? It would be nice if they where included in docs and/or
> were clickable directly from docstrings.
>

Agreed and you would see it here (but not clickable) if it was defined in
this project. You can see an example of this in the java.jdbc docs:
http://clojure.github.io/java.jdbc/#:clojure.java.jdbc.spec/as-arrays?

It would be a nice enhancement to support an external http source for those
external specs in the doc generator.

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

Re: [ANN] Clojure 1.9.0-RC2

2017-11-28 Thread Khalid Jebbari 
Specs in docs are nice, great addition.

2 things related to them :
- what is `quotable` ? Couldn't find its docs in the page
- I suppose `:closure.core.spec.alpha/exclude` refers to a spec, but again it's 
absent from the docs. A quick search in clojure.core and spec.alpha repos 
didn't reveal it. Where are they defined ? It would be nice if they where 
included in docs and/or were clickable directly from docstrings.

Thanks again for your hard work.

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

Re: [ANN] Clojure 1.9.0-RC2

2017-11-27 Thread Egg Syntax 
Great choices on how to present core specs 

 
-- really clean & readable.

Thanks!

On Monday, November 27, 2017 at 5:17:10 PM UTC-5, Alex Miller wrote:
>
> I should also mention that I've re-built the Clojure doc automation 
> process and the Clojure docs have refreshed for the first time in a long 
> while. Most importantly, the 1.9 docs are up to date and now include specs 
> for things that have been spec'ed:
>
> https://clojure.github.io/clojure/branch-master/index.html
>
> Example macro with specs:
>
> https://clojure.github.io/clojure/branch-master/clojure.core-api.html#clojure.core/refer-clojure
>
> Additionally, I am in the process of overhauling the contrib project doc 
> automation. In the meantime, I have at least done a manual update of the 
> spec API docs:
>
> https://clojure.github.io/spec.alpha
>
>
> On Monday, November 27, 2017 at 3:47:25 PM UTC-6, Alex Miller wrote:
>>
>> Clojure 1.9.0-RC2 is now available.
>>
>> Try it via
>>
>> - Download: https://repo1.maven.org/maven2/org/clojure/clojure/1.9.0-RC2
>> - Leiningen: [org.clojure/clojure "1.9.0-RC2"]
>>
>> 1.9.0-RC2 is largely the same as RC1 but has the following changes:
>>
>> - There is a new Maven profile and Ant target in the build to build an 
>> executable Clojure jar with deps included (and test.check). This can be 
>> useful for doing dev on Clojure itself or for just cloning the repo and 
>> doing a quick build to get something runnable.
>> - The readme.txt has been updated to include information about how to 
>> create and run a local jar.
>> - We have stopped publishing the clojure-VERSION.zip file as part of the 
>> release.
>>
>> We would appreciate anything you can do to try out this release. We do 
>> not plan to make any further changes prior to 1.9.0 unless regressions are 
>> found.
>>
>>

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

Re: [ANN] Clojure 1.9.0-RC2

2017-11-27 Thread Michael Glaesemann 

> On 2017-11-27, at 16:17, Alex Miller  wrote:
> 
> I should also mention that I've re-built the Clojure doc automation process 
> and the Clojure docs have refreshed for the first time in a long while.

Thanks, Alex!

Michael Glaesemann
grzm seespotcode net



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

Re: [ANN] Clojure 1.9.0-RC2

2017-11-27 Thread Alex Miller 
I should also mention that I've re-built the Clojure doc automation process 
and the Clojure docs have refreshed for the first time in a long while. 
Most importantly, the 1.9 docs are up to date and now include specs for 
things that have been spec'ed:

https://clojure.github.io/clojure/branch-master/index.html

Example macro with specs:
https://clojure.github.io/clojure/branch-master/clojure.core-api.html#clojure.core/refer-clojure

Additionally, I am in the process of overhauling the contrib project doc 
automation. In the meantime, I have at least done a manual update of the 
spec API docs:

https://clojure.github.io/spec.alpha


On Monday, November 27, 2017 at 3:47:25 PM UTC-6, Alex Miller wrote:
>
> Clojure 1.9.0-RC2 is now available.
>
> Try it via
>
> - Download: https://repo1.maven.org/maven2/org/clojure/clojure/1.9.0-RC2
> - Leiningen: [org.clojure/clojure "1.9.0-RC2"]
>
> 1.9.0-RC2 is largely the same as RC1 but has the following changes:
>
> - There is a new Maven profile and Ant target in the build to build an 
> executable Clojure jar with deps included (and test.check). This can be 
> useful for doing dev on Clojure itself or for just cloning the repo and 
> doing a quick build to get something runnable.
> - The readme.txt has been updated to include information about how to 
> create and run a local jar.
> - We have stopped publishing the clojure-VERSION.zip file as part of the 
> release.
>
> We would appreciate anything you can do to try out this release. We do not 
> plan to make any further changes prior to 1.9.0 unless regressions are 
> found.
>
>

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

[ANN] Clojure 1.9.0-RC2

2017-11-27 Thread Alex Miller 
Clojure 1.9.0-RC2 is now available.

Try it via

- Download: https://repo1.maven.org/maven2/org/clojure/clojure/1.9.0-RC2
- Leiningen: [org.clojure/clojure "1.9.0-RC2"]

1.9.0-RC2 is largely the same as RC1 but has the following changes:

- There is a new Maven profile and Ant target in the build to build an 
executable Clojure jar with deps included (and test.check). This can be 
useful for doing dev on Clojure itself or for just cloning the repo and 
doing a quick build to get something runnable.
- The readme.txt has been updated to include information about how to 
create and run a local jar.
- We have stopped publishing the clojure-VERSION.zip file as part of the 
release.

We would appreciate anything you can do to try out this release. We do not 
plan to make any further changes prior to 1.9.0 unless regressions are 
found.

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