add example placeholders and clean up some signature files (#12161)

src/fsharp/FSharp.Core/Linq.fsi

@@ -16,10 +16,12 @@ open Microsoft.FSharp.Quotations
 ///   Library functionality associated with converting F# quotations to .NET LINQ expression trees.
 /// </summary></namespacedoc>
 module LeafExpressionConverter =
+    /// <summary>
     /// When used in a quotation, this function indicates a specific conversion
     /// should be performed when converting the quotation to a LINQ expression. 
     ///
     /// This function should not be called directly. 
+    /// </summary>
     //
     // NOTE: when an F# expression tree is converted to a Linq expression tree using ToLinqExpression 
     // the transformation of <c>LinqExpressionHelper(e)</c> is the same as the transformation of
@@ -29,36 +31,60 @@ module LeafExpressionConverter =
     //[<System.Obsolete("This type is for use by the quotation to LINQ expression tree converter and is not for direct use from user code")>]
     val ImplicitExpressionConversionHelper : 'T -> Expression<'T>
 
+    /// <summary>
     /// When used in a quotation, this function indicates a specific conversion
     /// should be performed when converting the quotation to a LINQ expression. 
     ///
     /// This function should not be called directly. 
+    /// </summary>
     //[<System.Obsolete("This type is for use by the quotation to LINQ expression tree converter and is not for direct use from user code")>]
     val MemberInitializationHelper : 'T ->  'T
 
+    /// <summary>
     /// When used in a quotation, this function indicates a specific conversion
     /// should be performed when converting the quotation to a LINQ expression. 
     ///
     /// This function should not be called directly. 
+    /// </summary>
     //[<System.Obsolete("This type is for use by the quotation to LINQ expression tree converter and is not for direct use from user code")>]
     val NewAnonymousObjectHelper : 'T ->  'T
 
+    /// <summary>
     /// Converts a subset of F# quotations to a LINQ expression, for the subset of LINQ expressions represented by the
     /// expression syntax in the C# language.
+    /// </summary>
+    /// 
+    /// <example-tbd></example-tbd>
     val QuotationToExpression : Expr -> Expression
 
+    /// <summary>
     /// Converts a subset of F# quotations to a LINQ expression, for the subset of LINQ expressions represented by the
     /// expression syntax in the C# language. 
+    /// </summary>
+    /// 
+    /// <example-tbd></example-tbd>
     val QuotationToLambdaExpression : Expr<'T> -> Expression<'T>
 
+    /// <summary>
     /// Evaluates a subset of F# quotations by first converting to a LINQ expression, for the subset of LINQ expressions represented by the
     /// expression syntax in the C# language.
+    /// </summary>
+    /// 
+    /// <example-tbd></example-tbd>
     val EvaluateQuotation : Expr -> obj
 
+    /// <summary>
     /// A runtime helper used to evaluate nested quotation literals.
+    /// </summary>
+    /// 
+    /// <example-tbd></example-tbd>
     val SubstHelper : Expr * Var[] * obj[] -> Expr<'T>
 
+    /// <summary>
     /// A runtime helper used to evaluate nested quotation literals.
+    /// </summary>
+    /// 
+    /// <example-tbd></example-tbd>
     val SubstHelperRaw : Expr * Var[] * obj[] -> Expr
 
     val internal (|SpecificCallToMethod|_|) : System.RuntimeMethodHandle -> (Expr -> (Expr option * Type list * Expr list) option)

src/fsharp/FSharp.Core/QueryExtensions.fs

@@ -283,5 +283,3 @@ module internal Adapters =
             tipf expr
 
     let MakeSeqConv conv = match conv with NoConv -> NoConv | _ -> SeqConv conv
-
-

src/fsharp/FSharp.Core/result.fsi

@@ -11,10 +11,13 @@ namespace Microsoft.FSharp.Core
     module Result =
 
         /// <summary><c>map f inp</c> evaluates to <c>match inp with Error e -> Error e | Ok x -> Ok (f x)</c>.</summary>
+        ///
         /// <param name="mapping">A function to apply to the OK result value.</param>
         /// <param name="result">The input result.</param>
         ///
         /// <returns>A result of the input value after applying the mapping function, or Error if the input is Error.</returns>
+        /// 
+        /// <example-tbd></example-tbd>
         [<CompiledName("Map")>]
         val map : mapping:('T -> 'U) -> result:Result<'T, 'TError> -> Result<'U, 'TError>
 
@@ -24,6 +27,8 @@ namespace Microsoft.FSharp.Core
         /// <param name="result">The input result.</param>
         ///
         /// <returns>A result of the error value after applying the mapping function, or Ok if the input is Ok.</returns>
+        /// 
+        /// <example-tbd></example-tbd>
         [<CompiledName("MapError")>]
         val mapError: mapping:('TError -> 'U) -> result:Result<'T, 'TError> -> Result<'T, 'U>
 
@@ -34,5 +39,7 @@ namespace Microsoft.FSharp.Core
         /// <param name="result">The input result.</param>
         ///
         /// <returns>A result of the output type of the binder.</returns>
+        /// 
+        /// <example-tbd></example-tbd>
         [<CompiledName("Bind")>]
         val bind: binder:('T -> Result<'U, 'TError>) -> result:Result<'T, 'TError> -> Result<'U, 'TError>