mcleverdon forgot interface

Author: Michael Cleverdon

RazorEngineCore/IRazorEngineCompilationOptionsBuilder.cs

@@ -8,12 +8,53 @@ public interface IRazorEngineCompilationOptionsBuilder
     {
         RazorEngineCompilationOptions Options { get; set; }
 
+        /// <summary>
+        /// Loads the Assembly by name and adds it to the Engine's Assembly Reference list
+        /// </summary>
+        /// <param name="assemblyName">Full Name of the Assembly to add to the assembly list</param>
         void AddAssemblyReferenceByName(string assemblyName);
+
+        /// <summary>
+        /// Adds a loaded assembly to the Engine's Assembly Reference list
+        /// </summary>
+        /// <param name="assembly">Assembly to add to the assembly list</param>
         void AddAssemblyReference(Assembly assembly);
+
+        /// <summary>
+        /// <para>Adds a type's assembly to the Engine's Assembly Reference list</para>
+        /// <para>Also adds the type's GenericTypeArguments to the Reference list as well</para>
+        /// </summary>
+        /// <param name="type">The type who's assembly should be added to the assembly list</param>
         void AddAssemblyReference(Type type);
+
+        /// <summary>
+        /// Adds a MetadataReference for use in the Engine's Assembly Reference generation
+        /// </summary>
+        /// <param name="reference">Metadata Reference to add to the Engine's Referenced Assemblies</param>
         void AddMetadataReference(MetadataReference reference);
+        
+        /// <summary>
+            /// <para>Adds a default <c>using</c> to the compiled view. This is equivalent to adding <c>@using [NAMESPACE]</c> to every template rendered by the engine'</para>
+            /// Current Defaults: 
+            /// <list type="bullet">
+            ///     <listheader></listheader>
+            ///     <item>System.Linq</item>
+            ///     <item>System.Collections</item>
+            ///     <item>System.Collections.Generic</item>
+            /// </list>
+        /// </summary>
+        /// <param name="namespaceName">Namespace to add to default usings</param>
         void AddUsing(string namespaceName);
+        
+        /// <summary>
+        /// Adds <c>@inherits</c> directive to the compiled template
+        /// </summary>
+        /// <param name="type">Type to <c>@inherits</c> from</param>
         void Inherits(Type type);
+
+        /// <summary>
+        /// Enables debug info
+        /// </summary>
         void IncludeDebuggingInfo();
     }
 }

RazorEngineCore/RazorEngineCompilationOptionsBuilder.cs

@@ -59,7 +59,7 @@ public void AddMetadataReference(MetadataReference reference)
         }
 
         /// <summary>
-            /// <para>Adds a default <c>using</c> to the compiled view. This is equivalent to adding <c>@using [NAMESPACE]</c> to every template rendered by the engine'</para>
+            /// <para>Adds a default <c>using</c> to the compiled view. This is equivalent to adding <c>@using [NAMESPACE]</c> to the template rendered by the engine'</para>
             /// Current Defaults: 
             /// <list type="bullet">
             ///     <listheader></listheader>
@@ -75,9 +75,9 @@ public void AddUsing(string namespaceName)
         }
 
         /// <summary>
-        /// Adds type to @inherit from in the template
+        /// Adds <c>@inherits</c> directive to the compiled template
         /// </summary>
-        /// <param name="type">Type to @inherit from</param>
+        /// <param name="type">Type to <c>@inherits</c> from</param>
         public void Inherits(Type type)
         {
             this.Options.Inherits = this.RenderTypeName(type);