Added version notes for new features.

Author: thom

st3/sublime_lib/encodings.py

@@ -12,6 +12,9 @@ def from_sublime(name):
 
        >>> from_sublime("Western (Windows 1252)")
        "cp1252"
+
+    .. versionchanged:: 1.3
+        Raise :exc:`ValueError` if `name` is not a Sublime encoding.
     """
 
     try:
@@ -29,6 +32,9 @@ def to_sublime(name):
 
        >>> to_sublime("cp1252")
        "Western (Windows 1252)"
+
+    .. versionchanged:: 1.3
+        Raise :exc:`ValueError` if `name` is not a Python encoding.
     """
     try:
         return STANDARD_TO_SUBLIME[lookup(name).name]

st3/sublime_lib/panel.py

@@ -17,6 +17,8 @@ class Panel():
     .. py:attribute:: panel_name
 
         The name of the panel as it is listed in :meth:`sublime.Window.panels()`.
+
+    .. versionadded:: 1.3
     """
 
     def __init__(self, window, panel_name):
@@ -71,6 +73,9 @@ class OutputPanel(ViewStream, Panel):
     wrapping an output panel in the given `window` with the given `name`.
 
     :raise ValueError: if `window` has no output panel called `name`.
+
+    .. versionchanged:: 1.3
+        Now a subclass of :class:`Panel`.
     """
     @classmethod
     def create(

st3/sublime_lib/resource_path.py

@@ -54,6 +54,8 @@ class ResourcePath():
     Leading slashes are not matched literally.
     A pattern with a leading slash must match the entire path
     and not merely a suffix of the path.
+
+    .. versionadded:: 1.2
     """
 
     @classmethod
@@ -262,6 +264,8 @@ def relative_to(self, *other):
         `other` will be converted to a :class:`ResourcePath`.
 
         :raise ValueError: if this path is not a descendant of `other`.
+
+        .. versionadded:: 1.3
         """
         other_path = ResourcePath(*other)
         other_len = len(other_path.parts)
@@ -283,6 +287,8 @@ def with_name(self, name):
     def add_suffix(self, suffix):
         """
         Return a new path with the suffix added.
+
+        .. versionadded:: 1.3
         """
         return self.with_name(self.name + suffix)
 
@@ -297,6 +303,8 @@ def remove_suffix(self, suffix=None, *, must_remove=True):
 
         :raise ValueError: if `must_remove` is ``True`` (the default)
             and no suffix can be removed.
+
+        .. versionadded:: 1.3
         """
         new_name = None
 
@@ -436,6 +444,8 @@ def copy(self, target, exist_ok=True):
         :raise FileNotFoundError: if there is no resource at this path.
         :raise IsADirectoryError: if `target` is a directory.
         :raise FileExistsError: if `target` is a file and `exist_ok` is ``False``.
+
+        .. versionadded:: 1.3
         """
         if exist_ok:
             mode = 'w'
@@ -458,6 +468,8 @@ def copytree(self, target, exist_ok=False):
         then existing files under `target` will be overwritten.
 
         :raise FileExistsError: if `target` already exists and `exist_ok` is ``False``.
+
+        .. versionadded:: 1.3
         """
         target = Path(target)
 

st3/sublime_lib/show_selection_panel.py

@@ -67,7 +67,13 @@ def show_selection_panel(
     :raise ValueError: if `flags` cannot be converted
         to :class:`sublime_lib.flags.QuickPanelOption`.
 
-    ..  versionadded:: 1.2
+    .. versionadded:: 1.2
+
+    .. versionchanged:: 1.3
+        `labels` can be a mixture of strings and string sequences of uneven length.
+
+        `flags` can be any value or values
+        convertible to :class:`~sublime_lib.flags.QuickPanelOption`.
     """
     if len(items) == 0:
         raise ValueError("The items parameter must contain at least one item.")