Fix for Bug 28214 [runtime] Docs on IPath.makeRelative and IPath.makeAbsolute are misleading
diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPath.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPath.java
index 5c63bd1..6dc56a1 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPath.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPath.java
@@ -259,13 +259,15 @@
public String lastSegment();
/**
* Returns an absolute path with the segments and device id of this path.
- * If this path is absolute, it is simply returned.
+ * Absolute paths start with a path separator. If this path is absolute,
+ * it is simply returned.
*
* @return the new path
*/
public IPath makeAbsolute();
/**
* Returns a relative path with the segments and device id of this path.
+ * Absolute paths start with a path separator and relative paths do not.
* If this path is relative, it is simply returned.
*
* @return the new path
