diff options
| author | Glenn Morris | 2013-02-24 11:45:17 -0800 |
|---|---|---|
| committer | Glenn Morris | 2013-02-24 11:45:17 -0800 |
| commit | 1abfd3e85fa9b340699430cd9e15dd9f0073bdbe (patch) | |
| tree | 7e5b3bef0d0813f0627af5da403440708b212be2 /doc/misc | |
| parent | 4b9f0b67dae95106356e2cd7c7f03622702026f2 (diff) | |
| parent | c0c2eb8295bb99b6ac0bbf8c1e06b60220074a5b (diff) | |
| download | emacs-1abfd3e85fa9b340699430cd9e15dd9f0073bdbe.tar.gz emacs-1abfd3e85fa9b340699430cd9e15dd9f0073bdbe.zip | |
Merge from emacs-24; up to 2012-12-22T19:09:52Z!rgm@gnu.org
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/misc/tramp.texi | 33 |
2 files changed, 26 insertions, 14 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 9a4f4c10610..632f06d22b1 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,10 @@ | |||
| 1 | 2013-02-24 Michael Albinus <michael.albinus@gmx.de> | ||
| 2 | |||
| 3 | Port Tramp documentation to Texinfo 5.0. | ||
| 4 | * tramp.texi (top) [xxx, yyy, trampfn]: Remove superfluous @c. | ||
| 5 | (Filename Syntax): Do not use @trampfn{} in @item. | ||
| 6 | (Filename completion): Use @columnfractions in @multitable. | ||
| 7 | |||
| 1 | 2013-02-22 Glenn Morris <rgm@gnu.org> | 8 | 2013-02-22 Glenn Morris <rgm@gnu.org> |
| 2 | 9 | ||
| 3 | * flymake.texi (Syntax check statuses): Fix multitable continued rows. | 10 | * flymake.texi (Syntax check statuses): Fix multitable continued rows. |
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index f1dac493054..00b5e1e8dc1 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -20,20 +20,23 @@ | |||
| 20 | @c xxx and yyy are auxiliary macros in order to omit leading and | 20 | @c xxx and yyy are auxiliary macros in order to omit leading and |
| 21 | @c trailing whitespace. Not very elegant, but I don't know it better. | 21 | @c trailing whitespace. Not very elegant, but I don't know it better. |
| 22 | 22 | ||
| 23 | @macro xxx {one}@c | 23 | @macro xxx {one} |
| 24 | @set \one\@c | 24 | @set \one\ |
| 25 | @end macro | 25 | @end macro |
| 26 | 26 | ||
| 27 | @macro yyy {one, two}@c | 27 | @macro yyy {one, two} |
| 28 | @xxx{x\one\}@c | 28 | @xxx{x\one\}@c |
| 29 | @ifclear x@c | 29 | @ifclear x |
| 30 | \one\@w{}\two\@c | 30 | \one\@w{}\two\@c |
| 31 | @end ifclear | 31 | @end ifclear |
| 32 | @clear x\one\@c | 32 | @clear x\one\ |
| 33 | @end macro | 33 | @end macro |
| 34 | 34 | ||
| 35 | @macro trampfn {method, user, host, localname}@c | 35 | @macro trampfn {method, user, host, localname} |
| 36 | @value{prefix}@yyy{\method\,@value{postfixhop}}@yyy{\user\,@@}\host\@value{postfix}\localname\@c | 36 | @value{prefix}@c |
| 37 | @yyy{\method\,@value{postfixhop}}@c | ||
| 38 | @yyy{\user\,@@}@c | ||
| 39 | \host\@value{postfix}\localname\ | ||
| 37 | @end macro | 40 | @end macro |
| 38 | 41 | ||
| 39 | @copying | 42 | @copying |
| @@ -2323,25 +2326,25 @@ using the default method. @xref{Default Method}. | |||
| 2323 | Some examples of @value{tramp} filenames are shown below. | 2326 | Some examples of @value{tramp} filenames are shown below. |
| 2324 | 2327 | ||
| 2325 | @table @file | 2328 | @table @file |
| 2326 | @item @trampfn{, , melancholia, .emacs} | 2329 | @item @value{prefix}melancholia@value{postfix}.emacs |
| 2327 | Edit the file @file{.emacs} in your home directory on the machine | 2330 | Edit the file @file{.emacs} in your home directory on the machine |
| 2328 | @code{melancholia}. | 2331 | @code{melancholia}. |
| 2329 | 2332 | ||
| 2330 | @item @trampfn{, , melancholia.danann.net, .emacs} | 2333 | @item @value{prefix}melancholia.danann.net@value{postfix}.emacs |
| 2331 | This edits the same file, using the fully qualified domain name of | 2334 | This edits the same file, using the fully qualified domain name of |
| 2332 | the machine. | 2335 | the machine. |
| 2333 | 2336 | ||
| 2334 | @item @trampfn{, , melancholia, ~/.emacs} | 2337 | @item @value{prefix}melancholia@value{postfix}~/.emacs |
| 2335 | This also edits the same file; the @file{~} is expanded to your | 2338 | This also edits the same file; the @file{~} is expanded to your |
| 2336 | home directory on the remote machine, just like it is locally. | 2339 | home directory on the remote machine, just like it is locally. |
| 2337 | 2340 | ||
| 2338 | @item @trampfn{, , melancholia, ~daniel/.emacs} | 2341 | @item @value{prefix}melancholia@value{postfix}~daniel/.emacs |
| 2339 | This edits the file @file{.emacs} in the home directory of the user | 2342 | This edits the file @file{.emacs} in the home directory of the user |
| 2340 | @code{daniel} on the machine @code{melancholia}. The @file{~<user>} | 2343 | @code{daniel} on the machine @code{melancholia}. The @file{~<user>} |
| 2341 | construct is expanded to the home directory of that user on the remote | 2344 | construct is expanded to the home directory of that user on the remote |
| 2342 | machine. | 2345 | machine. |
| 2343 | 2346 | ||
| 2344 | @item @trampfn{, , melancholia, /etc/squid.conf} | 2347 | @item @value{prefix}melancholia@value{postfix}/etc/squid.conf |
| 2345 | This edits the file @file{/etc/squid.conf} on the machine | 2348 | This edits the file @file{/etc/squid.conf} on the machine |
| 2346 | @code{melancholia}. | 2349 | @code{melancholia}. |
| 2347 | 2350 | ||
| @@ -2453,7 +2456,8 @@ If you, for example, type @kbd{C-x C-f @value{prefix}t | |||
| 2453 | @key{TAB}}, @value{tramp} might give you as result the choice for | 2456 | @key{TAB}}, @value{tramp} might give you as result the choice for |
| 2454 | 2457 | ||
| 2455 | @example | 2458 | @example |
| 2456 | @multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} | 2459 | @c @multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} |
| 2460 | @multitable @columnfractions .5 .5 | ||
| 2457 | @ifset emacs | 2461 | @ifset emacs |
| 2458 | @item @value{prefixhop}telnet@value{postfixhop} @tab tmp/ | 2462 | @item @value{prefixhop}telnet@value{postfixhop} @tab tmp/ |
| 2459 | @item @value{prefixhop}toto@value{postfix} @tab | 2463 | @item @value{prefixhop}toto@value{postfix} @tab |
| @@ -2480,7 +2484,8 @@ Next @kbd{@key{TAB}} brings you all machine names @value{tramp} detects in | |||
| 2480 | your @file{/etc/hosts} file, let's say | 2484 | your @file{/etc/hosts} file, let's say |
| 2481 | 2485 | ||
| 2482 | @example | 2486 | @example |
| 2483 | @multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} | 2487 | @multitable @columnfractions .5 .5 |
| 2488 | @c @multitable {@trampfn{telnet, , melancholia.danann.net,}} {@trampfn{telnet, , 192.168.0.1,}} | ||
| 2484 | @item @trampfn{telnet, , 127.0.0.1,} @tab @trampfn{telnet, , 192.168.0.1,} | 2489 | @item @trampfn{telnet, , 127.0.0.1,} @tab @trampfn{telnet, , 192.168.0.1,} |
| 2485 | @item @trampfn{telnet, , @value{ipv6prefix}::1@value{ipv6postfix},} @tab @trampfn{telnet, , localhost,} | 2490 | @item @trampfn{telnet, , @value{ipv6prefix}::1@value{ipv6postfix},} @tab @trampfn{telnet, , localhost,} |
| 2486 | @item @trampfn{telnet, , melancholia.danann.net,} @tab @trampfn{telnet, , melancholia,} | 2491 | @item @trampfn{telnet, , melancholia.danann.net,} @tab @trampfn{telnet, , melancholia,} |