Updated comments.

Author: kmvanbrunt

cmd2/argparse_custom.py

@@ -398,7 +398,7 @@ def __init__(self, value: object, descriptive_data: Sequence[Any], *args: Any) -
         # Make sure all objects are renderable by a Rich table.
         renderable_data = [obj if is_renderable(obj) else str(obj) for obj in descriptive_data]
 
-        # Convert objects with ANSI escape sequences to Rich Text for correct display width.
+        # Convert strings containing ANSI style sequences into Rich Text objects for correct display width.
         self.descriptive_data = ru.prepare_objects_for_rendering(*renderable_data)
 
         # Save the original value to support CompletionItems as argparse choices.

cmd2/cmd2.py

@@ -1191,12 +1191,12 @@ def _completion_supported(self) -> bool:
 
     @property
     def visible_prompt(self) -> str:
-        """Read-only property to get the visible prompt with any ANSI style escape codes stripped.
+        """Read-only property to get the visible prompt with any ANSI style sequences stripped.
 
-        Used by transcript testing to make it easier and more reliable when users are doing things like coloring the
-        prompt using ANSI color codes.
+        Used by transcript testing to make it easier and more reliable when users are doing things like
+        coloring the prompt.
 
-        :return: prompt stripped of any ANSI escape codes
+        :return: the stripped prompt.
         """
         return su.strip_style(self.prompt)
 
@@ -4214,7 +4214,7 @@ def _print_documented_command_topics(self, header: str, cmds: list[str], verbose
     def render_columns(self, str_list: list[str] | None, display_width: int = 80) -> str:
         """Render a list of single-line strings as a compact set of columns.
 
-        This method correctly handles strings containing ANSI escape codes and
+        This method correctly handles strings containing ANSI style sequences and
         full-width characters (like those used in CJK languages). Each column is
         only as wide as necessary and columns are separated by two spaces.