adding PHPDoc

lib/db.php

@@ -49,10 +49,10 @@ class OC_DB {
 	/**
 	 * @var \Doctrine\DBAL\Connection
 	 */
-	static private $connection; //the prefered connection to use, only Doctrine
+	static private $connection; //the preferred connection to use, only Doctrine
 	static private $backend=null;
 	/**
-	 * @var Doctrine
+	 * @var \Doctrine\DBAL\Connection
 	 */
 	static private $DOCTRINE=null;
 
@@ -652,7 +652,7 @@ class OC_DB {
 	/**
 	 * check if a result is an error and throws an exception, works with \Doctrine\DBAL\DBALException
 	 * @param mixed $result
-	 * @param string message
+	 * @param string $message
 	 * @return void
 	 * @throws DatabaseException
 	 */

lib/db/mdb2schemawriter.php

@@ -7,6 +7,12 @@
  */
 
 class OC_DB_MDB2SchemaWriter {
+
+	/**
+	 * @param $file
+	 * @param \Doctrine\DBAL\Schema\AbstractSchemaManager $sm
+	 * @return bool
+	 */
 	static public function saveSchemaToFile($file, $sm) {
 		$xml = new SimpleXMLElement('<database/>');
 		$xml->addChild('name', OC_Config::getValue( "dbname", "owncloud" ));

lib/db/schema.php

@@ -12,8 +12,9 @@ class OC_DB_Schema {
 
 	/**
 	 * @brief saves database scheme to xml file
+	 * @param \Doctrine\DBAL\Connection $conn
 	 * @param string $file name of file
-	 * @param int $mode
+	 * @param int|string $mode
 	 * @return bool
 	 *
 	 * TODO: write more documentation