diff options
Diffstat (limited to 'tools/NUnit/doc/installation.html')
-rw-r--r-- | tools/NUnit/doc/installation.html | 126 |
1 files changed, 126 insertions, 0 deletions
diff --git a/tools/NUnit/doc/installation.html b/tools/NUnit/doc/installation.html new file mode 100644 index 0000000..0153a93 --- /dev/null +++ b/tools/NUnit/doc/installation.html @@ -0,0 +1,126 @@ +<!-- saved from url=(0014)about:internet --><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> +<html> +<!-- Standard Head Part --> +<head> +<title>NUnit - Installation</title> +<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> +<meta http-equiv="Content-Language" content="en-US"> +<link rel="stylesheet" type="text/css" href="nunit.css"> +<link rel="shortcut icon" href="favicon.ico"> +</head> +<!-- End Standard Head Part --> + +<body> + +<!-- Standard Header for NUnit.org --> +<div id="header"> + <a id="logo" href="http://www.nunit.org"><img src="img/logo.gif" alt="NUnit.org" title="NUnit.org"></a> + <div id="nav"> + <a href="http://www.nunit.org">NUnit</a> + <a class="active" href="index.html">Documentation</a> + </div> +</div> +<!-- End of Header --> + +<div id="content"> + +<h2>Installation</h2> +<p>By default the <b>NUnit</b> installation program places all of the files into the + <b>C:\Program Files\NUnit 2.5.5</b> directory. + In the installation directory there are up to four sub-directories: net-1.1, + net-2.0, doc, and samples. The actual number depends on what the user has + chosen to install. Source code is no + longer provided with the binary installation package. Download the source + package if source is needed. +<h3>Running NUnit</h3> +<p>The installation program places a number of shortcuts in the start menu, which + run NUnit under .NET or Mono, depending on what is installed on your system. + For NUnit 2.5, the gui only runs under version 2.0 of the CLR, although tests + may be executed under other versions using a separate process. + +<h3>Configuration</h3> +<p>When running NUnit from the command line or through the desktop shortcut, the + configuration files files nunit.exe.config and nunit-console.exe.config control + the operation of NUnit itself. + Settings that you place in these files are not available to your tests or to the + production code you are testing. +<p>A separate config file is used for your tests themselves. + If you are running tests from the test.dll assembly, the config file + should be named test.dll.config. If you are running tests from the NUnit test + project MyTests.nunit, the config file should be named MyTests.config. In + either case the config file must reside in the same directory as the file from + which it takes its name.</p> +<p>In addition to settings of your own, the config file for a set of tests may + contain information used by NUnit in loading your tests. In particular, this + allows you to control the apartment state and priority of the thread that NUnit + uses to run your tests. Other settings may be added in the future.</p> +<p>See the <a href="configFiles.html">Configuration Files</a> + page for further information on configuration.</p> + +<h3>Installation Verification</h3> +<p>NUnit's own tests are available as an installation option. If you installed +the tests, you may verify that the installation has worked successfully by +running the NUnit gui and loading and running NUnitTests.nunit. All tests should pass. +<div class="screenshot-left"> + <img src="img/gui-verify.jpg"></div> +<p> +<p><b>Note:</b> Although the NUnit installation has been modified to allow non-admin + users to install, there are still a large number of tests which can only run + successfully under an administrative id. This is a problem with the code in + the tests themselves, not with NUnit.</p> +<h3>Timing Tests</h3> +<p>The assembly timing-tests.dll contains several tests that measure the performance of + NUnit in loading tests. In addition, it contains some long-running tests that are used + to verify that all remoting timeout problems have been fixed. The test cases + all run for six to 12 minutes and give no indication whatsoever that they are + working! This is required since correct handling of a non-communicative user + test is what these tests are all about.</p> +<h3>Additional Tests</h3> +<p>Additional tests are included with the samples and in separate assemblies used + as data by the verification tests themselves. Failures or not run conditions in + these tests are intentional.</p> + +<h3>Manual Installation</h3> + +<p>You may build NUnit from source using one of the Visual Studio solutions or + the NAnt script. In either case, an output directory is created, which + contains all files needed in the proper relative location. Just copy this + directory to a permanent location and create shortcuts if desired. + +</div> + +<!-- Submenu --> +<div id="subnav"> +<ul> +<li><a href="index.html">NUnit 2.5.5</a></li> +<ul> +<li><a href="getStarted.html">Getting Started</a></li> +<ul> +<li><a href="quickStart.html">Quick Start</a></li> +<li id="current"><a href="installation.html">Installation</a></li> +<ul> +<li><a href="upgrade.html">Upgrading</a></li> +</ul> +</ul> +<li><a href="assertions.html">Assertions</a></li> +<li><a href="constraintModel.html">Constraints</a></li> +<li><a href="attributes.html">Attributes</a></li> +<li><a href="runningTests.html">Running Tests</a></li> +<li><a href="extensibility.html">Extensibility</a></li> +<li><a href="releaseNotes.html">Release Notes</a></li> +<li><a href="samples.html">Samples</a></li> +<li><a href="license.html">License</a></li> +</ul> +</ul> +</div> +<!-- End of Submenu --> + + +<!-- Standard Footer for NUnit.org --> +<div id="footer"> + Copyright © 2009 Charlie Poole. All Rights Reserved. +</div> +<!-- End of Footer --> + +</body> +</html> |