lib: add RFC-145 nixdoc comments to extended library functions

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I41c4b2cb70512699a044578fa88eb8266a6a6964

lib/lists.nix

@@ -1,33 +1,34 @@
 {lib}: let
   inherit (lib.lists) elem all;
 in {
-  /*
-  Checks if all values are present in the list.
+  /**
+    Checks if all values are present in the list.
 
-  Type:
+    # Type
+
+    ```
     listContainsValues :: { list :: [a], values :: [a] } -> Bool
+    ```
 
-  Arguments:
-    list - A list of elements.
-    values - A list of values to check for presence in the list.
+    # Arguments
 
-  Returns:
-    True if all values are present in the list, otherwise False.
+    - `list`: A list of elements.
+    - `values`: A list of values to check for presence in the list.
+
+    # Example
 
-  Example:
     ```nix
     listContainsValues { list = [1 2 3]; values = [2 3]; }
-    => True
+    => true
 
     listContainsValues { list = [1 2 3]; values = [2 4]; }
-    => False
+    => false
     ```
   */
   listContainsValues = {
     list,
     values,
   }: let
-    # Check if all values are present in the list
     containsValue = value: elem value list;
   in
     all containsValue values;