[runtime] Updates comments.
[mono.git] / mcs / class / corlib / System.Runtime.Serialization / ISurrogateSelector.cs
index 3747446136b0d788b12bd952362948735a21297e..b4f24fe3af636f2812fb1e5b0f6afff68dcfe130 100644 (file)
@@ -1,63 +1,65 @@
-//\r
-// System.Runtime.Serialization.ISurrogateSelector\r
-//\r
-// Author:\r
-//   David Dawkins (david@dawkins.st)\r
-//\r
-// (C) David Dawkins\r
-//\r
-\r
-//\r
-// Copyright (C) 2004 Novell, Inc (http://www.novell.com)\r
-//\r
-// Permission is hereby granted, free of charge, to any person obtaining\r
-// a copy of this software and associated documentation files (the\r
-// "Software"), to deal in the Software without restriction, including\r
-// without limitation the rights to use, copy, modify, merge, publish,\r
-// distribute, sublicense, and/or sell copies of the Software, and to\r
-// permit persons to whom the Software is furnished to do so, subject to\r
-// the following conditions:\r
-// \r
-// The above copyright notice and this permission notice shall be\r
-// included in all copies or substantial portions of the Software.\r
-// \r
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,\r
-// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\r
-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\r
-// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\r
-// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\r
-// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\r
-// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
-//\r
-\r
-namespace System.Runtime.Serialization {\r
-\r
-       /// <summary>\r
-       /// Creation of serialization surrogate selectors</summary>\r
-       public interface ISurrogateSelector {\r
-\r
-               /// <summary>\r
-               /// Insert specified selector into available surrogates</summary>\r
-               void ChainSelector( ISurrogateSelector selector );\r
-\r
-               /// <summary>\r
-               /// Return next surrogate in the surrogate chain</summary>\r
-               ISurrogateSelector GetNextSelector();\r
-\r
-               /// <summary>\r
-               /// Fetch the surrogate according the specified type, starting\r
-               /// the search from the surrogate selector for the specified\r
-               /// StreamingContext</summary>\r
-               /// <param name="type">Type of the object to be serialized</param>\r
-               /// <param name="context">Context for the serialization/deserialization</para,>\r
-               /// <param name="selector">Upon return, contains a reference to the selector where the returned surrogate was found</param>\r
-               /// <returns>The surrogate for the specified type and context</returns>\r
-               ISerializationSurrogate GetSurrogate(\r
-                       Type type,\r
-                       StreamingContext context,\r
-                       out ISurrogateSelector selector\r
-               );\r
-\r
-       }\r
-\r
-}\r
+//
+// System.Runtime.Serialization.ISurrogateSelector
+//
+// Author:
+//   David Dawkins (david@dawkins.st)
+//
+// (C) David Dawkins
+//
+
+//
+// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
+//
+// Permission is hereby granted, free of charge, to any person obtaining
+// a copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to
+// permit persons to whom the Software is furnished to do so, subject to
+// the following conditions:
+// 
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// 
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace System.Runtime.Serialization {
+
+       /// <summary>
+       /// Creation of serialization surrogate selectors</summary>
+        [System.Runtime.InteropServices.ComVisibleAttribute (true)]
+
+       public interface ISurrogateSelector {
+
+               /// <summary>
+               /// Insert specified selector into available surrogates</summary>
+               void ChainSelector( ISurrogateSelector selector );
+
+               /// <summary>
+               /// Return next surrogate in the surrogate chain</summary>
+               ISurrogateSelector GetNextSelector();
+
+               /// <summary>
+               /// Fetch the surrogate according the specified type, starting
+               /// the search from the surrogate selector for the specified
+               /// StreamingContext</summary>
+               /// <param name="type">Type of the object to be serialized</param>
+               /// <param name="context">Context for the serialization/deserialization</para,>
+               /// <param name="selector">Upon return, contains a reference to the selector where the returned surrogate was found</param>
+               /// <returns>The surrogate for the specified type and context</returns>
+               ISerializationSurrogate GetSurrogate(
+                       Type type,
+                       StreamingContext context,
+                       out ISurrogateSelector selector
+               );
+
+       }
+
+}