gccxml_gem 0.9.3-x86-darwin-11

data/share/gccxml-0.9/MIPSpro/mipspro_defs.cxx

@@ -0,0 +1,63 @@
+#ifdef _BOOL
+D_BOOL _BOOL
+#endif
+#ifdef _EXPLICIT_IS_KEYWORD
+D_EXPLICIT_IS_KEYWORD _EXPLICIT_IS_KEYWORD
+#endif
+#ifdef _LIBC_IN_NAMESPACE_STD_
+D_LIBC_IN_NAMESPACE_STD_ _LIBC_IN_NAMESPACE_STD_
+#endif
+#ifdef _MEMBER_TEMPLATES
+D_MEMBER_TEMPLATES _MEMBER_TEMPLATES
+#endif
+#ifdef _MUTABLE_IS_KEYWORD
+D_MUTABLE_IS_KEYWORD _MUTABLE_IS_KEYWORD
+#endif
+#ifdef _NAMESPACES
+D_NAMESPACES _NAMESPACES
+#endif
+#ifdef _PARTIAL_SPECIALIZATION_OF_CLASS_TEMPLATES
+D_PARTIAL_SPECIALIZATION_OF_CLASS_TEMPLATES _PARTIAL_SPECIALIZATION_OF_CLASS_TEMPLATES
+#endif
+#ifdef _STANDARD_C_PLUS_PLUS
+D_STANDARD_C_PLUS_PLUS _STANDARD_C_PLUS_PLUS
+#endif
+#ifdef _TYPENAME_IS_KEYWORD
+D_TYPENAME_IS_KEYWORD _TYPENAME_IS_KEYWORD
+#endif
+#ifdef _WCHAR_T
+D_WCHAR_T _WCHAR_T
+#endif
+#ifdef _WCHAR_T_IS_KEYWORD
+D_WCHAR_T_IS_KEYWORD _WCHAR_T_IS_KEYWORD
+#endif
+#ifdef __ANSI_CPP__
+D__ANSI_CPP__ __ANSI_CPP__
+#endif
+#ifdef __ARRAY_OPERATORS
+D__ARRAY_OPERATORS __ARRAY_OPERATORS
+#endif
+#ifdef __EDG_ABI_COMPATIBILITY_VERSION
+D__EDG_ABI_COMPATIBILITY_VERSION __EDG_ABI_COMPATIBILITY_VERSION
+#endif
+#ifdef __EDG_RUNTIME_USES_NAMESPACES
+D__EDG_RUNTIME_USES_NAMESPACES __EDG_RUNTIME_USES_NAMESPACES
+#endif
+#ifdef __EDG_VERSION__
+D__EDG_VERSION__ __EDG_VERSION__
+#endif
+#ifdef __EDG__
+D__EDG__ __EDG__
+#endif
+#ifdef __EXCEPTIONS
+D__EXCEPTIONS __EXCEPTIONS
+#endif
+#ifdef __LIBC_MATH_OVERLOAD__
+D__LIBC_MATH_OVERLOAD__ __LIBC_MATH_OVERLOAD__
+#endif
+#ifdef __RTTI
+D__RTTI __RTTI
+#endif
+#ifdef __STDC__
+D__STDC__ __STDC__
+#endif

data/share/gccxml-0.9/Sun/5.8/Cstd.patch

