Moved `Temporary Files' section to filesys.texi.
authorroland <roland>
Tue, 3 Aug 1993 06:02:52 +0000 (06:02 +0000)
committerroland <roland>
Tue, 3 Aug 1993 06:02:52 +0000 (06:02 +0000)
manual/stdio.texi

index 63b5177..3e7ab74 100644 (file)
@@ -27,7 +27,6 @@ representing a communications channel to a file, device, or process.
 * File Positioning::            About random-access streams.
 * Portable Positioning::        Random access on peculiar ANSI C systems.
 * Stream Buffering::            How to control buffering of streams.
-* Temporary Files::             How to open a temporary file.
 * Other Kinds of Streams::      Streams that do not necessarily correspond
                                  to an open file. 
 @end menu
@@ -3131,103 +3130,6 @@ This function is provided for compatibility with old BSD code.  Use
 @code{setvbuf} instead.
 @end deftypefun
 
-
-@node Temporary Files
-@section Temporary Files
-
-If you need to use a temporary file in your program, you can use the
-@code{tmpfile} function to open it.  Or you can use the @code{tmpnam}
-function make a name for a temporary file and then open it in the usual
-way with @code{fopen}.
-
-These facilities are declared in the header file @file{stdio.h}.
-@pindex stdio.h
-
-@comment stdio.h
-@comment ANSI
-@deftypefun {FILE *} tmpfile (void)
-This function creates a temporary binary file for update mode, as if by
-calling @code{fopen} with mode @code{"wb+"}.  The file is deleted
-automatically when it is closed or when the program terminates.  (On
-some other ANSI C systems the file may fail to be deleted if the program
-terminates abnormally).
-@end deftypefun
-
-@comment stdio.h
-@comment ANSI
-@deftypefun {char *} tmpnam (char *@var{result})
-This function constructs and returns a file name that is a valid file
-name and that does not name any existing file.  If the @var{result}
-argument is a null pointer, the return value is a pointer to an internal
-static string, which might be modified by subsequent calls.  Otherwise,
-the @var{result} argument should be a pointer to an array of at least
-@code{L_tmpnam} characters, and the result is written into that array.
-
-It is possible for @code{tmpnam} to fail if you call it too many times.
-This is because the fixed length of a temporary file name gives room for
-only a finite number of different names.  If @code{tmpnam} fails, it
-returns a null pointer.
-@end deftypefun
-
-@comment stdio.h
-@comment ANSI
-@deftypevr Macro int L_tmpnam
-The value of this macro is an integer constant expression that represents
-the minimum allocation size of a string large enough to hold the
-file name generated by the @code{tmpnam} function.
-@end deftypevr
-
-@comment stdio.h
-@comment ANSI
-@deftypevr Macro int TMP_MAX
-The macro @code{TMP_MAX} is a lower bound for how many temporary names
-you can create with @code{tmpnam}.  You can rely on being able to call
-@code{tmpnam} at least this many times before it might fail saying you
-have made too many temporary file names.
-
-With the GNU library, you can create a very large number of temporary
-file names---if you actually create the files, you will probably run out
-of disk space before you run out of names.  Some other systems have a
-fixed, small limit on the number of temporary files.  The limit is never
-less than @code{25}.
-@end deftypevr
-
-@comment stdio.h
-@comment SVID
-@deftypefun {char *} tempnam (const char *@var{dir}, const char *@var{prefix})
-This function generates a unique temporary filename.  If @var{prefix} is
-not a null pointer, up to five characters of this string are used as
-a prefix for the file name.
-
-The directory prefix for the temporary file name is determined by testing
-each of the following, in sequence.  The directory must exist and be
-writable.
-
-@itemize @bullet
-@item
-The environment variable @code{TMPDIR}, if it is defined.
-
-@item
-The @var{dir} argument, if it is not a null pointer.
-
-@item
-The value of the @code{P_tmpdir} macro.
-
-@item
-The directory @file{/tmp}.
-@end itemize
-
-This function is defined for SVID compatibility.
-@end deftypefun
-@cindex TMPDIR environment variable
-
-@comment stdio.h
-@comment SVID
-@c !!! are we putting SVID/GNU/POSIX.1/BSD in here or not??
-@deftypevr {SVID Macro} {char *} P_tmpdir
-This macro is the name of the default directory for temporary files.
-@end deftypevr
-
 @node Other Kinds of Streams
 @section Other Kinds of Streams