From 7acb513ba675aee12bdf52cf5ca8c3d162a93ef4 Mon Sep 17 00:00:00 2001 From: David Sanders Date: Thu, 17 Mar 2022 05:45:55 -0700 Subject: [PATCH] docs: update links to Chromium source (#33309) --- docs/api/app.md | 4 ++-- docs/api/client-request.md | 2 +- docs/api/command-line-switches.md | 4 ++-- docs/api/content-tracing.md | 2 +- docs/api/session.md | 2 +- docs/api/structures/protocol-response.md | 2 +- docs/api/structures/trace-config.md | 8 ++++---- docs/api/web-contents.md | 2 +- docs/development/build-instructions-gn.md | 6 +++--- docs/development/build-instructions-windows.md | 2 +- docs/glossary.md | 2 +- docs/tutorial/sandbox.md | 2 +- 12 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/api/app.md b/docs/api/app.md index 60eb2ee7785c..b8c4780b2285 100755 --- a/docs/api/app.md +++ b/docs/api/app.md @@ -714,7 +714,7 @@ Overrides the current application's name. ### `app.getLocale()` Returns `string` - The current application locale, fetched using Chromium's `l10n_util` library. -Possible return values are documented [here](https://source.chromium.org/chromium/chromium/src/+/master:ui/base/l10n/l10n_util.cc). +Possible return values are documented [here](https://source.chromium.org/chromium/chromium/src/+/main:ui/base/l10n/l10n_util.cc). To set the locale, you'll want to use a command line switch at app startup, which may be found [here](command-line-switches.md). @@ -1093,7 +1093,7 @@ Activation policy types: Imports the certificate in pkcs12 format into the platform certificate store. `callback` is called with the `result` of import operation, a value of `0` -indicates success while any other value indicates failure according to Chromium [net_error_list](https://source.chromium.org/chromium/chromium/src/+/master:net/base/net_error_list.h). +indicates success while any other value indicates failure according to Chromium [net_error_list](https://source.chromium.org/chromium/chromium/src/+/main:net/base/net_error_list.h). ### `app.configureHostResolver(options)` diff --git a/docs/api/client-request.md b/docs/api/client-request.md index 12f1ce1157e5..81410a281816 100644 --- a/docs/api/client-request.md +++ b/docs/api/client-request.md @@ -185,7 +185,7 @@ the first write will throw an error. If the passed value is not a `string`, its Certain headers are restricted from being set by apps. These headers are listed below. More information on restricted headers can be found in -[Chromium's header utils](https://source.chromium.org/chromium/chromium/src/+/master:services/network/public/cpp/header_util.cc;drc=1562cab3f1eda927938f8f4a5a91991fefde66d3;bpv=1;bpt=1;l=22). +[Chromium's header utils](https://source.chromium.org/chromium/chromium/src/+/main:services/network/public/cpp/header_util.cc;drc=1562cab3f1eda927938f8f4a5a91991fefde66d3;bpv=1;bpt=1;l=22). * `Content-Length` * `Host` diff --git a/docs/api/command-line-switches.md b/docs/api/command-line-switches.md index f395379c063f..d628b0549c1d 100644 --- a/docs/api/command-line-switches.md +++ b/docs/api/command-line-switches.md @@ -274,8 +274,8 @@ By default inspector websocket url is available in stderr and under /json/list e [ready]: app.md#event-ready [play-silent-audio]: https://github.com/atom/atom/pull/9485/files [debugging-main-process]: ../tutorial/debugging-main-process.md -[logging]: https://source.chromium.org/chromium/chromium/src/+/master:base/logging.h +[logging]: https://source.chromium.org/chromium/chromium/src/+/main:base/logging.h [node-cli]: https://nodejs.org/api/cli.html [play-silent-audio]: https://github.com/atom/atom/pull/9485/files [ready]: app.md#event-ready -[severities]: https://source.chromium.org/chromium/chromium/src/+/master:base/logging.h?q=logging::LogSeverity&ss=chromium +[severities]: https://source.chromium.org/chromium/chromium/src/+/main:base/logging.h?q=logging::LogSeverity&ss=chromium diff --git a/docs/api/content-tracing.md b/docs/api/content-tracing.md index 91e3ca43a256..ec8e3f797970 100644 --- a/docs/api/content-tracing.md +++ b/docs/api/content-tracing.md @@ -36,7 +36,7 @@ Returns `Promise` - resolves with an array of category groups once all Get a set of category groups. The category groups can change as new code paths are reached. See also the [list of built-in tracing -categories](https://chromium.googlesource.com/chromium/src/+/master/base/trace_event/builtin_categories.h). +categories](https://chromium.googlesource.com/chromium/src/+/main/base/trace_event/builtin_categories.h). > **NOTE:** Electron adds a non-default tracing category called `"electron"`. > This category can be used to capture Electron-specific tracing events. diff --git a/docs/api/session.md b/docs/api/session.md index 8bb1ad5ab3c5..5dc29aba9b6d 100644 --- a/docs/api/session.md +++ b/docs/api/session.md @@ -567,7 +567,7 @@ the original network configuration. * `errorCode` Integer - Error code. * `callback` Function * `verificationResult` Integer - Value can be one of certificate error codes - from [here](https://source.chromium.org/chromium/chromium/src/+/master:net/base/net_error_list.h). + from [here](https://source.chromium.org/chromium/chromium/src/+/main:net/base/net_error_list.h). Apart from the certificate error codes, the following special codes can be used. * `0` - Indicates success and disables Certificate Transparency verification. * `-2` - Indicates failure. diff --git a/docs/api/structures/protocol-response.md b/docs/api/structures/protocol-response.md index a20873ebb3b4..21a863240fab 100644 --- a/docs/api/structures/protocol-response.md +++ b/docs/api/structures/protocol-response.md @@ -31,4 +31,4 @@ * `uploadData` [ProtocolResponseUploadData](protocol-response-upload-data.md) (optional) - The data used as upload data. This is only used for URL responses when `method` is `"POST"`. -[net-error]: https://source.chromium.org/chromium/chromium/src/+/master:net/base/net_error_list.h +[net-error]: https://source.chromium.org/chromium/chromium/src/+/main:net/base/net_error_list.h diff --git a/docs/api/structures/trace-config.md b/docs/api/structures/trace-config.md index d5b3795f228f..4160b7121ca5 100644 --- a/docs/api/structures/trace-config.md +++ b/docs/api/structures/trace-config.md @@ -8,7 +8,7 @@ * `enable_argument_filter` boolean (optional) - if true, filter event data according to a specific list of events that have been manually vetted to not include any PII. See [the implementation in - Chromium][trace_event_args_whitelist.cc] for specifics. + Chromium][trace_event_args_allowlist.cc] for specifics. * `included_categories` string[] (optional) - a list of tracing categories to include. Can include glob-like patterns using `*` at the end of the category name. See [tracing categories][] for the list of categories. @@ -45,7 +45,7 @@ An example TraceConfig that roughly matches what Chrome DevTools records: } ``` -[tracing categories]: https://chromium.googlesource.com/chromium/src/+/master/base/trace_event/builtin_categories.h -[memory-infra docs]: https://chromium.googlesource.com/chromium/src/+/master/docs/memory-infra/memory_infra_startup_tracing.md#the-advanced-way -[trace_event_args_whitelist.cc]: https://chromium.googlesource.com/chromium/src/+/master/services/tracing/public/cpp/trace_event_args_whitelist.cc +[tracing categories]: https://chromium.googlesource.com/chromium/src/+/main/base/trace_event/builtin_categories.h +[memory-infra docs]: https://chromium.googlesource.com/chromium/src/+/main/docs/memory-infra/memory_infra_startup_tracing.md#the-advanced-way +[trace_event_args_allowlist.cc]: https://chromium.googlesource.com/chromium/src/+/main/services/tracing/public/cpp/trace_event_args_allowlist.cc [histogram]: https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md index 35ce46b590cc..bdfa22533256 100644 --- a/docs/api/web-contents.md +++ b/docs/api/web-contents.md @@ -92,7 +92,7 @@ Returns: * `frameRoutingId` Integer This event is like `did-finish-load` but emitted when the load failed. -The full list of error codes and their meaning is available [here](https://source.chromium.org/chromium/chromium/src/+/master:net/base/net_error_list.h). +The full list of error codes and their meaning is available [here](https://source.chromium.org/chromium/chromium/src/+/main:net/base/net_error_list.h). #### Event: 'did-fail-provisional-load' diff --git a/docs/development/build-instructions-gn.md b/docs/development/build-instructions-gn.md index 70b5c48ed857..cd955743df3b 100644 --- a/docs/development/build-instructions-gn.md +++ b/docs/development/build-instructions-gn.md @@ -196,12 +196,12 @@ If you test other combinations and find them to work, please update this documen See the GN reference for allowable values of [`target_os`][target_os values] and [`target_cpu`][target_cpu values]. -[target_os values]: https://gn.googlesource.com/gn/+/master/docs/reference.md#built_in-predefined-variables-target_os_the-desired-operating-system-for-the-build-possible-values -[target_cpu values]: https://gn.googlesource.com/gn/+/master/docs/reference.md#built_in-predefined-variables-target_cpu_the-desired-cpu-architecture-for-the-build-possible-values +[target_os values]: https://gn.googlesource.com/gn/+/main/docs/reference.md#built_in-predefined-variables-target_os_the-desired-operating-system-for-the-build-possible-values +[target_cpu values]: https://gn.googlesource.com/gn/+/main/docs/reference.md#built_in-predefined-variables-target_cpu_the-desired-cpu-architecture-for-the-build-possible-values #### Windows on Arm (experimental) -To cross-compile for Windows on Arm, [follow Chromium's guide](https://chromium.googlesource.com/chromium/src/+/refs/heads/master/docs/windows_build_instructions.md#Visual-Studio) to get the necessary dependencies, SDK and libraries, then build with `ELECTRON_BUILDING_WOA=1` in your environment before running `gclient sync`. +To cross-compile for Windows on Arm, [follow Chromium's guide](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/windows_build_instructions.md#Visual-Studio) to get the necessary dependencies, SDK and libraries, then build with `ELECTRON_BUILDING_WOA=1` in your environment before running `gclient sync`. ```bat set ELECTRON_BUILDING_WOA=1 diff --git a/docs/development/build-instructions-windows.md b/docs/development/build-instructions-windows.md index 49e436197d85..b827a713784b 100644 --- a/docs/development/build-instructions-windows.md +++ b/docs/development/build-instructions-windows.md @@ -9,7 +9,7 @@ Follow the guidelines below for building **Electron itself** on Windows, for the * Windows 10 / Server 2012 R2 or higher * Visual Studio 2017 15.7.2 or higher - [download VS 2019 Community Edition for free](https://www.visualstudio.com/vs/) - * See [the Chromium build documentation](https://chromium.googlesource.com/chromium/src/+/master/docs/windows_build_instructions.md#visual-studio) for more details on which Visual Studio + * See [the Chromium build documentation](https://chromium.googlesource.com/chromium/src/+/main/docs/windows_build_instructions.md#visual-studio) for more details on which Visual Studio components are required. * If your Visual Studio is installed in a directory other than the default, you'll need to set a few environment variables to point the toolchains to your installation path. diff --git a/docs/glossary.md b/docs/glossary.md index a4bfa2a96071..893c598c52b8 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -91,7 +91,7 @@ An IPC system for communicating intra- or inter-process, and that's important because Chrome is keen on being able to split its work into separate processes or not, depending on memory pressures etc. -See https://chromium.googlesource.com/chromium/src/+/master/mojo/README.md +See https://chromium.googlesource.com/chromium/src/+/main/mojo/README.md See also: [IPC](#ipc) diff --git a/docs/tutorial/sandbox.md b/docs/tutorial/sandbox.md index 0eb955c5da75..db71727efb6c 100644 --- a/docs/tutorial/sandbox.md +++ b/docs/tutorial/sandbox.md @@ -157,7 +157,7 @@ versions of Electron, we do not make a guarantee that every fix will be backported. Your best chance at staying secure is to be on the latest stable version of Electron. -[sandbox]: https://chromium.googlesource.com/chromium/src/+/master/docs/design/sandbox.md +[sandbox]: https://chromium.googlesource.com/chromium/src/+/main/docs/design/sandbox.md [issue-28466]: https://github.com/electron/electron/issues/28466 [browser-window]: ../api/browser-window.md [enable-sandbox]: ../api/app.md#appenablesandbox