=htc update outdated documentation in reference.conf

akka-http-core/src/main/resources/reference.conf

@@ -273,13 +273,16 @@ akka.http {
     max-chunk-ext-length       = 256
     max-chunk-size             = 1m
 
-    # Maximum content length which should not be exceeded by incoming HttpRequests.
-    # For file uploads which use the entityBytes Source of an incoming HttpRequest it is safe to
-    # set this to a very high value (or to `infinite` if feeling very adventurous) as the streaming
-    # upload will be back-pressured properly by Akka Streams.
-    # Please note however that this setting is a global property, and is applied to all incoming requests,
-    # not only file uploads consumed in a streaming fashion, so pick this limit wisely.
-    max-content-length         = 8m
+    # Default maximum content length which should not be exceeded by incoming request entities.
+    # Can be changed at runtime (to a higher or lower value) via the `HttpEntity::withSizeLimit` method.
+    # Note that it is not necessarily a problem to set this to a high value as all stream operations
+    # are always properly backpressured.
+    # Nevertheless you might want to apply some limit in order to prevent a single client from consuming
+    # an excessive amount of server resources.
+    #
+    # Set to `infinite` to completely disable entity length checks. (Even then you can still apply one
+    # programmatically via `withSizeLimit`.)
+    max-content-length = 8m
 
     # Sets the strictness mode for parsing request target URIs.
     # The following values are defined: