[Emacs-diffs] /srv/bzr/emacs/trunk r111910: * tramp.texi (External methods): Explain user name and host name

[Michael Albinus]

------------------------------------------------------------
revno: 111910
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Fri 2013-03-01 22:14:59 +0100
message:
  * tramp.texi (External methods): Explain user name and host name
  specification for "adb".
modified:
  doc/misc/ChangeLog
  doc/misc/tramp.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-03-01 08:16:13 +0000
+++ b/doc/misc/ChangeLog        2013-03-01 21:14:59 +0000
@@ -2,7 +2,8 @@
 
        * tramp.texi (Inline methods): Remove "ssh1", "ssh2", "plink1"
        and "plink2" entries.  "plink2" is obsolete for a long time.
-       (External methods): Remove "scp1" and "scp2" entries.
+       (External methods): Remove "scp1" and "scp2" entries.  Explain
+       user name and host name specification for "adb".
 
 2013-02-28  Michael Albinus  <address@hidden>
 

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2013-03-01 08:16:13 +0000
+++ b/doc/misc/tramp.texi       2013-03-01 21:14:59 +0000
@@ -1005,6 +1005,18 @@
 found via the @code{$PATH} environment variable, the variable
 @var{tramp-adb-program} must point to its absolute path.
 
+Usually, the @command{adb} method does not need any user name.  It
+runs under the permissions of the @command{adbd} process on the
+Android device.  If a user name is specified, @value{tramp} applies an
address@hidden on the device.  This does not work with all Android
+devices, especially with nonrooted ones.  In that case, an error
+message is displayed.
+
+If there is exactly one Android device connected to the local machine,
+a host name is not needed.  The shortest @value{tramp} name to be used
+is @address@hidden, , ,}} therefore.  Otherwise, one could find
+potential host names with the shell command @command{adb devices}.
+
 @end table