Merge branch 'main' into chained-transformation

src/main/java/com/github/olivergondza/saxeed/Bookmark.java

@@ -3,12 +3,12 @@
 /**
  * A reference to a tag acquired in a previous Saxeed run, to be queried in the next run.
  *
- * The reference is valid only between to consecutive runs. Provided the document was modified between the executions,
- * Saxeed provides no guarantee it will match anything, fail predictable, or match the intended tag.
+ * The reference is valid only between two consecutive runs. Provided the document was modified between the executions,
+ * Saxeed provides no guarantee it will match anything, fail predictably, or match the intended tag.
  *
  * To bookmark an element, call {@link Tag#bookmark()}. The object returned is valid outside the Saxeed transformation.
  * In the next processing, use {@link Tag#isBookmarked(Bookmark)} or {@link Tag#isBookmarked(java.util.List)} to
- * identify the element,
+ * identify the bookmarked element.
  */
 public interface Bookmark {
 

src/main/java/com/github/olivergondza/saxeed/Tag.java

@@ -72,7 +72,7 @@ public interface Tag {
     Bookmark bookmark();
 
     /**
-     * Determine if this tag has been bookmarked the bookmark provided.
+     * Determine if this tag matches the bookmark provided.
      */
     boolean isBookmarked(Bookmark bookmark);
 

src/main/java/com/github/olivergondza/saxeed/TagName.java

@@ -14,9 +14,9 @@
  * Example:
  *
  * <pre>
- *     `&lt;a>` := uri=""; prefix=""; local="a"
- *     `&lt;a xmlns="XXX">` := uri="XXX"; prefix=""; local="a" (`xmlns` can be declared on a parent tag)
- *     `&lt;x:a xmlns:x="XXX">` := uri="XXX"; prefix="x"; local="a" (`xmlns:x` can be declared on a parent tag)
+ *     `&lt;a&gt;` := uri=""; prefix=""; local="a"
+ *     `&lt;a xmlns="XXX"&gt;` := uri="XXX"; prefix=""; local="a" (`xmlns` can be declared on a parent tag)
+ *     `&lt;x:a xmlns:x="XXX"&gt;` := uri="XXX"; prefix="x"; local="a" (`xmlns:x` can be declared on a parent tag)
  * </pre>
  */
 public class TagName {