Skip to content

Commit

Permalink
Bulk-update: Hyperlinks to HTML standard (multipage/... => C/)
Browse files Browse the repository at this point in the history
This patch updates hyperlinks to HTML standard from
/multipage/chapter-title.html#topics to /C/#topics, which
redirects to /multipage/chapter-title.html#topics.

/C/#topics style is shorter and simpler.

This is a follow-up of https://crrev.com/c/1466543

Change-Id: I1490928bd406fcf50f8da739d0c9862c5cc980ae
Tbr: foolip@chromium.org
Reviewed-on: https://chromium-review.googlesource.com/c/1469814
Commit-Queue: Yuki Shiino <yukishiino@chromium.org>
Reviewed-by: Kentaro Hara <haraken@chromium.org>
Reviewed-by: Hiroshige Hayashizaki <hiroshige@chromium.org>
Cr-Commit-Position: refs/heads/master@{#631633}
  • Loading branch information
yuki3 authored and Commit Bot committed Feb 13, 2019
1 parent 7c1db40 commit b4fa97a
Show file tree
Hide file tree
Showing 235 changed files with 381 additions and 381 deletions.
12 changes: 6 additions & 6 deletions third_party/blink/renderer/SpecMapping.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,15 @@ implementation is [LocalFrame].
[Frame]: https://cs.chromium.org/src/third_party/blink/renderer/core/frame/frame.h
[LocalFrame]: https://cs.chromium.org/src/third_party/blink/renderer/core/frame/local_frame.h

### [origins](https://html.spec.whatwg.org/multipage/browsers.html#concept-origin)
### [origins](https://html.spec.whatwg.org/C/#concept-origin)

An origin corresponds to the [SecurityOrigin]. You can test for [same-origin]
using `SecurityOrigin::canAccess` and for [same-origin domain] using
`SecurityOrigin::isSameSchemeHostPort`.

[SecurityOrigin]: https://cs.chromium.org/src/third_party/blink/renderer/platform/weborigin/security_origin.h
[same-origin]: https://html.spec.whatwg.org/multipage/browsers.html#same-origin
[same-origin domain]: https://html.spec.whatwg.org/multipage/browsers.html#same-origin-domain
[same-origin]: https://html.spec.whatwg.org/C/#same-origin
[same-origin domain]: https://html.spec.whatwg.org/C/#same-origin-domain


### [Window object](https://html.spec.whatwg.org/C/#window)
Expand All @@ -42,11 +42,11 @@ implementation is [LocalDOMWindow].
The WindowProxy is part of the bindings implemented by the
[WindowProxy class](https://cs.chromium.org/Source/bindings/core/v8/WindowProxy.h).

### [canvas](https://html.spec.whatwg.org/multipage/scripting.html#the-canvas-element)
### [canvas](https://html.spec.whatwg.org/C/#the-canvas-element)

An HTML element into which drawing can be performed imperatively via
JavaScript. Multiple
[context types](https://html.spec.whatwg.org/multipage/scripting.html#dom-canvas-getcontext)
[context types](https://html.spec.whatwg.org/C/#dom-canvas-getcontext)
are supported for different use cases.

The main element's sources are in [HTMLCanvasElement]. Contexts are implemented
Expand All @@ -58,7 +58,7 @@ via modules. The top-level module is [HTMLCanvasElementModule].

The [2D canvas context] is implemented in [modules/canvas2d].

[2D canvas context]: https://html.spec.whatwg.org/multipage/scripting.html#canvasrenderingcontext2d
[2D canvas context]: https://html.spec.whatwg.org/C/#canvasrenderingcontext2d
[modules/canvas2d]: https://cs.chromium.org/chromium/src/third_party/blink/renderer/modules/canvas2d/


Expand Down
12 changes: 6 additions & 6 deletions third_party/blink/renderer/bindings/IDLExtendedAttributes.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,10 +142,10 @@ Undocumented: `[TreatNonObjectAsNull]`

### [CEReactions] _(m, a)_

Standard: [CEReactions](https://html.spec.whatwg.org/multipage/scripting.html#cereactions)
Standard: [CEReactions](https://html.spec.whatwg.org/C/#cereactions)

Summary: `[CEReactions]` indicates that
[custom element reactions](https://html.spec.whatwg.org/multipage/scripting.html#concept-custom-element-reaction)
[custom element reactions](https://html.spec.whatwg.org/C/#concept-custom-element-reaction)
are triggered for this method or attribute.

Usage: `[CEReactions]` takes no arguments.
Expand Down Expand Up @@ -304,7 +304,7 @@ The identifier argument or identifier list argument the `[Global]` extended attr

### [HTMLConstructor]

Standard: [HTMLConstructor](https://html.spec.whatwg.org/multipage/dom.html#html-element-constructors)
Standard: [HTMLConstructor](https://html.spec.whatwg.org/C/#html-element-constructors)

Summary: HTML Elements have special constructor behavior. Interface object of given interface with the `[HTMLConstructor]` attribute will have specific behavior when called.

Expand Down Expand Up @@ -484,7 +484,7 @@ interface Window {

### [Serializable] _(i)_

Standard: [Serializable](https://html.spec.whatwg.org/multipage/structured-data.html#serializable)
Standard: [Serializable](https://html.spec.whatwg.org/C/#serializable)

Summary: Serializable objects support being serialized, and later deserialized, for persistence in storage APIs or for passing with `postMessage()`.

Expand All @@ -498,7 +498,7 @@ This attribute has no effect on code generation and should simply be used in Bli

### [Transferable] _(i)_

Standard: [Transferable](https://html.spec.whatwg.org/multipage/structured-data.html#transferable)
Standard: [Transferable](https://html.spec.whatwg.org/C/#transferable)

Summary: Transferable objects support being transferred across Realms with `postMessage()`.

Expand Down Expand Up @@ -1656,4 +1656,4 @@ Redistribution and use in source and binary forms, with or without modification,
THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
***

[CrossOriginProperties]: https://html.spec.whatwg.org/multipage/browsers.html#crossoriginproperties-(-o-)
[CrossOriginProperties]: https://html.spec.whatwg.org/C/#crossoriginproperties-(-o-)
Original file line number Diff line number Diff line change
Expand Up @@ -117,9 +117,9 @@ the entered context is the context of the main frame
(not the context of `<iframe>`).

The entered context is a concept to implement the
[entry settings object](https://html.spec.whatwg.org/multipage/webappapis.html#entry-settings-object)
[entry settings object](https://html.spec.whatwg.org/C/#entry-settings-object)
of the HTML spec. The current context is a concept to implement the
[incumbent settings object](https://html.spec.whatwg.org/multipage/webappapis.html#incumbent-settings-object)
[incumbent settings object](https://html.spec.whatwg.org/C/#incumbent-settings-object)
of the HTML spec.

In summary, the entered context is a context from which the current JavaScript
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -385,7 +385,7 @@ bool BindingSecurity::ShouldAllowWrapperCreationOrThrowException(
return true;

// According to
// https://html.spec.whatwg.org/multipage/browsers.html#security-location,
// https://html.spec.whatwg.org/C/#security-location,
// cross-origin script access to a few properties of Location is allowed.
// Location already implements the necessary security checks.
if (wrapper_type_info->Equals(V8Location::GetWrapperTypeInfo()))
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -210,11 +210,11 @@ void V8Window::NamedPropertyGetterCustom(

// Note that named access on WindowProxy is allowed in the cross-origin case.
// 7.4.5 [[GetOwnProperty]] (P), step 6.
// https://html.spec.whatwg.org/multipage/browsers.html#windowproxy-getownproperty
// https://html.spec.whatwg.org/C/#windowproxy-getownproperty
//
// 7.3.3 Named access on the Window object
// The document-tree child browsing context name property set
// https://html.spec.whatwg.org/multipage/browsers.html#document-tree-child-browsing-context-name-property-set
// https://html.spec.whatwg.org/C/#document-tree-child-browsing-context-name-property-set
Frame* child = frame->Tree().ScopedChild(name);
if (child) {
UseCounter::Count(CurrentExecutionContext(info.GetIsolate()),
Expand Down Expand Up @@ -252,7 +252,7 @@ void V8Window::NamedPropertyGetterCustom(
CurrentDOMWindow(info.GetIsolate()), window,
BindingSecurity::ErrorReportOption::kDoNotReport)) {
// HTML 7.2.3.3 CrossOriginGetOwnPropertyHelper ( O, P )
// https://html.spec.whatwg.org/multipage/browsers.html#crossorigingetownpropertyhelper-(-o,-p-)
// https://html.spec.whatwg.org/C/#crossorigingetownpropertyhelper-(-o,-p-)
// step 3. If P is "then", @@toStringTag, @@hasInstance, or
// @@isConcatSpreadable, then return PropertyDescriptor{ [[Value]]:
// undefined, [[Writable]]: false, [[Enumerable]]: false,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ void JSBasedEventListener::Invoke(
// order, which says it should be done in step 10. There is no behavioral
// difference but the advantage that we can use listener's |ScriptState|
// after it get compiled.
// https://html.spec.whatwg.org/multipage/webappapis.html#event-handler-value
// https://html.spec.whatwg.org/C/#event-handler-value
v8::Local<v8::Value> listener = GetListenerObject(*event->currentTarget());

if (listener.IsEmpty() || !listener->IsObject())
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ class CORE_EXPORT JSBasedEventListener : public EventListener {
// content attribute to get compiled, potentially unsuccessfully.
//
// Implements "get the current value of the event handler".
// https://html.spec.whatwg.org/multipage/webappapis.html#getting-the-current-value-of-the-event-handler
// https://html.spec.whatwg.org/C/#getting-the-current-value-of-the-event-handler
// Returns v8::Null with firing error event instead of throwing an exception
// on failing to compile the uncompiled script body in eventHandler's value.
// Also, this can return empty because of crbug.com/881688 .
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ void JSEventHandler::SetCompiledHandler(ScriptState* incumbent_script_state,
v8::Local<v8::Function> listener) {
DCHECK(!HasCompiledHandler());

// https://html.spec.whatwg.org/multipage/webappapis.html#getting-the-current-value-of-the-event-handler
// https://html.spec.whatwg.org/C/#getting-the-current-value-of-the-event-handler
// Step 12: Set eventHandler's value to the result of creating a Web IDL
// EventHandler callback function object whose object reference is function
// and whose callback context is settings object.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ v8::Local<v8::Value> JSEventHandlerForContentAttribute::GetListenerObject(
}

// Implements Step 3. of "get the current value of the event handler"
// https://html.spec.whatwg.org/multipage/webappapis.html#getting-the-current-value-of-the-event-handler
// https://html.spec.whatwg.org/C/#getting-the-current-value-of-the-event-handler
v8::Local<v8::Value> JSEventHandlerForContentAttribute::GetCompiledHandler(
EventTarget& event_target) {
// Do not compile the same code twice.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ class JSEventHandlerForContentAttribute final : public JSEventHandler {
// The compiled v8::Function is returned and |JSEventHandler::event_handler_|
// gets initialized with it if lazy compilation succeeds.
// Otherwise, v8::Null is returned.
// https://html.spec.whatwg.org/multipage/webappapis.html#getting-the-current-value-of-the-event-handler
// https://html.spec.whatwg.org/C/#getting-the-current-value-of-the-event-handler
v8::Local<v8::Value> GetCompiledHandler(EventTarget&);

// Lazy compilation for content attribute should be tried only once, but we
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ namespace blink {

// ReferrerScriptInfo carries a copy of "referencing script's" info referenced
// in HTML Spec: "HostImportModuleDynamically" algorithm.
// https://html.spec.whatwg.org/multipage/webappapis.html#hostimportmoduledynamically(referencingscriptormodule,-specifier,-promisecapability)
// https://html.spec.whatwg.org/C/#hostimportmoduledynamically(referencingscriptormodule,-specifier,-promisecapability)
class CORE_EXPORT ReferrerScriptInfo {
public:
ReferrerScriptInfo() {}
Expand Down Expand Up @@ -62,7 +62,7 @@ class CORE_EXPORT ReferrerScriptInfo {

private:
// Spec: "referencing script's base URL"
// https://html.spec.whatwg.org/multipage/webappapis.html#concept-script-base-url
// https://html.spec.whatwg.org/C/#concept-script-base-url
//
// If base_url_.IsNull(), refer to ScriptOrigin::ResourceName() instead.
// Note: This improves the chance of getting into the fast path in
Expand All @@ -71,7 +71,7 @@ class CORE_EXPORT ReferrerScriptInfo {

// Spec: "referencing script's credentials mode"
// The default value is "same-origin" per:
// https://html.spec.whatwg.org/multipage/webappapis.html#default-classic-script-fetch-options
// https://html.spec.whatwg.org/C/#default-classic-script-fetch-options
const network::mojom::FetchCredentialsMode credentials_mode_ =
network::mojom::FetchCredentialsMode::kSameOrigin;

Expand All @@ -80,12 +80,12 @@ class CORE_EXPORT ReferrerScriptInfo {

// Spec: "referencing script's parser state"
// The default value is "not-parser-inserted" per:
// https://html.spec.whatwg.org/multipage/webappapis.html#default-classic-script-fetch-options
// https://html.spec.whatwg.org/C/#default-classic-script-fetch-options
const ParserDisposition parser_state_ = kNotParserInserted;

// Spec: "referencing script's referrer policy"
// The default value is "the empty string" per:
// https://html.spec.whatwg.org/multipage/webappapis.html#default-classic-script-fetch-options
// https://html.spec.whatwg.org/C/#default-classic-script-fetch-options
const network::mojom::ReferrerPolicy referrer_policy_ =
network::mojom::ReferrerPolicy::kDefault;
};
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ bool ScriptController::ExecuteScriptIfJavaScriptURL(

v8::HandleScope handle_scope(GetIsolate());

// https://html.spec.whatwg.org/multipage/browsing-the-web.html#navigate
// https://html.spec.whatwg.org/C/#navigate
// Step 12.8 "Let base URL be settings object's API base URL." [spec text]
KURL base_url = owner_document->BaseURL();

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -200,7 +200,7 @@ HTMLElement* ScriptCustomElementDefinition::CreateAutonomousCustomElementSync(
return ToHTMLElement(element);
}

// https://html.spec.whatwg.org/multipage/scripting.html#upgrades
// https://html.spec.whatwg.org/C/#upgrades
bool ScriptCustomElementDefinition::RunConstructor(Element& element) {
if (!script_state_->ContextIsValid())
return false;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ class CORE_EXPORT SerializedScriptValue
// This enumeration specifies whether we're serializing a value for storage;
// e.g. when writing to IndexedDB. This corresponds to the forStorage flag of
// the HTML spec:
// https://html.spec.whatwg.org/multipage/infrastructure.html#safe-passing-of-structured-data
// https://html.spec.whatwg.org/C/#safe-passing-of-structured-data
enum StoragePolicy {
// Not persisted; used only during the execution of the browser.
kNotForStorage,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ void V8ScriptValueSerializer::FinalizeTransfer(
ExceptionState& exception_state) {
// TODO(jbroman): Strictly speaking, this is not correct; transfer should
// occur in the order of the transfer list.
// https://html.spec.whatwg.org/multipage/infrastructure.html#structuredclonewithtransfer
// https://html.spec.whatwg.org/C/#structuredclonewithtransfer

v8::Isolate* isolate = script_state_->GetIsolate();

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ class File;
class Transferables;

// Serializes V8 values according to the HTML structured clone algorithm:
// https://html.spec.whatwg.org/multipage/infrastructure.html#structured-clone
// https://html.spec.whatwg.org/C/#structured-clone
//
// Supports only basic JavaScript objects and core DOM types. Support for
// modules types is implemented in a subclass.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@

namespace blink {

// https://html.spec.whatwg.org/multipage/dom.html#html-element-constructors
// https://html.spec.whatwg.org/C/#html-element-constructors
void V8HTMLConstructor::HtmlConstructor(
const v8::FunctionCallbackInfo<v8::Value>& info,
const WrapperTypeInfo& wrapper_type_info,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

namespace blink {

// https://html.spec.whatwg.org/multipage/dom.html#html-element-constructors
// https://html.spec.whatwg.org/C/#html-element-constructors
class CORE_EXPORT V8HTMLConstructor {
STATIC_ONLY(V8HTMLConstructor);

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -459,7 +459,7 @@ void V8ScriptRunner::ReportException(v8::Isolate* isolate,
v8::Local<v8::Value> exception) {
DCHECK(!exception.IsEmpty());

// https://html.spec.whatwg.org/multipage/webappapis.html#report-the-error
// https://html.spec.whatwg.org/C/#report-the-error
v8::Local<v8::Message> message =
v8::Exception::CreateMessage(isolate, exception);
if (IsMainThread())
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -333,7 +333,7 @@ def interface_context(interface, interfaces):

# [HTMLConstructor]
has_html_constructor = 'HTMLConstructor' in extended_attributes
# https://html.spec.whatwg.org/multipage/dom.html#html-element-constructors
# https://html.spec.whatwg.org/C/#html-element-constructors
if has_html_constructor:
if ('Constructor' in extended_attributes) or ('NoInterfaceObject' in extended_attributes):
raise Exception('[Constructor] and [NoInterfaceObject] MUST NOT be'
Expand Down
2 changes: 1 addition & 1 deletion third_party/blink/renderer/bindings/scripts/v8_methods.py
Original file line number Diff line number Diff line change
Expand Up @@ -434,7 +434,7 @@ def v8_value_to_local_cpp_value(interface_name, method, argument, index):

# History.pushState and History.replaceState are explicitly specified as
# serializing the value for storage. The default is to not serialize for
# storage. See https://html.spec.whatwg.org/multipage/browsers.html#dom-history-pushstate
# storage. See https://html.spec.whatwg.org/C/#dom-history-pushstate
if idl_type.name == 'SerializedScriptValue':
for_storage = (interface_name == 'History' and
method.name in ('pushState', 'replaceState'))
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -280,7 +280,7 @@ void {{v8_class_or_partial}}::CrossOriginNamedGetter(v8::Local<v8::Name> name, c
{% endif %}
{% else %}
// HTML 7.2.3.3 CrossOriginGetOwnPropertyHelper ( O, P )
// https://html.spec.whatwg.org/multipage/browsers.html#crossorigingetownpropertyhelper-(-o,-p-)
// https://html.spec.whatwg.org/C/#crossorigingetownpropertyhelper-(-o,-p-)
// step 3. If P is "then", @@toStringTag, @@hasInstance, or
// @@isConcatSpreadable, then return PropertyDescriptor{ [[Value]]:
// undefined, [[Writable]]: false, [[Enumerable]]: false,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -734,7 +734,7 @@ void V8TestInterfaceCheckSecurity::CrossOriginNamedGetter(v8::Local<v8::Name> na
}

// HTML 7.2.3.3 CrossOriginGetOwnPropertyHelper ( O, P )
// https://html.spec.whatwg.org/multipage/browsers.html#crossorigingetownpropertyhelper-(-o,-p-)
// https://html.spec.whatwg.org/C/#crossorigingetownpropertyhelper-(-o,-p-)
// step 3. If P is "then", @@toStringTag, @@hasInstance, or
// @@isConcatSpreadable, then return PropertyDescriptor{ [[Value]]:
// undefined, [[Writable]]: false, [[Enumerable]]: false,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ void TextAlign::ApplyValue(StyleResolverState& state,
ToCSSIdentifierValue(value).GetValueID() != CSSValueWebkitMatchParent) {
// Special case for th elements - UA stylesheet text-align does not apply if
// parent's computed value for text-align is not its initial value
// https://html.spec.whatwg.org/multipage/rendering.html#tables-2
// https://html.spec.whatwg.org/C/#tables-2
const CSSIdentifierValue& ident_value = ToCSSIdentifierValue(value);
if (ident_value.GetValueID() == CSSValueInternalCenter &&
state.ParentStyle()->GetTextAlign() !=
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -196,7 +196,7 @@ static bool DoesNotInheritTextDecoration(const ComputedStyle& style,
// Certain elements (<a>, <font>) override text decoration colors. "The font
// element is expected to override the color of any text decoration that spans
// the text of the element to the used value of the element's 'color' property."
// (https://html.spec.whatwg.org/multipage/rendering.html#phrasing-content-3)
// (https://html.spec.whatwg.org/C/#phrasing-content-3)
// The <a> behavior is non-standard.
static bool OverridesTextDecorationColors(const Element* element) {
return element &&
Expand Down
2 changes: 1 addition & 1 deletion third_party/blink/renderer/core/dom/character_data.cc
Original file line number Diff line number Diff line change
Expand Up @@ -227,7 +227,7 @@ void CharacterData::DidModifyData(const String& old_data, UpdateSource source) {

// Skip DOM mutation events if the modification is from parser.
// Note that mutation observer events will still fire.
// Spec: https://html.spec.whatwg.org/multipage/syntax.html#insert-a-character
// Spec: https://html.spec.whatwg.org/C/#insert-a-character
if (source != kUpdateFromParser && !IsInShadowTree()) {
if (GetDocument().HasListenerType(
Document::kDOMCharacterDataModifiedListener)) {
Expand Down
Loading

0 comments on commit b4fa97a

Please sign in to comment.