[Emacs-diffs] trunk r113081: * tramp.texi (Top, Configuration): Insert section `Predefined

[Michael Albinus]

------------------------------------------------------------
revno: 113081
revision-id: address@hidden
parent: address@hidden
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Wed 2013-06-19 15:21:15 +0200
message:
  * tramp.texi (Top, Configuration): Insert section `Predefined
  connection information' in menu.
  (Predefined connection information): New section.
  (Android shell setup): Make a reference to `Predefined connection
  information'.
modified:
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  doc/misc/tramp.texi            tramp.texi-20091113204419-o5vbwnq5f7feedwu-6324

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-06-19 07:01:22 +0000
+++ b/doc/misc/ChangeLog        2013-06-19 13:21:15 +0000
@@ -1,3 +1,11 @@
+2013-06-19  Michael Albinus  <address@hidden>
+
+       * tramp.texi (Top, Configuration): Insert section `Predefined
+       connection information' in menu.
+       (Predefined connection information): New section.
+       (Android shell setup): Make a reference to `Predefined connection
+       information'.
+
 2013-06-19  Glenn Morris  <address@hidden>
 
        * Makefile.in (version): New, set by configure.

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2013-04-16 08:11:56 +0000
+++ b/doc/misc/tramp.texi       2013-06-19 13:21:15 +0000
@@ -214,6 +214,8 @@
 * Customizing Completion::      Selecting config files for user/host name 
completion.
 * Password handling::           Reusing passwords for several connections.
 * Connection caching::          Reusing connection related information.
+* Predefined connection information::
+                                Setting own connection related information.
 * Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
 * Remote shell setup::          Remote shell setup hints.
 * Android shell setup::         Android shell setup hints.
@@ -542,6 +544,8 @@
 * Customizing Completion::      Selecting config files for user/host name 
completion.
 * Password handling::           Reusing passwords for several connections.
 * Connection caching::          Reusing connection related information.
+* Predefined connection information::
+                                Setting own connection related information.
 * Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
 * Remote shell setup::          Remote shell setup hints.
 * Android shell setup::         Android shell setup hints.
@@ -1727,6 +1731,35 @@
 connection again.
 
 
address@hidden Predefined connection information
address@hidden Setting own connection related information
+
+Sometimes, @var{tramp} is not able to detect correct connection
+related information.  In such cases, you could tell @var{tramp} which
+value it has to take.  Since this could result in errors, it has to be
+used with care.
+
address@hidden tramp-connection-properties
+Such settings can be performed via the list
address@hidden  An entry in this list has the
+form @code{(@var{regexp} @var{property} @var{value})}.  @var{regexp}
+matches remote file names for which a property shall be predefined.
+It can be @code{nil}.  @var{property} is a string, and @var{value} the
+corresponding value.  @var{property} could be any property found in
+the file @code{tramp-persistency-file-name}.
+
+A special property is @code{"busybox"}.  This must be set, if the
+remote host runs a very restricted busybox as shell, which closes the
+connection at will.  Since there is no reliable test for this,
address@hidden must be indicated this way.  Example:
+
address@hidden
+(add-to-list 'tramp-connection-properties
+             (list (regexp-quote "@trampfn{ssh, user, 
randomhost.your.domain,}")
+                   "busybox" t))
address@hidden lisp
+
+
 @node Remote Programs
 @section How @value{tramp} finds and uses programs on the remote machine
 
@@ -1874,7 +1907,7 @@
 
 @var{tramp-password-prompt-regexp} handles the detection of such
 requests for English environments.  When you use another localization
-of your (local or remote) host, you might need to adapt this. Example:
+of your (local or remote) host, you might need to adapt this.  Example:
 
 @lisp
 (setq
@@ -2048,7 +2081,8 @@
 @end lisp
 
 @noindent
-with @samp{192.168.0.26} being the IP address of your Android device.
+with @samp{192.168.0.26} being the IP address of your Android device
+(@pxref{Predefined connection information}).
 
 The user settings for the @code{$PATH} environment variable must be
 preserved.  It has also been reported, that the commands in