From 2a186edf3a7e15c6efb1b4ba265516824c34940d Mon Sep 17 00:00:00 2001
From: sksamuel <sam@sksamuel.com>
Date: Sat, 30 Dec 2023 13:54:15 -0600
Subject: [PATCH] Updated docs

---
 .../kotlin/com/sksamuel/tribune/core/collections/lists.kt     | 4 ++++
 .../main/kotlin/com/sksamuel/tribune/core/collections/sets.kt | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/lists.kt b/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/lists.kt
index 35fbb43..e002fd5 100644
--- a/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/lists.kt
+++ b/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/lists.kt
@@ -31,4 +31,8 @@ fun <I, O, E> Parser<I, O, E>.asList(): Parser<Collection<I>, List<O>, E> {
 fun <I, O, E> Parser.Companion.list(elementParser: Parser<I, O, E>): Parser<Collection<I>, List<O>, E> =
    elementParser.asList()
 
+/**
+ * Wraps a [Parser] that produces lists with nullable items, to filter any null entries in the outputted list.
+ * In other words, transforms a Parser I -> List<O?> to I -> List<O>.
+ */
 fun <I, O, E> Parser<I, List<O?>, E>.filterNulls(): Parser<I, List<O>, E> = map { it.filterNotNull() }
diff --git a/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/sets.kt b/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/sets.kt
index 0e0be8a..4a930c6 100644
--- a/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/sets.kt
+++ b/tribune-core/src/main/kotlin/com/sksamuel/tribune/core/collections/sets.kt
@@ -30,5 +30,9 @@ fun <I, O, E> Parser<I, O, E>.asSet(): Parser<Collection<I>, Set<O>, E> {
 
 fun <I, O, E> Parser<I, Set<O?>, E>.filterNulls(): Parser<I, Set<O>, E> = map { it.filterNotNull().toSet() }
 
+/**
+ * Wraps a [Parser] that produces sets with nullable items, to filter any null entries in the outputted set.
+ * In other words, transforms a Parser I -> Set<O?> to I -> Set<O>.
+ */
 fun <I, O, E> Parser.Companion.set(elementParser: Parser<I, O, E>): Parser<Collection<I>, Set<O>, E> =
    elementParser.asSet()