Issue #2225265 by eojthebrave: Add Utility group/topic for api.drupal.org

core/lib/Drupal/Component/Utility/Crypt.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Utility class for cryptographically-secure string handling routines.
+ *
+ * @ingroup utility
  */
 class Crypt {
 

core/lib/Drupal/Component/Utility/DiffArray.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers to perform diffs on multi dimensional arrays.
+ *
+ * @ingroup utility
  */
 class DiffArray {
 

core/lib/Drupal/Component/Utility/Html.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides DOMDocument helpers for parsing and serializing HTML strings.
+ *
+ * @ingroup utility
  */
 class Html {
 

core/lib/Drupal/Component/Utility/Image.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers to operate on images.
+ *
+ * @ingroup utility
  */
 class Image {
 

core/lib/Drupal/Component/Utility/Json.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers for dealing with json.
+ *
+ * @ingroup utility
  */
 class Json {
 

core/lib/Drupal/Component/Utility/NestedArray.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers to perform operations on nested arrays and array keys of variable depth.
+ *
+ * @ingroup utility
  */
 class NestedArray {
 

core/lib/Drupal/Component/Utility/Number.php

@@ -8,6 +8,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helper methods for manipulating numbers.
+ *
+ * @ingroup utility
  */
 class Number {
 

core/lib/Drupal/Component/Utility/Random.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Defines a utility class for creating random data.
+ *
+ * @ingroup utility
  */
 class Random {
 

core/lib/Drupal/Component/Utility/Settings.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Read only settings that are initialized with the class.
+ *
+ * @ingroup utility
  */
 final class Settings {
 

core/lib/Drupal/Component/Utility/SortArray.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides generic array sorting helper methods.
+ *
+ * @ingroup utility
  */
 class SortArray {
 

core/lib/Drupal/Component/Utility/String.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers to operate on strings.
+ *
+ * @ingroup utility
  */
 class String {
 

core/lib/Drupal/Component/Utility/Tags.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Defines a class that can explode and implode tags.
+ *
+ * @ingroup utility
  */
 class Tags {
 

core/lib/Drupal/Component/Utility/Timer.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers to use timers throughout a request.
+ *
+ * @ingroup utility
  */
 class Timer {
 

core/lib/Drupal/Component/Utility/Unicode.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides Unicode-related conversions and operations.
+ *
+ * @ingroup utility
  */
 class Unicode {
 

core/lib/Drupal/Component/Utility/UrlHelper.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Helper class URL based methods.
+ *
+ * @ingroup utility
  */
 class UrlHelper {
 

core/lib/Drupal/Component/Utility/UserAgent.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides user agent related utility functions.
+ *
+ * @ingroup utility
  */
 class UserAgent {
 

core/lib/Drupal/Component/Utility/Variable.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helpers for dealing with variables.
+ *
+ * @ingroup utility
  */
 class Variable {
 

core/lib/Drupal/Component/Utility/Xss.php

@@ -9,6 +9,8 @@ namespace Drupal\Component\Utility;
 
 /**
  * Provides helper to filter for cross-site scripting.
+ *
+ * @ingroup utility
  */
 class Xss {
 

core/modules/system/core.api.php

@@ -38,10 +38,11 @@
  * - @link views_overview Views @endlink
  * - @link database Database abstraction layer @endlink
  *
- * @section utility Other essential APIs
+ * @section other_essentials Other essential APIs
  *
  * - @link i18n Internationalization @endlink
  * - @link cache Caching @endlink
+ * - @link utility Utility classes and functions @endlink
  * - @link user_api User accounts, permissions, and roles @endlink
  * - @link theme_render Theme system and render API @endlink
  * - @link migration Migration @endlink
@@ -476,3 +477,25 @@
  * - Automated testing: @link testing Automated tests topic @endlink
  * @}
  */
+
+/**
+ * @defgroup utility Utility classes and functions
+ * @{
+ * Overview of utility classes and functions for developers.
+ *
+ * Drupal provides developers with a variety of utility functions that make it
+ * easier and more efficient to perform tasks that are either really common,
+ * tedious, or difficult. Utility functions help to reduce code duplication and
+ * should be used in place of one-off code whenever possible.
+ *
+ * @see common.inc
+ * @see file
+ * @see format
+ * @see mail.inc
+ * @see php_wrappers
+ * @see sanitization
+ * @see session.inc
+ * @see transliteration
+ * @see validation
+ * @}
+ */