From: Carl Schwan Date: Fri, 4 Mar 2022 10:42:03 +0000 (+0100) Subject: Clarify that some interface are not meant to be implemented X-Git-Tag: v24.0.0beta1~111^2~1 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=831aebf4f63835d0638d6cac656cd4bdcc863f31;p=nextcloud-server.git Clarify that some interface are not meant to be implemented This make sure that apps don't implement this interfaces and gives us more liberty to add new methods to them (as long as it is compatible from an usage point of view) Signed-off-by: Carl Schwan Co-authored-by: Vincent Petry --- diff --git a/lib/public/Share/IManager.php b/lib/public/Share/IManager.php index 8b1f5144b9a..ff4b6af19e0 100644 --- a/lib/public/Share/IManager.php +++ b/lib/public/Share/IManager.php @@ -37,7 +37,11 @@ use OCP\Share\Exceptions\GenericShareException; use OCP\Share\Exceptions\ShareNotFound; /** - * Interface IManager + * This interface allows to manage sharing files between users and groups. + * + * This interface must not be implemented in your application but + * instead should be used as a service and injected in your code with + * dependency injection. * * @since 9.0.0 */ diff --git a/lib/public/UserStatus/IManager.php b/lib/public/UserStatus/IManager.php index f709768d717..354a1e19ee9 100644 --- a/lib/public/UserStatus/IManager.php +++ b/lib/public/UserStatus/IManager.php @@ -26,7 +26,11 @@ declare(strict_types=1); namespace OCP\UserStatus; /** - * Interface IManager + * This interface allows to manage the user status. + * + * This interface must not be implemented in your application but + * instead should be used as a service and injected in your code with + * dependency injection. * * @since 20.0.0 */