Merge branch 'stable-1.4'

Author: james-d-mitchell

CITATION.cff

@@ -41,5 +41,5 @@ abstract: >-
   A Python package that wraps the functionality of the C++
   library libsemigroups.
 license: GPL-3.0+
-version: 1.4.0
-date-released: "2026-02-25"
+version: 1.4.1
+date-released: "2026-03-17"

README.md

@@ -150,10 +150,10 @@ uv pip install .
 To build `libsemigroups_pybind11` from a release archive:
 
 ```console
-curl -L -O https://github.com/libsemigroups/libsemigroups_pybind11/releases/latest/download/libsemigroups_pybind11-1.4.0.tar.gz
-tar -xf libsemigroups_pybind11-1.4.0.tar.gz
-rm -f libsemigroups_pybind11-1.4.0.tar.gz
-cd libsemigroups_pybind11-1.4.0
+curl -L -O https://github.com/libsemigroups/libsemigroups_pybind11/releases/latest/download/libsemigroups_pybind11-1.4.1.tar.gz
+tar -xf libsemigroups_pybind11-1.4.1.tar.gz
+rm -f libsemigroups_pybind11-1.4.1.tar.gz
+cd libsemigroups_pybind11-1.4.1
 pip install .
 ```
 

build_tools/__init__.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2021-2024 J. D. Mitchell
+# Copyright (c) 2021-2026 J. D. Mitchell
 #
 # Distributed under the terms of the GPL license version 3.
 #
@@ -11,4 +11,4 @@ def minimum_libsemigroups_version():
     """Returns the minimum required version of libsemigroups required to build
     libsemigroups_pybind11.
     """
-    return "3.5.1"
+    return "3.5.3"

docs/source/changelog-v1.rst

@@ -8,6 +8,13 @@
 Changelog - version 1
 =====================
 
+v1.4.1 (released 17/03/2026)
+----------------------------
+
+This a minor release which includes the latest version of libsemigroups_
+(v3.5.3), which contains a number of important bugfixes. There are also some
+improvements to the documentation. 
+
 v1.4.0 (released 25/02/2026)
 ----------------------------
 

docs/source/install.rst

@@ -101,10 +101,10 @@ To build ``libsemigroups_pybind11`` from a release archive:
 
 ::
 
-    $ curl -L -O https://github.com/libsemigroups/libsemigroups_pybind11/releases/latest/download/libsemigroups_pybind11-1.4.0.tar.gz
-    $ tar -xf libsemigroups_pybind11-1.4.0.tar.gz
-    $ rm -f libsemigroups_pybind11-1.4.0.tar.gz
-    $ cd libsemigroups_pybind11-1.4.0
+    $ curl -L -O https://github.com/libsemigroups/libsemigroups_pybind11/releases/latest/download/libsemigroups_pybind11-1.4.1.tar.gz
+    $ tar -xf libsemigroups_pybind11-1.4.1.tar.gz
+    $ rm -f libsemigroups_pybind11-1.4.1.tar.gz
+    $ cd libsemigroups_pybind11-1.4.1
     $ pip install .
 
 Building the documentation

release.toml

@@ -1,4 +1,4 @@
 [authors]
 expired_emails = []
 author_files = ["docs/source/authors.rst"]
-ignore = ["dependabot"]
+ignore = ["dependabot", "Codex"]

src/forest.cpp

@@ -143,7 +143,7 @@ Check if there are any nodes in the forest. This function returns
 Reinitialize an existing :any:`Forest` object.
 
 This function reinitializes an existing :any:`Forest` object so that it is in
-the same state as if it had just be constructed as ``Forest(n)``.
+the same state as if it had just been constructed as ``Forest(n)``.
 
 :param n: the number of nodes, defaults to ``0``.
 :type n: int
@@ -218,8 +218,7 @@ then node *i* is a root node.
       thing.def("number_of_nodes",
                 &Forest::number_of_nodes,
                 R"pbdoc(
-Returns the number of nodes in the forest. Returns the number of nodes
-in the forest.
+Returns the number of nodes in the forest.
 
 :returns:
    The number of nodes in the forest.
@@ -559,7 +558,7 @@ This function returns the number of paths in the range.
                 R"pbdoc(
 Returns the underlying Forest object.
 
-This function returns the :any:`Forest` object used to constructor or
+This function returns the :any:`Forest` object used to construct or
 initialise *self*.
 
 :returns: A :any:`Forest` object.
@@ -744,18 +743,18 @@ does nothing.
 Range object for iterating through paths in a :any:`Forest`.
 
 This class represents a range object that facilitates
-iterating through the paths from every node to the root of its subtree in a
+iterating through the paths from the root of each subtree to every node in a
 :any:`Forest` object. These nodes are taken in numerical order, so the first value
 returned by :any:`get` is the word to a root from node ``0``, after :any:`next`
 is called, :any:`get` returns the word to a root from node ``1``, and so on.
 The point of this class is to permit more efficient iteration over many paths
 in a :any:`Forest` object than :any:`path_from_root` (and its
 associated helper functions). :any:`path_from_root` traverses
-the :any:`Forest` from the given node to the root of its tree. If the path from
-nodes ``m`` and ``n`` to the root of their tree share a long common suffix, then
-this suffix will be traversed twice in two calls to :any:`path_from_root`.
+the :any:`Forest` from the root of a tree to a given node. If the paths to
+nodes ``m`` and ``n`` share a long common prefix, then this prefix will be
+traversed twice in two calls to :any:`path_from_root`.
 :any:`PathsFromRoots` avoids this by finding the least common ancestor of ``m`` and
-``n``, so that the suffix is not re-traversed. This works best when the nodes in
+``n``, so that the prefix is not re-traversed. This works best when the nodes in
 the :any:`Forest` are specified in a sensible order (such as via a depth-first or
 breadth-first traversal).)pbdoc");