+++
*** New user option 'Man-support-remote-systems'.
-This option controls whether the man page is taken from the remote
-system when the current buffer is remote. You can invoke the 'man'
-command with a prefix argument to reverse the value of this option
-only for the current invocation.
+This option controls whether the man page is formatted on the remote
+system when the current buffer's default-directory is remote. You can
+invoke the 'man' command with a prefix argument to countermand the
+value of this option for the current invocation of 'man'.
** DocView
"/bin/sh"))
(defun Man-header-file-path ()
- "Return the C header file search path that Man uses.
+ "Return the C header file search path that Man should use.
Normally, this is the value of the user option `Man-header-file-path',
-but when the man page is retrieved from a remote system this
-function tries to find the C header path on that system."
+but when the man page is formatted on a remote system (see
+`Man-support-remote-systems'), this function tries to figure out the
+list of directories where the remote system has the C header files."
(let ((remote-id (file-remote-p default-directory)))
(if (null remote-id)
;; The local case.
If `default-directory' is remote, and `Man-support-remote-systems'
is non-nil, this command formats the man page on the remote system.
A prefix argument reverses the value of `Man-support-remote-systems'
-for the current call."
+for the current invocation."
(interactive
(list (let* ((default-entry (Man-default-man-entry))