improve docstring related to #2267 and document the change in the changelog

2020-03-15 22:14:26 +01:00
parent beabaee345
commit c0c0efce18
2 changed files with 4 additions and 1 deletions
--- a/mongoengine/queryset/base.py
+++ b/mongoengine/queryset/base.py
@@ -1026,9 +1026,11 @@ class BaseQuerySet(object):

            posts = BlogPost.objects(...).fields(comments=0)

-        To retrieve a subrange of array elements:
+        To retrieve a subrange or sublist of array elements,
+        support exist for both the `slice` and `elemMatch` projection operator:

            posts = BlogPost.objects(...).fields(slice__comments=5)
+            posts = BlogPost.objects(...).fields(elemMatch__comments="test")

        :param kwargs: A set of keyword arguments identifying what to
            include, exclude, or slice.