Tweak some documentation

* .dir-locals.el (markdown-mode, org-mode): Codify existing
fill-column convention.
* CONTRIBUTING.org:
* README.md:
* doc/ivy.org: Prefer setopt, keymap-set, and keymap-global-set over
their older counterparts in examples.  End sentences with double
spaces.  Tweak occasional wording, capitalization, and markup.
* doc/ivy.texi: Regenerate manual.
* ivy.el (ivy-insert-current-full): Fix docstring.

Author: basil-conto

.dir-locals.el

@@ -8,4 +8,8 @@
   (indent-tabs-mode . nil)
   ;; extra config here: https://github.com/abo-abo/oremacs/blob/github/modes/ora-elisp-style-guide.el
   ;; (lisp-indent-function . common-lisp-indent-function)
-  ))
+  )
+ (markdown-mode
+  (fill-column . 70))
+ (org-mode
+  (fill-column . 70)))

CONTRIBUTING.org

@@ -54,12 +54,12 @@ Before submitting a change, run:
 - =make check-declare= - check accuracy of function declarations
 - =make checkdoc= - check documentation guidelines
 
-Use your own judgment for the commit messages, I recommend a verbose
+Use your own judgment for the commit messages.  I recommend a verbose
 style using =magit-commit-add-log=.
 
 * Copyright Assignment
 These packages are subject to the same [[https://www.gnu.org/prep/maintain/html_node/Copyright-Papers.html][Copyright Assignment]] policy as
-Emacs itself, org-mode, CEDET and other packages in [[https://elpa.gnu.org/packages/][GNU ELPA]].
+Emacs itself, Org Mode, CEDET and other packages in [[https://elpa.gnu.org/packages/][GNU ELPA]].
 
 Any [[https://www.gnu.org/prep/maintain/html_node/Legally-Significant.html#Legally-Significant][legally significant]] contributions can only be accepted after the
 author has completed their paperwork.  Please see [[https://git.savannah.gnu.org/cgit/gnulib.git/tree/doc/Copyright/request-assign.future][the request form]] if
@@ -70,6 +70,6 @@ copyright for your submitted changes to Emacs belongs to the FSF.
 This assignment works for all projects related to Emacs.  To obtain it
 you need to:
 - send one email
-- then send one letter (if you live in the US, it's digital)
+- then send one letter (in certain countries, it's digital)
 - wait for some time (in my case, I had to wait for one month; but
   recently it's less than a week)

README.md

@@ -18,12 +18,12 @@ commands.
 [![MELPA](https://melpa.org/packages/ivy-badge.svg)](https://melpa.org/#/ivy)
 [![MELPA Stable](https://stable.melpa.org/packages/ivy-badge.svg)](https://stable.melpa.org/#/ivy)
 
-Ivy is a generic completion mechanism for Emacs. While it operates
+Ivy is a generic completion mechanism for Emacs.  While it operates
 similarly to other completion schemes such as `icomplete-mode`, Ivy
 aims to be more efficient, smaller, simpler, and smoother to use yet
 highly customizable.
 
-To try Ivy, just call <kbd>M-x</kbd> `ivy-mode`. This will enable
+To try Ivy, just call <kbd>M-x</kbd> `ivy-mode`.  This will enable
 generic Ivy completion, including specific completion for file and
 buffer names.
 
@@ -33,46 +33,48 @@ Install the `ivy` package from GNU ELPA or MELPA.
 
 Users of Debian ≥10 (and derivatives such as Ubuntu ≥18.04) can
 install Ivy, Counsel, and Swiper with `sudo apt install elpa-counsel`.
-To add Hydra support `sudo apt install elpa-ivy-hydra`.
+To add Hydra support: `sudo apt install elpa-ivy-hydra`.
 
 ## Documentation
 
 ### Manual
-The manual is available as [HTML](https://oremacs.com/swiper/).
 
 Installing `ivy` from GNU ELPA or MELPA also installs the manual under
 the `(ivy)` Info node.
 
 The source file for the Info page is [here](doc/ivy.org).
 
+The manual is also available as [HTML](https://oremacs.com/swiper/).
+
 ### Wiki
-Ivy and Swiper wiki is here: [the wiki](https://github.com/abo-abo/swiper/wiki).
+
+Ivy and Swiper wiki [is here](https://github.com/abo-abo/swiper/wiki).
 
 ### Small config example
 
 ```elisp
 (ivy-mode)
-(setq ivy-use-virtual-buffers t)
-(setq enable-recursive-minibuffers t)
-;; enable this if you want `swiper' to use it
-;; (setq search-default-mode #'char-fold-to-regexp)
-(global-set-key "\C-s" 'swiper)
-(global-set-key (kbd "C-c C-r") 'ivy-resume)
-(global-set-key (kbd "<f6>") 'ivy-resume)
-(global-set-key (kbd "M-x") 'counsel-M-x)
-(global-set-key (kbd "C-x C-f") 'counsel-find-file)
-(global-set-key (kbd "<f1> f") 'counsel-describe-function)
-(global-set-key (kbd "<f1> v") 'counsel-describe-variable)
-(global-set-key (kbd "<f1> o") 'counsel-describe-symbol)
-(global-set-key (kbd "<f1> l") 'counsel-find-library)
-(global-set-key (kbd "<f2> i") 'counsel-info-lookup-symbol)
-(global-set-key (kbd "<f2> u") 'counsel-unicode-char)
-(global-set-key (kbd "C-c g") 'counsel-git)
-(global-set-key (kbd "C-c j") 'counsel-git-grep)
-(global-set-key (kbd "C-c k") 'counsel-ag)
-(global-set-key (kbd "C-x l") 'counsel-locate)
-(global-set-key (kbd "C-S-o") 'counsel-rhythmbox)
-(define-key minibuffer-local-map (kbd "C-r") 'counsel-minibuffer-history)
+(setopt ivy-use-virtual-buffers t)
+(setopt enable-recursive-minibuffers t)
+;; Enable this if you want `swiper' to use it:
+;; (setopt search-default-mode #'char-fold-to-regexp)
+(keymap-global-set "C-s" #'swiper-isearch)
+(keymap-global-set "C-c C-r" #'ivy-resume)
+(keymap-global-set "<f6>" #'ivy-resume)
+(keymap-global-set "M-x" #'counsel-M-x)
+(keymap-global-set "C-x C-f" #'counsel-find-file)
+(keymap-global-set "<f1> f" #'counsel-describe-function)
+(keymap-global-set "<f1> v" #'counsel-describe-variable)
+(keymap-global-set "<f1> o" #'counsel-describe-symbol)
+(keymap-global-set "<f1> l" #'counsel-find-library)
+(keymap-global-set "<f2> i" #'counsel-info-lookup-symbol)
+(keymap-global-set "<f2> u" #'counsel-unicode-char)
+(keymap-global-set "C-c g" #'counsel-git)
+(keymap-global-set "C-c j" #'counsel-git-grep)
+(keymap-global-set "C-c k" #'counsel-ag)
+(keymap-global-set "C-x l" #'counsel-locate)
+(keymap-global-set "C-S-o" #'counsel-rhythmbox)
+(keymap-set minibuffer-local-map "C-r" #'counsel-minibuffer-history)
 ```
 
 Note: parts of this config can be replaced by using `counsel-mode`.
@@ -84,23 +86,24 @@ Note: parts of this config can be replaced by using `counsel-mode`.
 [![MELPA](https://melpa.org/packages/counsel-badge.svg)](https://melpa.org/#/counsel)
 [![MELPA Stable](https://stable.melpa.org/packages/counsel-badge.svg)](https://stable.melpa.org/#/counsel)
 
-`ivy-mode` ensures that any Emacs command using
-`completing-read-function` uses ivy for completion.
+`ivy-mode` ensures that any Emacs command invoking `completing-read`
+or `completion-in-region` will use Ivy for completion.
 
 Counsel takes this further, providing versions of common Emacs
-commands that are customised to make the best use of Ivy. For example,
-`counsel-find-file` has some additional keybindings. Pressing
-<kbd>DEL</kbd> will move you to the parent directory.
+commands that are customized to make the best use of Ivy.  For
+example, `counsel-find-file` has some additional keybindings.
+Pressing <kbd>DEL</kbd> will move you to the parent directory.
 
 Enabling `counsel-mode` remaps built-in Emacs functions that have
-counsel replacements:
+Counsel replacements:
 
-| Emacs command              | Counsel equivalent           |
+| Emacs command              | Counsel counterpart          |
 |----------------------------|------------------------------|
 | `execute-extended-command` | `counsel-M-x`                |
 | `describe-bindings`        | `counsel-descbinds`          |
 | `describe-function`        | `counsel-describe-function`  |
 | `describe-variable`        | `counsel-describe-variable`  |
+| `describe-symbol`          | `counsel-describe-symbol`    |
 | `apropos-command`          | `counsel-apropos`            |
 | `describe-face`            | `counsel-describe-face`      |
 | `list-faces-display`       | `counsel-faces`              |
@@ -121,28 +124,33 @@ counsel replacements:
 [![MELPA](https://melpa.org/packages/swiper-badge.svg)](https://melpa.org/#/swiper)
 [![MELPA Stable](https://stable.melpa.org/packages/swiper-badge.svg)](https://stable.melpa.org/#/swiper)
 
-Swiper is an alternative to isearch that uses Ivy to show an overview
+Swiper is an alternative to Isearch that uses Ivy to show an overview
 of all matches.
 
 ![swiper.png](https://oremacs.com/download/swiper.png)
 
 A Helm version of Swiper is also available:
-[swiper-helm](https://github.com/abo-abo/swiper-helm).
+[`swiper-helm`](https://github.com/abo-abo/swiper-helm).
 
 ## Screenshots
 
 ![ivy-swiper-1.png](https://oremacs.com/download/ivy-swiper-1.png)
 
-There's also a ten minute [video demo](https://www.youtube.com/watch?v=VvnJQpTFVDc).
+There's also a ten minute [video demo](https://youtu.be/VvnJQpTFVDc).
 
 # Frequently asked questions
 
-Q: How do I enter an input that matches one of the candidates instead
-   of this candidate? Example: create a file `bar` when a file
-   `barricade` exists in the current directory.
+- Q: How do I enter an input that matches one of the candidates
+  instead of this candidate?  Example: create a file `bar` when a file
+  `barricade` exists in the current directory.
 
-A: Press <kbd>C-M-j</kbd>. Alternatively, you can make the prompt line selectable with `(setq ivy-use-selectable-prompt t)`.
+- A: Press <kbd>C-M-j</kbd>.  Alternatively, you can make the prompt
+  line selectable with:
+  ```elisp
+  (setopt ivy-use-selectable-prompt t)
+  ```
 
 # Contributing
 
-Please see the [guidelines](CONTRIBUTING.org) for reporting issues and opening pull requests.
+Please see the [guidelines](CONTRIBUTING.org) for reporting issues and
+opening pull requests.