From: Francois-Xavier Coudert <fxcoudert@gcc.gnu.org>
Date: Sun, 16 Aug 2015 12:47:15 +0000 (+0000)
Subject: re PR libfortran/41387 (OPEN, STATUS='NEW' of a symbolic link to a non-existing file... 
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=9f801fd79aca0090598da27d04506ddc65103443;p=gcc.git

re PR libfortran/41387 (OPEN, STATUS='NEW' of a symbolic link to a non-existing file fails.)

	PR fortran/41387
	* gfortran.texi: New section "File operations on symbolic links".

From-SVN: r226923
---

diff --git a/gcc/fortran/ChangeLog b/gcc/fortran/ChangeLog
index d1ead45836a..cede36efbf2 100644
--- a/gcc/fortran/ChangeLog
+++ b/gcc/fortran/ChangeLog
@@ -1,3 +1,8 @@
+2015-08-16  Francois-Xavier Coudert  <fxcoudert@gcc.gnu.org>
+
+	PR fortran/41387
+	* gfortran.texi: New section "File operations on symbolic links".
+
 2015-08-08  Francois-Xavier Coudert  <fxcoudert@gcc.gnu.org>
 
 	PR fortran/67059
diff --git a/gcc/fortran/gfortran.texi b/gcc/fortran/gfortran.texi
index a06c5fc4246..e15d6e6605b 100644
--- a/gcc/fortran/gfortran.texi
+++ b/gcc/fortran/gfortran.texi
@@ -1140,6 +1140,7 @@ might in some way or another become visible to the programmer.
 * Thread-safety of the runtime library::
 * Data consistency and durability::
 * Files opened without an explicit ACTION= specifier::
+* File operations on symbolic links::
 @end menu
 
 
@@ -1345,6 +1346,33 @@ processor dependent.  GNU Fortran behaves as follows:
 @end enumerate
 
 
+@node File operations on symbolic links
+@section File operations on symbolic links
+@cindex file, symbolic link
+
+This section documents the behavior of GNU Fortran for file operations on
+symbolic links, on systems that support them. 
+
+@itemize
+
+@item Results of INQUIRE statements of the ``inquire by file'' form will
+relate to the target of the symbolic link. For example,
+@code{INQUIRE(FILE="foo",EXIST=ex)} will set @var{ex} to @var{.true.} if
+@var{foo} is a symbolic link pointing to an existing file, and @var{.false.}
+if @var{foo} points to an non-existing file (``dangling'' symbolic link).
+
+@item Using the @code{OPEN} statement with a @code{STATUS="NEW"} specifier
+on a symbolic link will result in an error condition, whether the symbolic
+link points to an existing target or is dangling.
+
+@item If a symbolic link was connected, using the @code{CLOSE} statement
+with a @code{STATUS="DELETE"} specifier will cause the symbolic link itself
+to be deleted, not its target.
+
+@end itemize
+
+
+
 @c ---------------------------------------------------------------------
 @c Extensions
 @c ---------------------------------------------------------------------