Chromium Code Reviews| Index: dart/runtime/bin/net/README-updating |
| =================================================================== |
| --- dart/runtime/bin/net/README-updating (revision 0) |
| +++ dart/runtime/bin/net/README-updating (revision 0) |
| @@ -0,0 +1,34 @@ |
| +# Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file |
| +# for details. All rights reserved. Use of this source code is governed by a |
| +# BSD-style license that can be found in the LICENSE file. |
| + |
| +The standalone Dart executable uses the NSS library from Mozilla to |
| +support secure networking connections (SSL and TLS). It uses a copy |
| +of the library from the Chromium repository, that includes patches |
| +added by Chromium. We pin this to a fixed revision, using the |
| +nss_revision variable in all the DEPS files in the deps directory of |
| +the Dart repository. |
| + |
| +This revision should be updated when new security fixes are added to |
| +NSS, or every few months. The .gyp files in this directory are copies |
| +of the .gyp files in the Chromium copy of NSS, with changes made to |
| +account for the configurations and directory structure of the Dart |
| +repository. Differences between the Chromium versions and the Dart |
| +versions should be annotated with "# Added by Dart'. |
| + |
| +All the files should have a comment saying where the original file is |
| +in the Chromium repository. To update these files, look at the diff |
| +between the two revisions in Chromium, and apply the changes manually, |
| +with any needed modifications, to the Dart copies. Our aim is to keep |
| +the difference between the Chromium and Dart copies as small as |
| +possible. |
| + |
| +The nss_memio.cc and nss_memio.h files are also taken from Chromium, |
| +and should be updated at the same time. The os_Linux.s file is new, |
| +and should not need changing. |
| + |
| +The file nss.gyp includes support for disabling compilation of NSS |
| +using the variable dart_io_support, when building configurations that |
| +don't use it. NSS compilation is disabled when building Dartium, |
| +because Chromium includes its own copy, and the build process would |
| +get confused. |
|
Søren Gjesse
2014/03/20 14:24:48
Thanks for writing this!
|