HttpRequest.headers deprecated in JAR file - but not in API docs

alwayswill / google-api-java-client

Automatically exported from code.google.com/p/google-api-java-client

0 stars 0 forks source link

HttpRequest.headers deprecated in JAR file - but not in API docs #265

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago

Version of google-api-java-client (e.g. 1.4.1-beta)?

1.4.1-beta

Java environment (e.g. Java 6, Android 2.3, App Engine 1.4.3)?

JDK 1.5.0_12 and JDK 1.6.0_26

Describe the problem.

Running with -Xlint:deprecation issues this warning:

org/springhaven/testing/GdataTest1.java:76: warning: [deprecation] headers in 
com.google.api.client.http.HttpRequest has been deprec
ated

How would you expect it to be fixed?

Either un-deprectate the headers field in HttpRequest, or properly document the 
fact that this field is deprecated and what correct non-deprecated 
functionality we should use in place of HttpRequest.headers

Original issue reported on code.google.com by darkfoxp...@gmail.com on 12 Aug 2011 at 9:21

GoogleCodeExporter commented 9 years ago

It is deprecated in version 1.5.0-beta, not 1.4.0-beta.  Please take a look at 
the new API docs for more details:

http://javadoc.google-http-java-client.googlecode.com/hg/1.5.0-beta/com/google/a
pi/client/http/HttpRequest.html#headers

Original comment by yan...@google.com on 12 Aug 2011 at 9:53

Changed state: Invalid

GoogleCodeExporter commented 9 years ago

Okay.  I hadn't realized that I'd downloaded the 1.5.0-beta API.

In this case, shouldn't there be a link *SOMEWHERE* on 
http://code.google.com/p/google-api-java-client/ about the 1.5.0-beta APIs?

There's not even a mention that it's been released - and if it HASN'T been 
released, why is it on the downloads page?

Original comment by darkfoxp...@gmail.com on 12 Aug 2011 at 10:39

GoogleCodeExporter commented 9 years ago

I want to add:  Thank you for pointing me to the documentation URL and for 
informing me of the version difference.

My previous comment was admittedly 'snippy' and I apologise for that.

However, snippy or not, my point is valid.  Given that the 1.5.0-beta API is 
the first link that shows up in the Downloads page, there should be *some* 
mention of it, along with appropriate documentation links, etc., on the front 
page.

Original comment by darkfoxp...@gmail.com on 12 Aug 2011 at 10:43

GoogleCodeExporter commented 9 years ago

I agree your point is valid.  We'll update the documentation next week.

Original comment by yan...@google.com on 13 Aug 2011 at 2:15

Changed state: Accepted
Added labels: Priority-High, Type-Task
Removed labels: Priority-Medium, Type-Defect

GoogleCodeExporter commented 9 years ago

Closing as invalid for the original issue, but we still need to announce 
1.5.0-beta.

Original comment by yan...@google.com on 16 Aug 2011 at 2:38

Changed state: Invalid