[elpa] master afa592d 18/78: Rewrite the tng documentation a bit

[Dmitry Gutov]

branch: master
commit afa592dea8b35dfd127137c15ccc4a4be044486a
Author: Dmitry Gutov <address@hidden>
Commit: Dmitry Gutov <address@hidden>

    Rewrite the tng documentation a bit
    
    #706
---
 NEWS.md        | 10 +++++-----
 company-tng.el | 34 ++++++++++++++++++----------------
 2 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/NEWS.md b/NEWS.md
index ea93112..9b271e1 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -2,11 +2,11 @@
 
 ## Next
 
-* New feature `company-tng'. When added as a frontend, it allows you to insert
-  the candidates as soon they are selected, eliminating the need to press RET 
to
-  confirm your selection. See `company-tng.el` and use
-  `(company-tng-configure-default)` to give it a try.
-  ([#526](https://github.com/company-mode/company-mode/issues/526))
+* New feature `company-tng`. It contains a frontend and some helper code.
+  The frontend triggers insertion of the candidate as soon as it's selected, so
+  you don't need to press RET. Add `(company-tng-configure-default)` to your
+  init script to give it a try.
+  ([#526](https://github.com/company-mode/company-mode/issues/706))
 * New user option `company-tooltip-maximum-width`.
 
 ## 2017-07-15 (0.9.4)
diff --git a/company-tng.el b/company-tng.el
index 3996f31..3310141 100644
--- a/company-tng.el
+++ b/company-tng.el
@@ -1,5 +1,4 @@
-;;; company-tng.el --- company-mode frontend that inserts a candidate
-;;; into the buffer as soon as it's selected, Vim style
+;;; company-tng.el --- company-mode configuration for single-button interaction
 
 ;; Copyright (C) 2017  Free Software Foundation, Inc.
 
@@ -23,23 +22,24 @@
 
 ;;; Commentary:
 ;;
-;; company-tng (tab and go) allows you to use TAB to both select a
-;; completion candidate from the list and to insert it into the
-;; buffer.
+;; company-tng (Tab and Go) allows you to perform completion using just TAB.
+;; Pressing it will both select the next completion candidate in the list and
+;; insert it into the buffer (or make it look like it's inserted, in fact).
 ;;
-;; It cycles the candidates like `yank-pop' or `dabbrev-expand' or
-;; Vim: Pressing TAB selects the first item in the completion menu and
-;; inserts it in the buffer. Pressing TAB again selects the second
-;; item and replaces the inserted item with the second one. This can
-;; continue as long as the user wishes to cycle through the menu.
+;; It cycles the candidates like `yank-pop' or `dabbrev-expand' or Vim:
+;; Pressing TAB selects the first item in the completion menu and inserts it in
+;; the buffer. Pressing TAB again selects the second item and replaces the
+;; "inserted" item with the second one. This can continue as long as the user
+;; wishes to cycle through the menu. You can also press S-TAB to select the
+;; previous candidate, of course.
 ;;
-;; The benefits are that there is only one shortcut key to interact
-;; with and there is no need to confirm an entry.
+;; The benefits are that you only have to use one shortcut key and there is no
+;; need to confirm an entry.
 ;;
 ;; Usage:
 ;;
 ;; To apply the default configuration for company-tng call
-;; `company-tng-configure-default' from your configuration file.
+;; `company-tng-configure-default' from your init script.
 ;;
 ;; You can also configure company-tng manually:
 ;;
@@ -49,9 +49,11 @@
 ;; We recommend to bind TAB to `company-select-next', S-TAB to
 ;; `company-select-previous', and unbind RET and other now-unnecessary
 ;; keys from `company-active-map':
-;; (define-key company-active-map (kbd "TAB") 'company-select-next)
-;; (define-key company-active-map (kbd "<backtab>") 'company-select-previous)
-;; (define-key company-active-map (kbd "RET") nil)
+;;
+;;   (define-key company-active-map (kbd "TAB") 'company-select-next)
+;;   (define-key company-active-map (kbd "<backtab>") 'company-select-previous)
+;;   (define-key company-active-map (kbd "RET") nil)
+;;
 ;; Note that it's not necessary to rebind keys to use this frontend,
 ;; you can use the arrow keys or M-n/M-p to select and insert
 ;; candidates. You also need to decide which keys to unbind, depending