[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/doc/lispref/files.texi,v
From: |
Dan Nicolaescu |
Subject: |
[Emacs-diffs] Changes to emacs/doc/lispref/files.texi,v |
Date: |
Thu, 31 Jul 2008 05:34:01 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Dan Nicolaescu <dann> 08/07/31 05:33:56
Index: doc/lispref/files.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/files.texi,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- doc/lispref/files.texi 6 Feb 2008 03:16:10 -0000 1.4
+++ doc/lispref/files.texi 31 Jul 2008 05:33:36 -0000 1.5
@@ -1487,11 +1487,6 @@
See also @code{delete-directory} in @ref{Create/Delete Dirs}.
@end deffn
address@hidden define-logical-name varname string
-This function defines the logical name @var{varname} to have the value
address@hidden It is available only on VMS.
address@hidden defun
-
@defun set-file-modes filename mode
This function sets mode bits of @var{filename} to @var{mode} (which
must be an integer). Only the low 12 bits of @var{mode} are used.
@@ -1565,10 +1560,9 @@
On MS-DOS and MS-Windows, these functions (like the function that
actually operate on files) accept MS-DOS or MS-Windows file-name syntax,
where backslashes separate the components, as well as Unix syntax; but
-they always return Unix syntax. On VMS, these functions (and the ones
-that operate on files) understand both VMS file-name syntax and Unix
-syntax. This enables Lisp programs to specify file names in Unix syntax
-and work properly on all systems without change.
+they always return Unix syntax. This enables Lisp programs to specify
+file names in Unix syntax and work properly on all systems without
+change.
@menu
* File Name Components:: The directory part of a file name, and the rest.
@@ -1597,15 +1591,11 @@
On most systems, the directory part is everything up to and including
the last slash (backslash is also allowed in input on MS-DOS or
-MS-Windows); the nondirectory part is the rest. The rules in VMS syntax
-are complicated.
+MS-Windows); the nondirectory part is the rest.
For some purposes, the nondirectory part is further subdivided into
the name proper and the @dfn{version number}. On most systems, only
-backup files have version numbers in their names. On VMS, every file
-has a version number, but most of the time the file name actually used
-in Emacs omits the version number, so that version numbers in Emacs are
-found mostly in directory lists.
+backup files have version numbers in their names.
@defun file-name-directory filename
This function returns the directory part of @var{filename}, as a
@@ -1613,9 +1603,7 @@
@var{filename} does not include a directory part.
On GNU and Unix systems, a string returned by this function always
-ends in a slash. On MS-DOS it can also end in a colon. On VMS, it
-returns a string ending in one of the three characters @samp{:},
address@hidden, or @samp{>}.
+ends in a slash. On MS-DOS it can also end in a colon.
@example
@group
@@ -1626,10 +1614,6 @@
(file-name-directory "foo") ; @r{Unix example}
@result{} nil
@end group
address@hidden
-(file-name-directory "[X]FOO.TMP") ; @r{VMS example}
- @result{} "[X]"
address@hidden group
@end example
@end defun
@@ -1649,11 +1633,6 @@
(file-name-nondirectory "lewis/")
@result{} ""
@end group
address@hidden
-;; @r{The following example is accurate only on VMS.}
-(file-name-nondirectory "[X]FOO.TMP")
- @result{} "FOO.TMP"
address@hidden group
@end example
@end defun
@@ -1678,11 +1657,6 @@
(file-name-sans-versions "~rms/foo")
@result{} "~rms/foo"
@end group
address@hidden
-;; @r{The following example applies to VMS only.}
-(file-name-sans-versions "foo;23")
- @result{} "foo"
address@hidden group
@end example
@end defun
@@ -1758,12 +1732,11 @@
or a tilde (@samp{~}), and a relative one does not. On MS-DOS and
MS-Windows, an absolute file name starts with a slash or a backslash, or
with a drive specification @address@hidden:/}, where @var{x} is the
address@hidden letter}. The rules on VMS are complicated.
address@hidden letter}.
@defun file-name-absolute-p filename
This function returns @code{t} if file @var{filename} is an absolute
-file name, @code{nil} otherwise. On VMS, this function understands both
-Unix syntax and VMS syntax.
+file name, @code{nil} otherwise.
@example
@group
@@ -1819,8 +1792,8 @@
same as the usual Unix terminology.) These two different names for
the same entity are related by a syntactic transformation. On GNU and
Unix systems, this is simple: a directory name ends in a slash,
-whereas the directory's name as a file lacks that slash. On MS-DOS and
-VMS, the relationship is more complicated.
+whereas the directory's name as a file lacks that slash. On MS-DOS
+the relationship is more complicated.
The difference between a directory name and its name as a file is
subtle but crucial. When an Emacs variable or function argument is
@@ -1836,8 +1809,7 @@
This function returns a string representing @var{filename} in a form
that the operating system will interpret as the name of a directory. On
most systems, this means appending a slash to the string (if it does not
-already end in one). On VMS, the function converts a string of the form
address@hidden to the form @file{[X.Y]}.
+already end in one).
@example
@group
@@ -1851,8 +1823,7 @@
This function returns a string representing @var{dirname} in a form that
the operating system will interpret as the name of a file. On most
systems, this means removing the final slash (or backslash) from the
-string. On VMS, the function converts a string of the form @file{[X.Y]}
-to @file{[X]Y.DIR.1}.
+string.
@example
@group
@@ -2037,7 +2008,7 @@
@code{expand-file-name} uses the default directory when its second
argument is @code{nil}.
-Aside from VMS, the value is always a string ending with a slash.
+The value is always a string ending with a slash.
@example
@group
@@ -2097,8 +2068,6 @@
@end group
@end example
-On VMS, @samp{$} substitution is not done, so this function does nothing
-on VMS except discard superfluous initial components as shown above.
@end defun
@node Unique File Names
@@ -2417,11 +2386,6 @@
of file-attributes}).
@end defun
address@hidden file-name-all-versions file dirname
-This function returns a list of all versions of the file named
address@hidden in directory @var{dirname}. It is only available on VMS.
address@hidden defun
-
@defun file-expand-wildcards pattern &optional full
This function expands the wildcard pattern @var{pattern}, returning
a list of file names that match it.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/doc/lispref/files.texi,v,
Dan Nicolaescu <=