Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(8)

Unified Diff: packages/browser/README.md

Issue 1400473008: Roll Observatory packages and add a roll script (Closed) Base URL: git@github.com:dart-lang/observatory_pub_packages.git@master
Patch Set: Created 5 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « packages/browser/LICENSE ('k') | packages/browser/lib/dart.js » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: packages/browser/README.md
diff --git a/packages/browser/README.md b/packages/browser/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..fa968513d98e59bf061ff5aad36a4ffe5b5b70d0
--- /dev/null
+++ b/packages/browser/README.md
@@ -0,0 +1,39 @@
+This package contains dart.js, and previously contained interop.js
+
+dart.js
+=======
+
+The dart.js file is used in Dart browser apps to check for native Dart support
+and either (a) bootstrap Dartium or (b) load compiled JS instead. Previously,
+we've recommended that you add a script tag pointing the version of dart.js in
+our repository. This doesn't work offline and also results in slower startup
+(see [dartbug.com/6723](http://dartbug.com/6723)).
+
+Instead, we now recommend that you install dart.js via the following steps:
+
+1. Add the following to your pubspec.yaml:
+ dependencies:
+ browser: any
+
+2. Run pub install.
+
+3. Use a relative script tag in your html to the installed version:
+
+ `<script src="packages/browser/dart.js"></script>`
+
+If you do not wish to use pub, you may host a copy of this file locally instead.
+In this case, you will need to update it yourself as necessary. We reserve the
+right to move the old file in the repository, so we no longer recommend linking
+to it directly.
+
+interop.js
+==========
+
+This script was required for dart:js interop to work, but it is no longer
+needed. The functionality is now supported by dart:js directly.
+
+If you previously had a script such as this, please remove it:
+
+```html
+<script src="packages/browser/interop.js"></script>
+```
« no previous file with comments | « packages/browser/LICENSE ('k') | packages/browser/lib/dart.js » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698