summaryrefslogtreecommitdiff
path: root/dotnet/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'dotnet/README.txt')
-rw-r--r--dotnet/README.txt61
1 files changed, 29 insertions, 32 deletions
diff --git a/dotnet/README.txt b/dotnet/README.txt
index 1c0be05c11..0199ad6410 100644
--- a/dotnet/README.txt
+++ b/dotnet/README.txt
@@ -1,61 +1,58 @@
Info
====
-AMQP version currently 0.8 (see /Qpid.Common/amqp.xml)
+There are two separate .NET clients: one that implements AMQP 0-8 (and
+can communicate with the Java broker) and another that implements
+0-10 (and can communicate with the C++ broker).
+This README contains instructions for building the 0-8 client.
+
+Instructions for building and installing the 0-10 client are located in client-010/README.txt.
Setup
=====
-Install:
- Microsoft Visual Studio 2005 (VS2005)
- NAnt 0.85 - only required for builds outside VS2005 (.net 1.1, .net 2.0, mono 2.0)
- Ant 1.6.5
- Cygwin (or alternatively build via cmd but alter instructions below accordingly)
-
-Set up PATH to include Nant.exe:
+Essential:
- $ PATH=/cygdrive/c/WINDOWS/Microsoft.NET/Framework/v2.0.50727:$PATH
+ .NET 2.0 or later
+ Ant 1.6.5 (Java build tool, http://ant.apache.org)
+
+Either:
+ NAnt 0.85 - only required for builds outside Visual Studio
+OR
+ Microsoft Visual Studio 2008 (VS2008)
+
+Ensure that your PATH includes ant, e.g.:
-Set up PATH to include ant:
+ $ PATH=c:\java\ant\bin:%PATH%
+
+If using nant, set up PATH to include Nant.exe, e.g.:
- $ PATH=$ANT_HOME/bin:$PATH
+ $ set PATH=C:\dotnet\nant\bin;%PATH%
+If using msbuild, it is recommended to use a "Visual Studio Command Prompt"
Building
========
-Generate framing from /Qpid.Common/amqp.xml specificiation file:
+Generate framing from /Qpid.Common/amqp.xml specification file by running this script:
- $ build-framing
+ $ build-framing.bat
Alternatively, just switch to /Qpid.Common and run "ant" there.
-You can build from Visual Studio 2005 normally. Alternatively, you
-can build debug releases for any supported framework from the
-command line using Nant:
-
-To build .NET 2.0 executables (to bin/net-2.0):
-
- $ build-dotnet20
-
-To build .NET 1.1 executables (to bin/net-1.1):
+You can build from Visual Studio 2008 or from the command-line by running msbuild.
- $ build-dotnet11
-
-To build for Mono on Linux (to bin/mono-2.0):
-
- $ build-mono
+The script build-msbuild.bat provides some standard options to do a full build.
+If you are using nant, the script build-nant.bat contains standard arguments that do a full build.
+
+To build for Mono on Linux (to bin/mono-2.0) the build-mono shell script is provided.
Releasing
=========
-For .NET 1.1
-
- $ release net-1.1
-
-Generates ./bin/net-1.1/release/Qpid.NET-net-1.1-yyyyMMdd.zip
+nant can be used to create a release zip archive. A script is provided:
For .NET 2.0