@brief is removed completely

This commit is contained in:
Michael 2020-01-19 06:05:23 +00:00
parent fd1f1999f0
commit 0a4119adaf
170 changed files with 901 additions and 962 deletions

View file

@ -83,7 +83,7 @@ class Addon
/**
* @brief Synchronize addons:
* Synchronize addons:
*
* system.addon contains a comma-separated list of names
* of addons which are used on this system.
@ -130,7 +130,7 @@ class Addon
}
/**
* @brief uninstalls an addon.
* uninstalls an addon.
*
* @param string $addon name of the addon
* @return void
@ -157,7 +157,7 @@ class Addon
}
/**
* @brief installs an addon.
* installs an addon.
*
* @param string $addon name of the addon
* @return bool
@ -249,7 +249,7 @@ class Addon
}
/**
* @brief Parse addon comment in search of addon infos.
* Parse addon comment in search of addon infos.
*
* like
* \code

View file

@ -4,14 +4,14 @@
*
* @file include/Core/Config.php
*
* @brief Contains the class with methods for system configuration
* Contains the class with methods for system configuration
*/
namespace Friendica\Core;
use Friendica\DI;
/**
* @brief Arbitrary system configuration storage
* Arbitrary system configuration storage
*
* Note:
* If we ever would decide to return exactly the variable type as entered,
@ -20,7 +20,7 @@ use Friendica\DI;
class Config
{
/**
* @brief Loads all configuration values of family into a cached storage.
* Loads all configuration values of family into a cached storage.
*
* @param string $cat The category of the configuration value
*
@ -32,8 +32,7 @@ class Config
}
/**
* @brief Get a particular user's config variable given the category name
* ($family) and a key.
* Get a particular user's config variable given the category name ($family) and a key.
*
* @param string $cat The category of the configuration value
* @param string $key The configuration key to query
@ -48,8 +47,6 @@ class Config
}
/**
* @brief Sets a configuration value for system config
*
* Stores a config value ($value) in the category ($cat) under the key ($key)
*
* Note: Please do not store booleans - convert to 0/1 integer values!
@ -66,7 +63,7 @@ class Config
}
/**
* @brief Deletes the given key from the system configuration.
* Deletes the given key from the system configuration.
*
* @param string $cat The category of the configuration value
* @param string $key The configuration key to delete

View file

@ -9,7 +9,7 @@ interface IConfiguration
{
/**
* @brief Loads all configuration values of family into a cached storage.
* Loads all configuration values of family into a cached storage.
*
* All configuration values of the system are stored in the cache ( @see ConfigCache )
*
@ -20,7 +20,7 @@ interface IConfiguration
function load(string $cat = 'config');
/**
* @brief Get a particular user's config variable given the category name
* Get a particular user's config variable given the category name
* ($cat) and a $key.
*
* Get a particular config value from the given category ($cat)
@ -37,7 +37,7 @@ interface IConfiguration
function get(string $cat, string $key, $default_value = null, bool $refresh = false);
/**
* @brief Sets a configuration value for system config
* Sets a configuration value for system config
*
* Stores a config value ($value) in the category ($cat) under the key ($key)
*
@ -52,7 +52,7 @@ interface IConfiguration
function set(string $cat, string $key, $value);
/**
* @brief Deletes the given key from the system configuration.
* Deletes the given key from the system configuration.
*
* Removes the configured value from the stored cache in $this->configCache
* (@see ConfigCache) and removes it from the database (@see IConfigAdapter).

View file

@ -45,7 +45,7 @@ class Hook
}
/**
* @brief Adds a new hook to the hooks array.
* Adds a new hook to the hooks array.
*
* This function is meant to be called by modules on each page load as it works after loadHooks has been called.
*
@ -62,7 +62,7 @@ class Hook
}
/**
* @brief Registers a hook.
* Registers a hook.
*
* This function is meant to be called once when an addon is enabled for example as it doesn't add to the current hooks.
*
@ -127,7 +127,7 @@ class Hook
}
/**
* @brief Forks a hook.
* Forks a hook.
*
* Use this function when you want to fork a hook via the worker.
*
@ -162,7 +162,7 @@ class Hook
}
/**
* @brief Calls a hook.
* Calls a hook.
*
* Use this function when you want to be able to allow a hook to manipulate
* the provided data.
@ -181,7 +181,7 @@ class Hook
}
/**
* @brief Calls a single hook.
* Calls a single hook.
*
* @param App $a
* @param string $name of the hook to call

View file

@ -36,7 +36,7 @@ class L10n
}
/**
* @brief Return the localized version of the provided string with optional string interpolation
* Return the localized version of the provided string with optional string interpolation
*
* This function takes a english string as parameter, and if a localized version
* exists for the current language, substitutes it before performing an eventual
@ -58,7 +58,7 @@ class L10n
}
/**
* @brief Return the localized version of a singular/plural string with optional string interpolation
* Return the localized version of a singular/plural string with optional string interpolation
*
* This function takes two english strings as parameters, singular and plural, as
* well as a count. If a localized version exists for the current language, they
@ -83,7 +83,7 @@ class L10n
}
/**
* @brief Return installed languages codes as associative array
* Return installed languages codes as associative array
*
* Scans the view/lang directory for the existence of "strings.php" files, and
* returns an alphabetical list of their folder names (@-char language codes).
@ -99,7 +99,7 @@ class L10n
}
/**
* @brief Translate days and months names.
* Translate days and months names.
*
* @param string $s String with day or month name.
*
@ -111,7 +111,7 @@ class L10n
}
/**
* @brief Translate short days and months names.
* Translate short days and months names.
*
* @param string $s String with short day or month name.
*

View file

@ -132,7 +132,7 @@ class L10n
}
/**
* @brief Returns the preferred language from the HTTP_ACCEPT_LANGUAGE header
* Returns the preferred language from the HTTP_ACCEPT_LANGUAGE header
*
* @param string $sysLang The default fallback language
* @param array $server The $_SERVER array
@ -210,7 +210,7 @@ class L10n
}
/**
* @brief Return the localized version of the provided string with optional string interpolation
* Return the localized version of the provided string with optional string interpolation
*
* This function takes a english string as parameter, and if a localized version
* exists for the current language, substitutes it before performing an eventual
@ -245,7 +245,7 @@ class L10n
}
/**
* @brief Return the localized version of a singular/plural string with optional string interpolation
* Return the localized version of a singular/plural string with optional string interpolation
*
* This function takes two english strings as parameters, singular and plural, as
* well as a count. If a localized version exists for the current language, they

View file

@ -10,7 +10,7 @@ use Psr\Log\LoggerInterface;
use Psr\Log\LogLevel;
/**
* @brief Logger functions
* Logger functions
*/
class Logger
{
@ -231,8 +231,8 @@ class Logger
self::getWorker()->debug($message, $context);
}
/**
* @brief Logs the given message at the given log level
/**
* Logs the given message at the given log level
*
* @param string $msg
* @param string $level
@ -246,7 +246,8 @@ class Logger
}
/**
* @brief An alternative logger for development.
* An alternative logger for development.
*
* Works largely as log() but allows developers
* to isolate particular elements they are targetting
* personally without background noise

View file

@ -46,7 +46,7 @@ final class Process
}
/**
* @brief Checks if the maximum number of database processes is reached
* Checks if the maximum number of database processes is reached
*
* @return bool Is the limit reached?
*/
@ -86,7 +86,7 @@ final class Process
}
/**
* @brief Checks if the minimal memory is reached
* Checks if the minimal memory is reached
*
* @return bool Is the memory limit reached?
*/
@ -130,7 +130,7 @@ final class Process
}
/**
* @brief Checks if the maximum load is reached
* Checks if the maximum load is reached
*
* @return bool Is the load reached?
*/

