diff --git a/lib/composer/composer/InstalledVersions.php b/lib/composer/composer/InstalledVersions.php index 51e734a774b3e..cee8310f34762 100644 --- a/lib/composer/composer/InstalledVersions.php +++ b/lib/composer/composer/InstalledVersions.php @@ -255,7 +255,7 @@ public static function getRootPackage() /** * Returns the raw installed.php data for custom implementations * - * @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect. + * @deprecated 23.0.0 Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect. * @return array[] * @psalm-return array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array} */ diff --git a/lib/private/AppConfig.php b/lib/private/AppConfig.php index f6361ff2ac68d..ab9ec532df5a0 100644 --- a/lib/private/AppConfig.php +++ b/lib/private/AppConfig.php @@ -1295,7 +1295,7 @@ private function setAsLoaded(?bool $lazy): void { * @param string $default = null, default value if the key does not exist * * @return string the value or $default - * @deprecated - use getValue*() + * @deprecated 29.0.0 use getValue*() * * This function gets a value from the appconfig table. If the key does * not exist the default value will be returned @@ -1316,7 +1316,7 @@ public function getValue($app, $key, $default = null) { * @return bool True if the value was inserted or updated, false if the value was the same * @throws AppConfigTypeConflictException * @throws AppConfigUnknownKeyException - * @deprecated + * @deprecated 29.0.0 */ public function setValue($app, $key, $value) { /** @@ -1422,7 +1422,7 @@ private function convertTypedValue(string $value, int $type): string|int|float|b * @param string $app * * @return string[] - * @deprecated data sensitivity should be set when calling setValue*() + * @deprecated 29.0.0 data sensitivity should be set when calling setValue*() */ private function getSensitiveKeys(string $app): array { $sensitiveValues = [ @@ -1533,7 +1533,7 @@ private function getSensitiveKeys(string $app): array { * Clear all the cached app config values * New cache will be generated next time a config value is retrieved * - * @deprecated use {@see clearCache()} + * @deprecated 29.0.0 use {@see clearCache()} */ public function clearCachedConfig(): void { $this->clearCache(); diff --git a/lib/private/AppFramework/DependencyInjection/DIContainer.php b/lib/private/AppFramework/DependencyInjection/DIContainer.php index a96e050c0e643..37c070f6baa04 100644 --- a/lib/private/AppFramework/DependencyInjection/DIContainer.php +++ b/lib/private/AppFramework/DependencyInjection/DIContainer.php @@ -87,11 +87,11 @@ public function __construct(string $appName, array $urlParams = [], ?ServerConta $this->server->registerAppContainer($appName, $this); // aliases - /** @deprecated inject $appName */ + /** @deprecated 26.0.0 inject $appName */ $this->registerAlias('AppName', 'appName'); - /** @deprecated inject $webRoot*/ + /** @deprecated 26.0.0 inject $webRoot*/ $this->registerAlias('WebRoot', 'webRoot'); - /** @deprecated inject $userId */ + /** @deprecated 26.0.0 inject $userId */ $this->registerAlias('UserId', 'userId'); /** @@ -363,7 +363,7 @@ public function getAppName() { } /** - * @deprecated use IUserSession->isLoggedIn() + * @deprecated 12.0.0 use IUserSession->isLoggedIn() * @return boolean */ public function isLoggedIn() { @@ -371,7 +371,7 @@ public function isLoggedIn() { } /** - * @deprecated use IGroupManager->isAdmin($userId) + * @deprecated 12.0.0 use IGroupManager->isAdmin($userId) * @return boolean */ public function isAdminUser() { diff --git a/lib/private/Authentication/Token/PublicKeyTokenProvider.php b/lib/private/Authentication/Token/PublicKeyTokenProvider.php index 4eddd5c80f7d6..12c3a1d535bd1 100644 --- a/lib/private/Authentication/Token/PublicKeyTokenProvider.php +++ b/lib/private/Authentication/Token/PublicKeyTokenProvider.php @@ -430,7 +430,7 @@ private function hashToken(string $token): string { } /** - * @deprecated Fallback for instances where the secret might not have been set by accident + * @deprecated 26.0.0 Fallback for instances where the secret might not have been set by accident */ private function hashTokenWithEmptySecret(string $token): string { return hash('sha512', $token); diff --git a/lib/private/Cache/CappedMemoryCache.php b/lib/private/Cache/CappedMemoryCache.php index 2c2eab3209abd..999ed8a7a74e2 100644 --- a/lib/private/Cache/CappedMemoryCache.php +++ b/lib/private/Cache/CappedMemoryCache.php @@ -14,7 +14,7 @@ * * Uses a simple FIFO expiry mechanism * @template T - * @deprecated use OCP\Cache\CappedMemoryCache instead + * @deprecated 25.0.0 use OCP\Cache\CappedMemoryCache instead */ class CappedMemoryCache implements ICache, \ArrayAccess { private $capacity; diff --git a/lib/private/DB/Connection.php b/lib/private/DB/Connection.php index ecc6d09bc9536..0c6abc3dbda3d 100644 --- a/lib/private/DB/Connection.php +++ b/lib/private/DB/Connection.php @@ -282,7 +282,7 @@ public function getQueryBuilder(): IQueryBuilder { * Gets the QueryBuilder for the connection. * * @return \Doctrine\DBAL\Query\QueryBuilder - * @deprecated please use $this->getQueryBuilder() instead + * @deprecated 8.0.0 please use $this->getQueryBuilder() instead */ public function createQueryBuilder() { $backtrace = $this->getCallerBacktrace(); @@ -295,7 +295,7 @@ public function createQueryBuilder() { * Gets the ExpressionBuilder for the connection. * * @return \Doctrine\DBAL\Query\Expression\ExpressionBuilder - * @deprecated please use $this->getQueryBuilder()->expr() instead + * @deprecated 8.0.0 please use $this->getQueryBuilder()->expr() instead */ public function getExpressionBuilder() { $backtrace = $this->getCallerBacktrace(); diff --git a/lib/private/Files/Cache/Cache.php b/lib/private/Files/Cache/Cache.php index de66e8924a57d..9a6f7d41faa22 100644 --- a/lib/private/Files/Cache/Cache.php +++ b/lib/private/Files/Cache/Cache.php @@ -1113,7 +1113,7 @@ public function getPathById($id) { * * @param int $id * @return array first element holding the storage id, second the path - * @deprecated use getPathById() instead + * @deprecated 17.0.0 use getPathById() instead */ public static function getById($id) { $query = \OC::$server->getDatabaseConnection()->getQueryBuilder(); diff --git a/lib/private/Share20/Share.php b/lib/private/Share20/Share.php index 1c0b21b80388f..c1c13c77fa497 100644 --- a/lib/private/Share20/Share.php +++ b/lib/private/Share20/Share.php @@ -530,7 +530,7 @@ public function getToken() { * * @param int $parent * @return IShare - * @deprecated The new shares do not have parents. This is just here for legacy reasons. + * @deprecated 12.0.0 The new shares do not have parents. This is just here for legacy reasons. */ public function setParent($parent) { $this->parent = $parent; @@ -541,7 +541,7 @@ public function setParent($parent) { * Get the parent of this share. * * @return int - * @deprecated The new shares do not have parents. This is just here for legacy reasons. + * @deprecated 12.0.0 The new shares do not have parents. This is just here for legacy reasons. */ public function getParent() { return $this->parent; diff --git a/lib/private/User/Manager.php b/lib/private/User/Manager.php index 9a84b102a9901..64435b651d606 100644 --- a/lib/private/User/Manager.php +++ b/lib/private/User/Manager.php @@ -260,7 +260,7 @@ public function checkPasswordNoLogging($loginName, $password) { * @param int $limit * @param int $offset * @return IUser[] - * @deprecated since 27.0.0, use searchDisplayName instead + * @deprecated 27.0.0, use searchDisplayName instead */ public function search($pattern, $limit = null, $offset = null) { $users = []; diff --git a/lib/private/legacy/OC_Helper.php b/lib/private/legacy/OC_Helper.php index 6da063ef2ce58..735f6613f386b 100644 --- a/lib/private/legacy/OC_Helper.php +++ b/lib/private/legacy/OC_Helper.php @@ -417,7 +417,7 @@ public static function uploadLimit() { /** * Checks if a function is available * - * @deprecated Since 25.0.0 use \OCP\Util::isFunctionEnabled instead + * @deprecated 25.0.0 use \OCP\Util::isFunctionEnabled instead */ public static function is_function_enabled(string $function_name): bool { return \OCP\Util::isFunctionEnabled($function_name); @@ -425,7 +425,7 @@ public static function is_function_enabled(string $function_name): bool { /** * Try to find a program - * @deprecated Since 25.0.0 Use \OC\BinaryFinder directly + * @deprecated 25.0.0 Use \OC\BinaryFinder directly */ public static function findBinaryPath(string $program): ?string { $result = \OCP\Server::get(IBinaryFinder::class)->findBinaryPath($program); diff --git a/lib/private/legacy/OC_JSON.php b/lib/private/legacy/OC_JSON.php index a9682e2cce7df..94db596f8c597 100644 --- a/lib/private/legacy/OC_JSON.php +++ b/lib/private/legacy/OC_JSON.php @@ -12,7 +12,7 @@ class OC_JSON { /** * Check if the app is enabled, send json error msg if not * @param string $app - * @deprecated Use the AppFramework instead. It will automatically check if the app is enabled. + * @deprecated 12.0.0 Use the AppFramework instead. It will automatically check if the app is enabled. * @suppress PhanDeprecatedFunction */ public static function checkAppEnabled($app) { @@ -25,7 +25,7 @@ public static function checkAppEnabled($app) { /** * Check if the user is logged in, send json error msg if not - * @deprecated Use annotation based ACLs from the AppFramework instead + * @deprecated 12.0.0 Use annotation based ACLs from the AppFramework instead * @suppress PhanDeprecatedFunction */ public static function checkLoggedIn() { @@ -41,7 +41,7 @@ public static function checkLoggedIn() { /** * Check an ajax get/post call if the request token is valid, send json error msg if not. - * @deprecated Use annotation based CSRF checks from the AppFramework instead + * @deprecated 12.0.0 Use annotation based CSRF checks from the AppFramework instead * @suppress PhanDeprecatedFunction */ public static function callCheck() { @@ -59,7 +59,7 @@ public static function callCheck() { /** * Check if the user is a admin, send json error msg if not. - * @deprecated Use annotation based ACLs from the AppFramework instead + * @deprecated 12.0.0 Use annotation based ACLs from the AppFramework instead * @suppress PhanDeprecatedFunction */ public static function checkAdminUser() { @@ -72,7 +72,7 @@ public static function checkAdminUser() { /** * Send json error msg - * @deprecated Use a AppFramework JSONResponse instead + * @deprecated 12.0.0 Use a AppFramework JSONResponse instead * @suppress PhanDeprecatedFunction * @psalm-taint-escape html */ @@ -84,7 +84,7 @@ public static function error($data = []) { /** * Send json success msg - * @deprecated Use a AppFramework JSONResponse instead + * @deprecated 12.0.0 Use a AppFramework JSONResponse instead * @suppress PhanDeprecatedFunction * @psalm-taint-escape html */ @@ -96,7 +96,7 @@ public static function success($data = []) { /** * Encode JSON - * @deprecated Use a AppFramework JSONResponse instead + * @deprecated 12.0.0 Use a AppFramework JSONResponse instead */ private static function encode($data) { return json_encode($data, JSON_HEX_TAG); diff --git a/lib/private/legacy/OC_User.php b/lib/private/legacy/OC_User.php index b8a00de84cc3e..8fdba3a62b2f5 100644 --- a/lib/private/legacy/OC_User.php +++ b/lib/private/legacy/OC_User.php @@ -251,7 +251,7 @@ public static function setUserId($uid) { /** * Check if the user is logged in, considers also the HTTP basic credentials * - * @deprecated use \OC::$server->getUserSession()->isLoggedIn() + * @deprecated 12.0.0 use \OC::$server->getUserSession()->isLoggedIn() * @return bool */ public static function isLoggedIn() { @@ -353,7 +353,7 @@ public static function setPassword($uid, $password, $recoveryPassword = null) { * @return string * * returns the path to the users home directory - * @deprecated Use \OC::$server->getUserManager->getHome() + * @deprecated 12.0.0 Use \OC::$server->getUserManager->getHome() */ public static function getHome($uid) { $user = \OC::$server->getUserManager()->get($uid); @@ -373,7 +373,7 @@ public static function getHome($uid) { * @return array associative array with all display names (value) and corresponding uids (key) * * Get a list of all display names and user ids. - * @deprecated Use \OC::$server->getUserManager->searchDisplayName($search, $limit, $offset) instead. + * @deprecated 12.0.0 Use \OC::$server->getUserManager->searchDisplayName($search, $limit, $offset) instead. */ public static function getDisplayNames($search = '', $limit = null, $offset = null) { $displayNames = []; diff --git a/lib/private/legacy/OC_Util.php b/lib/private/legacy/OC_Util.php index 84bb0b645d5d0..d56a06b80c66a 100644 --- a/lib/private/legacy/OC_Util.php +++ b/lib/private/legacy/OC_Util.php @@ -236,7 +236,7 @@ public static function getVersionString() { } /** - * @deprecated the value is of no use anymore + * @deprecated 11.0.0 the value is of no use anymore * @return string */ public static function getEditionString() { diff --git a/lib/public/AppFramework/Http/EmptyContentSecurityPolicy.php b/lib/public/AppFramework/Http/EmptyContentSecurityPolicy.php index 0a6258be94138..7712fb3e9bd80 100644 --- a/lib/public/AppFramework/Http/EmptyContentSecurityPolicy.php +++ b/lib/public/AppFramework/Http/EmptyContentSecurityPolicy.php @@ -106,7 +106,7 @@ public function useJsNonce($nonce) { * @param bool $state * @return $this * @since 8.1.0 - * @deprecated Eval should not be used anymore. Please update your scripts. This function will stop functioning in a future version of Nextcloud. + * @deprecated 17.0.0 Eval should not be used anymore. Please update your scripts. This function will stop functioning in a future version of Nextcloud. */ public function allowEvalScript($state = true) { $this->evalScriptAllowed = $state; diff --git a/lib/public/BackgroundJob/IJob.php b/lib/public/BackgroundJob/IJob.php index 6988e1e682a14..28a7df1c3771f 100644 --- a/lib/public/BackgroundJob/IJob.php +++ b/lib/public/BackgroundJob/IJob.php @@ -10,7 +10,7 @@ use OCP\ILogger; /** - * This interface represend a backgroud job run with cron + * This interface represents a background job run with cron * * To implement a background job, you must extend either \OCP\BackgroundJob\Job, * \OCP\BackgroundJob\TimedJob or \OCP\BackgroundJob\QueuedJob @@ -33,7 +33,7 @@ interface IJob { * @param IJobList $jobList The job list that manages the state of this job * @param ILogger|null $logger * @since 7.0.0 - * @deprecated since 25.0.0 Use start() instead. This method will be removed + * @deprecated 25.0.0 Use start() instead. This method will be removed * with the ILogger interface */ public function execute(IJobList $jobList, ?ILogger $logger = null); diff --git a/lib/public/BackgroundJob/Job.php b/lib/public/BackgroundJob/Job.php index 3b25db311a43a..2483387a9c93c 100644 --- a/lib/public/BackgroundJob/Job.php +++ b/lib/public/BackgroundJob/Job.php @@ -39,7 +39,7 @@ public function __construct(ITimeFactory $time) { * @return void * * @since 15.0.0 - * @deprecated since 25.0.0 Use start() instead. This method will be removed + * @deprecated 25.0.0 Use start() instead. This method will be removed * with the ILogger interface */ public function execute(IJobList $jobList, ?ILogger $logger = null) { diff --git a/lib/public/BackgroundJob/QueuedJob.php b/lib/public/BackgroundJob/QueuedJob.php index caacff42b1a7e..75e27d1d60fb9 100644 --- a/lib/public/BackgroundJob/QueuedJob.php +++ b/lib/public/BackgroundJob/QueuedJob.php @@ -22,7 +22,7 @@ abstract class QueuedJob extends Job { * @param ILogger|null $logger * * @since 15.0.0 - * @deprecated since 25.0.0 Use start() instead. This method will be removed + * @deprecated 25.0.0 Use start() instead. This method will be removed * with the ILogger interface */ final public function execute($jobList, ?ILogger $logger = null) { diff --git a/lib/public/BackgroundJob/TimedJob.php b/lib/public/BackgroundJob/TimedJob.php index 6665d19478980..bec3f21fe16df 100644 --- a/lib/public/BackgroundJob/TimedJob.php +++ b/lib/public/BackgroundJob/TimedJob.php @@ -67,7 +67,7 @@ public function setTimeSensitivity(int $sensitivity): void { * @param ILogger|null $logger * * @since 15.0.0 - * @deprecated since 25.0.0 Use start() instead + * @deprecated 25.0.0 Use start() instead */ final public function execute(IJobList $jobList, ?ILogger $logger = null) { $this->start($jobList); diff --git a/lib/public/Collaboration/AutoComplete/AutoCompleteEvent.php b/lib/public/Collaboration/AutoComplete/AutoCompleteEvent.php index 7151f05aef3c0..1a2251783106b 100644 --- a/lib/public/Collaboration/AutoComplete/AutoCompleteEvent.php +++ b/lib/public/Collaboration/AutoComplete/AutoCompleteEvent.php @@ -12,7 +12,7 @@ /** * @since 16.0.0 - * @deprecated Use {@see AutoCompleteFilterEvent} instead + * @deprecated 28.0.0 Use {@see AutoCompleteFilterEvent} instead */ class AutoCompleteEvent extends GenericEvent { /** diff --git a/lib/public/GroupInterface.php b/lib/public/GroupInterface.php index 9329fe4a45409..a6c01fa1d1130 100644 --- a/lib/public/GroupInterface.php +++ b/lib/public/GroupInterface.php @@ -35,7 +35,7 @@ interface GroupInterface { /** * @since 12.0.0 - * @deprecated 29.0.0 + * @deprecated 29.0.0 */ public const REMOVE_FROM_GOUP = 0x00001000; // oops diff --git a/lib/public/Share_Backend.php b/lib/public/Share_Backend.php index b77731ccdfda5..794d72b787336 100644 --- a/lib/public/Share_Backend.php +++ b/lib/public/Share_Backend.php @@ -30,7 +30,7 @@ public function isValidSource($itemSource, $uidOwner); * Get a unique name of the item for the specified user * @param string $itemSource * @param string|false $shareWith User the item is being shared with - * @param array|null $exclude List of similar item names already existing as shared items @deprecated since version OC7 + * @param array|null $exclude List of similar item names already existing as shared items @deprecated 7.0.0 * @return string Target name * * This function needs to verify that the user does not already have an item with this name. diff --git a/lib/public/Support/CrashReport/IRegistry.php b/lib/public/Support/CrashReport/IRegistry.php index 9da4f24aaa34f..503a21038caf3 100644 --- a/lib/public/Support/CrashReport/IRegistry.php +++ b/lib/public/Support/CrashReport/IRegistry.php @@ -14,7 +14,7 @@ /** * @since 13.0.0 - * @deprecated used internally only + * @deprecated 20.0.0 used internally only */ interface IRegistry { /** @@ -35,7 +35,7 @@ public function register(IReporter $reporter): void; * @param string $category * @param array $context * - * @deprecated used internally only + * @deprecated 20.0.0 used internally only * @since 15.0.0 */ public function delegateBreadcrumb(string $message, string $category, array $context = []): void; @@ -46,7 +46,7 @@ public function delegateBreadcrumb(string $message, string $category, array $con * @param Exception|Throwable $exception * @param array $context * - * @deprecated used internally only + * @deprecated 20.0.0 used internally only * @since 13.0.0 */ public function delegateReport($exception, array $context = []); @@ -59,7 +59,7 @@ public function delegateReport($exception, array $context = []); * * @return void * - * @deprecated used internally only + * @deprecated 20.0.0 used internally only * @since 17.0.0 */ public function delegateMessage(string $message, array $context = []): void; @@ -68,7 +68,7 @@ public function delegateMessage(string $message, array $context = []): void; * Check if any reporter has been registered to delegate to * * @return bool - * @deprecated use internally only + * @deprecated 20.0.0 use internally only * @since 26.0.0 */ public function hasReporters(): bool;