Improve the documentation of 'vc-tor'

* lisp/vc/vc-dispatcher.el (vc-tor): Add :version.  Enhance
the doc string.

* etc/NEWS: Announce the new option.

diff --git a/etc/NEWS b/etc/NEWS
index 56127ba60189cb9fe905c57088ad202315b3cd84..137d476c926ab7cc4525f3e2d2f65235e02c7acd 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -823,6 +823,12 @@ The default value is 'find-dired-sort-by-filename'.
 
 ** Change Logs and VC
 
+---
+*** New user option 'vc-tor'.
+When non-nil, this option causes the VC commands to communicate with
+the repository via Tor's proxy, using the 'torsocks' wrapper script.
+The default is nil.
+
 +++
 *** New command 'log-edit-generate-changelog-from-diff', bound to 'C-c C-w'.
 This generates ChangeLog entries from the VC fileset diff.

diff --git a/lisp/vc/vc-dispatcher.el b/lisp/vc/vc-dispatcher.el
index bf238dedbb8838f991569ed12ae18ddfae00cf0b..40055091ef724780c49d4c6bab6321340d30e84c 100644 (file)
--- a/lisp/vc/vc-dispatcher.el
+++ b/lisp/vc/vc-dispatcher.el
@@ -268,8 +268,11 @@ and is passed 3 arguments: the COMMAND, the FILES and the FLAGS.")
   (if (not filelist) "."  (mapconcat 'identity filelist " ")))
 
 (defcustom vc-tor nil
-  "If non-nil, communicate with the repository site via Tor."
+  "If non-nil, communicate with the repository site via Tor.
+See https://2019.www.torproject.org/about/overview.html.en and
+the man pages for \"torsocks\" for more details about Tor."
   :type 'boolean
+  :version "27.1"
   :group 'vc)
 
 ;;;###autoload