diff --git a/plugins/org.eclipse.wtp.releng.utilities/sedscript.sed b/plugins/org.eclipse.wtp.releng.utilities/sedscript.sed
index 75002c7fc7b8658791102ddaf282e3c51c7d2d8f..5db15b5da7e2b1bd82083ba598561e9628354a82 100644
--- a/plugins/org.eclipse.wtp.releng.utilities/sedscript.sed
+++ b/plugins/org.eclipse.wtp.releng.utilities/sedscript.sed
@@ -1,3 +1,17 @@
+
+# This script finds patterns of the old form of specifying modules, that 
+#     consist of a path name ending with a module name. We know the model name 
+#     should stay the same, so this is just to tweak the path names. 
+#     Thought to be usefull for map files and Team Project Sets. 
+
+# Example use:
+#     The easiest case, if only a few files
+#     		sed -f sedscript.sed oldfile.pfs > newfile.pfs
+#  	   This case worked as excpeted on Linux, but not on windows using Cygwin
+#           sed -ibak -f sedscript.sed *.pfs
+$       A classic form: 
+#			find releng/maps/ -name *.map -exec sed -ibak -f sedscript.sed '{}' \;
+
 s:jst/components/assembly/features/org.eclipse.jst.feature:webtools.releng/assembly/features/org.eclipse.jst.feature:g
 s:jst/components/assembly/features/org.eclipse.jst.sdk:webtools.releng/assembly/features/org.eclipse.jst.sdk:g
 s:jst/components/assembly/features/org.eclipse.jst.tests:webtools.releng/assembly/features/org.eclipse.jst.tests:g