Re: Where do I find javadoc for clojure interfaces?

[Stuart Sierra]

Interfaces like ISeq are internal details of Clojure's implementation. 
They're not part of the public API, so there is no guarantee that they 
won't change in future releases.

–S


On Thursday, October 1, 2015 at 4:59:12 AM UTC-4, crocket wrote:
>
> http://clojure.github.io/clojure/javadoc/ doesn't expost interfaces like 
> clojure.lang.ISeq, so when I refer to such interfaces, I have to download 
> clojure javadoc from maven.
> I'd like to refer to those interface on web browsers. Why are they not 
> exposed on the web?
>

-- 
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: Where do I find javadoc for clojure interfaces?

[Daniel Compton]

This has come up before
https://groups.google.com/forum/#!topic/clojure/2ZHYa-Bv8UU.

Alex's 
statement on the matter:

> The Clojure internal Java interfaces are certainly intended to allow
library builders to create useful stuff that plays in the Clojure world. I
do not know that anyone has ever said that they are "public", but I
certainly think that any change to a core interface likely to break
external users would be considered very carefully.

I think that documentation on these interfaces would be very helpful. If
they are meant to be private then it would be good to document that too,
it's not obvious to an onlooker that this is the case. I took a look in
JIRA and couldn't find a ticket for this, but it's a hard thing to search
for.

On Sun, Oct 4, 2015 at 3:47 AM Stuart Sierra 
wrote:

> Interfaces like ISeq are internal details of Clojure's implementation.
> They're not part of the public API, so there is no guarantee that they
> won't change in future releases.
>
>
> –S
>
>
>
> On Thursday, October 1, 2015 at 4:59:12 AM UTC-4, crocket wrote:
>>
>> http://clojure.github.io/clojure/javadoc/ doesn't expost interfaces like
>> clojure.lang.ISeq, so when I refer to such interfaces, I have to download
>> clojure javadoc from maven.
>> I'd like to refer to those interface on web browsers. Why are they not
>> exposed on the web?
>>
> --
> 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.
>
-- 
Daniel

-- 
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: Where do I find javadoc for clojure interfaces?

[Phillip Lord]

Probably because they are not documented. This is the source code for
ISeq in total

/**
 * A persistent, functional, sequence interface
 * 
 * ISeqs are immutable values, i.e. neither first(), nor rest() changes
 * or invalidates the ISeq
 */
public interface ISeq extends IPersistentCollection {

Object first();

ISeq next();

ISeq more();

ISeq cons(Object o);

}

I think you are supposed to guess what the interfaces mean based on the
names of the methods.

Phil


crocket  writes:

> http://clojure.github.io/clojure/javadoc/ doesn't expost interfaces like 
> clojure.lang.ISeq, so when I refer to such interfaces, I have to download 
> clojure javadoc from maven.
> I'd like to refer to those interface on web browsers. Why are they not 
> exposed on the web?

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

Where do I find javadoc for clojure interfaces?

[crocket]

http://clojure.github.io/clojure/javadoc/ doesn't expost interfaces like 
clojure.lang.ISeq, so when I refer to such interfaces, I have to download 
clojure javadoc from maven.
I'd like to refer to those interface on web browsers. Why are they not 
exposed on the web?

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