|
1 |
| -This directory contains helper file for trace viewer (`go tool trace`). |
| 1 | +## Resources for Go's trace viewer |
2 | 2 |
|
3 |
| -`trace_viewer_full.html` was generated by following |
4 |
| -[instructions](https://github.com/catapult-project/catapult/blob/master/tracing/docs/embedding-trace-viewer.md) |
5 |
| -on revision `dc970d3e1f7b3da5a2849de70ff253acdb70148f` |
6 |
| -of [catapult](https://github.com/catapult-project/catapult) using: |
| 3 | +Go execution trace UI (`go tool trace`) embeds |
| 4 | +Chrome's trace viewer (Catapult) following the |
| 5 | +[instructions]( |
| 6 | +https://chromium.googlesource.com/catapult/+/refs/heads/master/tracing/docs/embedding-trace-viewer.md). This directory contains |
| 7 | +the helper files to embed Chrome's trace viewer. |
| 8 | + |
| 9 | +The current resources were generated/copied from |
| 10 | +[`Catapult@9508452e18f130c98499cb4c4f1e1efaedee8962`]( |
| 11 | +https://chromium.googlesource.com/catapult/+/9508452e18f130c98499cb4c4f1e1efaedee8962). |
| 12 | + |
| 13 | +### Updating `trace_viewer_full.html` |
| 14 | + |
| 15 | +The file was generated by catapult's `vulcanize_trace_viewer` command. |
7 | 16 | ```
|
8 |
| -catapult$ ./tracing/bin/vulcanize_trace_viewer --config=full |
9 |
| -catapult$ cp tracing/bin/trace_viewer_full.html $GOROOT/misc/trace/trace_viewer_lean.html |
| 17 | +$ git clone https://chromium.googlesource.com/catapult |
| 18 | +$ cd catapult |
| 19 | +$ ./tracing/bin/vulcanize_trace_viewer --config=full |
| 20 | +$ cp tracing/bin/trace_viewer_full.html $GOROOT/misc/trace/trace_viewer_full.html |
10 | 21 | ```
|
| 22 | + |
11 | 23 | We are supposed to use --config=lean (produces smaller html),
|
12 | 24 | but it is broken at the moment:
|
13 | 25 | https://github.com/catapult-project/catapult/issues/2247
|
14 | 26 |
|
| 27 | +### Updating `webcomponents.min.js` |
| 28 | + |
| 29 | +`webcomponents.min.js` is necessary to let the trace viewer page |
| 30 | +to import the `trace_viewer_full.html`. |
| 31 | +This is copied from the catapult repo. |
| 32 | + |
| 33 | +``` |
| 34 | +$ cp third_party/polymer/components/webcomponentsjs/webcomponents.min.js $GOROOT/misc/trace/webcomponents.min.js |
| 35 | +``` |
| 36 | + |
| 37 | +## Licenses |
| 38 | + |
15 | 39 | The license for trace-viewer is as follows:
|
16 | 40 | // Copyright (c) 2012 The Chromium Authors. All rights reserved.
|
17 | 41 | //
|
@@ -40,3 +64,42 @@ The license for trace-viewer is as follows:
|
40 | 64 | // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
41 | 65 | // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
42 | 66 | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| 67 | + |
| 68 | +The license for webcomponents.min.js is as follows: |
| 69 | + |
| 70 | +/** |
| 71 | + * @license |
| 72 | + * Copyright (c) 2014 The Polymer Project Authors. All rights reserved. |
| 73 | + * This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt |
| 74 | + * The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt |
| 75 | + * The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt |
| 76 | + * Code distributed by Google as part of the polymer project is also |
| 77 | + * subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt |
| 78 | + */ |
| 79 | +// Copyright (c) 2014 The Polymer Authors. All rights reserved. |
| 80 | +// |
| 81 | +// Redistribution and use in source and binary forms, with or without |
| 82 | +// modification, are permitted provided that the following conditions are |
| 83 | +// met: |
| 84 | +// |
| 85 | +// * Redistributions of source code must retain the above copyright |
| 86 | +// notice, this list of conditions and the following disclaimer. |
| 87 | +// * Redistributions in binary form must reproduce the above |
| 88 | +// copyright notice, this list of conditions and the following disclaimer |
| 89 | +// in the documentation and/or other materials provided with the |
| 90 | +// distribution. |
| 91 | +// * Neither the name of Google Inc. nor the names of its |
| 92 | +// contributors may be used to endorse or promote products derived from |
| 93 | +// this software without specific prior written permission. |
| 94 | +// |
| 95 | +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 96 | +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 97 | +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 98 | +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 99 | +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 100 | +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 101 | +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 102 | +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 103 | +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 104 | +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 105 | +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
0 commit comments