add more docs and example for new rename

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

SWIG/CHANGES.current

@@ -70,7 +70,6 @@ Version 1.3.28 (unreleased).
  		   hi, hello  ->  hi, Hello   // match
 		 };
 
-
 		 enum Hi {
  		   hi, hello  ->  hi, hello   // no match
 		 };
@@ -142,6 +141,22 @@ Version 1.3.28 (unreleased).
 	      Use "swig -dump_tree" to see the attributes names you can use to
 	      match an specific case.
 	
+            - Sometimes you need to process the 'source' name before
+              comparing, for example
+
+	        %namewarn("314: empty is a keyword",sourcefmt="%(lower)s") "empty";
+
+	      then if you have
+
+	        int Empty();  // "Empty" is the source 
+		
+	      you will get the keyword warning since 'Empty' will be
+	      lower cased, via the sourcefmt="%(lower)s" option,
+	      before comparing to the 'target' "empty".
+
+	      There is an additional 'targetfmt' option to process the
+	      'target' before comparing.
+      	
 12/30/2005: mmatus
 
 	  - Add initial support for gcj and Java -> <target language> mechanism.

SWIG/Examples/test-suite/php4/namewarn_rename.i

@@ -0,0 +1,13 @@
+%module namewarn_rename
+
+
+%inline %{
+
+  void Empty() {};
+  
+
+  class stdClass 
+  {
+  };
+
+%}