diff --git a/pom.xml b/pom.xml
index b8508e7e4..88e70d09e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -356,6 +356,9 @@ Copyright (c) 2012 - Jeremy Long
             <dependency>
                 <groupId>commons-cli</groupId>
                 <artifactId>commons-cli</artifactId>
+                <!-- Before upgrading to 1.3, note that this introduces several
+                deprecation warnings. Most notable OptionBuilder has been
+                marked as deprecated. Should probably be sorted out. -->
                 <version>1.2</version>
             </dependency>
             <dependency>
@@ -383,6 +386,8 @@ Copyright (c) 2012 - Jeremy Long
             <dependency>
                 <groupId>org.jmockit</groupId>
                 <artifactId>jmockit</artifactId>
+                <!-- Upgrading to 1.17 introduces build failures when building
+                with OpenJDK. -->
                 <version>1.16</version>
                 <scope>test</scope>
             </dependency>