From 5fab2497390607f424d5fb12a1fc0a6630de56f5 Mon Sep 17 00:00:00 2001
From: Larry Booker <lbooker42@gmail.com>
Date: Fri, 21 Jun 2024 17:31:00 -0700
Subject: [PATCH] Documentation improvements.

---
 py/server/deephaven/experimental/iceberg.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/py/server/deephaven/experimental/iceberg.py b/py/server/deephaven/experimental/iceberg.py
index a369318b141..7506bc95a25 100644
--- a/py/server/deephaven/experimental/iceberg.py
+++ b/py/server/deephaven/experimental/iceberg.py
@@ -92,7 +92,8 @@ def __init__(self, j_object: _JIcebergCatalogAdapter):
 
     def namespaces(self, namespace: Optional[str] = None) -> Table:
         """
-        Returns the namespaces in the catalog as a Deephaven table.
+        Returns information on the namespaces in the catalog as a Deephaven table. If a namespace is specified, the
+        tables in that namespace are listed; otherwise the top-level namespaces are listed.
 
         Args:
             namespace (Optional[str]): the higher-level namespace from which to list namespaces; if omitted, the
@@ -108,7 +109,7 @@ def namespaces(self, namespace: Optional[str] = None) -> Table:
 
     def tables(self, namespace: str) -> Table:
         """
-        Returns the list of tables in the provided namespace as a Deephaven table.
+        Returns information on the tables in the specified namespace as a Deephaven table.
 
         Args:
             namespace (str): the namespace from which to list tables.
@@ -123,7 +124,7 @@ def tables(self, namespace: str) -> Table:
 
     def snapshots(self, table_identifier: str) -> Table:
         """
-        Returns the list of snapshots of the provided table as a Deephaven table.
+        Returns information on the snapshots of the specified table as a Deephaven table.
 
         Args:
             table_identifier (str): the table from which to list snapshots.