feat: version bump, updated gradle and added some docs for new methods

Author: gotev

app/gradle/wrapper/gradle-wrapper.properties

@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-bin.zip

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Sun Jan 20 12:28:53 CET 2019
+#Sun Jan 20 12:40:43 CET 2019
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.5-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-bin.zip

manifest.gradle

@@ -9,15 +9,15 @@ ext {
     library_licenses = ["Apache-2.0"]
     library_licenses_url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
     library_project_group = 'net.gotev'
-    library_version = '4.0.0'
+    library_version = '4.1.0'
     version_code = 6
     min_sdk = 21
     target_sdk = 30
     demo_app_id = 'net.gotev.recycleradapterdemo'
 
     // Gradle classpath dependencies versions
     kotlin_version = '1.4.32'
-    gradle_version = '4.1.3'
+    gradle_version = '7.0.2'
 
     // Library and app testing dependencies versions
     junit_version = '4.13'

recycleradapter-extensions/src/main/java/net/gotev/recycleradapter/ext/DeclarativeExtensions.kt

@@ -43,14 +43,30 @@ fun renderableItems(action: RenderableItems.() -> Unit): RenderableItems {
 interface RecyclerAdapterProvider {
     val recyclerAdapter: RecyclerAdapter
 
+    /**
+     * Renders items in the recycler view.
+     * @param canvas renderable items to display in the list
+     */
     fun render(canvas: RenderableItems) {
         syncItemsOrEmpty(null, canvas)
     }
 
+    /**
+     * Renders items in the recycler view.
+     * @param onEmptyCanvas renderable items to be displayed if and only if [canvas]
+     * renderable items are empty. null by default.
+     * @param canvas renderable items to display in the list
+     */
     fun render(onEmptyCanvas: RenderableItems? = null, canvas: RenderableItems) {
         syncItemsOrEmpty(onEmptyCanvas, canvas)
     }
 
+    /**
+     * Renders items in the recycler view.
+     * @param onEmptyCanvas renderable items to be displayed if and only if [canvas]
+     * renderable items are empty. null by default.
+     * @param canvas renderable items to display in the list
+     */
     fun render(onEmptyCanvas: RenderableItems? = null, canvas: RenderableItems.() -> Unit) {
         syncItemsOrEmpty(onEmptyCanvas, renderableItems(canvas))
     }