yos-social-php: refactored oauth to match yap 1.6 + added oauth unit

tests + yql open tables support + improved phpdoc + INSTALL

INSTALL.txt

@@ -1,5 +1,7 @@
+=================
 Yahoo! OS PHP SDK
-=============
+=================
+
 After downloading and unpackaging the release, copy the contents of yosdk/lib
 to a directory that is accessible via the PHP require/require_once methods. In
 your PHP scripts, require the Yahoo.inc file:
@@ -46,8 +48,8 @@ YahooLogger::setDebugDestination('LOG');
 Storing OAuth credentials on filesystem, memcache, cookies
 ==========================================================
 
-By default OAuth credential (request + access tokens) are stored in PHP sessions.
-PHP sessions can easily be configured to work from local filesystem, database, or
+By default, OAuth credentials (request + access tokens) are stored in PHP sessions.
+PHP sessions can easily be configured to work from a local filesystem, a database, or
 a memcache instance. The sample apps provide working examples of filesystem storage
 and memcache storage.
 
@@ -58,9 +60,9 @@ Filesystem Session Storage (default)
 // Include the YOS library.
 require dirname(__FILE__).'/../lib/Yahoo.inc';
 
-// use memcache to store oauth credentials via php native sessions
-ini_set('session.save_handler', 'memcache');
-session_save_path('tcp://localhost:11211?persistent=1&weight=1&timeout=1&retry_interval=15');
+// use local filesystem to store oauth credentials via php native sessions
+ini_set('session.save_handler', 'files');
+session_save_path('/tmp/');
 session_start();
 
 ========================

lib/JSON.php

@@ -1,5 +1,4 @@
 <?php
-/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
 
 /**
  * Converts to and from JSON format.
@@ -666,7 +665,7 @@ function decode($str)
                                 // element in an associative array,
                                 // for now
                                 $parts = array();
-                                
+
                                 if (preg_match('/^\s*(["\'].*[^\\\]["\'])\s*:\s*(\S.*),?$/Uis', $slice, $parts)) {
                                     // "name":value pair
                                     $key = $this->decode($parts[1]);
@@ -802,5 +801,3 @@ function Services_JSON_Error($message = 'unknown error', $code = null,
     }
 
 }
-
-?>