View file

@ -11,22 +11,22 @@ use Friendica\Render\FriendicaSmarty;
use Friendica\Render\ITemplateEngine;
/**
* @brief This class handles Renderer related functions.
* This class handles Renderer related functions.
*/
class Renderer
{
/**
* @brief An array of registered template engines ('name'=>'class name')
* An array of registered template engines ('name'=>'class name')
*/
public static $template_engines = [];
/**
* @brief An array of instanced template engines ('name'=>'instance')
* An array of instanced template engines ('name'=>'instance')
*/
public static $template_engine_instance = [];
/**
* @brief An array for all theme-controllable parameters
* An array for all theme-controllable parameters
*
* Mostly unimplemented yet. Only options 'template_engine' and
* beyond are used.
@ -50,7 +50,7 @@ class Renderer
];
/**
* @brief This is our template processor
* This is our template processor
*
* @param string|FriendicaSmarty $s The string requiring macro substitution or an instance of FriendicaSmarty
* @param array $vars Key value pairs (search => replace)
@ -80,7 +80,7 @@ class Renderer
}
/**
* @brief Load a given template $s
* Load a given template $s
*
* @param string $s Template to load.
* @param string $root Optional.
@ -107,7 +107,7 @@ class Renderer
}
/**
* @brief Register template engine class
* Register template engine class
*
* @param string $class
*/
@ -126,7 +126,7 @@ class Renderer
}
/**
* @brief Return template engine instance.
* Return template engine instance.
*
* If $name is not defined, return engine defined by theme,
* or default
@ -153,7 +153,7 @@ class Renderer
}
/**
* @brief Returns the active template engine.
* Returns the active template engine.
*
* @return string the active template engine
*/

