~james-page/ubuntu/precise/nodejs/0.6.x-merge

« back to all changes in this revision

Viewing changes to deps/v8/tools/visual_studio/README.txt

  • Committer: James Page
  • Date: 2012-03-30 12:09:16 UTC
  • mfrom: (7.1.23 sid)
  • Revision ID: james.page@canonical.com-20120330120916-40hfu9o00qr5t87b
* Merge from Debian unstable:
  - New upstream release (LP: #892034).
  - This package is x86/arm only. Update control to match
  - d/patches/2009_increase_test_timeout.patch: Increased default test
    timeout from 60 to 120 seconds to support reliable execution of all
    tests on armhf/armel architectures.
  - d/patches/2005_expected_failing_tests.patch: 
    - Allow racey tests to fail: test-cluster-kill-workers,
      test-child-process-fork2 
    - Allow test-fs-watch to fail as LP buildd's don't support
      inotify.
    - Revert all other Ubuntu changes as no longer required.
* Update Standards-Version to 3.9.3.
* Patch wscript to enable build on mipsel arch, libv8 being available.
  Upstream does not support that arch, failure expected.
* test-cluster-kill-workers is expected to fail on armhf,
  Bug#660802 will be closed when test pass.
* test-buffer is expected to fail on armel,
  Bug#660800 will be closed when test pass.
* Add epoch to dependency on libev >= 1:4.11. Closes: bug#658441.
* Remove tools/doc because node-doc-generator has no license for now.
* Add copyright for doc/sh* files (shjs).
* source.lintian-overrides : source-contains-waf-binary tools/node-waf
  it is simply not the case here.
* test-stream-pipe-multi expected to timeout sometimes on busy builds. 
* New upstream release.
* Remove upstream patches.
* test-dgram-pingpong expected to timeout, the test itself is buggy.
* test-buffer expected to fail on armel, allow building package to make
  it easier to find the cause of the failure.
  Closes: bug#639636.
* Expect tests dgram-multicast and broadcast to fail.
  debian/patches/2005_expected_failing_tests.patch
* Drop dpkg-source local-options: Defaults since dpkg-source 1.16.1.
* New upstream release.
* Depend on libev-dev 4.11, see bug#657080.
* Bump dependency on openssl to 1.0.0g.
* Remove useless uv_loop_refcount from libuv,
  refreshed 2009_fix_shared_ev.patch.
* Apply to upstream patches landed after 0.6.10 release,
  to fix debugger repl and http client.
* New upstream release. Closes:bug#650661
* Repackage to remove non-dfsg font files ./deps/npm/html/*/*.ttf
* Remove unneeded bundled dependencies: lighter tarball,
  debian/copyright is easier to maintain.
* Drop unneeded build-dependency on scons.
* Depend on zlib1g, libc-ares, libev.
  Patches done to support building with those shared libs.
* Fix DEB_UPSTREAM_URL in debian/rules, and debian/watch.
* nodejs.pc file for pkgconfig is no more available.
* Build-depend on procps package, a test is using /bin/ps.
* Refreshed debian/patches/2005_expected_failing_tests.patch,
  only for tests that need networking.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
This directory contains Microsoft Visual Studio project files for including v8
2
 
in a Visual Studio/Visual C++ Express solution. All these project files have
3
 
been created for use with Microsoft Visual Studio 2005. They can however also
4
 
be used in both Visual Studio 2008 and Visual C++ 2008 Express Edition. When
5
 
using the project files in the 2008 editions minor upgrades to the files will
6
 
be performed by Visual Studio.
7
 
 
8
 
v8_base.vcproj
9
 
--------------
10
 
Base V8 library containing all the V8 code but no JavaScript library code.
11
 
 
12
 
v8.vcproj
13
 
---------
14
 
V8 library containing all the V8 and JavaScript library code embedded as source
15
 
which is compiled as V8 is running.
16
 
 
17
 
v8_mksnapshot.vcproj
18
 
--------------------
19
 
Executable v8_mksnapshot.exe for building a heap snapshot from a running V8.
20
 
 
21
 
v8_snapshot_cc.vcproj
22
 
---------------------
23
 
Uses v8_mksnapshot.exe to generate snapshot.cc, which is used in
24
 
v8_snapshot.vcproj.
25
 
 
26
 
v8_snapshot.vcproj
27
 
------------------
28
 
V8 library containing all the V8 and JavaScript library code embedded as a heap
29
 
snapshot instead of source to be compiled as V8 is running. Using this library
30
 
provides significantly faster startup time than v8.vcproj.
31
 
 
32
 
The property sheets common.vsprops, debug.vsprops and release.vsprops contains
33
 
most of the configuration options and are inhireted by the project files
34
 
described above. The location of the output directory used are defined in
35
 
common.vsprops.
36
 
 
37
 
With regard to Platform SDK version V8 has no specific requriments and builds
38
 
with either what is supplied with Visual Studio 2005 or the latest Platform SDK
39
 
from Microsoft.
40
 
 
41
 
When adding these projects to a solution the following dependencies needs to be
42
 
in place:
43
 
 
44
 
  v8.vcproj depends on v8_base.vcproj
45
 
  v8_mksnapshot.vcproj depends on v8.vcproj
46
 
  v8_snapshot_cc.vcproj depends on v8_mksnapshot.vcproj
47
 
  v8_snapshot.vcproj depends on v8_snapshot_cc.vcproj and v8_base.vcproj
48
 
 
49
 
A project which uses V8 should then depend on v8_snapshot.vcproj.
50
 
 
51
 
If V8 without snapshot if preferred only v8_base.vcproj and v8.vcproj are
52
 
required and a project which uses V8 should depend on v8.vcproj.
53
 
 
54
 
Two sample project files are available as well. These are v8_shell_sample.vcproj
55
 
for building the sample in samples\shell.cc and v8_process_sample.vcproj for
56
 
building the sample in samples\process.cc. Add either of these (or both) to a
57
 
solution with v8_base, v8, v8_mksnapshot and v8_snapshot set up as described
58
 
solution with v8_base, v8, v8_mksnapshot and v8_snapshot set up as described
59
 
above and have them depend on v8_snapshot.
60
 
 
61
 
Finally a sample Visual Studio solution file for is provided. This solution file
62
 
includes the two sample projects together with the V8 projects and with the
63
 
dependencies configured as described above.
64
 
 
65
 
Python requirements
66
 
-------------------
67
 
When using the Microsoft Visual Studio project files Python version 2.4 or later
68
 
is required. Make sure that python.exe is on the path before running Visual
69
 
Studio. The use of Python is in the command script js2c.cmd which is used in the
70
 
Custom Build Step for v8natives.js in the v8.vcproj project.
 
1
The Microsoft Visual Studio project files for including V8 in a Visual
 
2
Studio/Visual C++ Express solution has been retired. If a Visual
 
3
Studio project/solution is needed there is the option of using GYP to
 
4
generate these. Please look in the build directory in the root of the
 
5
V8 project. It contains the required infrastructure and a README.txt
 
6
file explaining how to get started.
 
7
 
 
8
Generating Visual Studio projects using GYP is how the Chromium
 
9
project integrated V8 into the Windows build.
 
10
 
 
11
The main build system for V8 is still SCons, see the V8 wiki page
 
12
http://code.google.com/p/v8/wiki/BuildingOnWindows for details.