diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/internal/storage/file/BitmapIndexImpl.java b/org.eclipse.jgit/src/org/eclipse/jgit/internal/storage/file/BitmapIndexImpl.java
index 2c4af7068..b27bcc425 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/internal/storage/file/BitmapIndexImpl.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/internal/storage/file/BitmapIndexImpl.java
@@ -327,6 +327,12 @@ public class BitmapIndexImpl implements BitmapIndex {
 		final EWAHCompressedBitmap bitmap;
 		final BitmapIndexImpl bitmapIndex;
 
+		/**
+		 * Construct compressed bitmap for given bitmap and bitmap index
+		 *
+		 * @param bitmap
+		 * @param bitmapIndex
+		 */
 		public CompressedBitmap(EWAHCompressedBitmap bitmap, BitmapIndexImpl bitmapIndex) {
 			this.bitmap = bitmap;
 			this.bitmapIndex = bitmapIndex;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/lib/BitmapIndex.java b/org.eclipse.jgit/src/org/eclipse/jgit/lib/BitmapIndex.java
index 037d3fd2a..9ddff2548 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/lib/BitmapIndex.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/lib/BitmapIndex.java
@@ -206,7 +206,9 @@ public interface BitmapIndex {
 		int cardinality();
 
 		/**
-		 * The BitmapIndex for this BitmapBuilder.
+		 * Get the BitmapIndex for this BitmapBuilder.
+		 *
+		 * @return the BitmapIndex for this BitmapBuilder
 		 *
 		 * @since 4.2
 		 */