From 4cc4e96dbd5d2fd1b47e622eb8505d3ab4848cc0 Mon Sep 17 00:00:00 2001 From: Joey Parrish Date: Tue, 8 Sep 2015 09:43:21 -0700 Subject: [PATCH] Overhaul license comments and file annotations * Updates all Copyright years to 2015. * Adds licenses annotations to all JS. * Makes all licenses identical to avoid repeated appearance in the compiled output. * Drops fileoverview annotations, which do not affect docs output. * The linter still requires fileoverview on externs. This patch required a newer closure compiler, since the previous version we used had a bug regarding license annotations that caused the license comment block to appear in the output once per file regardless of uniqueness. Change-Id: I2e9272db680cba7ecc4613d97f1d3a94ac2244cc --- app.js | 10 ++++++---- controls.js | 8 +++++--- externs/fullscreen.js | 7 +++++-- externs/htmltrackelement.js | 9 ++++++--- externs/jwk_set.js | 7 +++++-- externs/mediakeys.js | 10 +++++++--- externs/prefixed_eme.js | 7 +++++-- externs/xmlhttprequest.js | 7 ++++++- index.css | 2 +- index.html | 2 +- integration_tests.html | 2 +- lib/dash/container_segment_index_source.js | 7 +++---- lib/dash/duration_segment_index_source.js | 7 +++---- lib/dash/dynamic_live_segment_index.js | 11 ++++------- lib/dash/list_segment_index_source.js | 7 +++---- lib/dash/live_segment_index.js | 5 ++--- lib/dash/mpd_parser.js | 5 ++--- lib/dash/mpd_processor.js | 9 ++++----- lib/dash/mpd_request.js | 5 ++--- lib/dash/mpd_utils.js | 3 +-- lib/dash/timeline_segment_index_source.js | 7 +++---- lib/debug/asserts.js | 5 ++--- lib/debug/log.js | 5 ++--- lib/debug/timer.js | 5 ++--- lib/media/eme_manager.js | 3 +-- lib/media/i_abr_manager.js | 6 ++---- lib/media/i_segment_index_source.js | 3 +-- lib/media/i_stream.js | 5 ++--- lib/media/manifest_updater.js | 3 +-- lib/media/mp4_segment_index_parser.js | 7 +++---- lib/media/offline_segment_index_source.js | 7 +++---- lib/media/segment_index.js | 5 ++--- lib/media/segment_init_source.js | 3 +-- lib/media/segment_reference.js | 5 ++--- lib/media/simple_abr_manager.js | 5 ++--- lib/media/source_buffer_manager.js | 9 ++++----- lib/media/stream.js | 5 ++--- lib/media/stream_info.js | 9 ++++----- lib/media/stream_info_processor.js | 5 ++--- lib/media/text_segment_index_source.js | 7 +++---- lib/media/text_stream.js | 5 ++--- lib/media/webm_segment_index_parser.js | 7 +++---- lib/player/audio_track.js | 5 ++--- lib/player/dash_video_source.js | 5 ++--- lib/player/defaults.js | 3 +-- lib/player/drm_info.js | 3 +-- lib/player/drm_scheme_info.js | 5 ++--- lib/player/http_video_source.js | 5 ++--- lib/player/i_video_source.js | 5 ++--- lib/player/offline_video_source.js | 3 +-- lib/player/player.js | 5 ++--- lib/player/restrictions.js | 3 +-- lib/player/stats.js | 5 ++--- lib/player/stream_video_source.js | 5 ++--- lib/player/text_style.js | 3 +-- lib/player/text_track.js | 5 ++--- lib/player/video_track.js | 5 ++--- lib/polyfill/all.js | 7 +++---- lib/polyfill/customevent.js | 5 +---- lib/polyfill/fullscreen.js | 7 ++----- lib/polyfill/mediakeys.js | 7 ++----- lib/polyfill/patchedmediakeys_nop.js | 11 ++++------- lib/polyfill/patchedmediakeys_v01b.js | 11 ++++------- lib/polyfill/videoplaybackquality.js | 8 ++------ lib/util/ajax_request.js | 8 ++++---- lib/util/array_utils.js | 5 ++--- lib/util/clock.js | 3 +-- lib/util/content_database.js | 5 ++--- lib/util/content_database_reader.js | 3 +-- lib/util/content_database_writer.js | 3 +-- lib/util/data_view_reader.js | 8 +++----- lib/util/ebml_parser.js | 7 +++---- lib/util/eme_utils.js | 3 +-- lib/util/event_manager.js | 5 ++--- lib/util/ewma.js | 5 ++--- lib/util/ewma_bandwidth_estimator.js | 9 ++++----- lib/util/failover_uri.js | 7 +++---- lib/util/fake_event.js | 5 ++--- lib/util/fake_event_target.js | 6 ++---- lib/util/features.js | 7 +++---- lib/util/i_bandwidth_estimator.js | 6 ++---- lib/util/language_utils.js | 5 ++--- lib/util/license_request.js | 5 ++--- lib/util/map_utils.js | 3 +-- lib/util/multi_map.js | 6 +++--- lib/util/pssh.js | 5 ++--- lib/util/public_promise.js | 9 +++++---- lib/util/string_utils.js | 5 ++--- lib/util/task.js | 5 ++--- lib/util/typed_bind.js | 5 ++--- lib/util/uint8array_utils.js | 5 ++--- load.js | 11 +++++++---- shaka-player.uncompiled.js | 6 +++--- spec/ajax_request_spec.js | 5 ++--- spec/content_database_spec.js | 5 ++--- spec/data_view_reader_spec.js | 5 ++--- spec/ebml_parser_spec.js | 5 ++--- spec/event_manager_spec.js | 5 ++--- spec/fake_event_spec.js | 3 +-- spec/language_utils_spec.js | 5 ++--- spec/license_request_spec.js | 5 ++--- spec/live_integration.js | 3 +-- spec/manifest_updater_spec.js | 3 +-- spec/mpd_base_url_spec.js | 3 +-- spec/mpd_content_protection_spec.js | 3 +-- spec/mpd_processor_spec.js | 5 ++--- spec/mpd_segment_base_spec.js | 3 +-- spec/mpd_segment_list_spec.js | 3 +-- spec/mpd_segment_template_spec.js | 3 +-- spec/mpd_spec.js | 5 ++--- spec/mpd_utils_spec.js | 3 +-- spec/player_integration.js | 5 ++--- spec/pssh_spec.js | 3 +-- spec/segment_index_parser_spec.js | 3 +-- spec/segment_index_spec.js | 5 ++--- spec/task_spec.js | 3 +-- spec/util.js | 5 ++--- support.js | 1 + unit_tests.html | 2 +- 119 files changed, 273 insertions(+), 363 deletions(-) diff --git a/app.js b/app.js index ef82f26af..4c6c1166c 100644 --- a/app.js +++ b/app.js @@ -1,5 +1,6 @@ /** - * Copyright 2014 Google Inc. + * @license + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -12,12 +13,13 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - * - * @fileoverview Implements the application layer of the test application. */ -/** @class */ +/** + * The application layer of the test application. + * @class + */ var app = function() {}; diff --git a/controls.js b/controls.js index 1f0ca7453..e06c8a8c6 100644 --- a/controls.js +++ b/controls.js @@ -1,4 +1,5 @@ /** + * @license * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); @@ -12,12 +13,13 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - * - * @fileoverview Implements the video controls overlay. */ -/** @class */ +/** + * The video controls overlay for the test app. + * @class + */ var playerControls = function() {}; diff --git a/externs/fullscreen.js b/externs/fullscreen.js index 66f53d246..2dac8b719 100644 --- a/externs/fullscreen.js +++ b/externs/fullscreen.js @@ -1,5 +1,6 @@ /** - * Copyright 2014 Google Inc. + * @license + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -12,7 +13,9 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - * + */ + +/** * @fileoverview Externs for prefixed fullscreen methods. * @externs */ diff --git a/externs/htmltrackelement.js b/externs/htmltrackelement.js index 5c73c24d8..024d6c1c4 100644 --- a/externs/htmltrackelement.js +++ b/externs/htmltrackelement.js @@ -1,5 +1,6 @@ /** - * Copyright 2014 Google Inc. + * @license + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -12,8 +13,10 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - * - * @fileoverview HTMLTrackElement externs. + */ + +/** + * @fileoverview Externs for HTMLTrackElement. * @externs */ diff --git a/externs/jwk_set.js b/externs/jwk_set.js index 0d602d065..f1f0ace57 100644 --- a/externs/jwk_set.js +++ b/externs/jwk_set.js @@ -1,5 +1,6 @@ /** - * Copyright 2014 Google Inc. + * @license + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -12,7 +13,9 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - * + */ + +/** * @fileoverview Externs for JWK set. * @externs */ diff --git a/externs/mediakeys.js b/externs/mediakeys.js index 5424a4ecd..8183a3175 100644 --- a/externs/mediakeys.js +++ b/externs/mediakeys.js @@ -1,5 +1,6 @@ /** - * Copyright 2014 Google Inc. + * @license + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -12,9 +13,12 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. + */ + +/** + * @fileoverview Externs for MediaKeys based on + * {@link http://goo.gl/blgtZZ EME draft 12 March 2015} * - * @fileoverview MediaKey externs. - * Based on {@link http://goo.gl/blgtZZ EME draft 12 March 2015}. * @externs */ diff --git a/externs/prefixed_eme.js b/externs/prefixed_eme.js index 261631e0c..2edbb6862 100644 --- a/externs/prefixed_eme.js +++ b/externs/prefixed_eme.js @@ -1,5 +1,6 @@ /** - * Copyright 2014 Google Inc. + * @license + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -12,7 +13,9 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - * + */ + +/** * @fileoverview Externs for prefixed EME v0.1b. * @externs */ diff --git a/externs/xmlhttprequest.js b/externs/xmlhttprequest.js index c60b8f470..db02f0686 100644 --- a/externs/xmlhttprequest.js +++ b/externs/xmlhttprequest.js @@ -1,4 +1,5 @@ /** + * @license * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); @@ -12,8 +13,12 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. + */ + +/** + * @fileoverview Externs for XMLHttpRequest which are missing from the closure + * compiler. * - * @fileoverview XMLHttpRequest externs missing from closure. * @externs */ diff --git a/index.css b/index.css index bf6ee86e7..2426f11ff 100644 --- a/index.css +++ b/index.css @@ -1,5 +1,5 @@ /** - * Copyright 2014 Google Inc. + * Copyright 2015 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. diff --git a/index.html b/index.html index ca9a44de8..daba130ce 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@