From 157b6a8dc6784d8616741f71449f714bdaf40f73 Mon Nov 17 00:00:00 2016
From: "Kifah Meeran" <kufahmeeran@gmail.com.com>
Date: Sat, 12 Feb 2017 18:00:13 +0430
Subject: [PATCH] Updated text

---
 .../src/Plugin/migrate/process/MachineName.php     | 25 +++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/core/modules/migrate/src/Plugin/migrate/process/MachineName.php b/core/modules/migrate/src/Plugin/migrate/process/MachineName.php
index 15ed356..1b7c622 100644
--- a/core/modules/migrate/src/Plugin/migrate/process/MachineName.php
+++ b/core/modules/migrate/src/Plugin/migrate/process/MachineName.php
@@ -11,13 +11,28 @@
 use Symfony\Component\DependencyInjection\ContainerInterface;

 /**
- * This plugin creates a machine name.
+ * Creates a machine name.
  *
- * The current value gets transliterated, non-alphanumeric characters removed
- * and replaced by an underscore and multiple underscores are collapsed into
- * one.
+ * The machine_name process plugin takes the source value and runs it through
+ * the transliteration service. This makes the source value lowercase,
+ * replaces anything that is not a number or a letter with an underscore,
+ * and removes duplicate underscores.
  *
- * @link https://www.drupal.org/node/2135323 Online handbook documentation for machine_name process plugin @endlink
+ * Letters will have language decorations and accents removed.
+ *
+ * Example:
+ *
+ * @code
+ * process:
+ *   bar:
+ *     plugin: machine_name
+ *     source: foo
+ * @endcode
+ *
+ * If the value of foo in the source is áéí! then the destination value of bar
+ * will be aei_.
+ *
+ * @see \Drupal\migrate\Plugin\MigrateProcessInterface
  *
  * @MigrateProcessPlugin(
  *   id = "machine_name"