Issue #3397490 by quietone, smustgrave, xjm, longwave, poker10: Fix more words...

 * 'sites/default' will be used.

 *

 * For example, for a fictitious site installed at

 * https://www.drupal.org:8080/mysite/test/, the 'settings.php' file is searched

 * https://www.drupal.org:8080/my-site/test/, the 'settings.php' file is searched

 * for in the following directories:

 *

 * - sites/8080.www.drupal.org.mysite.test

 * - sites/www.drupal.org.mysite.test

 * - sites/drupal.org.mysite.test

 * - sites/org.mysite.test

 * - sites/8080.www.drupal.org.my-site.test

 * - sites/www.drupal.org.my-site.test

 * - sites/drupal.org.my-site.test

 * - sites/org.my-site.test

 *

 * - sites/8080.www.drupal.org.mysite

 * - sites/www.drupal.org.mysite

 * - sites/drupal.org.mysite

 * - sites/org.mysite

 * - sites/8080.www.drupal.org.my-site

 * - sites/www.drupal.org.my-site

 * - sites/drupal.org.my-site

 * - sites/org.my-site

 *

 * - sites/8080.www.drupal.org

 * - sites/www.drupal.org

 *

 * Note that if you are installing on a non-standard port number, prefix the

 * hostname with that number. For example,

 * https://www.drupal.org:8080/mysite/test/ could be loaded from

 * sites/8080.www.drupal.org.mysite.test/.

 * https://www.drupal.org:8080/my-site/test/ could be loaded from

 * sites/8080.www.drupal.org.my-site.test/.

 *

 * @see example.sites.php

 * @see \Drupal\Core\DrupalKernel::getSitePath()

 *

 * Aliases are defined in an associative array named $sites. The array is

 * written in the format: '<port>.<domain>.<path>' => 'directory'. As an

 * example, to map https://www.drupal.org:8080/mysite/test to the configuration

 * example, to map https://www.drupal.org:8080/my-site/test to the configuration

 * directory sites/example.com, the array should be defined as:

 * @code

 * $sites = [

 *   '8080.www.drupal.org.mysite.test' => 'example.com',

 *   '8080.www.drupal.org.my-site.test' => 'example.com',

 * ];

 * @endcode

 * The URL, https://www.drupal.org:8080/mysite/test/, could be a symbolic link

 * The URL, https://www.drupal.org:8080/my-site/test/, could be a symbolic link

 * or an Apache Alias directive that points to the Drupal root containing

 * index.php. An alias could also be created for a subdomain. See the

 * @link https://www.drupal.org/documentation/install online Drupal installation guide @endlink

 * URL: http://localhost:8080/example

 * $sites['8080.localhost.example'] = 'example.com';

 *

 * URL: https://www.drupal.org:8080/mysite/test/

 * $sites['8080.www.drupal.org.mysite.test'] = 'example.com';

 * URL: https://www.drupal.org:8080/my-site/test/

 * $sites['8080.www.drupal.org.my-site.test'] = 'example.com';

 * @endcode

 *

 * @see default.settings.php

 *

 * When you request a cache object, you can specify the bin name in your call to

 * \Drupal::cache(). Alternatively, you can request a bin by getting service

 * "cache.nameofbin" from the container. The default bin is called "default", with

 * service name "cache.default", it is used to store common and frequently used

 * caches.

 * "cache.name_of_bin" from the container. The default bin is called "default",

 * with service name "cache.default", it is used to store common and frequently

 * used caches.

 *

 * Other common cache bins are the following:

 *   - bootstrap: Data needed from the beginning to the end of most requests,

 *

 * A module can define a cache bin by defining a service in its

 * modulename.services.yml file as follows (substituting the desired name for

 * "nameofbin"):

 * "name_of_bin"):

 * @code

 * cache.nameofbin:

 * cache.name_of_bin:

 *   class: Drupal\Core\Cache\CacheBackendInterface

 *   tags:

 *     - { name: cache.bin }

 *   factory: ['@cache_factory', 'get']

 *   arguments: [nameofbin]

 *   arguments: [name_of_bin]

 * @endcode

 * See the @link container Services topic @endlink for more on defining

 * services.

 *   Typically, you will want to extend one of the classes listed in the

 *   sections above as a starting point.

 * - Make your class into a DataType plugin. To do that, put it in namespace

 *   \Drupal\yourmodule\Plugin\DataType (where "yourmodule" is your module's

 *   \Drupal\your_module\Plugin\DataType (where "your_module" is your module's

 *   short name), and add annotation of type

 *   \Drupal\Core\TypedData\Annotation\DataType to the documentation header.

 *   See the @link plugin_api Plugin API topic @endlink and the

 *     (database, settings, etc.) and web browser are not needed for the test,

 *     or if the Drupal environment can be replaced by a "mock" object.

 *   - Base class: \Drupal\Tests\UnitTestCase

 *   - Namespace: \Drupal\Tests\yourmodule\Unit (or a subdirectory)

 *   - Directory location: yourmodule/tests/src/Unit (or a subdirectory)

 *   - Namespace: \Drupal\Tests\your_module\Unit (or a subdirectory)

 *   - Directory location: your_module/tests/src/Unit (or a subdirectory)

 * - Kernel tests:

 *   - Purpose: Test functionality of a class if the full Drupal environment

 *     and web browser are not needed for the test, but the functionality has

 *     are only installed to the point of having services and hooks, unless you

 *     install them explicitly.

 *   - Base class: \Drupal\KernelTests\KernelTestBase

 *   - Namespace: \Drupal\Tests\yourmodule\Kernel (or a subdirectory)

 *   - Directory location: yourmodule/tests/src/Kernel (or a subdirectory)

 *   - Namespace: \Drupal\Tests\your_module\Kernel (or a subdirectory)

 *   - Directory location: your_module/tests/src/Kernel (or a subdirectory)

 * - Browser tests:

 *   - Purpose: Test functionality with the full Drupal environment and an

 *     internal simulated web browser, if JavaScript is not needed.

 *   - Base class: \Drupal\Tests\BrowserTestBase

 *   - Namespace: \Drupal\Tests\yourmodule\Functional (or a subdirectory)

 *   - Directory location: yourmodule/tests/src/Functional (or a subdirectory)

 *   - Namespace: \Drupal\Tests\your_module\Functional (or a subdirectory)

 *   - Directory location: your_module/tests/src/Functional (or a subdirectory)

 * - Browser tests with JavaScript:

 *   - Purpose: Test functionality with the full Drupal environment and an

 *     internal web browser that includes JavaScript execution.

 *   - Base class: \Drupal\FunctionalJavascriptTests\WebDriverTestBase

 *   - Namespace: \Drupal\Tests\yourmodule\FunctionalJavascript (or a

 *   - Namespace: \Drupal\Tests\your_module\FunctionalJavascript (or a

 *     subdirectory)

 *   - Directory location: yourmodule/tests/src/FunctionalJavascript (or a

 *   - Directory location: your_module/tests/src/FunctionalJavascript (or a

 *     subdirectory)

 * - Build tests:

 *   - Purpose: Test building processes and their outcomes, such as whether a

 *     workspace and a PHP-native HTTP server to send requests to the site

 *     you've built.

 *   - Base class: \Drupal\BuildTests\Framework\BuildTestBase

 *   - Namespace: \Drupal\Tests\yourmodule\Build (or a

 *   - Namespace: \Drupal\Tests\your_module\Build (or a

 *     subdirectory)

 *   - Directory location: yourmodule/tests/src/Build (or a

 *   - Directory location: your_module/tests/src/Build (or a

 *     subdirectory)

 *

 * Some notes about writing PHP test classes:

 *   test methods need to have a phpDoc block with @covers annotation telling

 *   which class method they are testing.

 * - In some cases, you may need to write a test module to support your test;

 *   put such modules under the yourmodule/tests/modules directory.

 *   put such modules under the your_module/tests/modules directory.

 *

 * Besides the PHPUnit tests described above, Drupal Core also includes a few

 * JavaScript-only tests, which use the Nightwatch.js framework to test

 * @method $this setDate(int $year, int $month, int $day)

 * @method $this setISODate(int $year, int $week, int $day = 1)

 * @method $this setTime(int $hour, int $minute, int $second = 0, int $microseconds = 0)

 * @method $this setTimestamp(int $unixtimestamp)

 * @method $this setTimestamp(int $unix_timestamp)

 * @method $this setTimezone(\DateTimeZone $timezone)

 * @method $this sub(\DateInterval $interval)

 * @method int getOffset()

namespace Drupal\Component\Transliteration;

// cspell:ignore vibber

// cspell:ignore Brion Vibber

/**

 * Implements transliteration without using the PECL extensions.