diff --git a/org.eclipse.jgit.lfs.server/src/org/eclipse/jgit/lfs/server/LfsProtocolServlet.java b/org.eclipse.jgit.lfs.server/src/org/eclipse/jgit/lfs/server/LfsProtocolServlet.java
index e9fb5051d..eb49ff093 100644
--- a/org.eclipse.jgit.lfs.server/src/org/eclipse/jgit/lfs/server/LfsProtocolServlet.java
+++ b/org.eclipse.jgit.lfs.server/src/org/eclipse/jgit/lfs/server/LfsProtocolServlet.java
@@ -108,6 +108,29 @@ public abstract class LfsProtocolServlet extends HttpServlet {
*
* @return the large file repository storing large files.
* @throws LfsException
+ * implementations should throw more specific exceptions to
+ * signal which type of error occurred:
+ *
+ * - {@link LfsValidationError}
+ * - when there is a validation error with one or more of the
+ * objects in the request
+ * - {@link LfsRepositoryNotFound}
+ * - when the repository does not exist for the user
+ * - {@link LfsRepositoryReadOnly}
+ * - when the user has read, but not write access. Only
+ * applicable when the operation in the request is "upload"
+ * - {@link LfsRateLimitExceeded}
+ * - when the user has hit a rate limit with the server
+ * - {@link LfsBandwidthLimitExceeded}
+ * - when the bandwidth limit for the user or repository has
+ * been exceeded
+ * - {@link LfsInsufficientStorage}
+ * - when there is insufficient storage on the server
+ * - {@link LfsUnavailable}
+ * - when LFS is not available
+ * - {@link LfsException}
+ * - when an unexpected internal server error occurred
+ *
* @since 4.5
*/
protected abstract LargeFileRepository getLargeFileRepository(