Bug 1225701 - Update comments in AccessibleCaret files. r=mtseng

DONTBUILD NPOTB

--HG--
extra : commitid : LWzB3w73OeN
extra : rebase_source : 4e359bda2a8c005eedf2ebf972182111094e809e

layout/base/AccessibleCaret.h

@@ -37,6 +37,8 @@ namespace mozilla {
 // that SetPosition() works correctly, the caller must make sure the layout is
 // up to date.
 //
+// Please see the wiki page for more information.
+// https://wiki.mozilla.org/Copy_n_Paste
 class AccessibleCaret
 {
 public:

layout/base/AccessibleCaretEventHub.h

@@ -47,14 +47,19 @@ class WidgetTouchEvent;
 // transitions by giving events, callbacks, and the return values by mocked
 // methods of AccessibleCaretEventHub. See TestAccessibleCaretEventHub.cpp.
 //
-// Besides dealing with real events, AccessibleCaretEventHub also synthesizes
-// fake events such as scroll-end or long-tap providing APZ is not in use.
+// Besides dealing with real events, AccessibleCaretEventHub could also
+// synthesize fake long-tap events and inject those events to itself on the
+// platform lacks eMouseLongTap. Turn on this preference
+// "layout.accessiblecaret.use_long_tap_injector" for the fake long-tap events.
 //
 // State transition diagram:
 // http://hg.mozilla.org/mozilla-central/raw-file/default/layout/base/doc/AccessibleCaretEventHubStates.png
 // Source code of the diagram:
 // http://hg.mozilla.org/mozilla-central/file/default/layout/base/doc/AccessibleCaretEventHubStates.dot
 //
+// Please see the wiki page for more information.
+// https://wiki.mozilla.org/Copy_n_Paste
+//
 class AccessibleCaretEventHub : public nsIReflowObserver,
                                 public nsIScrollObserver,
                                 public nsISelectionListener,

layout/base/AccessibleCaretManager.h

@@ -41,6 +41,9 @@ class Selection;
 // prior to performing its task. The caller must ensure the layout is up to
 // date.
 //
+// Please see the wiki page for more information.
+// https://wiki.mozilla.org/Copy_n_Paste
+//
 class AccessibleCaretManager
 {
 public: