Merge pull request square#484 from koalahamlet/master

Add 'Logging' section to website

website/index.html

@@ -215,6 +215,16 @@ <h4>Custom Error Handling</h4>
     .build();</pre>
             <p>Note that if the return exception is checked, it must be declared on the interface method. It is recommended that you pass the supplied <code>RetrofitError</code> as the cause to any new exceptions you throw.</p>
 
+            <h4>Logging</h4>
+            <p>If you need to take a closer look at the requests and responses you can easily add logging levels to the <code>RestAdapter</code> with the <code>LogLevel</code> property. The possible logging levels are <code>BASIC</code>, <code>FULL</code>, <code>HEADERS</code>, and <code>NONE</code>.</p>
+            <p>The following code shows the addition of a full log level which will log the headers, body, and metadata for both requests and responses.</p>
+            <pre class="prettyprint">
+RestAdapter restAdapter = new RestAdapter.Builder()
+    .setLogLevel(RestAdapter.LogLevel.FULL)
+    .setEndpoint("https://api.github.com")
+    .build();</pre>
+            <p>This logging can be added or changed at any point in the <code>RestAdapter</code>'s lifecycle by calling the same <code>.setLogLevel()</code> method and supplying a different <code>LogLevel</code> value.</p>
+
             <h3 id="download">Download</h3>
             <p><a href="http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=com.squareup.retrofit&a=retrofit&v=LATEST" class="dl version-href">&darr; <span class="version-tag">Latest</span> JAR</a></p>
             <p>The source code to the Retrofit, its samples, and this website is <a href="http://github.com/square/retrofit">available on GitHub</a>.</p>