@@ -501,6 +501,10 @@ public virtual string ExecuteCommand(string command)
501501 /// document with an automatically selected name. This document will be discarded after
502502 /// execution.
503503 /// </para>
504+ /// <para>
505+ /// For information about the types of result values that script code can return, see
506+ /// <see cref="Evaluate(string, bool, string)"/>.
507+ /// </para>
504508 /// </remarks>
505509 public object Evaluate ( string code )
506510 {
@@ -521,6 +525,10 @@ public object Evaluate(string code)
521525 /// If a debugger is attached, it will present the specified script code to the user as a
522526 /// document with the specified name. This document will be discarded after execution.
523527 /// </para>
528+ /// <para>
529+ /// For information about the types of result values that script code can return, see
530+ /// <see cref="Evaluate(string, bool, string)"/>.
531+ /// </para>
524532 /// </remarks>
525533 public object Evaluate ( string documentName , string code )
526534 {
@@ -543,6 +551,85 @@ public object Evaluate(string documentName, string code)
543551 /// document with the specified name. Discarding this document removes it from view but
544552 /// has no effect on the script engine.
545553 /// </para>
554+ /// <para>
555+ /// The following table summarizes the types of result values that script code can return.
556+ /// <list type="table">
557+ /// <listheader>
558+ /// <term>Type</term>
559+ /// <term>Returned As</term>
560+ /// <description>Remarks</description>
561+ /// </listheader>
562+ /// <item>
563+ /// <term><b>String</b></term>
564+ /// <term><see href="http://msdn.microsoft.com/en-us/library/system.string.aspx">System.String</see></term>
565+ /// <description>N/A</description>
566+ /// </item>
567+ /// <item>
568+ /// <term><b>Boolean</b></term>
569+ /// <term><see href="http://msdn.microsoft.com/en-us/library/system.boolean.aspx">System.Boolean</see></term>
570+ /// <description>N/A</description>
571+ /// </item>
572+ /// <item>
573+ /// <term><b>Number</b></term>
574+ /// <term><see href="http://msdn.microsoft.com/en-us/library/system.int32.aspx">System.Int32</see> or <see href="http://msdn.microsoft.com/en-us/library/system.double.aspx">System.Double</see></term>
575+ /// <description>
576+ /// Other numeric types are possible. The exact conversions between script and .NET
577+ /// numeric types are defined by the script engine.
578+ /// </description>
579+ /// </item>
580+ /// <item>
581+ /// <term><b>Null Reference</b></term>
582+ /// <term><c>null</c></term>
583+ /// <description>N/A</description>
584+ /// </item>
585+ /// <item>
586+ /// <term><b>Undefined</b></term>
587+ /// <term><see cref="Undefined"/></term>
588+ /// <description>
589+ /// This represents JavaScript’s
590+ /// <see href="http://msdn.microsoft.com/en-us/library/ie/dae3sbk5(v=vs.94).aspx">undefined</see>,
591+ /// VBScript’s
592+ /// <see href="http://msdn.microsoft.com/en-us/library/f8tbc79x(v=vs.85).aspx">Empty</see>,
593+ /// etc.
594+ /// </description>
595+ /// </item>
596+ /// <item>
597+ /// <term><b>Void</b></term>
598+ /// <term><see cref="VoidResult"/></term>
599+ /// <description>
600+ /// This is returned when script code forwards the result of a host method that returns no value.
601+ /// </description>
602+ /// </item>
603+ /// <item>
604+ /// <term><b>Host Object</b></term>
605+ /// <term>Native .NET type</term>
606+ /// <description>
607+ /// This includes all .NET types not mentioned above, including value types (enums,
608+ /// structs, etc.), and instances of all other classes. Script code can only create
609+ /// these objects by invoking a host method or constructor. They are returned to
610+ /// the host in their native .NET form.
611+ /// </description>
612+ /// </item>
613+ /// <item>
614+ /// <term><b>Script Object</b></term>
615+ /// <term><see href="http://msdn.microsoft.com/en-us/library/system.dynamic.dynamicobject.aspx">System.Dynamic.DynamicObject</see></term>
616+ /// <description>
617+ /// This includes all native script objects that have no .NET representation. C#'s
618+ /// <see href="http://msdn.microsoft.com/en-us/library/dd264741.aspx">dynamic</see>
619+ /// keyword provides a convenient way to access them.
620+ /// </description>
621+ /// </item>
622+ /// <item>
623+ /// <term>Other</term>
624+ /// <term>Unspecified</term>
625+ /// <description>
626+ /// This includes host types and other ClearScript-specific objects intended for
627+ /// script code use only. It may also include language-specific values that the
628+ /// ClearScript library does not support.
629+ /// </description>
630+ /// </item>
631+ /// </list>
632+ /// </para>
546633 /// </remarks>
547634 public object Evaluate ( string documentName , bool discard , string code )
548635 {
0 commit comments