diff --git a/lib/db.php b/lib/db.php
index ac9ed77898f..9e5bd2d99b3 100644
--- a/lib/db.php
+++ b/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
 	 */
diff --git a/lib/db/mdb2schemawriter.php b/lib/db/mdb2schemawriter.php
index a6367a0e354..21b43cbfe80 100644
--- a/lib/db/mdb2schemawriter.php
+++ b/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" ));
diff --git a/lib/db/schema.php b/lib/db/schema.php
index d862f3d25c9..3d5b404825a 100644
--- a/lib/db/schema.php
+++ b/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