add more docs

git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/trunk/SWIG@6620 626c5289-ae23-0410-ae9c-e8d60b6d4f22

Lib/common.swg

@@ -27,20 +27,32 @@
 
 #define SWIGRUNTIME(x) static x
 
+#ifndef SWIGINLINE
 #if defined(__cplusplus) || defined(__GNUC__)
 #  define SWIGINLINE inline
 #else
 #  define SWIGINLINE
 #endif
+#endif
 
 /* 
-   needed at Swig_cfunction_call/Swig_cmethod_call (cwrap.c) when
+   SWIG_TEMPLATE_DISAMBIGUATOR is needed when wrapping template calls
-   using template calls
+   (cwrap.c:Swig_cfunction_call/Swig_cmethod_call), as in
+
+     result = nspace::template function<int >(arg1);
+     result = arg1->template method<int >(arg2);
+
+    SWIG_TEMPLATE_DISAMBIGUATOR is compiler dependent (common.swg),
+      - SUN Studio requires 'template', 
+      - gcc-3.4 forbids the use of 'template'.
+      - gcc-3.2.3 produces internal errors if you use 'template'
 */
-#if defined(__SUNPRO_CC) 
+#ifndef SWIG_TEMPLATE_DISAMBIGUATOR
-#define SWIG_TEMPLATE_DISAMBIGUATOR template
+#  if defined(__SUNPRO_CC) 
-#else
+#    define SWIG_TEMPLATE_DISAMBIGUATOR template
-#define SWIG_TEMPLATE_DISAMBIGUATOR 
+#  else
+#    define SWIG_TEMPLATE_DISAMBIGUATOR 
+#  endif
 #endif
 
 /* This should only be incremented when either the layout of swig_type_info changes,