From 0b8c2545b98435654a3a437efad1ff43655ad623 Mon Sep 17 00:00:00 2001
From: Daniel Pham <pham.dany@gmail.com>
Date: Tue, 8 Mar 2016 22:31:13 -0500
Subject: [PATCH] :memo: Document 'app.focus()'

[ci skip]
---
 docs/api/app.md | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/docs/api/app.md b/docs/api/app.md
index f18c978fadd..36b55244a4d 100644
--- a/docs/api/app.md
+++ b/docs/api/app.md
@@ -248,14 +248,6 @@ This method guarantees that all `beforeunload` and `unload` event handlers are
 correctly executed. It is possible that a window cancels the quitting by
 returning `false` in the `beforeunload` event handler.
 
-### `app.hide()` _OS X_
-
-Hides all application windows without minimizing them.
-
-### `app.show()` _OS X_
-
-Shows application windows after they were hidden. Does not automatically focus them.
-
 ### `app.exit(exitCode)`
 
 * `exitCode` Integer
@@ -265,6 +257,18 @@ Exits immediately with `exitCode`.
 All windows will be closed immediately without asking user and the `before-quit`
 and `will-quit` events will not be emitted.
 
+### `app.focus()`
+
+On Linux, focuses on the first visible window. On OS X, makes the application the active app. On Windows, focuses on the application's first window.
+
+### `app.hide()` _OS X_
+
+Hides all application windows without minimizing them.
+
+### `app.show()` _OS X_
+
+Shows application windows after they were hidden. Does not automatically focus them.
+
 ### `app.getAppPath()`
 
 Returns the current application directory.