diff --git a/docs/tutorial/planned-breaking-changes.md b/docs/tutorial/planned-breaking-changes.md index 7dfc6084f5c9..b5401bfc2e4b 100644 --- a/docs/tutorial/planned-breaking-changes.md +++ b/docs/tutorial/planned-breaking-changes.md @@ -1,6 +1,6 @@ # Planned Breaking API Changes -The following list includes the APIs that will be removed in Electron 2.0. +The following list includes the APIs that will be removed in Electron 3.0. There is no timetable for when this release will occur but deprecation warnings will be added at least 90 days beforehand. @@ -25,16 +25,6 @@ let optionsB = {webPreferences: {enableBlinkFeatures: ''}} let windowB = new BrowserWindow(optionsB) ``` - -```js -// Deprecated -let optionsA = {titleBarStyle: 'hidden-inset'} -let windowA = new BrowserWindow(optionsA) -// Replace with -let optionsB = {titleBarStyle: 'hiddenInset'} -let windowB = new BrowserWindow(optionsB) -``` - ## `clipboard` ```js @@ -76,28 +66,9 @@ crashReporter.start({ }) ``` -## `menu` - -```js -// Deprecated -menu.popup(browserWindow, 100, 200, 2) -// Replace with -menu.popup(browserWindow, {x: 100, y: 200, positioningItem: 2}) -``` - ## `nativeImage` ```js -// Deprecated -nativeImage.toPng() -// Replace with -nativeImage.toPNG() - -// Deprecated -nativeImage.toJpeg() -// Replace with -nativeImage.toJPEG() - // Deprecated nativeImage.createFromBuffer(buffer, 1.0) // Replace with @@ -106,19 +77,15 @@ nativeImage.createFromBuffer(buffer, { }) ``` -## `process` +## `screen` ```js // Deprecated -process.versions['atom-shell'] +screen.getMenuBarHeight() // Replace with -process.versions.electron +screen.getPrimaryDisplay().workArea ``` -* `process.versions.electron` and `process.version.chrome` will be made - read-only properties for consistency with the other `process.versions` - properties set by Node. - ## `session` ```js @@ -155,21 +122,9 @@ webContents.openDevTools({detach: true}) webContents.openDevTools({mode: 'detach'}) ``` -```js -// Deprecated -webContents.setZoomLevelLimits(1, 2) -// Replace with -webContents.setVisualZoomLevelLimits(1, 2) -``` - ## `webFrame` ```js -// Deprecated -webFrame.setZoomLevelLimits(1, 2) -// Replace with -webFrame.setVisualZoomLevelLimits(1, 2) - // Deprecated webFrame.registerURLSchemeAsSecure('app') // Replace with @@ -181,15 +136,6 @@ webFrame.registerURLSchemeAsPrivileged('app', {secure: true}) protocol.registerStandardSchemes(['app'], {secure: true}) ``` -## `` - -```js -// Deprecated -webview.setZoomLevelLimits(1, 2) -// Replace with -webview.setVisualZoomLevelLimits(1, 2) -``` - ## Node Headers URL This is the URL specified as `disturl` in a `.npmrc` file or as the `--dist-url` @@ -199,26 +145,8 @@ Deprecated: https://atom.io/download/atom-shell Replace with: https://atom.io/download/electron -## Duplicate ARM Assets - -Each Electron release includes two identical ARM builds with slightly different -filenames, like `electron-v1.7.3-linux-arm.zip` and -`electron-v1.7.3-linux-armv7l.zip`. The asset with the `v7l` prefix was added -to clarify to users which ARM version it supports, and to disambiguate it from -future armv6l and arm64 assets that may be produced. - -The file _without the prefix_ is still being published to avoid breaking any -setups that may be consuming it. Starting at 2.0, the un-prefixed file will -no longer be published. - -For details, see -[6986](https://github.com/electron/electron/pull/6986) -and -[7189](https://github.com/electron/electron/pull/7189). - - ## `FIXME` comments -The `FIXME` string is used in code comments to denote things that should be -fixed for the 2.0 release. See +The `FIXME` string is used in code comments to denote things that should be +fixed for the 3.0 release. See https://github.com/electron/electron/search?q=fixme