You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@accumulo.apache.org by Josh Elser <jo...@gmail.com> on 2016/03/04 22:03:35 UTC
Fwd: 1.6 Javadoc missing classes
Good catch, Dan. Thanks for letting us know. Moving this one over to the
dev list to discuss further.
Christopher, looks like it might also be good to include iterator
javadocs despite not being in public API (interfaces, and o.a.a.c.i.user?).
-------- Original Message --------
Subject: 1.6 Javadoc missing classes
Date: Fri, 4 Mar 2016 15:59:26 -0500
From: Dan Blum <db...@bbn.com>
Reply-To: user@accumulo.apache.org
To: <us...@accumulo.apache.org>
A lot of classes seem to have gone missing from
http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator would be an
obvious example.
Re: 1.6 Javadoc missing classes
Posted by Josh Elser <jo...@gmail.com>.
So this just bit me. I went looking for Iterators and was confused why
they weren't there.
Christopher wrote:
> Sure, we can include that. Are there any other classes which would be
> good to have javadocs for which aren't public API?
>
> On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>> wrote:
>
> Good catch, Dan. Thanks for letting us know. Moving this one over to the
> dev list to discuss further.
>
> Christopher, looks like it might also be good to include iterator
> javadocs despite not being in public API (interfaces, and
> o.a.a.c.i.user?).
>
> -------- Original Message --------
> Subject: 1.6 Javadoc missing classes
> Date: Fri, 4 Mar 2016 15:59:26 -0500
> From: Dan Blum <dblum@bbn.com <ma...@bbn.com>>
> Reply-To: user@accumulo.apache.org <ma...@accumulo.apache.org>
> To: <user@accumulo.apache.org <ma...@accumulo.apache.org>>
>
> A lot of classes seem to have gone missing from
> http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> would be an
> obvious example.
>
Re: 1.6 Javadoc missing classes
Posted by Josh Elser <jo...@gmail.com>.
Oh, right. I forgot about the htrace shift. Don't we still have some
public-facing wrappers? I think we should have Javadocs published for
whatever the distributed tracing example we have published.
http://accumulo.apache.org/1.7/accumulo_user_manual.html#_instrumenting_a_client
Christopher wrote:
> The tracing APIs vary from version to version significantly. That puts a
> lot of extra effort on the person updating the included packages. How
> important are those now we're transitioning to use an external dependency?
>
> On Fri, Mar 4, 2016 at 5:17 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>> wrote:
>
> Maybe the distributed tracing APIs?
>
> Christopher wrote:
> > Sure, we can include that. Are there any other classes which would be
> > good to have javadocs for which aren't public API?
> >
> > On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>
> > <mailto:josh.elser@gmail.com <ma...@gmail.com>>> wrote:
> >
> > Good catch, Dan. Thanks for letting us know. Moving this one
> over to the
> > dev list to discuss further.
> >
> > Christopher, looks like it might also be good to include iterator
> > javadocs despite not being in public API (interfaces, and
> > o.a.a.c.i.user?).
> >
> > -------- Original Message --------
> > Subject: 1.6 Javadoc missing classes
> > Date: Fri, 4 Mar 2016 15:59:26 -0500
> > From: Dan Blum <dblum@bbn.com <ma...@bbn.com>
> <mailto:dblum@bbn.com <ma...@bbn.com>>>
> > Reply-To: user@accumulo.apache.org
> <ma...@accumulo.apache.org> <mailto:user@accumulo.apache.org
> <ma...@accumulo.apache.org>>
> > To: <user@accumulo.apache.org
> <ma...@accumulo.apache.org> <mailto:user@accumulo.apache.org
> <ma...@accumulo.apache.org>>>
> >
> > A lot of classes seem to have gone missing from
> > http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> > would be an
> > obvious example.
> >
>
Re: 1.6 Javadoc missing classes
Posted by Josh Elser <jo...@gmail.com>.
Oh, right. I forgot about the htrace shift. Don't we still have some
public-facing wrappers? I think we should have Javadocs published for
whatever the distributed tracing example we have published.
http://accumulo.apache.org/1.7/accumulo_user_manual.html#_instrumenting_a_client
Christopher wrote:
> The tracing APIs vary from version to version significantly. That puts a
> lot of extra effort on the person updating the included packages. How
> important are those now we're transitioning to use an external dependency?
>
> On Fri, Mar 4, 2016 at 5:17 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>> wrote:
>
> Maybe the distributed tracing APIs?
>
> Christopher wrote:
> > Sure, we can include that. Are there any other classes which would be
> > good to have javadocs for which aren't public API?
> >
> > On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>
> > <mailto:josh.elser@gmail.com <ma...@gmail.com>>> wrote:
> >
> > Good catch, Dan. Thanks for letting us know. Moving this one
> over to the
> > dev list to discuss further.
> >
> > Christopher, looks like it might also be good to include iterator
> > javadocs despite not being in public API (interfaces, and
> > o.a.a.c.i.user?).
> >
> > -------- Original Message --------
> > Subject: 1.6 Javadoc missing classes
> > Date: Fri, 4 Mar 2016 15:59:26 -0500
> > From: Dan Blum <dblum@bbn.com <ma...@bbn.com>
> <mailto:dblum@bbn.com <ma...@bbn.com>>>
> > Reply-To: user@accumulo.apache.org
> <ma...@accumulo.apache.org> <mailto:user@accumulo.apache.org
> <ma...@accumulo.apache.org>>
> > To: <user@accumulo.apache.org
> <ma...@accumulo.apache.org> <mailto:user@accumulo.apache.org
> <ma...@accumulo.apache.org>>>
> >
> > A lot of classes seem to have gone missing from
> > http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> > would be an
> > obvious example.
> >
>
Re: 1.6 Javadoc missing classes
Posted by Christopher <ct...@apache.org>.
The tracing APIs vary from version to version significantly. That puts a
lot of extra effort on the person updating the included packages. How
important are those now we're transitioning to use an external dependency?
On Fri, Mar 4, 2016 at 5:17 PM Josh Elser <jo...@gmail.com> wrote:
> Maybe the distributed tracing APIs?
>
> Christopher wrote:
> > Sure, we can include that. Are there any other classes which would be
> > good to have javadocs for which aren't public API?
> >
> > On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> > <ma...@gmail.com>> wrote:
> >
> > Good catch, Dan. Thanks for letting us know. Moving this one over to
> the
> > dev list to discuss further.
> >
> > Christopher, looks like it might also be good to include iterator
> > javadocs despite not being in public API (interfaces, and
> > o.a.a.c.i.user?).
> >
> > -------- Original Message --------
> > Subject: 1.6 Javadoc missing classes
> > Date: Fri, 4 Mar 2016 15:59:26 -0500
> > From: Dan Blum <dblum@bbn.com <ma...@bbn.com>>
> > Reply-To: user@accumulo.apache.org <ma...@accumulo.apache.org>
> > To: <user@accumulo.apache.org <ma...@accumulo.apache.org>>
> >
> > A lot of classes seem to have gone missing from
> > http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> > would be an
> > obvious example.
> >
>
Re: 1.6 Javadoc missing classes
Posted by Christopher <ct...@apache.org>.
The tracing APIs vary from version to version significantly. That puts a
lot of extra effort on the person updating the included packages. How
important are those now we're transitioning to use an external dependency?
On Fri, Mar 4, 2016 at 5:17 PM Josh Elser <jo...@gmail.com> wrote:
> Maybe the distributed tracing APIs?
>
> Christopher wrote:
> > Sure, we can include that. Are there any other classes which would be
> > good to have javadocs for which aren't public API?
> >
> > On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> > <ma...@gmail.com>> wrote:
> >
> > Good catch, Dan. Thanks for letting us know. Moving this one over to
> the
> > dev list to discuss further.
> >
> > Christopher, looks like it might also be good to include iterator
> > javadocs despite not being in public API (interfaces, and
> > o.a.a.c.i.user?).
> >
> > -------- Original Message --------
> > Subject: 1.6 Javadoc missing classes
> > Date: Fri, 4 Mar 2016 15:59:26 -0500
> > From: Dan Blum <dblum@bbn.com <ma...@bbn.com>>
> > Reply-To: user@accumulo.apache.org <ma...@accumulo.apache.org>
> > To: <user@accumulo.apache.org <ma...@accumulo.apache.org>>
> >
> > A lot of classes seem to have gone missing from
> > http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> > would be an
> > obvious example.
> >
>
Re: 1.6 Javadoc missing classes
Posted by Josh Elser <jo...@gmail.com>.
Maybe the distributed tracing APIs?
Christopher wrote:
> Sure, we can include that. Are there any other classes which would be
> good to have javadocs for which aren't public API?
>
> On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>> wrote:
>
> Good catch, Dan. Thanks for letting us know. Moving this one over to the
> dev list to discuss further.
>
> Christopher, looks like it might also be good to include iterator
> javadocs despite not being in public API (interfaces, and
> o.a.a.c.i.user?).
>
> -------- Original Message --------
> Subject: 1.6 Javadoc missing classes
> Date: Fri, 4 Mar 2016 15:59:26 -0500
> From: Dan Blum <dblum@bbn.com <ma...@bbn.com>>
> Reply-To: user@accumulo.apache.org <ma...@accumulo.apache.org>
> To: <user@accumulo.apache.org <ma...@accumulo.apache.org>>
>
> A lot of classes seem to have gone missing from
> http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> would be an
> obvious example.
>
Re: 1.6 Javadoc missing classes
Posted by Josh Elser <jo...@gmail.com>.
So this just bit me. I went looking for Iterators and was confused why
they weren't there.
Christopher wrote:
> Sure, we can include that. Are there any other classes which would be
> good to have javadocs for which aren't public API?
>
> On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>> wrote:
>
> Good catch, Dan. Thanks for letting us know. Moving this one over to the
> dev list to discuss further.
>
> Christopher, looks like it might also be good to include iterator
> javadocs despite not being in public API (interfaces, and
> o.a.a.c.i.user?).
>
> -------- Original Message --------
> Subject: 1.6 Javadoc missing classes
> Date: Fri, 4 Mar 2016 15:59:26 -0500
> From: Dan Blum <dblum@bbn.com <ma...@bbn.com>>
> Reply-To: user@accumulo.apache.org <ma...@accumulo.apache.org>
> To: <user@accumulo.apache.org <ma...@accumulo.apache.org>>
>
> A lot of classes seem to have gone missing from
> http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> would be an
> obvious example.
>
Re: 1.6 Javadoc missing classes
Posted by Josh Elser <jo...@gmail.com>.
Maybe the distributed tracing APIs?
Christopher wrote:
> Sure, we can include that. Are there any other classes which would be
> good to have javadocs for which aren't public API?
>
> On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <josh.elser@gmail.com
> <ma...@gmail.com>> wrote:
>
> Good catch, Dan. Thanks for letting us know. Moving this one over to the
> dev list to discuss further.
>
> Christopher, looks like it might also be good to include iterator
> javadocs despite not being in public API (interfaces, and
> o.a.a.c.i.user?).
>
> -------- Original Message --------
> Subject: 1.6 Javadoc missing classes
> Date: Fri, 4 Mar 2016 15:59:26 -0500
> From: Dan Blum <dblum@bbn.com <ma...@bbn.com>>
> Reply-To: user@accumulo.apache.org <ma...@accumulo.apache.org>
> To: <user@accumulo.apache.org <ma...@accumulo.apache.org>>
>
> A lot of classes seem to have gone missing from
> http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator
> would be an
> obvious example.
>
Re: 1.6 Javadoc missing classes
Posted by Christopher <ct...@apache.org>.
Sure, we can include that. Are there any other classes which would be good
to have javadocs for which aren't public API?
On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <jo...@gmail.com> wrote:
> Good catch, Dan. Thanks for letting us know. Moving this one over to the
> dev list to discuss further.
>
> Christopher, looks like it might also be good to include iterator
> javadocs despite not being in public API (interfaces, and o.a.a.c.i.user?).
>
> -------- Original Message --------
> Subject: 1.6 Javadoc missing classes
> Date: Fri, 4 Mar 2016 15:59:26 -0500
> From: Dan Blum <db...@bbn.com>
> Reply-To: user@accumulo.apache.org
> To: <us...@accumulo.apache.org>
>
> A lot of classes seem to have gone missing from
> http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator would be
> an
> obvious example.
>
>
Re: 1.6 Javadoc missing classes
Posted by Christopher <ct...@apache.org>.
Sure, we can include that. Are there any other classes which would be good
to have javadocs for which aren't public API?
On Fri, Mar 4, 2016 at 4:03 PM Josh Elser <jo...@gmail.com> wrote:
> Good catch, Dan. Thanks for letting us know. Moving this one over to the
> dev list to discuss further.
>
> Christopher, looks like it might also be good to include iterator
> javadocs despite not being in public API (interfaces, and o.a.a.c.i.user?).
>
> -------- Original Message --------
> Subject: 1.6 Javadoc missing classes
> Date: Fri, 4 Mar 2016 15:59:26 -0500
> From: Dan Blum <db...@bbn.com>
> Reply-To: user@accumulo.apache.org
> To: <us...@accumulo.apache.org>
>
> A lot of classes seem to have gone missing from
> http://accumulo.apache.org/1.6/apidocs/ - SortedKeyValueIterator would be
> an
> obvious example.
>
>