summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Albinus <michael.albinus@gmx.de>2013-02-24 18:58:55 +0100
committerMichael Albinus <michael.albinus@gmx.de>2013-02-24 18:58:55 +0100
commitc0c2eb8295bb99b6ac0bbf8c1e06b60220074a5b (patch)
tree90925ecfa9fb3330676f3b6dfbb7195e7f3ab305
parent51aa2a8b797cefbbee597b5c33ff955c0e470855 (diff)
downloademacs-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/ChangeLog8
-rw-r--r--doc/misc/tramp.texi33
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,}