Issue #2851394 by GoZ, hgunicamp, oknate, jungle, wolffereast, tameeshb, mmatsoo, ridhimaabrol24, jofitz, swarad07, tanc, shaktik, dimaro, shashikant_chauhan, MerryHamster, quietone, nitesh624, martin_q, boaloysius, gaurav.kapoor, nitvirus, ankithashetty, Munavijayalakshmi, kostyashupenko, leolando.tan, amit.drupal, ravi.shankar, akashkrishnan01, Swapnil_Kotwal, Saviktor, mrinalini9, anmolgoyal74, Venkatesh Rajan.J, shimpy, lomasr, Dinesh18, shubham.prakash, mahtab_alam, markdorison, cilefen, longwave, bleen, xjm, alexpott, gmaltoni: Fix grammar 'a' to 'an' when necessary

merge-requests/39/head
catch 2020-11-13 14:25:11 +00:00
parent 0ea2e4d0df
commit 1d6e7e25d5
272 changed files with 351 additions and 349 deletions

View File

@ -143,7 +143,7 @@ function drupal_find_theme_functions($cache, $prefixes) {
// Find theme functions that implement possible "suggestion" variants of // Find theme functions that implement possible "suggestion" variants of
// registered theme hooks and add those as new registered theme hooks. // registered theme hooks and add those as new registered theme hooks.
// The 'pattern' key defines a common prefix that all suggestions must // The 'pattern' key defines a common prefix that all suggestions must
// start with. The default is the name of the hook followed by '__'. An // start with. The default is the name of the hook followed by '__'. A
// 'base hook' key is added to each entry made for a found suggestion, // 'base hook' key is added to each entry made for a found suggestion,
// so that common functionality can be implemented for all suggestions of // so that common functionality can be implemented for all suggestions of
// the same base hook. To keep things simple, deep hierarchy of // the same base hook. To keep things simple, deep hierarchy of

View File

@ -15,7 +15,7 @@ class InvalidPluginDefinitionException extends PluginException {
protected $pluginId; protected $pluginId;
/** /**
* Constructs a InvalidPluginDefinitionException. * Constructs an InvalidPluginDefinitionException.
* *
* For the remaining parameters see \Exception. * For the remaining parameters see \Exception.
* *

View File

@ -8,7 +8,7 @@ namespace Drupal\Component\Plugin\Exception;
class PluginNotFoundException extends PluginException { class PluginNotFoundException extends PluginException {
/** /**
* Construct an PluginNotFoundException exception. * Construct a PluginNotFoundException exception.
* *
* For the remaining parameters see \Exception. * For the remaining parameters see \Exception.
* *

View File

@ -45,8 +45,8 @@ class Html {
* <command> tag anymore. * <command> tag anymore.
* See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/command. * See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/command.
* - The 'manifest' attribute is omitted because it only exists for the <html> * - The 'manifest' attribute is omitted because it only exists for the <html>
* tag. That tag only makes sense in a HTML-served-as-HTML context, in which * tag. That tag only makes sense in an HTML-served-as-HTML context, in
* case relative URLs are guaranteed to work. * which case relative URLs are guaranteed to work.
* *
* @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes
* @see https://stackoverflow.com/questions/2725156/complete-list-of-html-tag-attributes-which-have-a-url-value * @see https://stackoverflow.com/questions/2725156/complete-list-of-html-tag-attributes-which-have-a-url-value

View File

@ -242,14 +242,14 @@ class UrlHelper {
* TRUE if the URL has the same domain and base path. * TRUE if the URL has the same domain and base path.
* *
* @throws \InvalidArgumentException * @throws \InvalidArgumentException
* Exception thrown when a either $url or $bath_url are not fully qualified. * Exception thrown when either $url or $base_url are not fully qualified.
*/ */
public static function externalIsLocal($url, $base_url) { public static function externalIsLocal($url, $base_url) {
// Some browsers treat \ as / so normalize to forward slashes. // Some browsers treat \ as / so normalize to forward slashes.
$url = str_replace('\\', '/', $url); $url = str_replace('\\', '/', $url);
// Leading control characters may be ignored or mishandled by browsers, so // Leading control characters may be ignored or mishandled by browsers, so
// assume such a path may lead to an non-local location. The \p{C} character // assume such a path may lead to a non-local location. The \p{C} character
// class matches all UTF-8 control, unassigned, and private characters. // class matches all UTF-8 control, unassigned, and private characters.
if (preg_match('/^\p{C}/u', $url) !== 0) { if (preg_match('/^\p{C}/u', $url) !== 0) {
return FALSE; return FALSE;

View File

@ -55,7 +55,7 @@ class AccessManager implements AccessManagerInterface {
protected $checkProvider; protected $checkProvider;
/** /**
* Constructs a AccessManager instance. * Constructs an AccessManager instance.
* *
* @param \Drupal\Core\Routing\RouteProviderInterface $route_provider * @param \Drupal\Core\Routing\RouteProviderInterface $route_provider
* The route provider. * The route provider.

View File

@ -70,7 +70,7 @@ class EmailAction extends ConfigurableActionBase implements ContainerFactoryPlug
protected $emailValidator; protected $emailValidator;
/** /**
* Constructs a EmailAction object. * Constructs an EmailAction object.
* *
* @param array $configuration * @param array $configuration
* A configuration array containing information about the plugin instance. * A configuration array containing information about the plugin instance.

View File

@ -21,7 +21,7 @@ abstract class EntityActionBase extends ActionBase implements DependentPluginInt
protected $entityTypeManager; protected $entityTypeManager;
/** /**
* Constructs a EntityActionBase object. * Constructs an EntityActionBase object.
* *
* @param mixed[] $configuration * @param mixed[] $configuration
* A configuration array containing information about the plugin instance. * A configuration array containing information about the plugin instance.

View File

@ -71,7 +71,7 @@ class AjaxResponseAttachmentsProcessor implements AttachmentsResponseProcessorIn
protected $moduleHandler; protected $moduleHandler;
/** /**
* Constructs a AjaxResponseAttachmentsProcessor object. * Constructs an AjaxResponseAttachmentsProcessor object.
* *
* @param \Drupal\Core\Asset\AssetResolverInterface $asset_resolver * @param \Drupal\Core\Asset\AssetResolverInterface $asset_resolver
* An asset resolver. * An asset resolver.

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Ajax; namespace Drupal\Core\Ajax;
/** /**
* Defines an AJAX command to open content in a dialog in a off-canvas dialog. * Defines an AJAX command to open content in a dialog in an off-canvas tray.
* *
* @ingroup ajax * @ingroup ajax
*/ */
@ -18,7 +18,7 @@ class OpenOffCanvasDialogCommand extends OpenDialogCommand {
* Constructs an OpenOffCanvasDialogCommand object. * Constructs an OpenOffCanvasDialogCommand object.
* *
* The off-canvas dialog differs from the normal modal provided by * The off-canvas dialog differs from the normal modal provided by
* OpenDialogCommand in that a off-canvas has built in positioning and * OpenDialogCommand in that an off-canvas has built in positioning and
* behaviors. Drupal provides a built-in off-canvas dialog for this purpose, * behaviors. Drupal provides a built-in off-canvas dialog for this purpose,
* so the selector is hard-coded in the call to the parent constructor. * so the selector is hard-coded in the call to the parent constructor.
* *

View File

@ -34,7 +34,7 @@ class UpdateBuildIdCommand implements CommandInterface {
protected $new; protected $new;
/** /**
* Constructs a UpdateBuildIdCommand object. * Constructs an UpdateBuildIdCommand object.
* *
* @param string $old * @param string $old
* The old build_id. * The old build_id.

View File

@ -25,7 +25,7 @@ class ArchiverManager extends DefaultPluginManager {
protected $fileSystem; protected $fileSystem;
/** /**
* Constructs a ArchiverManager object. * Constructs an ArchiverManager object.
* *
* @param \Traversable $namespaces * @param \Traversable $namespaces
* An object that implements \Traversable which contains the root paths * An object that implements \Traversable which contains the root paths

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Archiver; namespace Drupal\Core\Archiver;
/** /**
* Defines a archiver implementation for .tar files. * Defines an archiver implementation for .tar files.
*/ */
class Tar implements ArchiverInterface { class Tar implements ArchiverInterface {

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Archiver; namespace Drupal\Core\Archiver;
/** /**
* Defines a archiver implementation for .zip files. * Defines an archiver implementation for .zip files.
* *
* @link http://php.net/zip * @link http://php.net/zip
*/ */

View File

@ -16,7 +16,7 @@ interface AssetDumperInterface {
* The file extension of this asset. * The file extension of this asset.
* *
* @return string * @return string
* An URI to access the dumped asset. * A URI to access the dumped asset.
*/ */
public function dump($data, $file_extension); public function dump($data, $file_extension);

View File

@ -21,7 +21,7 @@ interface ConfigFactoryInterface {
public function get($name); public function get($name);
/** /**
* Returns an mutable configuration object for a given name. * Returns a mutable configuration object for a given name.
* *
* Should not be used for config that will have runtime effects. Therefore it * Should not be used for config that will have runtime effects. Therefore it
* is always loaded override free. * is always loaded override free.

View File

@ -23,7 +23,7 @@ use Symfony\Component\EventDispatcher\EventDispatcherInterface;
* *
* @see \Drupal\Core\Config\StorageComparerInterface * @see \Drupal\Core\Config\StorageComparerInterface
* *
* The ConfigImporter has a identifier which is used to construct event names. * The ConfigImporter has an identifier which is used to construct event names.
* The events fired during an import are: * The events fired during an import are:
* - ConfigEvents::IMPORT_VALIDATE: Events listening can throw a * - ConfigEvents::IMPORT_VALIDATE: Events listening can throw a
* \Drupal\Core\Config\ConfigImporterException to prevent an import from * \Drupal\Core\Config\ConfigImporterException to prevent an import from
@ -1039,7 +1039,7 @@ class ConfigImporter {
} }
/** /**
* Determines if a import is already running. * Determines if an import is already running.
* *
* @return bool * @return bool
* TRUE if an import is already running, FALSE if not. * TRUE if an import is already running, FALSE if not.

View File

@ -59,7 +59,7 @@ class Query extends QueryBase implements QueryInterface {
* Overrides \Drupal\Core\Entity\Query\QueryBase::condition(). * Overrides \Drupal\Core\Entity\Query\QueryBase::condition().
* *
* Additional to the syntax defined in the QueryInterface you can use * Additional to the syntax defined in the QueryInterface you can use
* placeholders (*) to match all keys of an subarray. Let's take the follow * placeholders (*) to match all keys of a subarray. Let's take the follow
* yaml file as example: * yaml file as example:
* @code * @code
* level1: * level1:

View File

@ -1722,7 +1722,7 @@ abstract class Connection {
} }
/** /**
* Retrieves an unique ID from a given sequence. * Retrieves a unique ID from a given sequence.
* *
* Use this function if for some reason you can't use a serial field. For * Use this function if for some reason you can't use a serial field. For
* example, MySQL has no ways of reading of the current value of a sequence * example, MySQL has no ways of reading of the current value of a sequence

View File

@ -38,7 +38,7 @@ abstract class Database {
const RETURN_INSERT_ID = 3; const RETURN_INSERT_ID = 3;
/** /**
* An nested array of all active connections. It is keyed by database name * A nested array of all active connections. It is keyed by database name
* and target. * and target.
* *
* @var array * @var array

View File

@ -319,7 +319,7 @@ class Connection extends DatabaseConnection {
} }
/** /**
* Add a new savepoint with an unique name. * Add a new savepoint with a unique name.
* *
* The main use for this method is to mimic InnoDB functionality, which * The main use for this method is to mimic InnoDB functionality, which
* provides an inherent savepoint before any query in a transaction. * provides an inherent savepoint before any query in a transaction.

View File

@ -99,7 +99,7 @@ class Select extends QuerySelect {
} }
} }
// If $field contains an characters which are not allowed in a field name // If $field contains characters which are not allowed in a field name
// it is considered an expression, these can't be handled automatically // it is considered an expression, these can't be handled automatically
// either. // either.
if ($this->connection->escapeField($field) != $field) { if ($this->connection->escapeField($field) != $field) {

View File

@ -366,7 +366,7 @@ class Schema extends DatabaseSchema {
// Build the mapping between the old fields and the new fields. // Build the mapping between the old fields and the new fields.
$mapping = []; $mapping = [];
if (isset($specification['initial_from_field'])) { if (isset($specification['initial_from_field'])) {
// If we have a initial value, copy it over. // If we have an initial value, copy it over.
if (isset($specification['initial'])) { if (isset($specification['initial'])) {
$expression = 'COALESCE(' . $specification['initial_from_field'] . ', :default_initial_value)'; $expression = 'COALESCE(' . $specification['initial_from_field'] . ', :default_initial_value)';
$arguments = [':default_initial_value' => $specification['initial']]; $arguments = [':default_initial_value' => $specification['initial']];
@ -381,7 +381,7 @@ class Schema extends DatabaseSchema {
]; ];
} }
elseif (isset($specification['initial'])) { elseif (isset($specification['initial'])) {
// If we have a initial value, copy it over. // If we have an initial value, copy it over.
$mapping[$field] = [ $mapping[$field] = [
'expression' => ':newfieldinitial', 'expression' => ':newfieldinitial',
'arguments' => [':newfieldinitial' => $specification['initial']], 'arguments' => [':newfieldinitial' => $specification['initial']],

View File

@ -48,10 +48,10 @@ interface ConditionInterface {
* The value to test the field against. In most cases, and depending on the * The value to test the field against. In most cases, and depending on the
* operator, this will be a scalar or an array. As SQL accepts select * operator, this will be a scalar or an array. As SQL accepts select
* queries on any place where a scalar value or set is expected, $value may * queries on any place where a scalar value or set is expected, $value may
* also be a(n array of) SelectInterface(s). If $operator is a unary * also be a SelectInterface or an array of SelectInterfaces. If $operator
* operator, e.g. IS NULL, $value will be ignored and should be null. If * is a unary operator, e.g. IS NULL, $value will be ignored and should be
* the operator requires a subquery, e.g. EXISTS, the $field will be ignored * null. If the operator requires a subquery, e.g. EXISTS, the $field will
* and $value should be a SelectInterface object. * be ignored and $value should be a SelectInterface object.
* @param string|null $operator * @param string|null $operator
* The operator to use. Supported for all supported databases are at least: * The operator to use. Supported for all supported databases are at least:
* - The comparison operators =, <>, <, <=, >, >=. * - The comparison operators =, <>, <, <=, >, >=.

View File

@ -432,7 +432,7 @@ function hook_query_alter(Drupal\Core\Database\Query\AlterableInterface $query)
* a listing (e.g., from Views) and therefore require access control. * a listing (e.g., from Views) and therefore require access control.
* *
* @param $query * @param $query
* An Query object describing the composite parts of a SQL query. * A Query object describing the composite parts of a SQL query.
* *
* @see hook_query_alter() * @see hook_query_alter()
* @see node_query_node_access_alter() * @see node_query_node_access_alter()

View File

@ -154,7 +154,7 @@ class Datetime extends DateElementBase {
* element, no other format will work. See the * element, no other format will work. See the
* DateFormatterInterface::format() function for a list of the possible * DateFormatterInterface::format() function for a list of the possible
* formats and HTML5 standards for the HTML5 requirements. Defaults to the * formats and HTML5 standards for the HTML5 requirements. Defaults to the
* right HTML5 format for the chosen element if a HTML5 element is used, * right HTML5 format for the chosen element if an HTML5 element is used,
* otherwise defaults to DateFormat::load('html_date')->getPattern(). * otherwise defaults to DateFormat::load('html_date')->getPattern().
* - #date_date_element: The date element. Options are: * - #date_date_element: The date element. Options are:
* - datetime: Use the HTML5 datetime element type. * - datetime: Use the HTML5 datetime element type.
@ -164,7 +164,7 @@ class Datetime extends DateElementBase {
* - none: Do not display a date element. * - none: Do not display a date element.
* - #date_date_callbacks: Array of optional callbacks for the date element. * - #date_date_callbacks: Array of optional callbacks for the date element.
* - #date_time_element: The time element. Options are: * - #date_time_element: The time element. Options are:
* - time: Use a HTML5 time element type. * - time: Use an HTML5 time element type.
* - text: No HTML5 element, use a normal text field. * - text: No HTML5 element, use a normal text field.
* - none: Do not display a time element. * - none: Do not display a time element.
* - #date_time_format: A date format string that describes the format that * - #date_time_format: A date format string that describes the format that
@ -173,7 +173,7 @@ class Datetime extends DateElementBase {
* element, no other format will work. See the * element, no other format will work. See the
* DateFormatterInterface::format() function for a list of the possible * DateFormatterInterface::format() function for a list of the possible
* formats and HTML5 standards for the HTML5 requirements. Defaults to the * formats and HTML5 standards for the HTML5 requirements. Defaults to the
* right HTML5 format for the chosen element if a HTML5 element is used, * right HTML5 format for the chosen element if an HTML5 element is used,
* otherwise defaults to DateFormat::load('html_time')->getPattern(). * otherwise defaults to DateFormat::load('html_time')->getPattern().
* - #date_time_callbacks: An array of optional callbacks for the time * - #date_time_callbacks: An array of optional callbacks for the time
* element. Can be used to add a jQuery timepicker or an 'All day' checkbox. * element. Can be used to add a jQuery timepicker or an 'All day' checkbox.
@ -394,7 +394,7 @@ class Datetime extends DateElementBase {
} }
/** /**
* Retrieves the right format for a HTML5 date element. * Retrieves the right format for an HTML5 date element.
* *
* The format is important because these elements will not work with any other * The format is important because these elements will not work with any other
* format. * format.
@ -404,7 +404,7 @@ class Datetime extends DateElementBase {
* *
* @return string * @return string
* Returns the right format for the date element, or the original format * Returns the right format for the date element, or the original format
* if this is not a HTML5 element. * if this is not an HTML5 element.
*/ */
protected static function getHtml5DateFormat($element) { protected static function getHtml5DateFormat($element) {
switch ($element['#date_date_element']) { switch ($element['#date_date_element']) {
@ -421,7 +421,7 @@ class Datetime extends DateElementBase {
} }
/** /**
* Retrieves the right format for a HTML5 time element. * Retrieves the right format for an HTML5 time element.
* *
* The format is important because these elements will not work with any other * The format is important because these elements will not work with any other
* format. * format.
@ -431,7 +431,7 @@ class Datetime extends DateElementBase {
* *
* @return string * @return string
* Returns the right format for the time element, or the original format * Returns the right format for the time element, or the original format
* if this is not a HTML5 element. * if this is not an HTML5 element.
*/ */
protected static function getHtml5TimeFormat($element) { protected static function getHtml5TimeFormat($element) {
switch ($element['#date_time_element']) { switch ($element['#date_time_element']) {

View File

@ -3,7 +3,8 @@
namespace Drupal\Core\DependencyInjection; namespace Drupal\Core\DependencyInjection;
/** /**
* Provides an interface to get a instance of a class with dependency injection. * Provides an interface to get an instance of a class with dependency
* injection.
*/ */
interface ClassResolverInterface { interface ClassResolverInterface {

View File

@ -13,7 +13,7 @@ use Symfony\Component\Validator\ConstraintViolationList;
use Symfony\Component\Validator\ConstraintViolationListInterface; use Symfony\Component\Validator\ConstraintViolationListInterface;
/** /**
* Configuration entity that contains widget options for all components of a * Configuration entity that contains widget options for all components of an
* entity form in a given form mode. * entity form in a given form mode.
* *
* @ConfigEntityType( * @ConfigEntityType(

View File

@ -19,7 +19,7 @@ class EntityAutocompleteMatcher implements EntityAutocompleteMatcherInterface {
protected $selectionManager; protected $selectionManager;
/** /**
* Constructs a EntityAutocompleteMatcher object. * Constructs an EntityAutocompleteMatcher object.
* *
* @param \Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManagerInterface $selection_manager * @param \Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManagerInterface $selection_manager
* The entity reference selection handler plugin manager. * The entity reference selection handler plugin manager.

View File

@ -28,7 +28,7 @@ class EntityCreateAccessCheck implements AccessInterface {
protected $requirementsKey = '_entity_create_access'; protected $requirementsKey = '_entity_create_access';
/** /**
* Constructs a EntityCreateAccessCheck object. * Constructs an EntityCreateAccessCheck object.
* *
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
* The entity type manager service. * The entity type manager service.

View File

@ -35,7 +35,7 @@ class EntityCreateAnyAccessCheck implements AccessInterface {
protected $requirementsKey = '_entity_create_any_access'; protected $requirementsKey = '_entity_create_any_access';
/** /**
* Constructs a EntityCreateAnyAccessCheck object. * Constructs an EntityCreateAnyAccessCheck object.
* *
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
* The entity type manager. * The entity type manager.

View File

@ -17,7 +17,7 @@ interface EntityTypeManagerInterface extends PluginManagerInterface, CachedDisco
* The entity type ID for this access control handler. * The entity type ID for this access control handler.
* *
* @return \Drupal\Core\Entity\EntityAccessControlHandlerInterface * @return \Drupal\Core\Entity\EntityAccessControlHandlerInterface
* A access control handler instance. * An access control handler instance.
*/ */
public function getAccessControlHandler($entity_type_id); public function getAccessControlHandler($entity_type_id);

View File

@ -12,7 +12,7 @@ namespace Drupal\Core\Entity\Exception;
class NoCorrespondingEntityClassException extends \Exception { class NoCorrespondingEntityClassException extends \Exception {
/** /**
* Constructs an NoCorrespondingEntityClassException. * Constructs a NoCorrespondingEntityClassException.
* *
* @param string $class * @param string $class
* The class which does not correspond to an entity type. * The class which does not correspond to an entity type.

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Entity\Query; namespace Drupal\Core\Entity\Query;
/** /**
* Defines a interface for aggregated entity queries. * Defines an interface for aggregated entity queries.
*/ */
interface QueryAggregateInterface extends QueryInterface { interface QueryAggregateInterface extends QueryInterface {

View File

@ -408,7 +408,7 @@ class Tables implements TablesInterface {
$entity_type_id = $this->sqlQuery->getMetaData('entity_type'); $entity_type_id = $this->sqlQuery->getMetaData('entity_type');
$entity_type = $this->entityTypeManager->getActiveDefinition($entity_type_id); $entity_type = $this->entityTypeManager->getActiveDefinition($entity_type_id);
// Only the data table follows the entity language key, dedicated field // Only the data table follows the entity language key, dedicated field
// tables have an hard-coded 'langcode' column. // tables have a hard-coded 'langcode' column.
$langcode_key = $entity_type->getDataTable() == $table ? $entity_type->getKey('langcode') : 'langcode'; $langcode_key = $entity_type->getDataTable() == $table ? $entity_type->getKey('langcode') : 'langcode';
$placeholder = ':langcode' . $this->sqlQuery->nextPlaceholder(); $placeholder = ':langcode' . $this->sqlQuery->nextPlaceholder();
$join_condition .= ' AND [%alias].[' . $langcode_key . '] = ' . $placeholder; $join_condition .= ' AND [%alias].[' . $langcode_key . '] = ' . $placeholder;

View File

@ -475,7 +475,7 @@ class DefaultTableMapping implements TableMappingInterface {
} }
/** /**
* Adds a extra columns for a table to the table mapping. * Adds extra columns for a table to the table mapping.
* *
* @param string $table_name * @param string $table_name
* The name of table to add the extra columns for. * The name of table to add the extra columns for.

View File

@ -541,7 +541,7 @@ use Drupal\node\Entity\NodeType;
* @link container Services and Dependency Injection topic @endlink for more * @link container Services and Dependency Injection topic @endlink for more
* about how to properly retrieve services. * about how to properly retrieve services.
* *
* To query to find entities to load, use an entity query, which is a object * To query to find entities to load, use an entity query, which is an object
* implementing \Drupal\Core\Entity\Query\QueryInterface that you can retrieve * implementing \Drupal\Core\Entity\Query\QueryInterface that you can retrieve
* with: * with:
* @code * @code

View File

@ -99,7 +99,7 @@ abstract class HttpExceptionSubscriberBase implements EventSubscriberInterface {
if ($exception instanceof HttpExceptionInterface && (empty($handled_formats) || in_array($format, $handled_formats))) { if ($exception instanceof HttpExceptionInterface && (empty($handled_formats) || in_array($format, $handled_formats))) {
$method = 'on' . $exception->getStatusCode(); $method = 'on' . $exception->getStatusCode();
// Keep just the leading number of the status code to produce either a // Keep just the leading number of the status code to produce either a
// on400 or a 500 method callback. // 400 or a 500 method callback.
$method_fallback = 'on' . substr($exception->getStatusCode(), 0, 1) . 'xx'; $method_fallback = 'on' . substr($exception->getStatusCode(), 0, 1) . 'xx';
// We want to allow the method to be called and still not set a response // We want to allow the method to be called and still not set a response
// if it has additional filtering logic to determine when it will apply. // if it has additional filtering logic to determine when it will apply.

View File

@ -12,7 +12,7 @@ use Symfony\Component\Routing\Route;
/** /**
* Handles options requests. * Handles options requests.
* *
* Therefore it sends a options response using all methods on all possible * Therefore it sends an options response using all methods on all possible
* routes. * routes.
*/ */
class OptionsRequestSubscriber implements EventSubscriberInterface { class OptionsRequestSubscriber implements EventSubscriberInterface {

View File

@ -46,7 +46,7 @@ class ThemeHandler implements ThemeHandlerInterface {
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The config factory to get the installed themes. * The config factory to get the installed themes.
* @param \Drupal\Core\Extension\ThemeExtensionList $theme_list * @param \Drupal\Core\Extension\ThemeExtensionList $theme_list
* A extension discovery instance. * An extension discovery instance.
*/ */
public function __construct($root, ConfigFactoryInterface $config_factory, ThemeExtensionList $theme_list) { public function __construct($root, ConfigFactoryInterface $config_factory, ThemeExtensionList $theme_list) {
$this->root = $root; $this->root = $root;

View File

@ -6,7 +6,7 @@ use Drupal\Core\Access\AccessResult;
use Drupal\Core\Session\AccountInterface; use Drupal\Core\Session\AccountInterface;
/** /**
* Defines a item list class for changed fields. * Defines an item list class for changed fields.
*/ */
class ChangedFieldItemList extends FieldItemList { class ChangedFieldItemList extends FieldItemList {

View File

@ -6,7 +6,7 @@ use Drupal\Core\Entity\FieldableEntityInterface;
use Drupal\Core\Form\FormStateInterface; use Drupal\Core\Form\FormStateInterface;
/** /**
* Defines a item list class for entity reference fields. * Defines an item list class for entity reference fields.
*/ */
class EntityReferenceFieldItemList extends FieldItemList implements EntityReferenceFieldItemListInterface { class EntityReferenceFieldItemList extends FieldItemList implements EntityReferenceFieldItemListInterface {

View File

@ -132,7 +132,7 @@ abstract class FieldConfigBase extends ConfigEntityBase implements FieldConfigIn
* *
* This property is overlooked if the $default_value_callback is non-empty. * This property is overlooked if the $default_value_callback is non-empty.
* *
* Example for a integer field: * Example for an integer field:
* @code * @code
* array( * array(
* array('value' => 1), * array('value' => 1),

View File

@ -56,7 +56,7 @@ interface FieldStorageDefinitionInterface extends CacheableDependencyInterface {
* *
* Each field type defines the settings that are meaningful for that type. * Each field type defines the settings that are meaningful for that type.
* For example, a text field can define a 'max_length' setting, and an image * For example, a text field can define a 'max_length' setting, and an image
* field can define a 'alt_field_required' setting. * field can define an 'alt_field_required' setting.
* *
* The method always returns an array of all available settings for this field * The method always returns an array of all available settings for this field
* type, possibly with the default values merged in if values have not been * type, possibly with the default values merged in if values have not been

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Field; namespace Drupal\Core\Field;
/** /**
* Defines a item list class for map fields. * Defines an item list class for map fields.
*/ */
class MapFieldItemList extends FieldItemList { class MapFieldItemList extends FieldItemList {

View File

@ -65,7 +65,7 @@ class EntityReferenceEntityFormatter extends EntityReferenceFormatterBase {
protected static $recursiveRenderDepth = []; protected static $recursiveRenderDepth = [];
/** /**
* Constructs a EntityReferenceEntityFormatter instance. * Constructs an EntityReferenceEntityFormatter instance.
* *
* @param string $plugin_id * @param string $plugin_id
* The plugin_id for the formatter. * The plugin_id for the formatter.

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Form; namespace Drupal\Core\Form;
/** /**
* Provides an generic base class for a confirmation form. * Provides a generic base class for a confirmation form.
*/ */
abstract class ConfirmFormBase extends FormBase implements ConfirmFormInterface { abstract class ConfirmFormBase extends FormBase implements ConfirmFormInterface {

View File

@ -228,7 +228,7 @@ interface ImageInterface {
* @param float $degrees * @param float $degrees
* The number of (clockwise) degrees to rotate the image. * The number of (clockwise) degrees to rotate the image.
* @param string|null $background * @param string|null $background
* (optional) An hexadecimal integer specifying the background color to use * (optional) A hexadecimal integer specifying the background color to use
* for the uncovered area of the image after the rotation; for example, * for the uncovered area of the image after the rotation; for example,
* 0x000000 for black, 0xff00ff for magenta, and 0xffffff for white. When * 0x000000 for black, 0xff00ff for magenta, and 0xffffff for white. When
* NULL (the default) is specified, for images that support transparency, * NULL (the default) is specified, for images that support transparency,

View File

@ -35,7 +35,7 @@ class ImageToolkit extends Plugin {
/** /**
* The title of the image toolkit. * The title of the image toolkit.
* *
* The string should be wrapped in a @Translation(). * The string should be wrapped in @Translation().
* *
* @ingroup plugin_translatable * @ingroup plugin_translatable
* *

View File

@ -63,7 +63,7 @@ class ImageToolkitOperation extends Plugin {
/** /**
* The human-readable name of the image toolkit operation. * The human-readable name of the image toolkit operation.
* *
* The string should be wrapped in a @Translation(). * The string should be wrapped in @Translation().
* *
* @ingroup plugin_translatable * @ingroup plugin_translatable
* *
@ -74,7 +74,7 @@ class ImageToolkitOperation extends Plugin {
/** /**
* The description of the image toolkit operation. * The description of the image toolkit operation.
* *
* The string should be wrapped in a @Translation(). * The string should be wrapped in @Translation().
* *
* @ingroup plugin_translatable * @ingroup plugin_translatable
* *

View File

@ -9,7 +9,7 @@ use Symfony\Component\HttpFoundation\Response;
* Defines the interface for response policy implementations. * Defines the interface for response policy implementations.
* *
* The response policy is evaluated in order to determine whether a page should * The response policy is evaluated in order to determine whether a page should
* be stored a in the cache. Calling code should do so unless static::DENY is * be stored in the cache. Calling code should do so unless static::DENY is
* returned from the check() method. * returned from the check() method.
*/ */
interface ResponsePolicyInterface { interface ResponsePolicyInterface {

View File

@ -27,7 +27,7 @@ class InfoHookDecorator implements DiscoveryInterface {
protected $hook; protected $hook;
/** /**
* Constructs a InfoHookDecorator object. * Constructs an InfoHookDecorator object.
* *
* @param \Drupal\Component\Plugin\Discovery\DiscoveryInterface $decorated * @param \Drupal\Component\Plugin\Discovery\DiscoveryInterface $decorated
* The object implementing DiscoveryInterface that is being decorated. * The object implementing DiscoveryInterface that is being decorated.

View File

@ -17,7 +17,7 @@ use Drupal\Core\Plugin\DefaultPluginManager;
class QueueWorkerManager extends DefaultPluginManager implements QueueWorkerManagerInterface { class QueueWorkerManager extends DefaultPluginManager implements QueueWorkerManagerInterface {
/** /**
* Constructs an QueueWorkerManager object. * Constructs a QueueWorkerManager object.
* *
* @param \Traversable $namespaces * @param \Traversable $namespaces
* An object that implements \Traversable which contains the root paths * An object that implements \Traversable which contains the root paths

View File

@ -23,7 +23,7 @@ namespace Drupal\Core\Render;
* use a @code _controller @endcode route, and return a render array. * use a @code _controller @endcode route, and return a render array.
* This will cause a main content renderer * This will cause a main content renderer
* (\Drupal\Core\Render\MainContent\MainContentRendererInterface) to be * (\Drupal\Core\Render\MainContent\MainContentRendererInterface) to be
* used, and in case of a HTML request that will be * used, and in case of an HTML request that will be
* \Drupal\Core\Render\MainContent\HtmlRenderer. * \Drupal\Core\Render\MainContent\HtmlRenderer.
* *
* In fact, this is not only *typically* used in a limited environment, it even * In fact, this is not only *typically* used in a limited environment, it even

View File

@ -56,7 +56,7 @@ class Element {
/** /**
* Identifies the children of an element array, optionally sorted by weight. * Identifies the children of an element array, optionally sorted by weight.
* *
* The children of a element array are those key/value pairs whose key does * The children of an element array are those key/value pairs whose key does
* not start with a '#'. See drupal_render() for details. * not start with a '#'. See drupal_render() for details.
* *
* @param array $elements * @param array $elements

View File

@ -13,7 +13,7 @@ use Drupal\Core\Url as CoreUrl;
* *
* Properties: * Properties:
* - #title: The link text. * - #title: The link text.
* - #url: \Drupal\Core\Url object containing URL information pointing to a * - #url: \Drupal\Core\Url object containing URL information pointing to an
* internal or external link. See \Drupal\Core\Utility\LinkGeneratorInterface. * internal or external link. See \Drupal\Core\Utility\LinkGeneratorInterface.
* *
* Usage example: * Usage example:
@ -69,7 +69,7 @@ class Link extends RenderElement {
} }
// This #pre_render callback can be invoked from inside or outside of a Form // This #pre_render callback can be invoked from inside or outside of a Form
// API context, and depending on that, a HTML ID may be already set in // API context, and depending on that, an HTML ID may be already set in
// different locations. #options should have precedence over Form API's #id. // different locations. #options should have precedence over Form API's #id.
// #attributes have been taken over into #options above already. // #attributes have been taken over into #options above already.
if (isset($element['#options']['attributes']['id'])) { if (isset($element['#options']['attributes']['id'])) {

View File

@ -8,7 +8,7 @@ use Drupal\Core\Form\FormStateInterface;
* Provides a matched path render element. * Provides a matched path render element.
* *
* Provides a form element to enter a path which can be optionally validated and * Provides a form element to enter a path which can be optionally validated and
* stored as either a \Drupal\Core\Url value object or a array containing a * stored as either a \Drupal\Core\Url value object or an array containing a
* route name and route parameters pair. * route name and route parameters pair.
* *
* @FormElement("path") * @FormElement("path")

View File

@ -382,7 +382,7 @@ class Table extends FormElement {
$element['#attributes']['class'][] = 'responsive-enabled'; $element['#attributes']['class'][] = 'responsive-enabled';
} }
// If the custom #tabledrag is set and there is a HTML ID, add the table's // If the custom #tabledrag is set and there is an HTML ID, add the table's
// HTML ID to the options and attach the behavior. // HTML ID to the options and attach the behavior.
if (!empty($element['#tabledrag']) && isset($element['#attributes']['id'])) { if (!empty($element['#tabledrag']) && isset($element['#attributes']['id'])) {
foreach ($element['#tabledrag'] as $options) { foreach ($element['#tabledrag'] as $options) {

View File

@ -45,7 +45,7 @@ class ElementInfoManager extends DefaultPluginManager implements ElementInfoMana
protected $cacheTagInvalidator; protected $cacheTagInvalidator;
/** /**
* Constructs a ElementInfoManager object. * Constructs an ElementInfoManager object.
* *
* @param \Traversable $namespaces * @param \Traversable $namespaces
* An object that implements \Traversable which contains the root paths * An object that implements \Traversable which contains the root paths

View File

@ -17,7 +17,7 @@ use Drupal\Core\Theme\ThemeManagerInterface;
use Symfony\Component\HttpFoundation\RequestStack; use Symfony\Component\HttpFoundation\RequestStack;
/** /**
* Turns a render array into a HTML string. * Turns a render array into an HTML string.
*/ */
class Renderer implements RendererInterface { class Renderer implements RendererInterface {
use DoTrustedCallbackTrait; use DoTrustedCallbackTrait;

View File

@ -6,7 +6,7 @@ use Symfony\Component\Routing\Matcher\Dumper\MatcherDumperInterface as SymfonyMa
use Symfony\Component\Routing\RouteCollection; use Symfony\Component\Routing\RouteCollection;
/** /**
* Extends the symfony matcher dumper interface with a addRoutes method. * Extends the symfony matcher dumper interface with an addRoutes method.
*/ */
interface MatcherDumperInterface extends SymfonyMatcherDumperInterface { interface MatcherDumperInterface extends SymfonyMatcherDumperInterface {

View File

@ -15,7 +15,7 @@ class SitePathFactory {
protected $drupalKernel; protected $drupalKernel;
/** /**
* Constructs an SitePathFactory instance. * Constructs a SitePathFactory instance.
* *
* @param \Drupal\Core\DrupalKernelInterface $drupal_kernel * @param \Drupal\Core\DrupalKernelInterface $drupal_kernel
* The Drupal kernel. * The Drupal kernel.

View File

@ -38,7 +38,7 @@ use Drupal\Component\Utility\NestedArray;
* *
* The attribute keys and values are automatically escaped for output with * The attribute keys and values are automatically escaped for output with
* Html::escape(). No protocol filtering is applied, so when using user-entered * Html::escape(). No protocol filtering is applied, so when using user-entered
* input as a value for an attribute that expects an URI (href, src, ...), * input as a value for an attribute that expects a URI (href, src, ...),
* UrlHelper::stripDangerousProtocols() should be used to ensure dangerous * UrlHelper::stripDangerousProtocols() should be used to ensure dangerous
* protocols (such as 'javascript:') are removed. For example: * protocols (such as 'javascript:') are removed. For example:
* @code * @code

View File

@ -501,7 +501,7 @@ class TwigExtension extends AbstractExtension {
* RenderableInterface or toString(). * RenderableInterface or toString().
* *
* @return mixed * @return mixed
* The rendered output or an \Twig\Markup object. * The rendered output or a \Twig\Markup object.
* *
* @see render * @see render
* @see TwigNodeVisitor * @see TwigNodeVisitor

View File

@ -10,7 +10,7 @@ use Drupal\Core\Session\AccountInterface;
* While possible values specify which values existing data might have, settable * While possible values specify which values existing data might have, settable
* values define the values that are allowed to be set by a user. * values define the values that are allowed to be set by a user.
* *
* For example, in an workflow scenario, the settable values for a state field * For example, in a workflow scenario, the settable values for a state field
* might depend on the currently set state, while possible values are all * might depend on the currently set state, while possible values are all
* states. Thus settable values would be used in an editing context, while * states. Thus settable values would be used in an editing context, while
* possible values would be used for presenting filtering options in a search. * possible values would be used for presenting filtering options in a search.

View File

@ -10,7 +10,7 @@ use Drupal\Core\TypedData\Type\BinaryInterface;
* *
* The plain value of binary data is a PHP file resource, see * The plain value of binary data is a PHP file resource, see
* http://php.net/manual/language.types.resource.php. For setting the value * http://php.net/manual/language.types.resource.php. For setting the value
* a PHP file resource or a (absolute) stream resource URI may be passed. * a PHP file resource or an (absolute) stream resource URI may be passed.
* *
* @DataType( * @DataType(
* id = "binary", * id = "binary",
@ -48,7 +48,7 @@ class BinaryData extends PrimitiveBase implements BinaryInterface {
/** /**
* Overrides TypedData::setValue(). * Overrides TypedData::setValue().
* *
* Supports a PHP file resource or a (absolute) stream resource URI as value. * Supports a PHP file resource or an (absolute) stream resource URI as value.
*/ */
public function setValue($value, $notify = TRUE) { public function setValue($value, $notify = TRUE) {
if (!isset($value)) { if (!isset($value)) {

View File

@ -7,7 +7,7 @@ use Drupal\Core\TypedData\Type\DurationInterface;
/** /**
* The duration ISO8601 data type. * The duration ISO8601 data type.
* *
* The plain value of this data type is a ISO8601 duration string. * The plain value of this data type is an ISO8601 duration string.
* *
* @DataType( * @DataType(
* id = "duration_iso8601", * id = "duration_iso8601",

View File

@ -9,7 +9,7 @@ use Drupal\Core\TypedData\PrimitiveInterface;
* *
* The plain value of binary data is a PHP file resource, see * The plain value of binary data is a PHP file resource, see
* http://php.net/manual/language.types.resource.php. For setting the value * http://php.net/manual/language.types.resource.php. For setting the value
* a PHP file resource or a (absolute) stream resource URI may be passed. * a PHP file resource or an (absolute) stream resource URI may be passed.
* *
* @ingroup typed_data * @ingroup typed_data
*/ */

View File

@ -146,7 +146,7 @@ interface TypedDataManagerInterface extends PluginManagerInterface, CachedDiscov
* The parent typed data object, implementing the TypedDataInterface and * The parent typed data object, implementing the TypedDataInterface and
* either the ListInterface or the ComplexDataInterface. * either the ListInterface or the ComplexDataInterface.
* @param string $property_name * @param string $property_name
* The name of the property to instantiate, or the delta of an list item. * The name of the property to instantiate, or the delta of a list item.
* @param mixed $value * @param mixed $value
* (optional) The data value. If set, it has to match one of the supported * (optional) The data value. If set, it has to match one of the supported
* data type formats as documented by the data type classes. * data type formats as documented by the data type classes.

View File

@ -3,7 +3,7 @@
namespace Drupal\Core\Updater; namespace Drupal\Core\Updater;
/** /**
* Defines a Exception class for the Drupal\Core\Updater\Updater class * Defines an Exception class for the Drupal\Core\Updater\Updater class
* hierarchy. * hierarchy.
* *
* This is identical to the base Exception class, we just give it a more * This is identical to the base Exception class, we just give it a more

View File

@ -334,7 +334,7 @@ class Url implements TrustedCallbackInterface {
* Create a new Url object for entity URIs. * Create a new Url object for entity URIs.
* *
* @param array $uri_parts * @param array $uri_parts
* Parts from an URI of the form entity:{entity_type}/{entity_id} as from * Parts from a URI of the form entity:{entity_type}/{entity_id} as from
* parse_url(). * parse_url().
* @param array $options * @param array $options
* An array of options, see \Drupal\Core\Url::fromUri() for details. * An array of options, see \Drupal\Core\Url::fromUri() for details.
@ -387,12 +387,12 @@ class Url implements TrustedCallbackInterface {
* - 'internal:/some-path' (path component is '/some-path') to 'some-path' * - 'internal:/some-path' (path component is '/some-path') to 'some-path'
* *
* @param array $uri_parts * @param array $uri_parts
* Parts from an URI of the form internal:{path} as from parse_url(). * Parts from a URI of the form internal:{path} as from parse_url().
* @param array $options * @param array $options
* An array of options, see \Drupal\Core\Url::fromUri() for details. * An array of options, see \Drupal\Core\Url::fromUri() for details.
* *
* @return static * @return static
* A new Url object for a 'internal:' URI. * A new Url object for an 'internal:' URI.
* *
* @throws \InvalidArgumentException * @throws \InvalidArgumentException
* Thrown when the URI's path component doesn't have a leading slash. * Thrown when the URI's path component doesn't have a leading slash.
@ -432,7 +432,7 @@ class Url implements TrustedCallbackInterface {
* Creates a new Url object for 'route:' URIs. * Creates a new Url object for 'route:' URIs.
* *
* @param array $uri_parts * @param array $uri_parts
* Parts from an URI of the form route:{route_name};{route_parameters} as * Parts from a URI of the form route:{route_name};{route_parameters} as
* from parse_url(), where the path is the route name optionally followed by * from parse_url(), where the path is the route name optionally followed by
* a ";" followed by route parameters in key=value format with & separators. * a ";" followed by route parameters in key=value format with & separators.
* @param array $options * @param array $options
@ -511,7 +511,7 @@ class Url implements TrustedCallbackInterface {
* Generates a URI string that represents the data in the Url object. * Generates a URI string that represents the data in the Url object.
* *
* The URI will typically have the scheme of route: even if the object was * The URI will typically have the scheme of route: even if the object was
* constructed using an entity: or internal: scheme. A internal: URI that * constructed using an entity: or internal: scheme. An internal: URI that
* does not match a Drupal route with be returned here with the base: scheme, * does not match a Drupal route with be returned here with the base: scheme,
* and external URLs will be returned in their original form. * and external URLs will be returned in their original form.
* *

View File

@ -130,7 +130,7 @@ class ProjectInfo {
} }
elseif (empty($status)) { elseif (empty($status)) {
// If we have a project_name that matches, but the project_display_type // If we have a project_name that matches, but the project_display_type
// does not, it means we're processing a uninstalled module or theme // does not, it means we're processing an uninstalled module or theme
// that belongs to a project that has some enabled code. In this case, // that belongs to a project that has some enabled code. In this case,
// we add the uninstalled thing into a separate array for separate // we add the uninstalled thing into a separate array for separate
// display. // display.

View File

@ -1208,7 +1208,7 @@
* @param {string} [response.method] * @param {string} [response.method]
* The jQuery DOM manipulation method to be used. * The jQuery DOM manipulation method to be used.
* @param {string} [response.selector] * @param {string} [response.selector]
* A optional jQuery selector string. * An optional jQuery selector string.
* @param {object} [response.settings] * @param {object} [response.settings]
* An optional array of settings that will be used. * An optional array of settings that will be used.
*/ */

View File

@ -45,7 +45,7 @@
} }
/** /**
* Returns the last value of an multi-value textfield. * Returns the last value of a multi-value textfield.
* *
* @function Drupal.autocomplete.extractLastTerm * @function Drupal.autocomplete.extractLastTerm
* *

View File

@ -54,7 +54,7 @@
* Scan a dialog for any primary buttons and move them to the button area. * Scan a dialog for any primary buttons and move them to the button area.
* *
* @param {jQuery} $dialog * @param {jQuery} $dialog
* An jQuery object containing the element that is the dialog target. * A jQuery object containing the element that is the dialog target.
* *
* @return {Array} * @return {Array}
* An array of buttons that need to be added to the button area. * An array of buttons that need to be added to the button area.

View File

@ -8,7 +8,7 @@
* Off-canvas dialog implementation using jQuery Dialog. * Off-canvas dialog implementation using jQuery Dialog.
* *
* Transforms the regular dialogs created using Drupal.dialog when the dialog * Transforms the regular dialogs created using Drupal.dialog when the dialog
* element equals '#drupal-off-canvas' into an side-loading dialog. * element equals '#drupal-off-canvas' into a side-loading dialog.
* *
* @namespace * @namespace
*/ */

View File

@ -21,7 +21,7 @@ use Drupal\Core\Plugin\DefaultPluginManager;
class AggregatorPluginManager extends DefaultPluginManager { class AggregatorPluginManager extends DefaultPluginManager {
/** /**
* Constructs a AggregatorPluginManager object. * Constructs an AggregatorPluginManager object.
* *
* @param string $type * @param string $type
* The plugin type, for example fetcher. * The plugin type, for example fetcher.

View File

@ -26,7 +26,7 @@ class Rss extends RssPluginBase {
public $base_table = 'aggregator_item'; public $base_table = 'aggregator_item';
/** /**
* The actual field which is used to identify a aggregator item. * The actual field which is used to identify an aggregator item.
* *
* @var string * @var string
*/ */

View File

@ -333,7 +333,7 @@ EOF;
} }
/** /**
* Returns a example RSS091 feed. * Returns an example RSS091 feed.
* *
* @return string * @return string
* Path to the feed. * Path to the feed.
@ -343,7 +343,7 @@ EOF;
} }
/** /**
* Returns a example Atom feed. * Returns an example Atom feed.
* *
* @return string * @return string
* Path to the feed. * Path to the feed.
@ -355,7 +355,7 @@ EOF;
} }
/** /**
* Returns a example feed. * Returns an example feed.
* *
* @return string * @return string
* Path to the feed. * Path to the feed.

View File

@ -91,7 +91,7 @@ class IntegrationTest extends ViewsKernelTestBase {
$values['timestamp'] = mt_rand(REQUEST_TIME - 10, REQUEST_TIME + 10); $values['timestamp'] = mt_rand(REQUEST_TIME - 10, REQUEST_TIME + 10);
$values['title'] = $this->randomMachineName(); $values['title'] = $this->randomMachineName();
$values['description'] = $this->randomMachineName(); $values['description'] = $this->randomMachineName();
// Add a image to ensure that the sanitizing can be tested below. // Add an image to ensure that the sanitizing can be tested below.
$values['author'] = $this->randomMachineName() . '<img src="http://example.com/example.png" \>"'; $values['author'] = $this->randomMachineName() . '<img src="http://example.com/example.png" \>"';
$values['link'] = 'https://www.drupal.org/node/' . mt_rand(1000, 10000); $values['link'] = 'https://www.drupal.org/node/' . mt_rand(1000, 10000);
$values['guid'] = $this->randomString(); $values['guid'] = $this->randomString();

View File

@ -23,7 +23,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
/** /**
* Service for sending an HTML response in chunks (to get faster page loads). * Service for sending an HTML response in chunks (to get faster page loads).
* *
* At a high level, BigPipe sends a HTML response in chunks: * At a high level, BigPipe sends an HTML response in chunks:
* 1. one chunk: everything until just before </body> this contains BigPipe * 1. one chunk: everything until just before </body> this contains BigPipe
* placeholders for the personalized parts of the page. Hence this sends the * placeholders for the personalized parts of the page. Hence this sends the
* non-personalized parts of the page. Let's call it The Skeleton. * non-personalized parts of the page. Let's call it The Skeleton.
@ -58,7 +58,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
* the logic though, we choose to call this "no-JS BigPipe". * the logic though, we choose to call this "no-JS BigPipe".
* *
* However, there is also a tangible benefit: some dynamic/expensive content is * However, there is also a tangible benefit: some dynamic/expensive content is
* not HTML, but for example a HTML attribute value (or part thereof). It's not * not HTML, but for example an HTML attribute value (or part thereof). It's not
* possible to efficiently replace such content using JavaScript, so "classic" * possible to efficiently replace such content using JavaScript, so "classic"
* BigPipe is out of the question. For example: CSRF tokens in URLs. * BigPipe is out of the question. For example: CSRF tokens in URLs.
* *
@ -68,7 +68,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
* Finally, a closer look at the implementation, and how it supports and reuses * Finally, a closer look at the implementation, and how it supports and reuses
* existing Drupal concepts: * existing Drupal concepts:
* 1. BigPipe placeholders: 1 HtmlResponse + N embedded AjaxResponses. * 1. BigPipe placeholders: 1 HtmlResponse + N embedded AjaxResponses.
* - Before a BigPipe response is sent, it is just a HTML response that * - Before a BigPipe response is sent, it is just an HTML response that
* contains BigPipe placeholders. Those placeholders look like * contains BigPipe placeholders. Those placeholders look like
* <span data-big-pipe-placeholder-id=""></span>. JavaScript is used to * <span data-big-pipe-placeholder-id=""></span>. JavaScript is used to
* replace those placeholders. * replace those placeholders.
@ -76,9 +76,9 @@ use Symfony\Component\HttpKernel\KernelEvents;
* - The Skeleton of course has attachments, including most notably asset * - The Skeleton of course has attachments, including most notably asset
* libraries. And those we track in drupalSettings.ajaxPageState.libraries * libraries. And those we track in drupalSettings.ajaxPageState.libraries
* so that when we load new content through AJAX, we don't load the same * so that when we load new content through AJAX, we don't load the same
* asset libraries again. A HTML page can have multiple AJAX responses, each * asset libraries again. An HTML page can have multiple AJAX responses,
* of which should take into account the combined AJAX page state of the * each of which should take into account the combined AJAX page state of
* HTML document and all preceding AJAX responses. * the HTML document and all preceding AJAX responses.
* - BigPipe does not make use of multiple AJAX requests/responses. It uses a * - BigPipe does not make use of multiple AJAX requests/responses. It uses a
* single HTML response. But it is a more long-lived one: The Skeleton is * single HTML response. But it is a more long-lived one: The Skeleton is
* sent first, the closing </body> tag is not yet sent, and the connection * sent first, the closing </body> tag is not yet sent, and the connection
@ -100,7 +100,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
* 1. <span data-big-pipe-nojs-placeholder-id=""></span> if it's a * 1. <span data-big-pipe-nojs-placeholder-id=""></span> if it's a
* placeholder that will be replaced by HTML * placeholder that will be replaced by HTML
* 2. big_pipe_nojs_placeholder_attribute_safe: if it's a placeholder * 2. big_pipe_nojs_placeholder_attribute_safe: if it's a placeholder
* inside a HTML attribute, in which 1. would be invalid (angle brackets * inside an HTML attribute, in which 1. would be invalid (angle brackets
* are not allowed inside HTML attributes) * are not allowed inside HTML attributes)
* No-JS BigPipe placeholders are not replaced using JavaScript, they must * No-JS BigPipe placeholders are not replaced using JavaScript, they must
* be replaced upon sending the BigPipe response. So, while the response is * be replaced upon sending the BigPipe response. So, while the response is
@ -526,7 +526,7 @@ class BigPipe {
// Send the start signal. // Send the start signal.
$this->sendChunk("\n" . static::START_SIGNAL . "\n"); $this->sendChunk("\n" . static::START_SIGNAL . "\n");
// A BigPipe response consists of a HTML response plus multiple embedded // A BigPipe response consists of an HTML response plus multiple embedded
// AJAX responses. To process the attachments of those AJAX responses, we // AJAX responses. To process the attachments of those AJAX responses, we
// need a fake request that is identical to the master request, but with // need a fake request that is identical to the master request, but with
// one change: it must have the right Accept header, otherwise the work- // one change: it must have the right Accept header, otherwise the work-
@ -617,7 +617,7 @@ EOF;
* A fake subrequest that contains the cumulative AJAX page state of the * A fake subrequest that contains the cumulative AJAX page state of the
* HTML document and all preceding Embedded HTML or AJAX responses. * HTML document and all preceding Embedded HTML or AJAX responses.
* @param \Symfony\Component\HttpFoundation\Response|\Drupal\Core\Render\HtmlResponse|\Drupal\Core\Ajax\AjaxResponse $embedded_response * @param \Symfony\Component\HttpFoundation\Response|\Drupal\Core\Render\HtmlResponse|\Drupal\Core\Ajax\AjaxResponse $embedded_response
* Either a HTML response or an AJAX response that will be embedded in the * Either an HTML response or an AJAX response that will be embedded in the
* overall HTML response. * overall HTML response.
* *
* @return \Symfony\Component\HttpFoundation\Response * @return \Symfony\Component\HttpFoundation\Response
@ -752,7 +752,7 @@ EOF;
} }
/** /**
* Splits a HTML string into fragments. * Splits an HTML string into fragments.
* *
* Creates an array of HTML fragments, separated by placeholders. The result * Creates an array of HTML fragments, separated by placeholders. The result
* includes the placeholders themselves. The original order is respected. * includes the placeholders themselves. The original order is respected.

View File

@ -176,8 +176,8 @@ class BigPipeStrategy implements PlaceholderStrategyInterface {
* A placeholder. * A placeholder.
* *
* @return bool * @return bool
* Whether the placeholder is safe for use in a HTML attribute (in case it's * Whether the placeholder is safe for use in an HTML attribute (in case
* a placeholder for a HTML attribute value or a subset of it). * it's a placeholder for an HTML attribute value or a subset of it).
*/ */
protected static function placeholderIsAttributeSafe($placeholder) { protected static function placeholderIsAttributeSafe($placeholder) {
assert(is_string($placeholder)); assert(is_string($placeholder));
@ -229,8 +229,8 @@ class BigPipeStrategy implements PlaceholderStrategyInterface {
* @param array $placeholder_render_array * @param array $placeholder_render_array
* The render array for a placeholder. * The render array for a placeholder.
* @param bool $placeholder_must_be_attribute_safe * @param bool $placeholder_must_be_attribute_safe
* Whether the placeholder must be safe for use in a HTML attribute (in case * Whether the placeholder must be safe for use in an HTML attribute (in
* it's a placeholder for a HTML attribute value or a subset of it). * case it's a placeholder for an HTML attribute value or a subset of it).
* *
* @return array * @return array
* The resulting BigPipe no-JS placeholder render array. * The resulting BigPipe no-JS placeholder render array.

View File

@ -9,7 +9,7 @@ use Drupal\Core\Security\TrustedCallbackInterface;
class BigPipeTestController implements TrustedCallbackInterface { class BigPipeTestController implements TrustedCallbackInterface {
/** /**
* Returns a all BigPipe placeholder test case render arrays. * Returns all BigPipe placeholder test case render arrays.
* *
* @return array * @return array
*/ */

View File

@ -182,7 +182,7 @@ class BlockListBuilder extends ConfigEntityListBuilder implements FormInterface
// Weights range from -delta to +delta, so delta should be at least half // Weights range from -delta to +delta, so delta should be at least half
// of the amount of blocks present. This makes sure all blocks in the same // of the amount of blocks present. This makes sure all blocks in the same
// region get an unique weight. // region get a unique weight.
$weight_delta = round(count($entities) / 2); $weight_delta = round(count($entities) / 2);
$placement = FALSE; $placement = FALSE;

View File

@ -35,7 +35,7 @@ interface RefinableDependentAccessInterface extends DependentAccessInterface {
* instance with the existing and new dependencies as the members of the * instance with the existing and new dependencies as the members of the
* group. * group.
* *
* If there is an existing dependency and it is a instance of AccessGroupAnd * If there is an existing dependency and it is an instance of AccessGroupAnd
* the dependency will be added to the existing access group. * the dependency will be added to the existing access group.
* *
* @param \Drupal\Core\Access\AccessibleInterface $access_dependency * @param \Drupal\Core\Access\AccessibleInterface $access_dependency

View File

@ -31,7 +31,7 @@ interface BookManagerInterface {
* $link, in which case $max_depth should be greater than $link['depth']. * $link, in which case $max_depth should be greater than $link['depth'].
* *
* @return array * @return array
* An tree of menu links in an array, in the order they should be rendered. * A tree of menu links in an array, in the order they should be rendered.
*/ */
public function bookTreeAllData($bid, $link = NULL, $max_depth = NULL); public function bookTreeAllData($bid, $link = NULL, $max_depth = NULL);

View File

@ -16,7 +16,7 @@ use Drupal\Core\StringTranslation\TranslationInterface;
/** /**
* Defines a breakpoint plugin manager to deal with breakpoints. * Defines a breakpoint plugin manager to deal with breakpoints.
* *
* Extension can define breakpoints in a EXTENSION_NAME.breakpoints.yml file * Extension can define breakpoints in an EXTENSION_NAME.breakpoints.yml file
* contained in the extension's base directory. Each breakpoint has the * contained in the extension's base directory. Each breakpoint has the
* following structure: * following structure:
* @code * @code

View File

@ -49,7 +49,7 @@ class ColorSafePreviewTest extends BrowserTestBase {
\Drupal::service('theme_installer')->install(['color_test_theme']); \Drupal::service('theme_installer')->install(['color_test_theme']);
$this->drupalLogin($this->bigUser); $this->drupalLogin($this->bigUser);
// Markup is being printed from a HTML file located in: // Markup is being printed from an HTML file located in:
// core/modules/color/tests/modules/color_test/themes/color_test_theme/color/preview.html // core/modules/color/tests/modules/color_test/themes/color_test_theme/color/preview.html
$url = Url::fromRoute('system.theme_settings_theme', ['theme' => 'color_test_theme']); $url = Url::fromRoute('system.theme_settings_theme', ['theme' => 'color_test_theme']);
$this->drupalGet($url); $this->drupalGet($url);

View File

@ -22,7 +22,7 @@ function comment_token_info() {
]; ];
$tokens = []; $tokens = [];
// Provide a integration for each entity type except comment. // Provides an integration for each entity type except comment.
foreach (\Drupal::entityTypeManager()->getDefinitions() as $entity_type_id => $entity_type) { foreach (\Drupal::entityTypeManager()->getDefinitions() as $entity_type_id => $entity_type) {
if ($entity_type_id == 'comment' || !$entity_type->entityClassImplements(ContentEntityInterface::class)) { if ($entity_type_id == 'comment' || !$entity_type->entityClassImplements(ContentEntityInterface::class)) {
continue; continue;

View File

@ -22,7 +22,7 @@ function comment_views_data_alter(&$data) {
], ],
]; ];
// Provide a integration for each entity type except comment. // Provides an integration for each entity type except comment.
foreach (\Drupal::entityTypeManager()->getDefinitions() as $entity_type_id => $entity_type) { foreach (\Drupal::entityTypeManager()->getDefinitions() as $entity_type_id => $entity_type) {
if ($entity_type_id == 'comment' || !$entity_type->entityClassImplements(ContentEntityInterface::class) || !$entity_type->getBaseTable()) { if ($entity_type_id == 'comment' || !$entity_type->entityClassImplements(ContentEntityInterface::class) || !$entity_type->getBaseTable()) {
continue; continue;

View File

@ -7,7 +7,7 @@ use Drupal\Core\Field\FieldItemList;
use Drupal\Core\Session\AccountInterface; use Drupal\Core\Session\AccountInterface;
/** /**
* Defines a item list class for comment fields. * Defines an item list class for comment fields.
*/ */
class CommentFieldItemList extends FieldItemList { class CommentFieldItemList extends FieldItemList {

View File

@ -242,7 +242,7 @@ class CommentController extends ControllerBase {
$build['comment_parent'] = $this->entityTypeManager()->getViewBuilder('comment')->view($comment); $build['comment_parent'] = $this->entityTypeManager()->getViewBuilder('comment')->view($comment);
} }
// The comment is in response to a entity. // The comment is in response to an entity.
elseif ($entity->access('view', $account)) { elseif ($entity->access('view', $account)) {
// We make sure the field value isn't set so we don't end up with a // We make sure the field value isn't set so we don't end up with a
// redirect loop. // redirect loop.

View File

@ -37,7 +37,7 @@ class UnpublishByKeywordComment extends ConfigurableActionBase implements Contai
protected $renderer; protected $renderer;
/** /**
* Constructs a UnpublishByKeywordComment object. * Constructs an UnpublishByKeywordComment object.
* *
* @param array $configuration * @param array $configuration
* A configuration array containing information about the plugin instance. * A configuration array containing information about the plugin instance.

View File

@ -33,7 +33,7 @@ class EntityComment extends EntityContentBase {
protected $stubCommentedEntityIds; protected $stubCommentedEntityIds;
/** /**
* Builds an comment entity destination. * Builds a comment entity destination.
* *
* @param array $configuration * @param array $configuration
* A configuration array containing information about the plugin instance. * A configuration array containing information about the plugin instance.

View File

@ -227,7 +227,7 @@ class CommentLinkBuilderTest extends UnitTestCase {
// If the view mode is teaser, or the user can access comments and // If the view mode is teaser, or the user can access comments and
// comments exist or the form is on a separate page. // comments exist or the form is on a separate page.
if ($combination['view_mode'] == 'teaser' || ($combination['has_access_comments'] && $combination['comment_count']) || $combination['form_location'] == CommentItemInterface::FORM_SEPARATE_PAGE) { if ($combination['view_mode'] == 'teaser' || ($combination['has_access_comments'] && $combination['comment_count']) || $combination['form_location'] == CommentItemInterface::FORM_SEPARATE_PAGE) {
// There should be a add comment link. // There should be an add comment link.
$expected['comment-add'] = ['title' => 'Add new comment']; $expected['comment-add'] = ['title' => 'Add new comment'];
if ($combination['form_location'] == CommentItemInterface::FORM_BELOW) { if ($combination['form_location'] == CommentItemInterface::FORM_BELOW) {
// On the same page. // On the same page.

View File

@ -173,7 +173,7 @@ class ConfigExportImportUITest extends BrowserTestBase {
$this->assertText($this->contentType->label()); $this->assertText($this->contentType->label());
$this->drupalPostForm(NULL, [], 'Import all'); $this->drupalPostForm(NULL, [], 'Import all');
// After importing the snapshot has been updated an there are no warnings. // After importing the snapshot has been updated and there are no warnings.
$this->assertNoText('Warning message'); $this->assertNoText('Warning message');
$this->assertText('There are no configuration changes to import.'); $this->assertText('There are no configuration changes to import.');

View File

@ -14,7 +14,7 @@ use Symfony\Component\DependencyInjection\ContainerInterface;
class ConfigTranslationMapperList extends ControllerBase { class ConfigTranslationMapperList extends ControllerBase {
/** /**
* A array of configuration mapper instances. * An array of configuration mapper instances.
* *
* @var \Drupal\config_translation\ConfigMapperInterface[] * @var \Drupal\config_translation\ConfigMapperInterface[]
*/ */

View File

@ -40,7 +40,7 @@ class DynamicLocalTasks extends DeriverBase implements ContainerDeriverInterface
protected $moderationInfo; protected $moderationInfo;
/** /**
* Creates an FieldUiLocalTask object. * Creates a FieldUiLocalTask object.
* *
* @param string $base_plugin_id * @param string $base_plugin_id
* The base plugin ID. * The base plugin ID.

View File

@ -38,7 +38,7 @@ process:
new_nid: new_nid:
- -
# If the path is of the form "node/<ID>" and is not routed, we will get # If the path is of the form "node/<ID>" and is not routed, we will get
# back an URI of the form "base:node/<ID>". # back a URI of the form "base:node/<ID>".
plugin: link_uri plugin: link_uri
source: link_path source: link_path
validate_route: false validate_route: false

View File

@ -151,7 +151,7 @@ abstract class DateTestBase extends BrowserTestBase {
} }
/** /**
* Renders a entity_test and sets the output in the internal browser. * Renders an entity_test and sets the output in the internal browser.
* *
* @param int $id * @param int $id
* The entity_test ID to render. * The entity_test ID to render.

Some files were not shown because too many files have changed in this diff Show More