X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=mcs%2Fclass%2FREADME;h=efebe9ad5a9acc314ec75efbb1ffda5a9fb1ba7f;hb=844983bf87468ee3fc786ce8a6f8c7aeedb1f09a;hp=15209b481b3bad29cf92eb85a71b5b626d2adcd3;hpb=a8940d7f4110c0148c5cc3e24d2fc7e097a10f27;p=mono.git

diff --git a/mcs/class/README b/mcs/class/README
index 15209b481b3..efebe9ad5a9 100644
--- a/mcs/class/README
+++ b/mcs/class/README
@@ -25,10 +25,20 @@ testing.
 		throw new NotImplementedException ();
 	}
 
-* Supporting both .NET 1.2, .NET 1.1 and .NET 1.0 builds
+	Ideally, write a human description of the reason why there is
+	a MonoTODO, this will be useful in the future for our
+	automated tools that can assist in developers porting their
+	code.
 
-	The defines NET_1_1 and NET_1_2 are used to include
-	features.   When NET_1_2 is defined, it also implies that the
+	Do not use MonoTODO attributes for reminding yourself of
+	internal changes that must be done. Use FIXMEs or other kinds
+	of comments in the source code for that purpose, and if the
+	problem requires to be followed up on, file a bug.
+
+* Supporting .NET 1.2, .NET 1.1 and .NET 1.0 builds
+
+	The defines NET_1_1 and NET_2_0 are used to include
+	features.   When NET_2_0 is defined, it also implies that the
 	NET_1_1 is defined.
 
 	To have code which is only available in an old version, use ONLY_1_0,
@@ -224,6 +234,45 @@ testing.
 				void Method (string lpstrArgument)
 				void Method (string my_string)
 
+		* Empty methods: They should have the body of code using two 	
+		  lines, in consistency with the rest:
+
+			good:
+				void EmptyMethod ()
+				{
+				}
+
+			bad:
+				void EmptyMethod () {}
+
+				void EmptyMethod () 
+				{}
+		
+		* Line length: The line length for C# source code is 134 columns.
+
+
+		  If your function declaration arguments go beyond
+		  this point, please align your arguments to match the
+		  opening brace, like this:
+
+	 		void Function (int arg, string argb,
+	 			       int argc)
+	 		{
+	 		}
+	 
+	  	  When invoking functions, the rule is different, the
+		  arguments are not aligned with the previous
+		  argument, instead they begin at the tabbed position,
+		  like this:
+	  
+			void M ()
+			{
+				MethodCall ("Very long string that will force",
+					"Next argument on the 8-tab pos",
+					"Just like this one")
+		
+			}
+		
 	Here are a couple of examples:
 
 class X : Y {