[Pkg-owncloud-commits] [owncloud] 35/55: Improve phpdoc

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to annotated tag v5.0.16RC1
in repository owncloud.

commit 61425344cc223a1f4fb6edc36d332d3ded761f2e
Author: Robin Appelman <icewind at owncloud.com>
Date:   Thu Apr 3 15:30:41 2014 +0200

    Improve phpdoc
---
 apps/files_sharing/lib/cache.php | 7 +++++++
 lib/files/cache/cache.php        | 4 +++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/apps/files_sharing/lib/cache.php b/apps/files_sharing/lib/cache.php
index 38b6a5f..64ab183 100644
--- a/apps/files_sharing/lib/cache.php
+++ b/apps/files_sharing/lib/cache.php
@@ -336,6 +336,13 @@ class Shared_Cache extends Cache {
 		return $ids;
 	}
 
+	/**
+	 * get the path of a file on this storage by it's id
+	 *
+	 * @param int $id
+	 * @param string $pathEnd (optional) used internally for recursive calls
+	 * @return string | null
+	 **/
 	public function getPathById($id, $pathEnd = '') {
 		// direct shares are easy
 		if ($path = $this->getShareById($id)) {
diff --git a/lib/files/cache/cache.php b/lib/files/cache/cache.php
index d62a904..a30598f 100644
--- a/lib/files/cache/cache.php
+++ b/lib/files/cache/cache.php
@@ -660,7 +660,7 @@ class Cache {
 	}
 
 	/**
-	 * get the storage id of the storage for a file and the internal path of the file
+	 * path of a file on this storage by it's id
 	 *
 	 * @param int $id
 	 * @return string | null
@@ -677,6 +677,8 @@ class Cache {
 
 	/**
 	 * get the storage id of the storage for a file and the internal path of the file
+	 * unlike getPathById this does not limit the search to files on this storage and
+	 * instead does a global search in the cache table
 	 *
 	 * @param int $id
 	 * @return array, first element holding the storage id, second the path

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud.git