View file

@ -245,7 +245,6 @@ class Search
/**
* Searching for global contacts for autocompletion
*
* @brief Searching for global contacts for autocompletion
* @param string $search Name or part of a name or nick
* @param string $mode Search mode (e.g. "community")
* @param int $page Page number (starts at 1)

View file

@ -51,7 +51,7 @@ final class Cache implements SessionHandlerInterface
}
/**
* @brief Standard PHP session write callback
* Standard PHP session write callback
*
* This callback updates the stored session data and/or the expiration depending
* on the case. Uses the Session::expire for existing session, 5 minutes

View file

@ -58,7 +58,7 @@ final class Database implements SessionHandlerInterface
}
/**
* @brief Standard PHP session write callback
* Standard PHP session write callback
*
* This callback updates the DB-stored session data and/or the expiration depending
* on the case. Uses the Session::expire global for existing session, 5 minutes

View file

@ -11,7 +11,7 @@ use Psr\Log\LoggerInterface;
/**
* @brief Manage storage backends
* Manage storage backends
*
* Core code uses this class to get and set current storage backend class.
* Addons use this class to register and unregister additional backends.
@ -67,7 +67,7 @@ class StorageManager
}
/**
* @brief Return current storage backend class
* Return current storage backend class
*
* @return Storage\IStorage|null
*/
@ -77,7 +77,7 @@ class StorageManager
}
/**
* @brief Return storage backend class by registered name
* Return storage backend class by registered name
*
* @param string|null $name Backend name
* @param boolean $onlyUserBackend True, if just user specific instances should be returrned (e.g. not SystemResource)
@ -163,7 +163,7 @@ class StorageManager
}
/**
* @brief Set current storage backend class
* Set current storage backend class
*
* @param string $name Backend class name
*
@ -184,7 +184,7 @@ class StorageManager
}
/**
* @brief Get registered backends
* Get registered backends
*
* @return array
*/
@ -222,7 +222,7 @@ class StorageManager
}
/**
* @brief Unregister a storage backend class
* Unregister a storage backend class
*
* @param string $class Backend class name
*
@ -247,7 +247,7 @@ class StorageManager
}
/**
* @brief Move up to 5000 resources to storage $dest
* Move up to 5000 resources to storage $dest
*
* Copy existing data to destination storage and delete from source.
* This method cannot move to legacy in-table `data` field.

View file

@ -11,17 +11,17 @@ use Friendica\Util\XML;
/**
* @file include/Core/System.php
*
* @brief Contains the class with system relevant stuff
* Contains the class with system relevant stuff
*/
/**
* @brief System methods
* System methods
*/
class System
{
/**
* @brief Returns a string with a callstack. Can be used for logging.
* Returns a string with a callstack. Can be used for logging.
* @param integer $depth optional, default 4
* @return string
*/
@ -93,7 +93,7 @@ class System
}
/**
* @brief Send HTTP status header and exit.
* Send HTTP status header and exit.
*
* @param integer $val HTTP status result value
* @param string $message Error message. Optional.
@ -117,7 +117,7 @@ class System
}
/**
* @brief Encodes content to json.
* Encodes content to json.
*
* This function encodes an array to json format
* and adds an application/json HTTP header to the output.
@ -227,7 +227,7 @@ class System
}
/**
* @brief Returns the system user that is executing the script
* Returns the system user that is executing the script
*
* This mostly returns something like "www-data".
*
@ -244,7 +244,7 @@ class System
}
/**
* @brief Checks if a given directory is usable for the system
* Checks if a given directory is usable for the system
*
* @param $directory
* @param bool $check_writable

View file

@ -40,7 +40,7 @@ class Theme
}
/**
* @brief Parse theme comment in search of theme infos.
* Parse theme comment in search of theme infos.
*
* like
* \code
@ -110,7 +110,7 @@ class Theme
}
/**
* @brief Returns the theme's screenshot.
* Returns the theme's screenshot.
*
* The screenshot is expected as view/theme/$theme/screenshot.[png|jpg].
*
@ -182,7 +182,7 @@ class Theme
}
/**
* @brief Get the full path to relevant theme files by filename
* Get the full path to relevant theme files by filename
*
* This function searches in order in the current theme directory, in the current theme parent directory, and lastly
* in the base view/ folder.
@ -215,7 +215,7 @@ class Theme
}
/**
* @brief Return relative path to theme stylesheet file
* Return relative path to theme stylesheet file
*
* Provide a sane default if nothing is chosen or the specified theme does not exist.
*

View file

@ -14,7 +14,7 @@ class Update
const FAILED = 1;
/**
* @brief Function to check if the Database structure needs an update.
* Function to check if the Database structure needs an update.
*
* @param string $basePath The base path of this application
* @param boolean $via_worker Is the check run via the worker?

View file

@ -14,7 +14,7 @@ use Friendica\Util\Strings;
use Friendica\Worker\Delivery;
/**
* @brief UserImport class
* UserImport class
*/
class UserImport
{
@ -84,7 +84,7 @@ class UserImport
}
/**
* @brief Import account file exported from mod/uexport
* Import account file exported from mod/uexport
*
* @param array $file array from $_FILES
* @throws \Friendica\Network\HTTPException\InternalServerErrorException

View file

@ -14,11 +14,11 @@ use Friendica\Util\Network;
/**
* @file src/Core/Worker.php
*
* @brief Contains the class for the worker background job processing
* Contains the class for the worker background job processing
*/
/**
* @brief Worker methods
* Worker methods
*/
class Worker
{
@ -40,7 +40,7 @@ class Worker
private static $state;
/**
* @brief Processes the tasks that are in the workerqueue table
* Processes the tasks that are in the workerqueue table
*
* @param boolean $run_cron Should the cron processes be executed?
* @return void
@ -163,7 +163,7 @@ class Worker
}
/**
* @brief Check if non executed tasks do exist in the worker queue
* Check if non executed tasks do exist in the worker queue
*
* @return boolean Returns "true" if tasks are existing
* @throws \Exception
@ -177,7 +177,7 @@ class Worker
}
/**
* @brief Returns the number of deferred entries in the worker queue
* Returns the number of deferred entries in the worker queue
*
* @return integer Number of deferred entries in the worker queue
* @throws \Exception
@ -192,7 +192,7 @@ class Worker
}
/**
* @brief Returns the number of non executed entries in the worker queue
* Returns the number of non executed entries in the worker queue
*
* @return integer Number of non executed entries in the worker queue
* @throws \Exception
@ -207,7 +207,7 @@ class Worker
}
/**
* @brief Returns the highest priority in the worker queue that isn't executed
* Returns the highest priority in the worker queue that isn't executed
*
* @return integer Number of active worker processes
* @throws \Exception
@ -226,7 +226,7 @@ class Worker
}
/**
* @brief Returns if a process with the given priority is running
* Returns if a process with the given priority is running
*
* @param integer $priority The priority that should be checked
*
@ -240,7 +240,7 @@ class Worker
}
/**
* @brief Execute a worker entry
* Execute a worker entry
*
* @param array $queue Workerqueue entry
*
@ -359,7 +359,7 @@ class Worker
}
/**
* @brief Execute a function from the queue
* Execute a function from the queue
*
* @param array $queue Workerqueue entry
* @param string $funcname name of the function
@ -450,7 +450,7 @@ class Worker
}
/**
* @brief Checks if the number of database connections has reached a critical limit.
* Checks if the number of database connections has reached a critical limit.
*
* @return bool Are more than 3/4 of the maximum connections used?
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -533,7 +533,7 @@ class Worker
}
/**
* @brief fix the queue entry if the worker process died
* fix the queue entry if the worker process died
* @return void
* @throws \Exception
*/
@ -605,7 +605,7 @@ class Worker
}
/**
* @brief Checks if the number of active workers exceeds the given limits
* Checks if the number of active workers exceeds the given limits
*
* @return bool Are there too much workers running?
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -735,7 +735,7 @@ class Worker
}
/**
* @brief Returns the number of active worker processes
* Returns the number of active worker processes
*
* @return integer Number of active worker processes
* @throws \Exception
@ -749,7 +749,7 @@ class Worker
}
/**
* @brief Returns waiting jobs for the current process id
* Returns waiting jobs for the current process id
*
* @return array waiting workerqueue jobs
* @throws \Exception
@ -768,7 +768,7 @@ class Worker
}
/**
* @brief Returns the next jobs that should be executed
* Returns the next jobs that should be executed
*
* @return array array with next jobs
* @throws \Exception
@ -803,7 +803,7 @@ class Worker
}
/**
* @brief Returns the priority of the next workerqueue job
* Returns the priority of the next workerqueue job
*
* @return string priority
* @throws \Exception
@ -876,7 +876,7 @@ class Worker
}
/**
* @brief Find and claim the next worker process for us
* Find and claim the next worker process for us
*
* @return boolean Have we found something?
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -919,7 +919,7 @@ class Worker
}
/**
* @brief Returns the next worker process
* Returns the next worker process
*
* @return string SQL statement
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -952,7 +952,7 @@ class Worker
}
/**
* @brief Removes a workerqueue entry from the current process
* Removes a workerqueue entry from the current process
* @return void
* @throws \Exception
*/
@ -967,7 +967,7 @@ class Worker
}
/**
* @brief Call the front end worker
* Call the front end worker
* @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
@ -982,7 +982,7 @@ class Worker
}
/**
* @brief Call the front end worker if there aren't any active
* Call the front end worker if there aren't any active
* @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
@ -1033,7 +1033,7 @@ class Worker
}
/**
* @brief Removes long running worker processes
* Removes long running worker processes
* @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
@ -1051,7 +1051,7 @@ class Worker
}
/**
* @brief Runs the cron processes
* Runs the cron processes
* @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
@ -1070,7 +1070,7 @@ class Worker
}
/**
* @brief Spawns a new worker
* Spawns a new worker
* @param bool $do_cron
* @return void
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -1092,7 +1092,7 @@ class Worker
}
/**
* @brief Adds tasks to the worker queue
* Adds tasks to the worker queue
*
* @param (integer|array) priority or parameter array, strings are deprecated and are ignored
*
@ -1272,8 +1272,6 @@ class Worker
/**
* Log active processes into the "process" table
*
* @brief Log active processes into the "process" table
*/
public static function startProcess()
{
@ -1289,7 +1287,6 @@ class Worker
/**
* Remove the active process from the "process" table
*
* @brief Remove the active process from the "process" table
* @return bool
* @throws \Exception
*/
@ -1301,7 +1298,6 @@ class Worker
/**
* Set the flag if some job is waiting
*
* @brief Set the flag if some job is waiting
* @param boolean $jobs Is there a waiting job?
* @throws \Exception
*/
@ -1316,7 +1312,6 @@ class Worker
/**
* Checks if some worker job waits to be executed
*
* @brief Checks if some worker job waits to be executed
* @return bool
* @throws \Exception
*/