userguide: Document mark --replace flag

- Explicitly document --replace, which was previously only mentioned
  in the command syntax.

- Improve wording: "a window can only have one mark" is slightly
  misleading because it appears to describe the limitation as a
  property of the model, whereas this actually pertains the mark
  command.

diff --git a/docs/userguide b/docs/userguide
index bf5a4d219164c6b8d2d9fb44feb61be5d2ba5e89..55e80ce18e41fba2626e5c55452fe916836727d7 100644 (file)
--- a/docs/userguide
+++ b/docs/userguide
@@ -2416,8 +2416,9 @@ this mark or add it otherwise. Note that you may need to use this in
 combination with +--add+ (see below) as any other marks will otherwise be
 removed.
 
-By default, a window can only have one mark. You can use the +--add+ flag to
-put more than one mark on a window.
+The +--replace+ flag causes i3 to remove any existing marks, which is also the
+default behavior. You can use the +--add+ flag to put more than one mark on a
+window.
 
 Refer to <<show_marks>> if you don't want marks to be shown in the window decoration.