From fe387e762df676ad24634747cc572b02d6cad55f Mon Sep 17 00:00:00 2001
From: Markus Keller
Date: Fri, 6 Feb 2015 14:38:43 +0100
Subject: Bug 459310: New API: DebugPlugin#splitArguments(String) fixed
 incomplete Javadoc

---
 .../core/org/eclipse/debug/core/DebugPlugin.java                   | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'org.eclipse.debug.core')

diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java
index c2b9ed73a..665ffc876 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java
@@ -1518,9 +1518,14 @@ public class DebugPlugin extends Plugin {
 	 * Splits the given command line into separate arguments that can be
 	 * concatenated with a space as joiner. Embedded quotes and backslashes are
 	 * kept as is (i.e. not interpreted).
+	 * <p>
+	 * Use this method to avoid e.g. losing quotes around an argument like
+	 * <code>"${env_var:A}"</code>, which may later be substituted by a string
+	 * that contains spaces.
+	 * </p>
 	 *
 	 * @param args command line arguments as a single string
-	 * @return individual arguments in original (
+	 * @return individual arguments in original form
 	 * @since 3.10
 	 */
 	public static String[] splitArguments(String args) {
-- 
cgit v1.2.3