On Sep 1, 2011, at 8:08 AM, Michael McCandless wrote: > OK thanks Jukka. > > We might want to mark APIs like TemporaryResources "internal" in the > javadocs, ie, that we reseve the right to suddenly change them and > they are just public so that the sub-packages in Tika can use them. > In Lucene we added @lucene.internal javadoc tag for this (it expands > into descriptive prose).
So long as no one will yell at me when I inevitably forget to do this, and/or am inconsistent (per usual) about my use of it :) Cheers, Chris > > Mike McCandless > > http://blog.mikemccandless.com > > On Thu, Sep 1, 2011 at 7:33 AM, Jukka Zitting <[email protected]> wrote: >> Hi, >> >> On Thu, Sep 1, 2011 at 12:23 PM, Michael McCandless >> <[email protected]> wrote: >>> Can we just remove (not deprecate) TemporaryFiles...? >>> (We are not at 1.0 release yet). >> >> Yes, I think we should do that. >> >> I didn't want to do this in the scope of TIKA-701 so I rather left a >> deprecated backwards-compatible class there. >> >> I filed TIKA-703 [1] to track the removal of all deprecated parts of >> our public API. >> >> [1] https://issues.apache.org/jira/browse/TIKA-703 >> >> BR, >> >> Jukka Zitting >> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Chris Mattmann, Ph.D. Senior Computer Scientist NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA Office: 171-266B, Mailstop: 171-246 Email: [email protected] WWW: http://sunset.usc.edu/~mattmann/ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Adjunct Assistant Professor, Computer Science Department University of Southern California, Los Angeles, CA 90089 USA ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
