documentation/notifications.md

   1 <!--
   2 This is part of the VimFx documentation.
   3 Copyright Simon Lydell 2015, 2016.
   4 See the file README.md for copying conditions.
   5 -->
   6
   7 # Notifications
   8
   9 Some commands may show notifications, such as the `n` and `N` commands which
  10 tell when they wrap around the page, or the phrase you searched for could not be
  11 found. Actually, any command that sometimes cannot do anything (such as the `f`
  12 command if there are no clickable elements in sight) instead show a notification
  13 in those cases, so that _something_ happens instead of leaving you unsure if you
  14 pressed the correct keys or not.
  15
  16 Notifications also show you which keys you’ve typed so far of a multi-key
  17 shortcut or to filter hint markers by element text in Hints mode.
  18
  19 VimFx’s notifications are similar to the “URL popup,” shown when hovering or
  20 focusing links, but is placed on the opposite side.
  21
  22 Notifications are shown until you click something, press a key or switch tab.
  23
  24 (See also the [`notifications_enabled`] and [`notify_entered_keys`] options.)
  25
  26 [`notifications_enabled`]: options.md#notifications_enabled
  27 [`notify_entered_keys`]: options.md#notify_entered_keys