aboutsummaryrefslogtreecommitdiff
path: root/gcc/doc
diff options
context:
space:
mode:
authorZack Weinberg <zack@gcc.gnu.org>2003-07-03 04:24:01 +0000
committerZack Weinberg <zack@gcc.gnu.org>2003-07-03 04:24:01 +0000
commit3dce14083fc35cc2b60906577cf797e0ae49f1b8 (patch)
tree37ea22037f920e97ce155abc8dd8f4290af8dba6 /gcc/doc
parentbacb96b24f038ebc8072abfcdb145ff6568a8554 (diff)
downloadgcc-3dce14083fc35cc2b60906577cf797e0ae49f1b8.zip
gcc-3dce14083fc35cc2b60906577cf797e0ae49f1b8.tar.gz
gcc-3dce14083fc35cc2b60906577cf797e0ae49f1b8.tar.bz2
system.h: Include filenames.h.
* system.h: Include filenames.h. (IS_DIR_SEPARATOR, IS_ABSOLUTE_PATHNAME): Don't define. (DIR_SEPARATOR, DIR_SEPARATOR_2): If not already defined, define based on HAVE_DOS_BASED_FILE_SYSTEM. * config/i386/xm-cygwin.h, config/i386/xm-djgpp.h * config/i386/xm-mingw32.h: Don't define HAVE_DOS_BASED_FILE_SYSTEM, DIR_SEPARATOR, or DIR_SEPARATOR_2. * doc/hostconfig.texi: Update to match. * cppfiles.c, gcc.c, gensupport.c, protoize.c, config/i386/cygwin.h: Use IS_ABSOLUTE_PATH throughout. * gcc.c (DIR_UP): Delete, unused. * protoize.c (IS_SAME_PATH): Define in terms of FILENAME_CMP. (is_abspath): Delete. java: * jcf-path.c: Don't default-define PATH_SEPARATOR nor DIR_SEPARATOR. Use FILENAME_CMP. * jcf-write.c: Don't default-define DIR_SEPARATOR. * jcf.h: Delete COMPARE_FILENAMES definition. From-SVN: r68863
Diffstat (limited to 'gcc/doc')
-rw-r--r--gcc/doc/hostconfig.texi49
1 files changed, 27 insertions, 22 deletions
diff --git a/gcc/doc/hostconfig.texi b/gcc/doc/hostconfig.texi
index c13d364..626a893 100644
--- a/gcc/doc/hostconfig.texi
+++ b/gcc/doc/hostconfig.texi
@@ -47,35 +47,40 @@ common thing to do in this hook is to detect stack overflow.
@cindex configuration file
@cindex @file{xm-@var{machine}.h}
-GCC supports some filesystems that are very different to standard Unix
-filesystems. These macros, defined in @file{xm-@var{machine}.h},
-let you choose.
+GCC needs to know a number of things about the semantics of the host
+machine's filesystem. Filesystems with Unix and MS-DOS semantics are
+automatically detected. For other systems, you can define the
+following macros in @file{xm-@var{machine}.h}.
@ftable @code
-@item VMS
-Define this macro if the host system is VMS@.
-
@item HAVE_DOS_BASED_FILE_SYSTEM
-Define this macro if the host file system obeys the semantics defined by
-MS-DOS instead of Unix. DOS file systems are case insensitive, file
-specifications may begin with a drive letter, and both forward slash and
-backslash (@samp{/} and @samp{\}) are directory separators. If you
-define this macro, you probably need to define the next three macros too.
-
-@item PATH_SEPARATOR
-If defined, this macro should expand to a character constant specifying
-the separator for elements of search paths. The default value is a
-colon (@samp{:}). DOS-based systems usually use semicolon (@samp{;}).
+This macro is automatically defined by @file{system.h} if the host
+file system obeys the semantics defined by MS-DOS instead of Unix.
+DOS file systems are case insensitive, file specifications may begin
+with a drive letter, and both forward slash and backslash (@samp{/}
+and @samp{\}) are directory separators.
@item DIR_SEPARATOR
@itemx DIR_SEPARATOR_2
If defined, these macros expand to character constants specifying
-separators for directory names within a file specification. They are
-used somewhat inconsistently throughout the compiler. If your system
-behaves like Unix (only forward slash separates pathnames), define
-neither of them. If your system behaves like DOS (both forward and
-backward slash can be used), define @code{DIR_SEPARATOR} to @samp{/}
-and @code{DIR_SEPARATOR_2} to @samp{\}.
+separators for directory names within a file specification.
+@file{system.h} will automatically give them appropriate values on
+Unix and MS-DOS file systems. If your file system is neither of
+these, define one or both appropriately in @file{xm-@var{machine}.h}.
+
+However, operating systems like VMS, where constructing a pathname is
+more complicated than just stringing together directory names
+separated by a special character, should not define either of these
+macros.
+
+@item PATH_SEPARATOR
+If defined, this macro should expand to a character constant
+specifying the separator for elements of search paths. The default
+value is a colon (@samp{:}). DOS-based systems usually, but not
+always, use semicolon (@samp{;}).
+
+@item VMS
+Define this macro if the host system is VMS@.
@item HOST_OBJECT_SUFFIX
Define this macro to be a C string representing the suffix for object