michael@0: This directory contains the code originally borrowed from the Blink Web Audio michael@0: implementation. We are forking the code here because in many cases the burden michael@0: of adopting Blink specific utilities is too large compared to the prospect of michael@0: importing upstream fixes by just copying newer versions of the code in the michael@0: future. michael@0: michael@0: The process of borrowing code from Blink is as follows: michael@0: michael@0: * Try to borrow utility classes only, and avoid borrowing code which depends michael@0: too much on the Blink specific utilities. michael@0: * First, import the pristine files from the Blink repository before adding michael@0: them to the build system, noting the SVN revision of Blink from which the michael@0: original files were copied in the commit message. michael@0: * In a separate commit, add the imported source files to the build system, michael@0: and apply the necessary changes to make it build successfully. michael@0: * Use the code in a separate commit. michael@0: * Never add headers as exported headers. All headers should be included michael@0: using the following convention: #include "blink/Header.h". michael@0: * Leave the imported code in the WebCore namespace, and import the needed michael@0: names into the Mozilla code via `using'. michael@0: * Cherry-pick upsteam fixes manually when needed. In case you fix a problem michael@0: that is not Mozilla specific locally, try to upstream your changes into michael@0: Blink. michael@0: * Ping ehsan for any questions.