diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/errors/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/errors/package-info.java
new file mode 100644
index 000000000..4066d1e75
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/errors/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Exceptions thrown by API commands.
+ */
+package org.eclipse.jgit.api.errors;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/package-info.java
new file mode 100644
index 000000000..f1e6571d5
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * High-level API commands (the porcelain of JGit).
+ */
+package org.eclipse.jgit.api;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/blame/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/blame/package-info.java
new file mode 100644
index 000000000..05f6c5914
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/blame/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Computing blame/annotate information of files.
+ */
+package org.eclipse.jgit.blame;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/diff/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/diff/package-info.java
new file mode 100644
index 000000000..98c44e11a
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/diff/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Comparing file contents by computing diffs.
+ */
+package org.eclipse.jgit.diff;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/dircache/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/dircache/package-info.java
new file mode 100644
index 000000000..297065a07
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/dircache/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Reading and editing the directory cache (index).
+ */
+package org.eclipse.jgit.dircache;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/errors/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/errors/package-info.java
new file mode 100644
index 000000000..44fd432b4
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/errors/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Exceptions thrown by lower-level JGit APIs.
+ */
+package org.eclipse.jgit.errors;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/events/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/events/package-info.java
new file mode 100644
index 000000000..5cdb72307
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/events/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Events and listener interfaces.
+ */
+package org.eclipse.jgit.events;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/fnmatch/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/fnmatch/package-info.java
new file mode 100644
index 000000000..ba6753b60
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/fnmatch/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * File name matcher.
+ */
+package org.eclipse.jgit.fnmatch;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/ignore/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/ignore/package-info.java
new file mode 100644
index 000000000..6797e9888
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/ignore/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Ignore rule parser/matcher (for .gitignore entries).
+ */
+package org.eclipse.jgit.ignore;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/internal/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/internal/package-info.java
new file mode 100644
index 000000000..b78f8ebd1
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/internal/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Internal classes.
+ */
+package org.eclipse.jgit.internal;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/lib/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/lib/package-info.java
new file mode 100644
index 000000000..ce2711e02
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/lib/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Core API for repository, config, refs, object database.
+ */
+package org.eclipse.jgit.lib;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/merge/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/merge/package-info.java
new file mode 100644
index 000000000..d61cd6a5c
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/merge/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Content and commit history merge algorithms.
+ */
+package org.eclipse.jgit.merge;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/nls/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/nls/package-info.java
new file mode 100644
index 000000000..0f2105a28
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/nls/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Native language support (i18n).
+ */
+package org.eclipse.jgit.nls;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/notes/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/notes/package-info.java
new file mode 100644
index 000000000..1908b6609
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/notes/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Git notes processing (for commits, etc).
+ */
+package org.eclipse.jgit.notes;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/patch/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/patch/package-info.java
new file mode 100644
index 000000000..b8e18a6b5
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/patch/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Patch file parser and data structure.
+ */
+package org.eclipse.jgit.patch;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/revplot/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/revplot/package-info.java
new file mode 100644
index 000000000..8bec5f1f7
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/revplot/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Building/rendering revision graphs.
+ */
+package org.eclipse.jgit.revplot;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/filter/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/filter/package-info.java
new file mode 100644
index 000000000..135850cba
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/filter/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Filters for use in revision walking.
+ */
+package org.eclipse.jgit.revwalk.filter;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/package-info.java
new file mode 100644
index 000000000..05ab51e48
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Walking revision graphs (commit history).
+ */
+package org.eclipse.jgit.revwalk;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/storage/dfs/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/storage/dfs/package-info.java
new file mode 100644
index 000000000..32f3d3275
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/storage/dfs/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Distributed file system based repository storage.
+ */
+package org.eclipse.jgit.storage.dfs;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/storage/file/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/storage/file/package-info.java
new file mode 100644
index 000000000..9b3506b1d
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/storage/file/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * File based repository storage.
+ */
+package org.eclipse.jgit.storage.file;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/storage/pack/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/storage/pack/package-info.java
new file mode 100644
index 000000000..ac7d115e6
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/storage/pack/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Reading/writing Git pack files.
+ */
+package org.eclipse.jgit.storage.pack;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/submodule/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/submodule/package-info.java
new file mode 100644
index 000000000..b5f70bb9b
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/submodule/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Git submodule support.
+ */
+package org.eclipse.jgit.submodule;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/transport/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/transport/package-info.java
new file mode 100644
index 000000000..e885384cc
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/transport/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Transport (fetch/push) for different protocols.
+ */
+package org.eclipse.jgit.transport;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/transport/resolver/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/transport/resolver/package-info.java
new file mode 100644
index 000000000..63be596d9
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/transport/resolver/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Server-side resolver for locating repositories by URLs.
+ */
+package org.eclipse.jgit.transport.resolver;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/treewalk/filter/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/treewalk/filter/package-info.java
new file mode 100644
index 000000000..9044c511d
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/treewalk/filter/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Filters for use in tree walking.
+ */
+package org.eclipse.jgit.treewalk.filter;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/treewalk/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/treewalk/package-info.java
new file mode 100644
index 000000000..9e25f92aa
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/treewalk/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Walking and comparing directory/file trees (of commits, file system).
+ */
+package org.eclipse.jgit.treewalk;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/util/io/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/util/io/package-info.java
new file mode 100644
index 000000000..70a4d816c
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/util/io/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Utility classes for IO (streams).
+ */
+package org.eclipse.jgit.util.io;
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/util/package-info.java b/org.eclipse.jgit/src/org/eclipse/jgit/util/package-info.java
new file mode 100644
index 000000000..88e827198
--- /dev/null
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/util/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Utility classes.
+ */
+package org.eclipse.jgit.util;