1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/content/media/webaudio/blink/README Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,24 @@
1.4 +This directory contains the code originally borrowed from the Blink Web Audio
1.5 +implementation. We are forking the code here because in many cases the burden
1.6 +of adopting Blink specific utilities is too large compared to the prospect of
1.7 +importing upstream fixes by just copying newer versions of the code in the
1.8 +future.
1.9 +
1.10 +The process of borrowing code from Blink is as follows:
1.11 +
1.12 +* Try to borrow utility classes only, and avoid borrowing code which depends
1.13 + too much on the Blink specific utilities.
1.14 +* First, import the pristine files from the Blink repository before adding
1.15 + them to the build system, noting the SVN revision of Blink from which the
1.16 + original files were copied in the commit message.
1.17 +* In a separate commit, add the imported source files to the build system,
1.18 + and apply the necessary changes to make it build successfully.
1.19 +* Use the code in a separate commit.
1.20 +* Never add headers as exported headers. All headers should be included
1.21 + using the following convention: #include "blink/Header.h".
1.22 +* Leave the imported code in the WebCore namespace, and import the needed
1.23 + names into the Mozilla code via `using'.
1.24 +* Cherry-pick upsteam fixes manually when needed. In case you fix a problem
1.25 + that is not Mozilla specific locally, try to upstream your changes into
1.26 + Blink.
1.27 +* Ping ehsan for any questions.
