Issue #3417566 by quietone, smustgrave, longwave: Correct more words in comments plus pathnames

merge-requests/6506/head
Dave Long 2024-02-08 09:21:36 +00:00
parent 5ce8edeafa
commit 0b70058e0f
No known key found for this signature in database
GPG Key ID: ED52AE211E142771
41 changed files with 77 additions and 83 deletions

View File

@ -7,10 +7,10 @@ by your host). In the following examples, 'username' is an example MySQL user
which has the CREATE and GRANT privileges. Use the appropriate user name for
your system.
First, you must create a new database for your Drupal site (here, 'databasename'
is the name of the new database):
First, you must create a new database for your Drupal site (here,
'database_name' is the name of the new database):
mysqladmin -u username -p create databasename
mysqladmin -u username -p create database_name
MySQL will prompt for the 'username' database password and then create the
initial database files. Next you must log in and set the access database rights:
@ -21,12 +21,12 @@ Again, you will be asked for the 'username' database password. At the MySQL
prompt, enter the following command:
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER,
CREATE TEMPORARY TABLES ON databasename.*
CREATE TEMPORARY TABLES ON database_name.*
TO 'username'@'localhost' IDENTIFIED BY 'password';
where:
'databasename' is the name of your database
'database_name' is the name of your database
'username' is the username of your MySQL account
'localhost' is the web server host where Drupal is installed
'password' is the password required for that username

View File

@ -19,10 +19,10 @@ Note that the database must be created with UTF-8 (Unicode) encoding.
This step is only necessary if you don't already have a database set up
(e.g., by your host) or want to create a new database for use with Drupal
only. The following command creates a new database named 'databasename',
only. The following command creates a new database named 'database_name',
which is owned by the previously created 'username':
createdb --encoding=UTF8 --owner=username databasename
createdb --encoding=UTF8 --owner=username database_name
If there are no errors, then the command was successful.

View File