@@ -0,0 +1,156 @@
+diff -r -u old/algorithm new/algorithm
+--- old/algorithm	2009-06-05 10:01:07.000000000 +0200
++++ new/algorithm	2009-06-05 10:01:43.000000000 +0200
+@@ -880,6 +880,11 @@
+                                RandomAccessIterator last, Pointer buffer,
+                                Distance buffer_size, T*, Compare comp);
+ 
++#if !defined(__MINMAX_DEFINED) 
++  template <class T>
++  inline const T& (min)(const T& a, const T& b);
++#endif
++
+   template <class RandomAccessIterator, class Pointer, class Distance, class T>
+   inline void __stable_sort (RandomAccessIterator first,
+                              RandomAccessIterator last,
+diff -r -u old/istream new/istream
+--- old/istream	2009-06-05 10:01:07.000000000 +0200
++++ new/istream	2009-06-05 10:01:43.000000000 +0200
+@@ -67,7 +67,7 @@
+ 
+     _EXPLICIT basic_istream(basic_streambuf<charT, traits> *sb);
+ 
+-    _EXPLICIT basic_istream(EmptyCtor) : basic_ios<charT, traits>(1) {}
++    _EXPLICIT basic_istream(ios_base::EmptyCtor) : basic_ios<charT, traits>(1) {}
+     virtual ~basic_istream();
+ 
+     class sentry 
+@@ -307,7 +307,7 @@
+           }
+           else
+           {
+-            ostream_type* ost = stream.tie();
++            basic_ostream<charT, traits>* ost = stream.tie();
+             if (ost && ost->rdbuf() != sb) 
+               ost->flush();
+ 
+@@ -419,9 +419,11 @@
+         const istream_iterator<T,charT,traits,Distance>& x,
+         const istream_iterator<T,charT,traits,Distance>& y);
+ #else
+-    friend inline bool operator== <> (
++/* SMOSS 29/08/07 inline not allowed in friend declaration */
++    friend /*inline*/ bool operator== <> (
+         const istream_iterator<T,charT,traits,Distance>& x,
+         const istream_iterator<T,charT,traits,Distance>& y);
++/* END SMOSS 29/08/07 inline not allowed in friend declaration */
+ #endif
+   public: 
+     typedef charT char_type;
+diff -r -u old/ostream new/ostream
+--- old/ostream	2009-06-05 10:01:07.000000000 +0200
++++ new/ostream	2009-06-05 10:01:43.000000000 +0200
+@@ -88,7 +88,7 @@
+     typedef basic_ios<charT, traits>               ios_type;
+ 
+     _EXPLICIT basic_ostream(basic_streambuf<charT, traits> *sb);
+-    _EXPLICIT basic_ostream(EmptyCtor) : basic_ios<charT, traits>(1) {}
++    _EXPLICIT basic_ostream(ios_base::EmptyCtor) : basic_ios<charT, traits>(1) {}
+     virtual ~basic_ostream();
+ 
+     class sentry {
+@@ -97,8 +97,7 @@
+       sentry(basic_ostream<charT,traits>& stream)
+         : __stream(stream)                  
+       {  
+-                      
+-        streambuf_type* sb = stream.rdbuf();
++        basic_streambuf<charT, traits>* sb = stream.rdbuf();
+         if ( sb ) {
+           stream.rdbuf()->buffer_mutex_.acquire();
+         }
+diff -r -u old/rw/iterator new/rw/iterator
+--- old/rw/iterator	2009-06-05 10:01:07.000000000 +0200
++++ new/rw/iterator	2009-06-05 10:01:43.000000000 +0200
+@@ -426,10 +426,12 @@
+     friend inline difference_type (std::operator-) (const self& x, const self& y);
+     friend inline self (std::operator+)     (difference_type n, const self& x);
+ #else
+-    friend inline bool operator== <>   (const self& x, const self& y);
+-    friend inline bool operator<  <>   (const self& x, const self& y);
+-    friend inline difference_type operator- <> (const self& x, const self& y);
+-    friend inline self operator+  <>   (difference_type n, const self& x);
++/* SMOSS 29/08/07 removing 'inline' from friend declarations */
++    friend /*inline*/ bool operator== <>   (const self& x, const self& y);
++    friend /*inline*/ bool operator<  <>   (const self& x, const self& y);
++    friend /*inline*/ difference_type operator- <> (const self& x, const self& y);
++    friend /*inline*/ self operator+  <>   (difference_type n, const self& x);
++/* END SMOSS 29/08/07 removing 'inline' from friend declarations */
+ #endif        
+   protected:
+ 
+@@ -581,7 +583,9 @@
+     typedef Reference reference;
+     typedef Pointer pointer;
+ 
+-    friend inline bool operator== <>   (const self& x, const self& y);
++/* SMOSS 29/08/07 removing 'inline' from friend declarations */
++    friend /*inline*/ bool operator== <>   (const self& x, const self& y);
++/* END SMOSS 29/08/07 removing 'inline' from friend declarations */
+         
+   protected:
+ 
+diff -r -u old/streambuf new/streambuf
+--- old/streambuf	2009-06-05 10:01:07.000000000 +0200
++++ new/streambuf	2009-06-05 10:01:43.000000000 +0200
+@@ -927,7 +927,10 @@
+    * int_type snextc()
+    * returns the next character
+    */
+-
++/* SMOSS 29/08/07 Can't use typename in template specializations */
++#ifdef _TYPENAME
++# define _TYPENAME
++#endif
+   inline _TYPENAME basic_streambuf<char, char_traits<char> >::int_type
+   basic_streambuf<char, char_traits<char> >::snextc()
+   {
+@@ -1208,6 +1211,11 @@
+   {
+     return seekpos(sp, which);
+   }
++#ifdef _TYPENAME
++# define _TYPENAME typename
++# undef _OLD_TYPENAME
++#endif
++/* END SMOSS 29/08/07 Can't use typename in template specializations */
+ 
+   /*
+    * basic_streambuf *pubsetbuf(char_type *, streamsize)
+diff -r -u old/string new/string
+--- old/string	2009-06-05 10:01:07.000000000 +0200
++++ new/string	2009-06-05 10:01:43.000000000 +0200
+@@ -797,7 +797,9 @@
+     // Null string ref
+     //
+ #ifndef _RWSTD_NO_STATIC_DEF3
+-    static __SUNW_GLOBAL const __null_ref_type __nullref;
++/* SMOSS 29/08/07 Can't resolve #define __SUNW_GLOBAL __global */
++    static /* __SUNW_GLOBAL */ const __null_ref_type __nullref;
++/* SMOSS 29/08/07 Can't resolve #define __SUNW_GLOBAL __global */
+ #endif
+ 
+     static __string_ref_type * __getNullRep ()
+diff -r -u old/typeinfo new/typeinfo
+--- old/typeinfo	2009-06-05 10:01:07.000000000 +0200
++++ new/typeinfo	2009-06-05 10:01:43.000000000 +0200
+@@ -34,7 +34,8 @@
+ 	// Implementation
+ 	const void* __data;
+ 	type_info(const void*) throw();
+-	friend __Cimpl::__type_info_friend;
++	/* SMOSS 29/08/07 Can't resolve */
++	//friend __Cimpl::__type_info_friend;
+     };
+ 
+     class bad_typeid: public exception {

data/share/gccxml-0.9/Sun/5.8/adapt_headers.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+
+cd `dirname $0`
+
+#########################################
+# Patch STL Headers (Non-STLport)
+#########################################
+
+CC_INCLUDES=`../find_flags "$@" | perl -ne '($a) = m|-I([/a-zA-Z0-9\._-]+/include/CC)|o ; print "$a\n" if $a'`
+
+mkdir -p rw
+
+cp $CC_INCLUDES/typeinfo .
+cp $CC_INCLUDES/Cstd/istream .
+cp $CC_INCLUDES/Cstd/ostream .
+cp $CC_INCLUDES/Cstd/streambuf .
+cp $CC_INCLUDES/Cstd/string .
+cp $CC_INCLUDES/Cstd/algorithm .
+cp $CC_INCLUDES/Cstd/rw/iterator rw/iterator
+
+gpatch -p1 < Cstd.patch
+
+#########################################
+# Patch the standard headers
+#########################################
+
+if [ `uname -r` = "5.10" ]
+then
+  mkdir -p iso
+  cp /usr/include/iso/stdlib_iso.h iso
+  gpatch -p1 < std-5.10.patch
+fi

data/share/gccxml-0.9/Sun/5.8/std-5.10.patch

@@ -0,0 +1,22 @@
+diff -r -u old/iso/stdlib_iso.h new/iso/stdlib_iso.h
+--- old/iso/stdlib_iso.h	Wed May 20 12:02:31 2009
++++ new/iso/stdlib_iso.h	Wed May 20 12:01:23 2009
+@@ -110,8 +110,10 @@
+ extern double atof(const char *);
+ extern int atoi(const char *);
+ extern long int atol(const char *);
++/* SMOSS 29/08/07
+ extern void *bsearch(const void *, const void *, size_t, size_t,
+ 	int (*)(const void *, const void *));
++*/
+ #if __cplusplus >= 199711L
+ extern "C++" {
+ 	void *bsearch(const void *, const void *, size_t, size_t,
+@@ -131,7 +133,6 @@
+ extern size_t mbstowcs(wchar_t *_RESTRICT_KYWD, const char *_RESTRICT_KYWD,
+ 	size_t);
+ extern int mbtowc(wchar_t *_RESTRICT_KYWD, const char *_RESTRICT_KYWD, size_t);
+-extern void qsort(void *, size_t, size_t, int (*)(const void *, const void *));
+ #if __cplusplus >= 199711L
+ extern "C++" {
+ 	void qsort(void *, size_t, size_t, int (*)(const void *, const void *));

data/share/gccxml-0.9/Sun/README

@@ -0,0 +1,8 @@
+Sun CC support contributed by Pierre-Olivier Gaillard
+
+This is a small README file regarding gccxml support for Solaris and Sun CC.
+
+The Sun CC headers are not suitable for GCC and need to be adapted. The modified files may not be redistributed freely. This forces you to perform the following operations:
+ ./<CC-version>/adapt_headers.sh
+
+This will produce corrected header files in the corresponding directory.

data/share/gccxml-0.9/Sun/find_flags

@@ -0,0 +1,51 @@
+#!/bin/sh
+#=============================================================================
+#
+#  Program:   GCC-XML
+#  Module:    $RCSfile: find_flags,v $
+#  Language:  C++
+#  Date:      $Date: 2009-06-09 18:18:01 $
+#  Version:   $Revision: 1.2 $
+#
+#  Copyright (c) 2002 Kitware, Inc., Insight Consortium.  All rights reserved.
+#  See Copyright.txt for details.
+#
+#     This software is distributed WITHOUT ANY WARRANTY; without even 
+#     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
+#     PURPOSE.  See the above copyright notices for more information.
+#
+#=============================================================================
+
+# Find the compiler executable name.
+if test "x$1" = "x" ; then
+  if test "x${CXX}" = "x" ; then
+    CXX=CC
+  fi
+else 
+  CXX="$1"
+  shift
+  CXXFLAGS="$@"
+fi
+
+# Find the compiler version
+CXX_VERSION=`${CXX} -V 2>&1 | awk '{print $4}'`
+[ -z "${CXX_VERSION}" ] && echo "Could not find compiler version" && exit 1
+
+# Compute the script dir
+SCRIPT_DIR=`dirname $0`
+if test "x$SCRIPT_DIR" = "x" ; then SCRIPT_DIR="." ; fi
+SCRIPT_DIR=`cd "$SCRIPT_DIR" ; pwd`
+
+# Compute the version-specific support dir
+CXX_SUPPORT_DIR="$SCRIPT_DIR/$CXX_VERSION"
+
+# Use the version-specific find_flags if available
+if [ -f "$CXX_SUPPORT_DIR/find_flags" ]
+then
+  . "$CXX_SUPPORT_DIR/find_flags"
+else
+  . "$SCRIPT_DIR/find_flags_common"
+fi
+ 
+# Print out the options
+echo $OPTIONS

data/share/gccxml-0.9/Sun/find_flags_common

@@ -0,0 +1,42 @@
+#!/bin/sh
+#=============================================================================
+#
+#  Program:   GCC-XML
+#  Module:    $RCSfile: find_flags_common,v $
+#  Language:  C++
+#  Date:      $Date: 2009-06-09 18:18:01 $
+#  Version:   $Revision: 1.1 $
+#
+#  Copyright (c) 2002 Kitware, Inc., Insight Consortium.  All rights reserved.
+#  See Copyright.txt for details.
+#
+#     This software is distributed WITHOUT ANY WARRANTY; without even 
+#     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
+#     PURPOSE.  See the above copyright notices for more information.
+#
+#=============================================================================
+
+GCCXML_PID="$$"
+cat > "/tmp/gccxml_identify_compiler_args$GCCXML_PID.cc" <<!
+#include <>
+!
+
+# Find the macro definition options.
+MACROS=`${CXX} ${CXXFLAGS} /tmp/gccxml_identify_compiler_args$GCCXML_PID.cc -E -xdumpmacros=defs 2>&1 |
+       awk '{ if ($1 ~ /#define/) printf("-D%s=%s %s %s ",$2,$3,$4,$5) }'` 
+MACROS="-D__cplusplus=199711L -D__STDC__ -D_REENTRANT $MACROS"
+
+# Find the include path options.
+INCLUDES="`echo '' | ${CXX} -v -E ${CXXFLAGS} ~ 2>&1 | perl -ne 'print m|(-I/[/a-zA-Z0-9\._-]+\s*)|og'`"
+INCLUDES="$INCLUDES -I/usr/include"
+
+# Use hacked headers
+if [ -d "$CXX_SUPPORT_DIR" ]; then
+  INCLUDES="-iwrapper\"$CXX_SUPPORT_DIR\" $INCLUDES"
+fi
+
+# Cleanup
+rm -rf "/tmp/gccxml_identify_compiler_args$GCCXML_PID.cc"
+ 
+# Format the options.
+OPTIONS="$MACROS $INCLUDES $SPECIAL"

data/share/gccxml-0.9/gccxml_config

@@ -0,0 +1,2 @@
+GCCXML_COMPILER="/usr/bin/c++"
+GCCXML_CXXFLAGS=""

data/share/gccxml-0.9/gccxml_identify_compiler.cc

@@ -0,0 +1,13 @@
+#if defined(__GNUC__)
+GCCXML_SUPPORT="GCC"
+#elif defined(__sgi) && defined(_COMPILER_VERSION)
+GCCXML_SUPPORT="MIPSpro"
+#elif defined(__INTEL_COMPILER) && (__INTEL_COMPILER >= 700)
+GCCXML_SUPPORT="Intel"
+#elif defined(__SUNPRO_CC)
+GCCXML_SUPPORT="Sun"
+#elif defined(__IBMCPP__)
+GCCXML_SUPPORT="IBM"
+#else
+GCCXML_SUPPORT=""
+#endif

data/share/man/man1/gccxml.1

@@ -0,0 +1,246 @@
+.TH GCC-XML 1 "August 29, 2010" "GCC-XML 0.9.0"
+.SH NAME
+.TP
+.B gccxml
+- Create an XML representation of C++ declarations.
+.SH SYNOPSIS
+.PP
+gccxml [options] <input-file> -fxml=<output-file>
+.SH DESCRIPTION
+.PP
+GCC-XML parses a C++ source file as it is seen by the compiler when it is built.  An easy-to-parse XML representation of the class, function, and namespace declarations is dumped to a specified file.  Full C preprocessing transforms the file into a C++ translation unit as seen by the compiler.  This means that GCC-XML should make use of the same standard library and other header files as the compiler.  GCC-XML can be configured to simulate any of several popular compilers. 
+.SH OPTIONS
+.PP
+The following options are available for running GCC-XML:
+.TP
+.B --copyright
+Print the GCC-XML copyright and exit.
+.TP
+.B --debug
+Print extra debugging information.
+This option causes GCC-XML to print the executable name and command-line arguments used to execute the patched GCC C++ parser.  This is useful when attempting to simulate an unsupported compiler.
+.TP
+.B -fxml=<output-file>
+Specify the XML output file.
+This option is passed directly on to the patched GCC C++ parser.  It enables the XML dump and specifies the output file name.
+.TP
+.B -fxml-start=<xxx>[,...]
+Specify a list of starting declarations.
+This option is passed directly on to the patched GCC C++ parser.  It is meaningful only if -fxml= is also specified.  This specifies a comma-separated list of named starting declarations.  GCC-XML will dump only the subset of the declarations in the translation unit that is reachable through a sequence of source references from one of the specified starting declarations.
+.TP
+.B --gccxml-compiler <xxx>
+Set GCCXML_COMPILER to "xxx".
+.TP
+.B --gccxml-cxxflags <xxx>
+Set GCCXML_CXXFLAGS to "xxx".
+.TP
+.B --gccxml-executable <xxx>
+Set GCCXML_EXECUTABLE to "xxx".
+.TP
+.B --gccxml-cpp <xxx>
+Set GCCXML_CPP to "xxx".
+.TP
+.B --gccxml-config <xxx>
+Set GCCXML_CONFIG to "xxx".
+.TP
+.B --gccxml-root <xxx>
+Set GCCXML_ROOT to "xxx".
+.TP
+.B --gccxml-gcc-options <xxx>
+Read GCC options from file "xxx".
+This option specifies a file from which to read options to pass to the patched GCC C++ parser.  This is useful for specifying a long list of include directories.  Each line in the file becomes one option.  Empty lines and lines beginning in '#' are ignored.
+.TP
+.B --help
+Print full help and exit.
+Full help displays most of the documentation provided by the UNIX man page.  It is provided for use on non-UNIX platforms, but is also convenient if the man page is not installed.
+.TP
+.B --help-html
+Print full help in HTML format.
+This option is used by GCC-XML authors to help produce web pages.
+.TP
+.B --man
+Print a UNIX man page and exit.
+This option is used by GCC-XML authors to generate the UNIX man page.
+.TP
+.B --print
+Print configuration settings and exit.
+GCC-XML has many configuration options to help it simulate another compiler.  Using this option will cause GCC-XML to configure itself as if it were going to parse the C++ source, but stop and print the configuration found.  This is useful for checking the configuration.
+.TP
+.B --preprocess
+Preprocess the input and exit.
+GCC-XML simulates the proprocessor of another compiler.  Using this option will cause GCC-XML to configure itself as if it were going to parse the C++ source, but stop after preprocessing.  This is useful for debugging problems related to simulation of the other compiler.
+.TP
+.B -E
+Alias for --preprocess.
+.TP
+.B --version
+Show program name/version banner and exit.
+.PP
+Other flags, such as -I and -D, are passed on to the patched GCC C++ parser executable.
+.SH SETTINGS
+.PP
+GCC-XML is designed to simulate a compiler's parser while reading C++ source code.  Some configuration settings are needed to determine how to simulate a particular compiler of the user's choice.  The following settings can be used to configure GCC-XML:
+.TP
+.B GCCXML_COMPILER
+The C++ compiler to be simulated.
+GCC-XML will attempt to automatically determine how to simulate the compiler specified by this setting.  The compiler is specified by its executable name (such as "g++").  For Visual Studio, the compiler is specified by "msvc6", "msvc7", "msvc71", or "msvc8" (if "cl" is given, GCC-XML attempts to guess which VS to use).
+.TP
+.B GCCXML_CXXFLAGS
+The flags for the C++ compiler to be simulated.
+The behavior of most compilers can be adjusted by specifying flags on the command line.  When GCC-XML attempts to automatically determine how to simulate a compiler, these flags are taken into consideration.
+.TP
+.B GCCXML_CONFIG
+The configuration file for common settings.
+When non-default settings are often used, it is convenient to write a single file containing them.  When such a file is specified, it will be read to configure any settings that are not yet known.  Each line of the file consists of one assignment of the form KEY="VALUE" (for example, GCCXML_COMPILER="g++").
+.TP
+.B GCCXML_EXECUTABLE
+Specify the patched GCC C++ parser executable.
+The GCC-XML program as seen by the user is actually a front-end that determines the flags needed to configure the patched GCC C++ parser to simulate another compiler.  This setting specifies the real executable to run once the flags have been determined.  Users should rarely need to change this value from its default.
+.TP
+.B GCCXML_CPP
+Specify the GCC C preprocessor executable.
+The GCC-XML program as seen by the user is actually a front-end that determines the flags needed to configure the patched GCC C++ parser to simulate another compiler.  This setting specifies the preprocessor to run with the flags that have been determined for debugging purposes.  Users should rarely need to change this value from its default.
+.TP
+.B GCCXML_ROOT
+The GCC-XML support library directory.
+Since GCC-XML is only one C++ parser, it cannot exactly duplicate the functionality of every compiler it tries to simulate.  Some compilers provide standard headers with code that GCC-XML cannot directly handle.  To work around this limitation, a support library is provided for each compiler.  This consists of a set of header files that are used in place of the compiler's system headers.  These files contain slight tweaks and then include the corresponding real header.  The root of the directory tree containing these support library headers is specified by this setting.  Users should rarely need to change this value from its default.
+.TP
+.B GCCXML_FLAGS
+Flags used to simulate the other compiler.
+When GCC-XML runs the patched GCC C++ parser, these flags are passed to the program to tell it how to simulate a particular compiler.  This setting is usually detected automatically from the other settings, but it can be specified directly by advanced users.  Most users should not attempt to change this value from the automatic configuration.
+.TP
+.B GCCXML_USER_FLAGS
+Additional user flags for compiler simulation.
+When GCC-XML runs the patched GCC C++ parser, these flags are passed in addition to those specified by GCCXML_FLAGS.  This allows advanced users to tweak the compiler simulation while still using the automatic configuration of GCCXML_FLAGS.  Users should rarely need to change this value from its default.
+.PP
+There are several means by which these settings are configured.  They are listed here in order of precedence (highest first):
+.TP
+.B Command-line Options
+Settings can be specified by their corresponding options.
+When a setting's corresponding command-line option is provided, it is used in favor over any other means of configuration.  If GCCXML_CONFIG is set on the command-line, settings are read from the file with precedence just slightly lower than other command-line options.
+.TP
+.B Environment Variables
+Settings are configured by name in the environment.
+Each setting not already known is read from an environment variable with its name.  If GCCXML_CONFIG is set by the environment, settings are read from the file with precedence just slightly lower than other environment variables.
+.TP
+.B Configuration Files
+A search for GCCXML_CONFIG is performed.
+If GCCXML_CONFIG has not yet been set, an attempt is made to find a configuration file automatically.  First, if the file $HOME/.gccxml/config exists, it will be used.  Second, if GCC-XML is being executed from its build directory, a config file from that directory will be used.  Finally, if a config file is found in the installation's support library directory, it will be used.  Once found, any unknown settings are read from the configuration file.
+.TP
+.B Guessing
+Guesses are made based on other settings.
+Once GCCXML_COMPILER has been set, it is used to automatically find the setting for GCCXML_FLAGS.  If it is not set, the "CXX" environment variable is checked as a last-resort to find the compiler setting and determine GCCXML_FLAGS.
+.PP
+Most users should not have to adjust the defaults for these settings.  There is a default GCCXML_CONFIG file provided in the support library directory after installation.  It configures GCC-XML to simulate the compiler that was used to build it.
+.SH COMPILERS
+.PP
+GCC-XML can simulate any of the following compilers:
+.TP
+.B GCC
+Versions 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x
+.TP
+.B Visual C++
+Versions 8, 7.1, 7.0, and 6 (sp5)
+.TP
+.B Borland, Intel, SGI
+formerly supported but no longer tested
+.PP
+The following extra C preprocessor definitions are provided:
+.TP
+.B -D__GCCXML__=MMmmpp
+MM, mm, and pp are the major, minor, and patch versions of GCC-XML.  This preprocessor symbol identifies GCC-XML to the source code as it is preprocessed.  It can be used to enable GCC-XML-specific information.
+.TP
+.B -D__GCCXML_GNUC__=M
+Defined to internal GCC parser major version.
+.TP
+.B -D__GCCXML_GNUC_MINOR__=m
+Defined to internal GCC parser minor version.
+.TP
+.B -D__GCCXML_GNUC_PATCHLEVEL__=p
+Defined to internal GCC parser patchlevel.
+.PP
+Advanced users can simulate other compilers by manually configuring the GCCXML_FLAGS setting.  Contact the mailing list for help.
+.SH METAINFO
+.PP
+GCC-XML has added a new attribute to the legal set of C/C++ attributes.  The attribute is used to attach meta information to C/C++ source code, which will then appear in the XML output.  The syntax for declaring an attribute is as follows:
+.TP
+.B __attribute((gccxml(<string>, <string>, ...)))
+Here <string> is a quoted string.  There must be at least one argument to the 'gccxml' attribute, but there is no upper limit to the total number of arguments.  Each argument is verified to be a string - if a non-string argument is found, the attribute is ignored.
+.PP
+The XML output for the code element that is tagged with the attribute will then contain the following:
+.TP
+.B attributes=" ... gccxml(<string>,<string>,<string> ...) ... "
+The 'attributes' XML attribute contains all attributes applied to the code element.  Each argument of the attribute is printed without enclosing quotes, so if an argument contains the ',' character, the argument will appear to be multiple arguments.
+.PP
+The 'gccxml' attribute can be applied to any declaration including structs, classes, fields, parameters, methods, functions, variables, and typedefs.  The only exception is that GCC's handling of the '__attribute' language element is currently broken for enumerations and constructors with an inlined body.  The 'gccxml' attribute can be used any number of times on a given declaration.
+.PP
+As an example of how this attribute can be used to attach meta information to C++ declarations, consider the following macro:
+.TP
+.B #define _out_    __attribute((gccxml("out")))
+Here '_out_' has been defined to be the gccxml attribute where the first argument is the string "out".  It is recommended that the first argument be used as a unique string name for the type of meta information begin applied.
+.PP
+Now a method declaration can be written as follows:
+.TP
+.B void getInteger(_out_ int& i);
+This will cause the XML output to contain meta information for the '_out_' attribute, in the form "gccxml(out)".
+.PP
+Using the 'gccxml' attribute enables meta information to be included directly within C++ source code, without the need for a custom parser to extract the meta information.  The 'gccxml' attribute is provided for convenience only - there is no guarantee that future versions of GCC will accept the '__attribute' language element in a bug-free manner.
+.SH COPYRIGHT
+.PP
+GCC-XML - XML output for GCC
+
+.PP
+Copyright (c) 2002-2007 Kitware, Inc., Insight Consortium
+
+.PP
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+.TP
+.B  * 
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+.TP
+.B  * 
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+.TP
+.B  * 
+The names of Kitware, Inc., the Insight Consortium, or the names of any consortium members, or of any contributors, may not be used to endorse or promote products derived from this software without specific prior written permission.
+
+.TP
+.B  * 
+Modified source versions must be plainly marked as such, and must not be misrepresented as being the original software.
+
+.PP
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+.PP
+------------------------------------------------------------
+
+.PP
+gccxml_cc1plus - A GCC parser patched for XML dumps of translation units
+
+.PP
+Copyright (c) 2002-2007 Kitware, Inc., Insight Consortium
+
+.PP
+This program 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 of the License, or (at your option) any later version.
+
+.PP
+This program 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.
+
+.PP
+You should have received a copy of the GNU General Public License along with this program; if not, write to the
+  Free Software Foundation, Inc.
+  51 Franklin Street, Fifth Floor
+  Boston, MA  02110-1301  USA
+
+.SH MAILING LIST
+For help and discussion about using gccxml, a mailing list is
+provided at
+.B gccxml@www.gccxml.org.
+Please first read the full documentation at
+.B http://www.gccxml.org
+before posting questions to the list.
+.SH AUTHOR
+This manual page was generated by "gccxml --man".