fix the Focus key command

2 files changed, 17 insertions, 6 deletions

diff --git a/doc/asciidoc/fluxbox-keys.txt b/doc/asciidoc/fluxbox-keys.txt
index 70f3b66..e52ffa8 100644
--- a/doc/asciidoc/fluxbox-keys.txt
+++ b/doc/asciidoc/fluxbox-keys.txt
@@ -163,10 +163,13 @@ BottomRight*
 
 Window Commands
 ~~~~~~~~~~~~~~~
-These commands affect only the currently focused window.
+These commands ordinarily affect only the currently focused window. The
+*OnWindow* modifier and *ForEach* command may affect the window that is used.
 
-*Activate* | *Focus*::
-        Set the focus to the window matching the argument, and raise it.
+*Activate* ['pattern'] | *Focus* ['pattern']::
+        Set the focus to the window matching the argument. If 'pattern' is
+        omitted, this may be used with the *OnWindow* modifier to set the
+        focus. See *CLIENT PATTERNS* for more about the 'pattern' arguments.
 
 *Minimize* | *MinimizeWindow* | *Iconify*::
         Minimize the current window, equivalent to the window button.
diff --git a/doc/fluxbox-keys.5 b/doc/fluxbox-keys.5
index aa0523a..75af5ab 100644
--- a/doc/fluxbox-keys.5
+++ b/doc/fluxbox-keys.5
@@ -165,11 +165,19 @@ By default \fIcorner\fR is \fBBottomRight\fR, but may be overridden with one of:
 Start dragging to add this window to another\'s tabgroup\.
 .RE
 .SS "Window Commands"
-These commands affect only the currently focused window\.
+These commands ordinarily affect only the currently focused window\. The \fBOnWindow\fR modifier and \fBForEach\fR command may affect the window that is used\.
 .PP
-\fBActivate\fR | \fBFocus\fR
+\fBActivate\fR [\fIpattern\fR] | \fBFocus\fR [\fIpattern\fR]
 .RS 4
-Set the focus to the window matching the argument, and raise it\.
+Set the focus to the window matching the argument\. If
+\fIpattern\fR
+is omitted, this may be used with the
+\fBOnWindow\fR
+modifier to set the focus\. See
+\fBCLIENT PATTERNS\fR
+for more about the
+\fIpattern\fR
+arguments\.
 .RE
 .PP
 \fBMinimize\fR | \fBMinimizeWindow\fR | \fBIconify\fR