@ -77,7 +77,7 @@
*
* @code
* $databases['default']['default'] = [
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',
@ -193,7 +193,7 @@ $databases = [];
* @code
* $databases['default']['default'] = [
* 'driver' => 'pgsql',
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',
@ -215,7 +215,7 @@ $databases = [];
* 'driver' => 'my_driver',
* 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
* 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',
@ -230,7 +230,7 @@ $databases = [];
* 'driver' => 'my_driver',
* 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
* 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',

View File

@ -7,7 +7,7 @@
* Configuration file for multi-site support and directory aliasing feature.
*
* This file is required for multi-site support and also allows you to define a
* set of aliases that map hostnames, ports, and pathnames to configuration
* set of aliases that map host names, ports, and path names to configuration
* directories in the sites directory. These aliases are loaded prior to
* scanning for directories, and they are exempt from the normal discovery
* rules. See default.settings.php to view how Drupal discovers the

View File

@ -346,7 +346,7 @@ class Drupal {
* an object of a class that implements
* \Drupal\Core\DependencyInjection\ContainerInjectionInterface.
*
* One common usecase is to provide a class which contains the actual code
* One common use case is to provide a class which contains the actual code
* of a hook implementation, without having to create a service.
*
* @param string $class

View File

@ -6,6 +6,8 @@ namespace Drupal\Component\Utility;
use Masterminds\HTML5\Serializer\OutputRules;
// cspell:ignore drupalhtmlbuilder
/**
* Drupal-specific HTML5 serializer rules.
*

View File

@ -87,8 +87,8 @@ class CsrfTokenGenerator {
return FALSE;
}
$value = $this->computeToken($seed, $value);
// PHP 8.0 strictly typehints for hash_equals. Maintain BC until we can
// enforce scalar typehints on this method.
// PHP 8.0 strictly type hints for hash_equals. Maintain BC until we can
// enforce scalar type hints on this method.
if (!is_string($token)) {
return FALSE;
}

View File

@ -313,7 +313,7 @@ abstract class Tasks {
'#title' => t('Host'),
'#default_value' => empty($database['host']) ? 'localhost' : $database['host'],
'#size' => 45,
// Hostnames can be 255 characters long.
// Host names can be 255 characters long.
'#maxlength' => 255,
'#required' => TRUE,
];

View File

@ -33,11 +33,11 @@ abstract class TransactionManagerBase implements TransactionManagerInterface {
* additional savepoints, and release any savepoint in the sequence. When
* this happens, the database will implicitly release all the savepoints
* created after the one released. Given Drupal implementation of the
* Transaction objects, we cannot force descoping of the corresponding
* Transaction savepoint objects from the manager, because they live in the
* scope of the calling code. This stack ensures that when an outlived
* Transaction object gets out of scope, it will not try to release on the
* database a savepoint that no longer exists.
* Transaction objects, we cannot force reducing the scope of the
* corresponding Transaction savepoint objects from the manager, because they
* live in the scope of the calling code. This stack ensures that when an
* outlived Transaction object gets out of scope, it will not try to release
* on the database a savepoint that no longer exists.
*
* Differently, rollbacks are strictly being checked for LIFO order: if a
* rollback is requested against a savepoint that is not the last created,

View File

@ -189,7 +189,7 @@ class DrupalKernel implements DrupalKernelInterface, TerminableInterface {
protected $containerNeedsDumping;
/**
* List of discovered services.yml pathnames.
* List of discovered services.yml path names.
*
* This is a nested array whose top-level keys are 'app' and 'site', denoting
* the origin of a service provider. Site-specific providers have to be

View File

@ -62,7 +62,7 @@ class EntityForm extends FormBase implements EntityFormInterface {
* {@inheritdoc}
*/
public function getBaseFormId() {
// Assign ENTITYTYPE_form as base form ID to invoke corresponding
// Assign ENTITY_TYPE_form as base form ID to invoke corresponding
// hook_form_alter(), #validate, #submit, and #theme callbacks, but only if
// it is different from the actual form ID, since callbacks would be invoked
// twice otherwise.

View File

@ -204,14 +204,14 @@ class DatabaseDriverList extends ExtensionList {
/**
* {@inheritdoc}
*/
public function getPathnames() {
public function getPathNames() {
throw new \LogicException(__METHOD__ . '() is not implemented');
}
/**
* {@inheritdoc}
*/
protected function recalculatePathnames() {
protected function recalculatePathNames() {
throw new \LogicException(__METHOD__ . '() is not implemented');
}

View File

@ -170,14 +170,14 @@ abstract class ExtensionList {
$this->pathNames = NULL;
try {
$this->state->delete($this->getPathnamesCacheId());
$this->state->delete($this->getPathNamesCacheId());
}
catch (DatabaseExceptionWrapper $e) {
// Ignore exceptions caused by a non existing {key_value} table in the
// early installer.
}
$this->cache->delete($this->getPathnamesCacheId());
$this->cache->delete($this->getPathNamesCacheId());
// @todo In the long run it would be great to add the reset, but the early
// installer fails due to that. https://www.drupal.org/node/2719315 could
// help to resolve with that.
@ -210,7 +210,7 @@ abstract class ExtensionList {
* @return string
* The filename cache ID.
*/
protected function getPathnamesCacheId() {
protected function getPathNamesCacheId() {
return "system.{$this->type}.files";
}
@ -413,15 +413,15 @@ abstract class ExtensionList {
*
* @return string[]
*/
public function getPathnames() {
public function getPathNames() {
if ($this->pathNames === NULL) {
$cache_id = $this->getPathnamesCacheId();
$cache_id = $this->getPathNamesCacheId();
if ($cache = $this->cache->get($cache_id)) {
$path_names = $cache->data;
}
// We use $file_names below.
elseif (!$path_names = $this->state->get($cache_id)) {
$path_names = $this->recalculatePathnames();
$path_names = $this->recalculatePathNames();
// Store filenames to allow static::getPathname() to retrieve them
// without having to rebuild or scan the filesystem.
$this->state->set($cache_id, $path_names);
@ -438,7 +438,7 @@ abstract class ExtensionList {
* @return string[]
* An array of .info.yml file locations keyed by the extension machine name.
*/
protected function recalculatePathnames() {
protected function recalculatePathNames() {
$extensions = $this->getList();
ksort($extensions);
@ -518,7 +518,7 @@ abstract class ExtensionList {
elseif (isset($this->pathNames[$extension_name])) {
return $this->pathNames[$extension_name];
}
elseif (($path_names = $this->getPathnames()) && isset($path_names[$extension_name])) {
elseif (($path_names = $this->getPathNames()) && isset($path_names[$extension_name])) {
return $path_names[$extension_name];
}
throw new UnknownExtensionException("The {$this->type} $extension_name does not exist.");

View File

@ -43,7 +43,7 @@ trait ExtensionListTrait {
elseif (isset(static::$staticAddedPathNames[$extension_name])) {
return static::$staticAddedPathNames[$extension_name];
}
elseif (($path_names = $this->getPathnames()) && isset($path_names[$extension_name])) {
elseif (($path_names = $this->getPathNames()) && isset($path_names[$extension_name])) {
// Ensure we don't have to do path scanning more than really needed.
foreach ($path_names as $extension => $path_name) {
static::$staticAddedPathNames[$extension] = $path_name;

View File

@ -2,6 +2,8 @@
namespace Drupal\Core\Render;
// cspell:ignore turbolinks
use Drupal\Core\Asset\AssetCollectionRendererInterface;
use Drupal\Core\Asset\AssetResolverInterface;
use Drupal\Core\Asset\AttachedAssets;

View File

@ -16,6 +16,8 @@ use Symfony\Component\Routing\Exception\RouteNotFoundException;
use Symfony\Component\Routing\RouteCollection;
use Drupal\Core\Database\Connection;
// cspell:ignore filesort
/**
* A Route Provider front-end for all Drupal-stored routes.
*/

View File

@ -163,7 +163,7 @@ class TestDiscovery {
// Prevent expensive class loader lookups for each reflected test class by
// registering the complete classmap of test classes to the class loader.
// This also ensures that test classes are loaded from the discovered
// pathnames; a namespace/classname mismatch will throw an exception.
// path names; a namespace/classname mismatch will throw an exception.
$this->classLoader->addClassMap($classmap);
foreach ($classmap as $classname => $pathname) {
@ -213,7 +213,7 @@ class TestDiscovery {
*
* @return array
* A classmap containing all discovered class files; i.e., a map of
* fully-qualified classnames to pathnames.
* fully-qualified classnames to path names.
*/
public function findAllClassFiles($extension = NULL) {
$classmap = [];
@ -247,7 +247,7 @@ class TestDiscovery {
*
* @return array
* An associative array whose keys are fully-qualified class names and whose
* values are corresponding filesystem pathnames.
* values are corresponding filesystem path names.
*
* @throws \InvalidArgumentException
* If $namespace_prefix does not end in a namespace separator (backslash).

View File

@ -9,6 +9,8 @@ use Drupal\Core\Extension\ExtensionDiscovery;
use Drupal\Core\KeyValueStore\KeyValueStoreInterface;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
// cspell:ignore updatetype
/**
* Provides all and missing update implementations.
*

View File

@ -724,7 +724,7 @@
* The Ajax object will, if instructed, bind to a key press response. This
* will test to see if the key press is valid to trigger this event and
* if it is, trigger it for us and prevent other keypresses from triggering.
* In this case we're handling RETURN and SPACEBAR keypresses (event codes 13
* In this case we're handling RETURN and SPACE BAR keypresses (event codes 13
* and 32. RETURN is often used to submit a form when in a textfield, and
* SPACE is often used to activate an element without submitting.
*
@ -739,7 +739,7 @@
// Detect enter key and space bar and allow the standard response for them,
// except for form elements of type 'text', 'tel', 'number' and 'textarea',
// where the spacebar activation causes inappropriate activation if
// where the space bar activation causes inappropriate activation if
// #ajax['keypress'] is TRUE. On a text-type widget a space should always
// be a space.
if (

View File

@ -178,7 +178,6 @@ customevent
customrequest
cweagans
dailymotion
databasename
datelist
daterange
datestamp
@ -204,7 +203,6 @@ desaturate
desaturated
desaturates
desaturating
descoping
destructable
devel
deviantart
@ -257,7 +255,6 @@ endmacro
endset
endtrans
enoki
entitytype
entityviewedit
errmode
etag
@ -293,7 +290,6 @@ fieldlinks
fieldnames
fieldsets
filemime
filesort
filesystems
filetransfer
findwith
@ -339,7 +335,6 @@ hmac
hoglet
hookname
hosters
hostnames
hrefs
htkey
htmlcorrector
@ -379,7 +374,6 @@ johansson
jqueryui
jsonlint
jssdk
jumplinks
justinrainbow
kangarookitten
kernighan
@ -397,7 +391,6 @@ kword
lamoids
languageswitcher
libc
libmysqlclient
licious
lified
lightninggreen
@ -478,7 +471,6 @@ multibyte
multicardinality
multifield
multilanguage
multipage
multipass
multisite
multistar
@ -494,7 +486,6 @@ namespacing
navs
ndocs
necolas
negotiatiors
newcol
newfieldinitial
newnode
@ -559,7 +550,6 @@ parseable
parsererror
pastafazoul
pathauto
pathnames
pcre
pcss
peast
@ -718,7 +708,6 @@ smalldatetime
somecompany
sortablejs
sourceediting
spacebar
specialchars
spiffiness
splitbutton
@ -863,12 +852,9 @@ trgm
trid
troopal
truecolor
turbolinks
twistie
twocol
typehint
typehinted
typehints
tzid
uids
ulwa
@ -903,12 +889,10 @@ untabbable
upcasted
upcasting
updateprogress
updatetype
uploaders
uploadprogress
upscaling
urandom
usecase
userid
userinfo
userref

View File

@ -7,7 +7,7 @@ use Drupal\field\Entity\FieldConfig;
use Drupal\language\Entity\ConfigurableLanguage;
/**
* Tests multilanguage fields logic that require a full environment.
* Tests multilingual fields logic that require a full environment.
*
* @group field
*/

View File

@ -7,9 +7,9 @@ use Drupal\language\Entity\ConfigurableLanguage;
use Drupal\field\Entity\FieldStorageConfig;
/**
* Tests multilanguage fields logic.
* Tests multilingual fields logic.
*
* The following tests will check the multilanguage logic in field handling.
* The following tests will check the multilingual logic in field handling.
*
* @group field
*/

View File

@ -30,7 +30,7 @@ class FieldUI {
}
/**
* Returns the next redirect path in a multipage sequence.
* Returns the next redirect path in a multi-page sequence.
*
* @param array $destinations
* An array of destinations to redirect to.

View File

@ -98,7 +98,7 @@ use Drupal\Core\Access\AccessResult;
* revision ID. The `rel` negotiator takes a version argument which is either
* the string `latest-version` or the string `working-copy`.
*
* In the future, other negotiatiors may be developed, such as negotiatiors that
* In the future, other negotiators may be developed, such as negotiators that
* are UUID-, timestamp-, or workspace-based.
*
* To illustrate how a particular entity revision is requested, imagine a node

View File

@ -6,7 +6,7 @@ use Drupal\language\Entity\ConfigurableLanguage;
use Drupal\content_translation\ContentTranslationHandler;
/**
* Tests multilanguage fields logic.
* Tests multilingual fields logic.
*
* @group media
*/

View File

@ -58,7 +58,7 @@
$(once('media-library-menu-item', $menu.find('a')))
.on('keypress', (e) => {
// The AJAX link has the button role, so we need to make sure the link
// is also triggered when pressing the spacebar.
// is also triggered when pressing the space bar.
if (e.which === 32) {
e.preventDefault();
e.stopPropagation();

View File

@ -212,7 +212,7 @@ class EntityReferenceWidgetTest extends MediaLibraryTestBase {
$this->assertAnnounceContains('Showing Type Three media.');
$this->switchToMediaType('One');
$this->assertAnnounceContains('Showing Type One media.');
// Assert the links can be triggered by via the spacebar.
// Assert the links can be triggered by via the space bar.
$assert_session->elementExists('named', ['link', 'Type Three'])->keyPress(32);
$this->assertAnnounceContains('Showing Type Three media.');
$assert_session->elementExists('css', '.ui-dialog-titlebar-close')->click();

View File

@ -8,6 +8,8 @@ use Drupal\Core\Database\Install\Tasks as InstallTasks;
use Drupal\mysql\Driver\Database\mysql\Connection;
use Drupal\Core\Database\DatabaseNotFoundException;
// cspell:ignore libmysqlclient
/**
* Specifies installation tasks for MySQL and equivalent databases.
*/

View File

@ -1357,7 +1357,7 @@ function system_requirements($phase) {
];
}
// See if trusted hostnames have been configured, and warn the user if they
// See if trusted host names have been configured, and warn the user if they
// are not set.
if ($phase == 'runtime') {
$trusted_host_patterns = Settings::get('trusted_host_patterns');

View File

@ -17,7 +17,7 @@ abstract class TourTestBase extends BrowserTestBase {
* // Basic example.
* $this->assertTourTips();
*
* // Advanced example. The following would be used for multipage or
* // Advanced example. The following would be used for multi-page or
* // targeting a specific subset of tips.
* $tips = array();
* $tips[] = array('data-id' => 'foo');

View File

@ -297,7 +297,7 @@ class SqlTest extends UnitTestCase {
'id' => 1,
]);
// Note: Let the same entity be returned multiple times, for example to
// support the translation usecase.
// support the translation use case.
$result[] = new ResultRow([
'id' => 2,
]);

View File

@ -22,7 +22,7 @@
<ini name="memory_limit" value="-1"/>
<!-- Example SIMPLETEST_BASE_URL value: http://localhost -->
<env name="SIMPLETEST_BASE_URL" value=""/>
<!-- Example SIMPLETEST_DB value: mysql://username:password@localhost/databasename#table_prefix -->
<!-- Example SIMPLETEST_DB value: mysql://username:password@localhost/database_name#table_prefix -->
<env name="SIMPLETEST_DB" value=""/>
<!-- Example BROWSERTEST_OUTPUT_DIRECTORY value: /path/to/webroot/sites/simpletest/browser_output -->
<env name="BROWSERTEST_OUTPUT_DIRECTORY" value=""/>

View File

@ -271,7 +271,7 @@ All arguments are long options.
Required when running tests without a Drupal installation that
contains default database connection info in settings.php.
Examples:
mysql://username:password@localhost/databasename#table_prefix
mysql://username:password@localhost/database_name#table_prefix
sqlite://localhost/relative/path/db.sqlite
sqlite://localhost//absolute/path/db.sqlite

View File

@ -101,7 +101,7 @@ class TestSiteInstallCommand extends Command {
->addOption('json', NULL, InputOption::VALUE_NONE, 'Output test site connection details in JSON.')
->addUsage('--setup-file core/tests/Drupal/TestSite/TestSiteMultilingualInstallTestScript.php --json')
->addUsage('--install-profile demo_umami --langcode fr')
->addUsage('--base-url "http://example.com" --db-url "mysql://username:password@localhost/databasename#table_prefix"');
->addUsage('--base-url "http://example.com" --db-url "mysql://username:password@localhost/database_name#table_prefix"');
}
/**

View File

@ -32,7 +32,7 @@ class TestSiteTearDownCommand extends Command {
->addOption('db-url', NULL, InputOption::VALUE_OPTIONAL, 'URL for database. Defaults to the environment variable SIMPLETEST_DB.', getenv('SIMPLETEST_DB'))
->addOption('keep-lock', NULL, InputOption::VALUE_NONE, 'Keeps the database prefix lock. Useful for ensuring test isolation when running concurrent tests.')
->addUsage('test12345678')
->addUsage('test12345678 --db-url "mysql://username:password@localhost/databasename#table_prefix"')
->addUsage('test12345678 --db-url "mysql://username:password@localhost/database_name#table_prefix"')
->addUsage('test12345678 --keep-lock');
}

View File

@ -57,7 +57,7 @@ class ArgumentsResolverTest extends TestCase {
];
// Test with a raw value that overrides the provided upcast value, since
// it is not typehinted.
// it is not type hinted.
$scalars = ['foo' => 'baz'];
$objects = ['foo' => new \stdClass()];
$data[] = [

View File

@ -39,7 +39,7 @@ class ValidateHostnameTest extends UnitTestCase {
$data[] = ['security<.drupal.org:80', 'HTTP_HOST with &lt; is invalid'];
$data[] = ['security..drupal.org:80', 'HTTP_HOST with .. is invalid'];
// Verifies hostnames that are too long, or have too many parts are
// Verifies host names that are too long, or have too many parts are
// invalid.
$data[] = [str_repeat('x', 1000) . '.security.drupal.org:80', 'HTTP_HOST with more than 1000 characters is invalid.'];
$data[] = [str_repeat('x.', 100) . 'security.drupal.org:80', 'HTTP_HOST with more than 100 subdomains is invalid.'];

View File

@ -137,12 +137,12 @@ class ExtensionListTest extends UnitTestCase {
}
/**
* @covers ::getPathnames
* @covers ::getPathNames
*/
public function testGetPathnames() {
public function testGetPathNames() {
$test_extension_list = $this->setupTestExtensionList();
$filenames = $test_extension_list->getPathnames();
$filenames = $test_extension_list->getPathNames();
$this->assertEquals([
'test_name' => 'example/test_name/test_name.info.yml',
], $filenames);
@ -189,7 +189,7 @@ class ExtensionListTest extends UnitTestCase {
$this->assertEquals('example/test_name', $path);
$pathname = $test_extension_list->getPathname('test_name');
$this->assertEquals('example/test_name/test_name.info.yml', $pathname);
$filenames = $test_extension_list->getPathnames();
$filenames = $test_extension_list->getPathNames();
$this->assertEquals([
'test_name' => 'example/test_name/test_name.info.yml',
], $filenames);
@ -201,7 +201,7 @@ class ExtensionListTest extends UnitTestCase {
$this->assertEquals('example/test_name', $path);
$pathname = $test_extension_list->getPathname('test_name');
$this->assertEquals('example/test_name/test_name.info.yml', $pathname);
$filenames = $test_extension_list->getPathnames();
$filenames = $test_extension_list->getPathNames();
$this->assertEquals([
'test_name' => 'example/test_name/test_name.info.yml',
], $filenames);

View File

@ -79,7 +79,7 @@ class PathValidatorTest extends UnitTestCase {
}
/**
* Tests the isValid() method for <none> (used for jumplinks).
* Tests the isValid() method for <none> (used for jump links).
*
* @covers ::isValid
*/

View File

@ -77,7 +77,7 @@
*
* @code
* $databases['default']['default'] = [
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',
@ -193,7 +193,7 @@ $databases = [];
* @code
* $databases['default']['default'] = [
* 'driver' => 'pgsql',
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',
@ -215,7 +215,7 @@ $databases = [];
* 'driver' => 'my_driver',
* 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
* 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',
@ -230,7 +230,7 @@ $databases = [];
* 'driver' => 'my_driver',
* 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
* 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
* 'database' => 'databasename',
* 'database' => 'database_name',
* 'username' => 'sql_username',
* 'password' => 'sql_password',
* 'host' => 'localhost',

View File

@ -7,7 +7,7 @@
* Configuration file for multi-site support and directory aliasing feature.
*
* This file is required for multi-site support and also allows you to define a
* set of aliases that map hostnames, ports, and pathnames to configuration
* set of aliases that map host names, ports, and path names to configuration
* directories in the sites directory. These aliases are loaded prior to
* scanning for directories, and they are exempt from the normal discovery
* rules. See default.settings.php to view how Drupal discovers the