/libs/FSharp-2.0.0.0/doc/README-vfsi.html

https://github.com/pblasucci/Giftee · HTML · 89 lines · 58 code · 31 blank · 0 comment · 0 complexity · ddcb9352f5ceb056663b9b8c71197b82 MD5 · raw file 

    

  1. <html>
    2. 

  2. 

  3. <head>
    4. 

  4. <title>The F# Compiler Version 2.0.0.0</title>
    5. 

  5. 

  6.   <link type="text/css" rel="Stylesheet" href="/rmcstyle.css"><link type="text/css" rel="Stylesheet" href="rmcstyle-copy.css">
    7. 

  7.   <link type="text/css" rel="Stylesheet" href="/groupStyle.css"><link type="text/css" rel="Stylesheet" href="groupStyle-copy.css">
    8. 

  8. 

  9.   <style type="text/css">
    10. 

  10.   TT { font-weight: bold; color: blue; font-size: 10pt; }
    11. 

  11.   PRE { font-weight: bold; color: blue; font-size: 10pt;  }
    12. 

  12.   </style>
    13. 

  13. </head>
    14. 

  14. 

  15. 

  16. <body>
    17. 

  17. 

  18. <h1> Using F# Interactive in Visual Studio</h1>
    19. 

  19. 

  20. <p>
    21. 

  21. If you use Visual Studio 2008 or Visual Studio 2010 (including the
    22. 

  22. freely available <a href="http://www.microsoft.com/downloads/en/details.aspx?familyid=40646580-97FA-4698-B65F-620D4B4B1ED7&displaylang=en">Visual Studio 2008 Shell</a> and 
    23. 

  23. the <a href="http://www.microsoft.com/downloads/en/details.aspx?familyid=8E5AA7B6-8436-43F0-B778-00C3BCA733D3&displaylang=en">Visual Studio 2010 Integrated Shell</a>), 
    24. 

  24. you can use  'F# Interactive' as a tool window!   </p>
    25. 

  25. 

  26. <h4>Starting F# Interactive</h4>
    27. 

  27. 

  28. <p> To start the session, go to the View -> Other Windows and select 'F# Interactive'. You can also start a session
    29. 

  29. simply using <tt>Alt-Return</tt> in an F# source document, or using the shortcut Ctrl+Alt+F.</p>
    30. 

  30. 

  31. 

  32. <h4>Editing and Evaluating a Script</h4>
    33. 

  33. 

  34. <p>You create a script file using File -> New File -> Script -> F# Script File.</p>
    35. 

  35. 

  36. <p> The normal mode of operation is to edit an F# script file and send fragments for execution in the tool window. In
    37. 

  37. this mode, your fragments are typechecked as you type, and you are actively working towards a completed 
    38. 

  38. file that can act as the finished product of your explorative programming. The tool window is then
    39. 

  39. just used for displaying data.</p>
    40. 

  40. 

  41. <p>In the script file, you should use <tt>#r</tt> and <tt>#I</tt> to reference assemblies 
    42. 

  42. and augment your assembly include path.</p>
    43. 

  43. 

  44. 

  45. <p>The session is global to the instance of Visual Studio and text can be sent from any
    46. 

  46. F# source code file (.fs, .fsi, .fsx, .ml, .mli).
    47. 

  47. Use the <tt>Alt-Return</tt> combination to evaluate
    48. 

  48. selected text. For example, highlight <tt>printfn "Hello World"</tt> and use this key combination - the code will then
    49. 

  49. execute.  </p>
    50. 

  50. 

  51. 

  52. <h4>Execution Context for Scripts</h4>
    53. 

  53. 

  54. 

  55. <p>The F# Interactive session executes only those code fragments you direct it to. If you select a fragment from
    56. 

  56. half-way through your script, earlier portions of the script will not be executed implicitly. </p>
    57. 

  57. 

  58. <p>When sending text from a file, file names are resolved relative to the scripts containing the reference.  Visual F# Interactive sets the 
    59. 

  59. line and directory context of the session each time an entry is sent from Visual Studio, though it doesn't
    60. 

  60. adjust the value of <tt>System.Environment.CurrentDirectory</tt>. It can be useful to add  </p>
    61. 

  61. <pre>
    62. 

  62.     System.Environment.CurrentDirectory <- __SOURCE_DIRECTORY__
    63. 

  63. </pre>
    64. 

  64. <p>to your script. <tt>__SOURCE_DIRECTORY</tt> can be used in any F# source file and is expanded to the directory
    65. 

  65. containing the file.</p>
    66. 

  66. 

  67. 

  68. <h4>Organizing Your Scripts</h4>
    69. 

  69. 

  70. <p> Although scripts can be authored without a project, it can be useful to create an F# Project to hold a group of related scripts.  
    71. 

  71. You can do this with <tt>New Project</tt> or by making a copy of one of the projects in 
    72. 

  72. the F# Samples directory. You can also use <tt>#load</tt> to load both signature and implementation files as
    73. 

  73. if they have been compiled as compilation units by the command-line compiler.</p>
    74. 

  74. 

  75. 

  76. <h4>Controlling the Evaluation Session</h4>
    77. 

  77. 

  78. <p>In the tool window, <tt>#quit;;</tt> will quit and Ctrl+C will cancel execution. 
    79. 

  79. The context menu in the tool window includes 
    80. 

  80. "Reset Session" and "Cancel Evaluation" commands.
    81. 

  81. If you do type into the tool window, history is available with the up/down arrows.  </p>
    82. 

  82. 

  83. 

  84. <p> To troubleshoot, see README-fsharp.html</p>
    85. 

  85. 

  86. <p>Please contact fsbugs@microsoft.com with feedback on this documentation.</p>
    87. 

  87. 

  88. </body>
    89. 

  89. </html>
    90.