From 01e93c108c6dd1d36b4af75e36f45d87416a312e Mon Sep 17 00:00:00 2001
From: Cheng Zhao <zcbenz@gmail.com>
Date: Mon, 2 Jun 2014 23:18:14 +0800
Subject: [PATCH] :memo: Mention platform limitations on Linux.

---
 docs/api/tray.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/api/tray.md b/docs/api/tray.md
index 02350a68c90..f35fc4bdcf6 100644
--- a/docs/api/tray.md
+++ b/docs/api/tray.md
@@ -21,6 +21,13 @@ appIcon.setContextMenu(contextMenu);
 __Platform limitations:__
 
 * On OS X `clicked` event will be ignored if the tray icon has context menu.
+* On Linux app indicator will be used if it is supported, otherwise
+  `GtkStatusIcon` will be used instead.
+* App indicator will only be showed when it has context menu.
+* When app indicator is used on Linux, `clicked` event is ignored.
+
+So if you want to keep exact same behaviors on all platforms, you should not
+rely on `clicked` event and always attach a context menu to the tray icon.
 
 ## Class: Tray