diff --git a/src/java/org/apache/poi/poifs/macros/VBAMacroExtractor.java b/src/java/org/apache/poi/poifs/macros/VBAMacroExtractor.java
index cbcd3861e..37b43d4f0 100644
--- a/src/java/org/apache/poi/poifs/macros/VBAMacroExtractor.java
+++ b/src/java/org/apache/poi/poifs/macros/VBAMacroExtractor.java
@@ -27,8 +27,8 @@ import java.util.Map;
 import org.apache.poi.util.StringUtil;
 
 /**
- * This class extracts out the source of all VBA Modules of an office file,
- *  both OOXML and OLE2/POIFS, eg XLSM or DOC
+ * This tool extracts out the source of all VBA Modules of an office file,
+ *  both OOXML (eg XLSM) and OLE2/POIFS (eg DOC), to STDOUT or a directory.
  */
 public class VBAMacroExtractor {
     public static void main(String args[]) throws IOException {
diff --git a/src/java/org/apache/poi/poifs/macros/VBAMacroReader.java b/src/java/org/apache/poi/poifs/macros/VBAMacroReader.java
index 0b8ebdda8..1d59a4751 100644
--- a/src/java/org/apache/poi/poifs/macros/VBAMacroReader.java
+++ b/src/java/org/apache/poi/poifs/macros/VBAMacroReader.java
@@ -42,7 +42,7 @@ import org.apache.poi.util.RLEDecompressingInputStream;
 
 /**
  * Finds all VBA Macros in an office file (OLE2/POIFS and OOXML/OPC),
- *  and returns them
+ *  and returns them.
  */
 public class VBAMacroReader implements Closeable {
     protected static final String VBA_PROJECT_OOXML = "xl/vbaProject.bin";