diff options
author | Michael Albinus <michael.albinus@gmx.de> | 2013-02-24 18:58:55 +0100 |
---|---|---|
committer | Michael Albinus <michael.albinus@gmx.de> | 2013-02-24 18:58:55 +0100 |
commit | c0c2eb8295bb99b6ac0bbf8c1e06b60220074a5b (patch) | |
tree | 90925ecfa9fb3330676f3b6dfbb7195e7f3ab305 | |
parent | 51aa2a8b797cefbbee597b5c33ff955c0e470855 (diff) | |
download | emacs-c0c2eb8295bb99b6ac0bbf8c1e06b60220074a5b.tar.gz |
Port documentation to Texinfo 5.0.
* tramp.texi (top) [xxx, yyy, trampfn]: Remove superfluous @c.
(Filename Syntax): Do not use @trampfn{} in @item.
(Filename completion): Use @columnfractions in @multitable.
-rw-r--r-- | doc/misc/ChangeLog | 8 | ||||
-rw-r--r-- | doc/misc/tramp.texi | 33 |
2 files changed, 27 insertions, 14 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 0d6e0785c09..63cbcdc5a15 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,3 +1,11 @@ +2013-02-24 Michael Albinus <michael.albinus@gmx.de> + + Port documentation to Texinfo 5.0. + + * tramp.texi (top) [xxx, yyy, trampfn]: Remove superfluous @c. + (Filename Syntax): Do not use @trampfn{} in @item. + (Filename completion): Use @columnfractions in @multitable. + 2013-02-22 Glenn Morris <rgm@gnu.org> * flymake.texi (Syntax check statuses): Fix multitable continued rows. diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 616b32806f4..493c69da052 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -20,20 +20,23 @@ @c xxx and yyy are auxiliary macros in order to omit leading and @c trailing whitespace. Not very elegant, but I don't know it better. -@macro xxx {one}@c -@set \one\@c +@macro xxx {one} +@set \one\ @end macro -@macro yyy {one, two}@c +@macro yyy {one, two} @xxx{x\one\}@c -@ifclear x@c +@ifclear x \one\@w{}\two\@c @end ifclear -@clear x\one\@c +@clear x\one\ @end macro -@macro trampfn {method, user, host, localname}@c -@value{prefix}@yyy{\method\,@value{postfixhop}}@yyy{\user\,@@}\host\@value{postfix}\localname\@c +@macro trampfn {method, user, host, localname} +@value{prefix}@c +@yyy{\method\,@value{postfixhop}}@c +@yyy{\user\,@@}@c +\host\@value{postfix}\localname\ @end macro @copying @@ -2268,25 +2271,25 @@ using the default method. @xref{Default Method}. Some examples of @value{tramp} filenames are shown below. @table @file -@item @trampfn{, , melancholia, .emacs} +@item @value{prefix}melancholia@value{postfix}.emacs Edit the file @file{.emacs} in your home directory on the machine @code{melancholia}. -@item @trampfn{, , melancholia.danann.net, .emacs} +@item @value{prefix}melancholia.danann.net@value{postfix}.emacs This edits the same file, using the fully qualified domain name of the machine. -@item @trampfn{, , melancholia, ~/.emacs} +@item @value{prefix}melancholia@value{postfix}~/.emacs This also edits the same file; the @file{~} is expanded to your home directory on the remote machine, just like it is locally. -@item @trampfn{, , melancholia, ~daniel/.emacs} +@item @value{prefix}melancholia@value{postfix}~daniel/.emacs This edits the file @file{.emacs} in the home directory of the user @code{daniel} on the machine @code{melancholia}. The @file{~<user>} construct is expanded to the home directory of that user on the remote machine. -@item @trampfn{, , melancholia, /etc/squid.conf} +@item @value{prefix}melancholia@value{postfix}/etc/squid.conf This edits the file @file{/etc/squid.conf} on the machine @code{melancholia}. @@ -2396,7 +2399,8 @@ If you, for example, type @kbd{C-x C-f @value{prefix}t @key{TAB}}, @value{tramp} might give you as result the choice for @example -@multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} +@c @multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} +@multitable @columnfractions .5 .5 @ifset emacs @item @value{prefixhop}telnet@value{postfixhop} @tab tmp/ @item @value{prefixhop}toto@value{postfix} @tab @@ -2423,7 +2427,8 @@ Next @kbd{@key{TAB}} brings you all machine names @value{tramp} detects in your @file{/etc/hosts} file, let's say @example -@multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} +@multitable @columnfractions .5 .5 +@c @multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} @item @trampfn{telnet, , 127.0.0.1,} @tab @trampfn{telnet, , 192.168.0.1,} @item @trampfn{telnet, , @value{ipv6prefix}::1@value{ipv6postfix},} @tab @trampfn{telnet, , localhost,} @item @trampfn{telnet, , melancholia.danann.net,} @tab @trampfn{telnet, , melancholia,} |