diff --git a/target-platform-configuration/src/main/java/org/eclipse/tycho/target/MirrorTargetPlatformMojo.java b/target-platform-configuration/src/main/java/org/eclipse/tycho/target/MirrorTargetPlatformMojo.java
index 83b0ee99f8..3e85d86a02 100644
--- a/target-platform-configuration/src/main/java/org/eclipse/tycho/target/MirrorTargetPlatformMojo.java
+++ b/target-platform-configuration/src/main/java/org/eclipse/tycho/target/MirrorTargetPlatformMojo.java
@@ -82,14 +82,14 @@ public class MirrorTargetPlatformMojo extends AbstractMojo {
      * <options>
     *   <!-- should optional dependencies be included (true) or ignored (false), defaults to true -->
     *   <includeOptionalDependencies>true/false</includeOptionalDependencies>
-    *   <!-- should requirements be considered always greedy (true) or only if specified (false), defaults to true -->
+    *   <!-- should requirements be considered always greedy (true) - i.e., install even if there are no usages - or only if specified (false), defaults to true -->
     *   <everythingGreedy>true/false</everythingGreedy>
-    *   <!-- should only strict dependencies be consodered (true) or all dependencies (false), defaults to false -->
-    *   <!-- a strict dependency is onw with a strict version range (e.g. [1.2,1.2]) and usually maps to items included in a feature -->
+    *   <!-- should only strict dependencies be considered (true) or all dependencies (false), defaults to false -->
+    *   <!-- a strict dependency is one with a strict version range (e.g. [1.2,1.2]) and usually maps to items included in a feature, default is false -->
     *   <considerStrictDependencyOnly>true/false</considerStrictDependencyOnly>
-    *   <!-- should only items that have a filter be considerd (true) or all of them (false), default is false -->
+    *   <!-- should only items that have a filter be considered (true) or all of them (false), default is false -->
     *   <followOnlyFilteredRequirements>true/false</followOnlyFilteredRequirements>
-    *   <!-- if no filter context is defined and there is a filter, it is forced to be asume to be matched (true) or non matching (false), default is true -->
+    *   <!-- if no filter context is defined and a filter is encountered (e.g., os = win32 on a requirement), the filter will always match (true) or fail (false), default is true -->
     *   <forceFilterTo>true/false</forceFilterTo>
     *   <!-- should only the latest version (true) or all versions (false) be included, default is true -->
     *   <latestVersion>true/false</latestVersion>