Commit b1a2b924 authored by Kai Großjohann's avatar Kai Großjohann
Browse files

* tramp.el: Version 2.0.31 released.

(tramp-handle-expand-file-name): Do not allow ".." to
cross file handler boundaries, so that "/user@host:/../foo"
expands to itself, rather than "/foo".  This is intended to work
in conjunction with a change in `file-relative-name' which makes
sure to use absolute file names if FILE and DIRECTORY have
different handlers.
(tramp-handle-insert-directory): Comment out XEmacs
kludge.  Suggested by Katsumi Yamaoka <yamaoka@jpl.org>.

* Makefile.in (../info/tramp): Compile Emacs, instead of XEmacs,
version of manual.

* tramp.texi (Auto-save and Backup): New node.
parent ef6e365d
2003-03-29 Kai Gro,A_(Bjohann <kai.grossjohann@gmx.net>
* tramp.el: Version 2.0.31 released.
(tramp-handle-expand-file-name): Do not allow ".." to
cross file handler boundaries, so that "/user@host:/../foo"
expands to itself, rather than "/foo". This is intended to work
in conjunction with a change in `file-relative-name' which makes
sure to use absolute file names if FILE and DIRECTORY have
different handlers.
(tramp-handle-insert-directory): Comment out XEmacs
kludge. Suggested by Katsumi Yamaoka <yamaoka@jpl.org>.
2003-03-29 Michael Albinus <Michael.Albinus@alcatel.de>
* trampver.el: New file, to support Autoconf in Tramp CVS
repository.
* tramp.el (tramp-version, tramp-bug-report-address): Moved to
trampver.el, which is required now.
(tramp-chunksize): Type can be nil as well. Reported
by Markus Rost <rost@math.ohio-state.edu>.
* tramp-smb.el (tramp-smb-read-file-entry): Make reading size of a
listing entry more robust. Ranges from 10 chars (Samba 1) to 7-9
chars (Samba 2).
2003-03-29 John Paul Wallington <jpw@gnu.org> 2003-03-29 John Paul Wallington <jpw@gnu.org>
   
