[Emacs-diffs] emacs/doc/misc ChangeLog eshell.texi tramp.texi

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       09/12/09 10:10:18

Modified files:
        doc/misc       : ChangeLog eshell.texi tramp.texi 

Log message:
        * eshell.texi (History): Add the other built-in variables.
        (Built-ins): Explain built-ins, and how to apply the external commands.
        Add `history', `su' and `sudo'.
        
        * tramp.texi (Remote processes): Add missing <RET> in the example.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/ChangeLog?cvsroot=emacs&r1=1.355&r2=1.356
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/eshell.texi?cvsroot=emacs&r1=1.8&r2=1.9
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/tramp.texi?cvsroot=emacs&r1=1.36&r2=1.37

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/ChangeLog,v
retrieving revision 1.355
retrieving revision 1.356
diff -u -b -r1.355 -r1.356
--- ChangeLog   8 Dec 2009 03:29:05 -0000       1.355
+++ ChangeLog   9 Dec 2009 10:10:18 -0000       1.356
@@ -1,3 +1,11 @@
+2009-12-09  Michael Albinus  <address@hidden>
+
+       * eshell.texi (History): Add the other built-in variables.
+       (Built-ins): Explain built-ins, and how to apply the external commands.
+       Add `history', `su' and `sudo'.
+
+       * tramp.texi (Remote processes): Add missing <RET> in the example.
+
 2009-12-01  Bill Wohler  <address@hidden>
 
        * mh-e.texi (Searching): Use mh vfolder_format and fix typo in database

Index: eshell.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/eshell.texi,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- eshell.texi 16 Feb 2009 17:42:00 -0000      1.8
+++ eshell.texi 9 Dec 2009 10:10:18 -0000       1.9
@@ -334,6 +334,20 @@
 This variable always contains the previous working directory (the
 current working directory from before the last @code{cd} command).
 
address@hidden $_
address@hidden $_
+It refers to the last argument of the last command.
+
address@hidden $$
address@hidden $$
+This is the result of the last command.  In case of an external
+command, it is @code{t} or @code{nil}.
+
address@hidden $?
address@hidden $?
+This variable contains the exit code of the last command (0 or 1 for
+Lisp functions, based on successful completion).
+
 @end table
 
 @node Scripts
@@ -343,7 +357,19 @@
 @node Built-ins
 @section Built-in commands
 
-Here is a list of built-in commands that Eshell knows about:
+Several commands are built-in in Eshell.  In order to call the
+external variant of a built-in command @code{foo}, you could call
address@hidden  Usually, this should not be necessary.  You can check
+what will be applied by the @code{which} command:
+
address@hidden
+~ $ which ls
+eshell/ls is a compiled Lisp function in `em-ls.el'
+~ $ which *ls
+/bin/ls
address@hidden example
+
+Some of the built-in commands have a special behaviour in Eshell:
 
 @table @code
 
@@ -367,6 +393,48 @@
 
 With @samp{cd -42}, you can access the directory stack by number.
 
address@hidden history
address@hidden history
+The @samp{history} command shows all commands kept in the history ring
+as numbered list.  If the history ring contains
address@hidden commands, those numbers change after every
+command invocation, therefore the @samp{history} command shall be
+applied before using the expansion mechanism with history numbers.
+
+The n-th entry of the history ring can be applied with the @samp{!n}
+command.  If @code{n} is negative, the entry is counted from the end
+of the history ring.
+
address@hidden expands to the last command beginning with @code{foo}, and
address@hidden to the last command containing @code{foo}.  The n-th
+argument of the last command beginning with @code{foo} is accessible
+by @code{!foo:n}.
+
address@hidden su
address@hidden su
address@hidden sudo
address@hidden sudo
address@hidden and @code{sudo} work as expected: they apply the following
+commands (@code{su}), or the command being an argument (@code{sudo})
+under the permissions of somebody else.
+
+This does not work only on
+the local host, but even on a remote one, when
address@hidden is a remote file name.  The necessary
+proxy configuration of Tramp is performed
address@hidden
+automatically, @ref{Multi-hops, , , tramp}.
address@hidden ifinfo
address@hidden
+automatically.
address@hidden ifnotinfo
+Example:
+
address@hidden
+~ $ cd /ssh:otherhost:/etc
+/ssh:user@@otherhost:/etc $ sudo find-file shadow
address@hidden example
+
 @end table
 
 

Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -b -r1.36 -r1.37
--- tramp.texi  29 Nov 2009 20:40:12 -0000      1.36
+++ tramp.texi  9 Dec 2009 10:10:18 -0000       1.37
@@ -2594,10 +2594,11 @@
 
 @example
 @b{~ $} cd @trampfn{ssh, user, remotehost, /etc} @key{RET}
address@hidden@trampfn{ssh, user, remotehost, /etc} $} find-file shadow
address@hidden@trampfn{ssh, user, remotehost, /etc} $} find-file shadow 
@key{RET}
 File is not readable: @trampfn{ssh, user, remotehost, /etc/shadow}
address@hidden@trampfn{ssh, user, remotehost, /etc} $} sudo find-file shadow
address@hidden@trampfn{ssh, user, remotehost, /etc} $} sudo find-file shadow 
@key{RET}
 #<buffer shadow>
+
 @address@hidden, user, remotehost, /etc} $} su - @key{RET}
 @address@hidden, root, remotehost, /root} $} id @key{RET}
 uid=0(root) gid=0(root) groups=0(root)