Document how to switch to files/buffers vertically

* helm-grep.el (helm-grep-actions):                 Do it.
* helm-help.el (helm-ff-help-message):              Do it.
* helm-regexp.el (helm-source-multi-occur-actions): Do it.

3 files changed, 14 insertions, 4 deletions

diff --git a/helm-grep.el b/helm-grep.el
index de0ec2b0..2e7f8f48 100644
--- a/helm-grep.el
+++ b/helm-grep.el
@@ -205,7 +205,7 @@ Possible value are:
    "Find File" 'helm-grep-action
    "Find file other frame" 'helm-grep-other-frame
    "Save results in grep buffer" 'helm-grep-save-results
-   "Find file other window" 'helm-grep-other-window)
+   "Find file other window (C-u vertically)" 'helm-grep-other-window)
   "Actions for helm grep."
   :group 'helm-grep
   :type '(alist :key-type string :value-type function))
diff --git a/helm-help.el b/helm-help.el
index 87c2f11c..fddcd954 100644
--- a/helm-help.el
+++ b/helm-help.el
@@ -641,8 +641,8 @@ argument will execute action synchronously. Moreover it will follow the first
 file of the marked files in its destination directory.
 
 When `dired-async-mode' is enabled, an additional action named \"Backup files\"
-will be available. (Such command is not natively available in Emacs.)  See
-[[Using wildcard to select multiple files]] for details.
+will be available. (Such command is not natively available in Emacs).
+See [[Using wildcard to select multiple files]] for details.
 
 *** Bookmark the `helm-find-files' session.
 
@@ -777,6 +777,16 @@ prompted to attach files to one of these mail buffers.
 - If you are not in a mail buffer and no mail buffer exists,
 a new mail buffer is created with the attached files in it.
 
+*** Open files in separate windows.
+
+When [[Marked candidates][marking]] multiple files or using [[Use the wildcard to select multiple files.][wildcard]], helm allow opening all
+this files in separate windows using an horizontal layout or a
+vertical layout if you used a prefix arg, when no more windows can be
+displayed in frame, next files are opened in background without being
+displayed.  When using \\<helm-find-files-map>\\[helm-ff-run-switch-other-window] the current
+buffer is kept and files are displayed next to it.
+
+
 ** Commands
 \\<helm-find-files-map>
 \\[helm-ff-run-locate]\t\tRun `locate' (`\\[universal-argument]' to specify locate database, `M-n' to insert basename of candidate).
diff --git a/helm-regexp.el b/helm-regexp.el
index ced2a8a5..9b152e68 100644
--- a/helm-regexp.el
+++ b/helm-regexp.el
@@ -54,7 +54,7 @@ Any other non--nil value update after confirmation."
 
 (defcustom helm-source-multi-occur-actions
   '(("Go to Line" . helm-moccur-goto-line)
-    ("Goto line other window" . helm-moccur-goto-line-ow)
+    ("Goto line other window (C-u vertically)" . helm-moccur-goto-line-ow)
     ("Goto line new frame" . helm-moccur-goto-line-of))
   "Actions for helm-occur and helm-moccur."
   :group 'helm-regexp