* international/mule.el (with-category-table): Use `make-symbol' * international/mule.el (with-category-table): Use `make-symbol'
......
...@@ -754,21 +754,38 @@ Result is a list of (LOCALNAME MODE SIZE MONTH DAY TIME YEAR)." ...@@ -754,21 +754,38 @@ Result is a list of (LOCALNAME MODE SIZE MONTH DAY TIME YEAR)."
;; They should have the format ;; They should have the format
;; ;;
;; \s-\{2,2} - leading spaces ;; \s-\{2,2} - leading spaces
;; \S-\(.*\S-\)\s-* - file name, 32 chars, left bound ;; \S-\(.*\S-\)\s-* - file name, 30 chars, left bound
;; \s-+[ADHRSV]* - permissions, 7 chars, right bound
;; \s- - space delimeter ;; \s- - space delimeter
;; \s-*[ADHRS]* - permissions, 5 chars, right bound ;; \s-+[0-9]+ - size, 8 chars, right bound
;; \s- - space delimeter
;; \s-*[0-9]+ - size, 8 (Samba) or 7 (Windows)
;; chars, right bound
;; \s-\{2,2\} - space delimeter ;; \s-\{2,2\} - space delimeter
;; \w\{3,3\} - weekday ;; \w\{3,3\} - weekday
;; \s- - space delimeter ;; \s- - space delimeter
;; \w\{3,3\} - month
;; \s- - space delimeter
;; [ 19][0-9] - day ;; [ 19][0-9] - day
;; \s- - space delimeter ;; \s- - space delimeter
;; [0-9]\{2,2\}:[0-9]\{2,2\}:[0-9]\{2,2\} - time ;; [0-9]\{2,2\}:[0-9]\{2,2\}:[0-9]\{2,2\} - time
;; \s- - space delimeter ;; \s- - space delimeter
;; [0-9]\{4,4\} - year ;; [0-9]\{4,4\} - year
;; ;;
;; samba/src/client.c (http://samba.org/doxygen/samba/client_8c-source.html)
;; has function display_finfo:
;;
;; d_printf(" %-30s%7.7s %8.0f %s",
;; finfo->name,
;; attrib_string(finfo->mode),
;; (double)finfo->size,
;; asctime(LocalTime(&t)));
;;
;; in Samba 1.9, there's the following code:
;;
;; DEBUG(0,(" %-30s%7.7s%10d %s",
;; CNV_LANG(finfo->name),
;; attrib_string(finfo->mode),
;; finfo->size,
;; asctime(LocalTime(&t))));
;;
;; Problems: ;; Problems:
;; * Modern regexp constructs, like spy groups and counted repetitions, aren't ;; * Modern regexp constructs, like spy groups and counted repetitions, aren't
;; available in older Emacsen. ;; available in older Emacsen.
...@@ -828,27 +845,28 @@ Result is the list (LOCALNAME MODE SIZE MTIME)." ...@@ -828,27 +845,28 @@ Result is the list (LOCALNAME MODE SIZE MTIME)."
;; size ;; size
(if (string-match "\\([0-9]+\\)$" line) (if (string-match "\\([0-9]+\\)$" line)
(setq (let ((length (- (max 10 (1+ (length (match-string 1 line)))))))
size (string-to-number (match-string 1 line)) (setq size (string-to-number (match-string 1 line)))
line (substring (when (string-match "\\([ADHRSV]+\\)" (substring line length))
line 0 (- (max 8 (1+ (length (match-string 1 line))))))) (setq length (+ length (match-end 0))))
(setq line (substring line 0 length)))
(return)) (return))
;; mode ;; mode: ARCH, DIR, HIDDEN, RONLY, SYSTEM, VOLID
(if (string-match "\\(\\([ADHRS]+\\)?\\s-?\\)$" line) (if (string-match "\\([ADHRSV]+\\)?$" line)
(setq (setq
mode (or (match-string 2 line) "") mode (or (match-string 1 line) "")
mode (save-match-data (format mode (save-match-data (format
"%s%s" "%s%s"
(if (string-match "D" mode) "d" "-") (if (string-match "D" mode) "d" "-")
(mapconcat (mapconcat
(lambda (x) "") " " (lambda (x) "") " "
(concat "r" (if (string-match "R" mode) "-" "w") "x")))) (concat "r" (if (string-match "R" mode) "-" "w") "x"))))
line (substring line 0 (- (1+ (length (match-string 2 line)))))) line (substring line 0 -7))
(return)) (return))
;; localname ;; localname
(if (string-match "^\\s-+\\(\\S-\\(.*\\S-\\)?\\)\\s-+$" line) (if (string-match "^\\s-+\\(\\S-\\(.*\\S-\\)?\\)\\s-*$" line)
(setq localname (match-string 1 line)) (setq localname (match-string 1 line))
(return)))) (return))))
......
;;; tramp.el --- Transparent Remote Access, Multiple Protocol -*- coding: iso-8859-1; -*- ;;; -*- mode: Emacs-Lisp; coding: iso-8859-1; -*-
;;; tramp.el --- Transparent Remote Access, Multiple Protocol
;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc. ;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
;; Author: Kai.Grossjohann@CS.Uni-Dortmund.DE ;; Author: kai.grossjohann@gmx.net
;; Keywords: comm, processes ;; Keywords: comm, processes
;; This file is part of GNU Emacs. ;; This file is part of GNU Emacs.
...@@ -29,8 +30,7 @@ ...@@ -29,8 +30,7 @@
;; the local and the remote host, whereas tramp.el uses a combination ;; the local and the remote host, whereas tramp.el uses a combination
;; of rsh and rcp or other work-alike programs, such as ssh/scp. ;; of rsh and rcp or other work-alike programs, such as ssh/scp.
;; ;;
;; For more detailed instructions, please see the info file, which is ;; For more detailed instructions, please see the info file.
;; included in the file `tramp.tar.gz' mentioned below.
;; ;;
;; Notes: ;; Notes:
;; ----- ;; -----
...@@ -46,13 +46,11 @@ ...@@ -46,13 +46,11 @@
;; ;;
;; Also see the todo list at the bottom of this file. ;; Also see the todo list at the bottom of this file.
;; ;;
;; The current version of tramp.el can be retrieved from the following ;; The current version of Tramp can be retrieved from the following URL:
;; URL: ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/tramp.tar.gz ;; http://savannah.nongnu.org/download/tramp/
;; For your convenience, the *.el file is available separately from
;; the same directory.
;; ;;
;; There's a mailing list for this, as well. Its name is: ;; There's a mailing list for this, as well. Its name is:
;; tramp-devel@mail.freesoftware.fsf.org ;; tramp-devel@mail.freesoftware.fsf.org
;; Send a mail with `help' in the subject (!) to the administration ;; Send a mail with `help' in the subject (!) to the administration
;; address for instructions on joining the list. The administration ;; address for instructions on joining the list. The administration
;; address is: ;; address is:
...@@ -69,14 +67,8 @@ ...@@ -69,14 +67,8 @@
;;; Code: ;;; Code:
;; In the Tramp CVS repository, the version numer is auto-frobbed from ;; The Tramp version number and bug report address, as prepared by configure.
;; the Makefile, so you should edit the top-level Makefile to change (require 'trampver)
;; the version number.
(defconst tramp-version "2.0.30"
"This version of tramp.")
(defconst tramp-bug-report-address "tramp-devel@mail.freesoftware.fsf.org"
"Email address to send bug reports to.")
(require 'timer) (require 'timer)
(require 'format-spec) ;from Gnus 5.8, also in tar ball (require 'format-spec) ;from Gnus 5.8, also in tar ball
...@@ -1275,7 +1267,7 @@ checked via the following code: ...@@ -1275,7 +1267,7 @@ checked via the following code:
Please raise a bug report via \"M-x tramp-bug\" if your system needs Please raise a bug report via \"M-x tramp-bug\" if your system needs
this variable to be set as well." this variable to be set as well."
:group 'tramp :group 'tramp
:type 'integer) :type '(choice (const nil) integer))
;;; Internal Variables: ;;; Internal Variables:
...@@ -2831,6 +2823,10 @@ This is like `dired-recursive-delete-directory' for tramp files." ...@@ -2831,6 +2823,10 @@ This is like `dired-recursive-delete-directory' for tramp files."
(file-name-nondirectory localname))))) (file-name-nondirectory localname)))))
(sit-for 1) ;needed for rsh but not ssh? (sit-for 1) ;needed for rsh but not ssh?
(tramp-wait-for-output)) (tramp-wait-for-output))
;; The following let-binding is used by code that's commented
;; out. Let's leave the let-binding in for a while to see
;; that the commented-out code is really not needed. Commenting-out
;; happened on 2003-03-13.
(let ((old-pos (point))) (let ((old-pos (point)))
(insert-buffer-substring (insert-buffer-substring
(tramp-get-buffer multi-method method user host)) (tramp-get-buffer multi-method method user host))
...@@ -2843,13 +2839,16 @@ This is like `dired-recursive-delete-directory' for tramp files." ...@@ -2843,13 +2839,16 @@ This is like `dired-recursive-delete-directory' for tramp files."
(save-excursion (save-excursion
(tramp-send-command multi-method method user host "cd") (tramp-send-command multi-method method user host "cd")
(tramp-wait-for-output)) (tramp-wait-for-output))
;; Another XEmacs specialty follows. What's the right way to do ;; For the time being, the XEmacs kludge is commented out.
;; it? ;; Please test it on various XEmacs versions to see if it works.
(when (and (featurep 'xemacs) ;; ;; Another XEmacs specialty follows. What's the right way to do
(eq major-mode 'dired-mode)) ;; ;; it?
(save-excursion ;; (when (and (featurep 'xemacs)
(require 'dired) ;; (eq major-mode 'dired-mode))
(dired-insert-set-properties old-pos (point))))))) ;; (save-excursion
;; (require 'dired)
;; (dired-insert-set-properties old-pos (point))))
)))
;; Continuation of kluge to pacify byte-compiler. ;; Continuation of kluge to pacify byte-compiler.
;;(eval-when-compile ;;(eval-when-compile
...@@ -2917,20 +2916,33 @@ the result will be a local, non-Tramp, filename." ...@@ -2917,20 +2916,33 @@ the result will be a local, non-Tramp, filename."
(setq uname (buffer-substring (point) (tramp-line-end-position))) (setq uname (buffer-substring (point) (tramp-line-end-position)))
(setq localname (concat uname fname)) (setq localname (concat uname fname))
(erase-buffer))) (erase-buffer)))
;; Look if localname starts with "/../" construct. If this is ;; No tilde characters in file name, do normal
;; the case, then we return a local name instead of a remote name. ;; expand-file-name (this does "/./" and "/../"). We bind
(if (string-match "^/\\.\\./" localname) ;; directory-sep-char here for XEmacs on Windows, which
(expand-file-name (substring localname 3)) ;; would otherwise use backslash.
;; No tilde characters in file name, do normal (let ((directory-sep-char ?/))
;; expand-file-name (this does "/./" and "/../"). We bind (tramp-make-tramp-file-name
;; directory-sep-char here for XEmacs on Windows, which multi-method method user host
;; would otherwise use backslash. (tramp-drop-volume-letter
(let ((directory-sep-char ?/)) (tramp-run-real-handler 'expand-file-name
(tramp-make-tramp-file-name (list localname)))))))))
multi-method method user host
(tramp-drop-volume-letter ;; old version follows. it uses ".." to cross file handler
(tramp-run-real-handler 'expand-file-name ;; boundaries.
(list localname)))))))))) ;; ;; Look if localname starts with "/../" construct. If this is
;; ;; the case, then we return a local name instead of a remote name.
;; (if (string-match "^/\\.\\./" localname)
;; (expand-file-name (substring localname 3))
;; ;; No tilde characters in file name, do normal
;; ;; expand-file-name (this does "/./" and "/../"). We bind
;; ;; directory-sep-char here for XEmacs on Windows, which
;; ;; would otherwise use backslash.
;; (let ((directory-sep-char ?/))
;; (tramp-make-tramp-file-name
;; multi-method method user host
;; (tramp-drop-volume-letter
;; (tramp-run-real-handler 'expand-file-name
;; (list localname))))))))))
;; Remote commands. ;; Remote commands.
......
;;; -*- mode: Emacs-Lisp; coding: iso-8859-1; -*-
;;; trampver.el --- Transparent Remote Access, Multiple Protocol
;;; lisp/trampver.el. Generated from trampver.el.in by configure.
;; Copyright (C) 2003 Free Software Foundation, Inc.
;; Author: Kai.Grossjohann@CS.Uni-Dortmund.DE
;; Keywords: comm, processes
;; This file is part of GNU Emacs.
;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 2, or (at your option)
;; any later version.
;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING. If not, write to the
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
;; Boston, MA 02111-1307, USA.
;;; Code:
;; In the Tramp CVS repository, the version numer and the bug report address
;; are auto-frobbed from configure.ac, so you should edit that file and run
;; "autoconf && ./configure" to change them.
(defconst tramp-version "2.0.31"
"This version of Tramp.")
(defconst tramp-bug-report-address "tramp-devel@mail.freesoftware.fsf.org"
"Email address to send bug reports to.")
(provide 'trampver)
;;; trampver.el ends here
2003-03-29 Kai Gro,A_(Bjohann <kai.grossjohann@gmx.net>
* Makefile.in (../info/tramp): Compile Emacs, instead of XEmacs,
version of manual.
* tramp.texi (Auto-save and Backup): New node.
2003-03-29 Michael Albinus <Michael.Albinus@alcatel.de>
* tramp.texi (Top): Include trampver.texi. Rename "Emacs" to "GNU
Emacs" in order to have better differentiation to "XEmacs".
`emacs-other-name', `emacs-other-dir' and `emacs-other-file-name'
are new macros in order to point to the other Emacs flavor where
appropriate. In info case, point to node `Installation' in order
to explain how to generate the other way. In html case, make a
link to the other html file.
(Obtaining TRAMP): Added a paragraph saying to perform `autoconf'
after CVS checkout/update.
(Installation): Completely rewritten.
(Installation parameters, Load paths): New sections under
`Installation'.
2003-02-28 Kai Gro,A_(Bjohann <kai.grossjohann@uni-duisburg.de> 2003-02-28 Kai Gro,A_(Bjohann <kai.grossjohann@uni-duisburg.de>
* tramp.texi: Version 2.0.30 released. * tramp.texi: Version 2.0.30 released.
......
...@@ -268,7 +268,7 @@ emacs-mime.dvi: emacs-mime.texi ...@@ -268,7 +268,7 @@ emacs-mime.dvi: emacs-mime.texi
$(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi $(ENVADD) $(TEXI2DVI) ${srcdir}/emacs-mime.texi
../info/tramp: tramp.texi ../info/tramp: tramp.texi
cd $(srcdir); $(MAKEINFO) tramp.texi cd $(srcdir); $(MAKEINFO) -D emacs tramp.texi
tramp.dvi: tramp.texi tramp.dvi: tramp.texi
$(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi $(ENVADD) $(TEXI2DVI) ${srcdir}/tramp.texi
......
...@@ -8,12 +8,10 @@ ...@@ -8,12 +8,10 @@
@c This is *so* much nicer :) @c This is *so* much nicer :)
@footnotestyle end @footnotestyle end
@c In the Tramp CVS, the version number is auto-frobbed from the @c In the Tramp CVS, the version number is auto-frobbed from
@c Makefile, so you should edit the top-level Makefile to change @c configure.ac, so you should edit that file and run
@c the version number. @c "autoconf && ./configure" to change the version number.
@macro trampver{} @include trampver.texi
2.0.30
@end macro
@c Entries for @command{install-info} to use @c Entries for @command{install-info} to use
@dircategory Emacs @dircategory Emacs
...@@ -27,15 +25,16 @@ ...@@ -27,15 +25,16 @@
@sc{tramp} @sc{tramp}
@end macro @end macro
@c Distinguish between GNU Emacs and XEmacs. Derived from the
@c Makefile variable $(EMACS-ID). Valid values are `emacs' and `xemacs'.
@set emacs
@c Some flags which make the text independent on the (X)Emacs flavor. @c Some flags which make the text independent on the (X)Emacs flavor.
@c "emacs" resp "xemacs" are set in the Makefile.
@c GNU Emacs values. @c GNU Emacs values.
@ifset emacs @ifset emacs
@set emacs-name Emacs @set emacs-name GNU Emacs
@set emacs-dir emacs @set emacs-dir emacs
@set emacs-other-name XEmacs
@set emacs-other-dir xemacs
@set emacs-other-file-name tramp-xemacs.html
@set ftp-package-name Ange-FTP @set ftp-package-name Ange-FTP
@set tramp-prefix / @set tramp-prefix /
@set tramp-prefix-single-hop @set tramp-prefix-single-hop
...@@ -48,6 +47,9 @@ ...@@ -48,6 +47,9 @@
@ifset xemacs @ifset xemacs
@set emacs-name XEmacs @set emacs-name XEmacs
@set emacs-dir xemacs @set emacs-dir xemacs
@set emacs-other-name GNU Emacs
@set emacs-other-dir emacs
@set emacs-other-file-name tramp-emacs.html
@set ftp-package-name EFS @set ftp-package-name EFS
@set tramp-prefix /[ @set tramp-prefix /[
@set tramp-prefix-single-hop [ @set tramp-prefix-single-hop [
...@@ -122,6 +124,16 @@ programs, such as @command{ssh}/@command{scp}. ...@@ -122,6 +124,16 @@ programs, such as @command{ssh}/@command{scp}.
You can find the latest version of this document on the web at You can find the latest version of this document on the web at
@uref{http://www.freesoftware.fsf.org/tramp/}. @uref{http://www.freesoftware.fsf.org/tramp/}.
The manual has been generated for @value{emacs-name}.
@ifinfo
If you want to read the info pages for @value{emacs-other-name}, you
should read in @ref{Installation} how to create them.
@end ifinfo
@ifhtml
If you're using the other Emacs flavour, you should read the
@uref{@value{emacs-other-file-name}, @value{emacs-other-name}} pages.
@end ifhtml
@ifhtml @ifhtml
This manual is also available as a @uref{tramp_ja.html, Japanese This manual is also available as a @uref{tramp_ja.html, Japanese
translation}. translation}.
...@@ -176,6 +188,7 @@ Configuring @tramp{} for use ...@@ -176,6 +188,7 @@ Configuring @tramp{} for use
* Remote Programs:: How @tramp{} finds and uses programs on the remote machine. * Remote Programs:: How @tramp{} finds and uses programs on the remote machine.
* Remote shell setup:: Remote shell setup hints. * Remote shell setup:: Remote shell setup hints.
* Windows setup hints:: Issues with Cygwin ssh. * Windows setup hints:: Issues with Cygwin ssh.
* Auto-save and Backup:: Auto-save and Backup.
Using @tramp Using @tramp
...@@ -199,7 +212,7 @@ Things related to Version Control that don't fit elsewhere ...@@ -199,7 +212,7 @@ Things related to Version Control that don't fit elsewhere
How file names, directories and localnames are mangled and managed. How file names, directories and localnames are mangled and managed.
* Localname deconstruction:: Breaking a localname into its components. * Localname deconstruction:: Breaking a localname into its components.
@end detailmenu @end detailmenu
@end menu @end menu
...@@ -368,23 +381,23 @@ behind the scenes when you open a file with @tramp{}. ...@@ -368,23 +381,23 @@ behind the scenes when you open a file with @tramp{}.
@chapter Obtaining @tramp{}. @chapter Obtaining @tramp{}.
@cindex obtaining Tramp @cindex obtaining Tramp
@tramp{} is freely available on the Internet and the latest release may be @tramp{} is freely available on the Internet and the latest release
downloaded from may be downloaded from
@uref{ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/tramp.tar.gz}. This @uref{http://savannah.nongnu.org/download/tramp/}. This
release includes the full documentation and code for @tramp{}, suitable release includes the full documentation and code for @tramp{},
for installation. But Emacs (21.4 or later) includes @tramp{} suitable for installation. But Emacs (21.4 or later) includes
already, and there is a @tramp{} package for XEmacs, as well. So @tramp{} already, and there is a @tramp{} package for XEmacs, as well.
maybe it is easier to just use those. But if you want the bleeding So maybe it is easier to just use those. But if you want the bleeding
edge, read on@dots{...} edge, read on@dots{...}
For the especially brave, @tramp{} is available from CVS. The CVS version For the especially brave, @tramp{} is available from CVS. The CVS
is the latest version of the code and may contain incomplete features or version is the latest version of the code and may contain incomplete
new issues. Use these versions at your own risk. features or new issues. Use these versions at your own risk.
Instructions for obtaining the latest development version of @tramp{} Instructions for obtaining the latest development version of @tramp{}
from CVS can be found by going to the Savannah project page at the from CVS can be found by going to the Savannah project page at the
following URL and then clicking on the CVS link in the navigation bar at following URL and then clicking on the CVS link in the navigation bar
the top. at the top.
@noindent @noindent
@uref{http://savannah.gnu.org/projects/tramp/} @uref{http://savannah.gnu.org/projects/tramp/}
...@@ -404,15 +417,25 @@ CVS password: @strong{(just hit RET here)} ...@@ -404,15 +417,25 @@ CVS password: @strong{(just hit RET here)}
@end example @end example
@noindent @noindent
You should now have a directory @file{~/@value{emacs-dir}/tramp} containing the latest You should now have a directory @file{~/@value{emacs-dir}/tramp}
version of @tramp{}. You can fetch the latest updates from the repository containing the latest version of @tramp{}. You can fetch the latest
by issuing the command: updates from the repository by issuing the command:
@example @example
] @strong{cd ~/@value{emacs-dir}/tramp} ] @strong{cd ~/@value{emacs-dir}/tramp}
] @strong{cvs update -d} ] @strong{cvs update -d}
@end example @end example
@noindent
Once you've got updated files from the CVS repository, you need to run
@command{autoconf} in order to get an up-to-date @file{configure}
script:
@example
] @strong{cd ~/@value{emacs-dir}/tramp}
] @strong{autoconf}
@end example
@node History @node History
@chapter History of @tramp{} @chapter History of @tramp{}
...@@ -442,33 +465,40 @@ following information is not necessary. Installing @tramp{} into your ...@@ -442,33 +465,40 @@ following information is not necessary. Installing @tramp{} into your
to rebuilding your machine from scratch. ;) to rebuilding your machine from scratch. ;)
Seriously though, the installation should be a fairly simple matter. Seriously though, the installation should be a fairly simple matter.
The easiest way to proceed is as follows: The easiest way to proceed is as follows:
@itemize @bullet @itemize @bullet
@item @item
Choose a directory, say @file{~/@value{emacs-dir}/}. Change into that Choose a directory, say @file{~/@value{emacs-dir}/}. Change into that
directory and unpack the tarball. This will give you a directory directory and unpack the tarball. This will give you a directory
@file{~/@value{emacs-dir}/tramp/} which contains subdirectories @file{~/@value{emacs-dir}/tramp-@trampver{}/} which contains
@file{lisp} for the Lisp code and @file{texi} for the documentation. subdirectories @file{lisp} for the Lisp code and @file{texi} for the
documentation. Make a symbolic link:
@item
Optionally byte-compile all files in the Lisp directory,
@file{~/@value{emacs-dir}/tramp/lisp/}, by issuing a command like the
following from the top level directory
@file{~/@value{emacs-dir}/tramp/}:
@example @example
make EMACS=@value{emacs-dir} all ln -s tramp-@trampver{} tramp
@end example @end example
If there are missing libraries reported it is likely they are provided @item
in the @file{~/@value{emacs-dir}/tramp/contrib/} directory. This @command{cd} to @file{~/@value{emacs-dir}/tramp/} and type
case, you need to call @command{make} like this: @command{./configure} to configure Tramp for your system.
@example Running `configure' takes awhile. While running, it prints some
make EMACS=@value{emacs-dir} USE_CONTRIB=1 all messages telling which features it is checking for.
@end example
@item
Type @command{make} to build the byte-compiled Lisp files as well as