1 files changed, 15 insertions, 1 deletions

diff --git a/sway/sway.5.txt b/sway/sway.5.txt
index 3cccdfd5..d76951b5 100644
--- a/sway/sway.5.txt
+++ b/sway/sway.5.txt
@@ -316,7 +316,7 @@ The default colors are:
         If smart_gaps are _on_ then gaps will only be enabled if a workspace has more
         than one child container.
 
-**mark** <--add|--replace> <--toggle> <identifier>::
+**mark** \<--add|--replace> \<--toggle> <identifier>::
         Marks are arbitrary labels that can be used to identify certain windows and
         then jump to them at a later time. By default, the **mark** command sets
         _identifier_ as the only mark on a window. By specifying _--add_, mark will
@@ -426,6 +426,20 @@ The string contains one or more (space separated) attribute/value pairs and they
 are used by some commands filter which views to execute actions on. All attributes
 must match for the criteria string to match.
 
+Criteria may be used with either the **for_window** or **assign** commands to
+specify operations to perform on new views. A criteria may also be used to
+perform specific commands (ones that normally act upon one window) on all views
+that match that criteria. For example:
+
+Focus on a window with the mark "IRC":
+        [con_mark="IRC"] focus
+
+Kill all windows with the title "Emacs":
+        [class="Emacs"] kill
+
+Mark all Firefox windows with "Browser":
+        [class="Firefox"] mark Browser
+
 Currently supported attributes:
 
 **class**::