Merge pull request #487 from mayerwin/patch-1
[mono.git] / docs / reactive-extension-bundle.txt
1 With this change, we bundle Reactive Extensions from Microsoft.
2
3 Steps to do:
4
5 - Until we add submodule, check out Rx sources from http://rx.codeplex.com:
6
7         $ cd external
8         $ git clone git://github.com/atsushieno/rx.git
9         $ cd rx
10         $ git checkout rx-oss-v1.0
11         $ cd ../..
12
13   Note that the original repo at rx.codeplex.com will *fail* on Linux!
14   codeplex.codeplex.com/workitem/26133
15   Also note that rx.codeplex.com is huge and takes very long time to checkout.
16
17 - expand rx-mono-changes-3.tar.bz2
18
19         $ tar jxvf rx-mono-changes-3.tar.bz2
20
21 - Apply changes to mcs/class/Makefile:
22
23         $ cd mcs/class
24         $ patch -i add-rx-libs.patch -p3
25         $ cd ../..
26
27 Then it should be done.
28
29 Note that this does not include Mono.Reactive.Testing into the build yet -
30 this library depends on nunit.framework.dll but it wouldn't be built before
31 this assembly is built. This needs to be resolved.
32
33 ** Current Status
34
35 - We don't have Microsoft.Reactive.Testing.dll. Instead, I created an
36   alternative Mono.Reactive.Testing.dll which *mostly* uses MS sources for
37   that assembly but uses NUnit.Framework instead.
38
39   To make it happen, I added a small script that automatically replaces
40   MSTest dependency parts with that for NUnit (replacer.sh under rx tree).
41
42   (We'll also have to rename namespaces and have more source changes, but
43   so far it is to get things runnable.)
44
45 - To check the build sanity, I imported unit tests (as explained above)
46   and it is supposed to run by "make run-test" in Mono.Reactive.Testing
47   directory (the tests were all in one place in MS tests, so I made it
48   in Mono.Reactive.Testing directory instead).
49