From fd9f7cb3c746fde0d3de1ab4b49967bff3ec0611 Mon Sep 17 00:00:00 2001 From: girst Date: Fri, 8 Mar 2024 16:07:16 +0100 Subject: [PATCH] update external documentation hyperlinks sadly, a lot of interesting stuff has just evaporated. * Browser is no a custom element (MozBrowser) https://searchfox.org/mozilla-central/source/toolkit/content/widgets/browser-custom-element.js * Services.jsm is now built into the C++ core https://bugzilla.mozilla.org/show_bug.cgi?id=1464542 --- documentation/api.md | 11 ++++++----- documentation/config-file.md | 19 ++++++++++--------- documentation/known-bugs.md | 8 +++----- documentation/options.md | 2 +- documentation/tools.md | 6 +++--- 5 files changed, 23 insertions(+), 23 deletions(-) diff --git a/documentation/api.md b/documentation/api.md index 892d734..2d984ad 100644 --- a/documentation/api.md +++ b/documentation/api.md @@ -932,13 +932,14 @@ returns the DOM element associated with that id. If no element can be found, [commands.coffee]: ../extension/lib/commands.coffee [vim.coffee]: ../extension/lib/vim.coffee + [`event.key`]: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key [`event.code`]: https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/code [`Window`]: https://developer.mozilla.org/en-US/docs/Web/API/Window -[`Browser`]: https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/browser +[`Browser`]: https://web.archive.org/web/20210216134001/https://developer.mozilla.org/en-US/docs/Archive/Mozilla/XUL/browser [`window.location`]: https://developer.mozilla.org/en-US/docs/Web/API/Location [`URL`]: https://developer.mozilla.org/en-US/docs/Web/API/URL -[Message Manager]: https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox/Message_Manager -[TabSelect]: https://developer.mozilla.org/en-US/docs/Web/Events/TabSelect -[web console]: https://developer.mozilla.org/en-US/docs/Tools/Web_Console -[about:config]: http://kb.mozillazine.org/About:config +[Message Manager]: https://web.archive.org/web/20210515122642/https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Multiprocess_Firefox/Message_manager +[TabSelect]: https://web.archive.org/web/20180512135723/https://developer.mozilla.org/en-US/docs/Web/Events/TabSelect +[web console]: https://firefox-source-docs.mozilla.org/devtools-user/web_console/index.html +[about:config]: https://kb.mozillazine.org/About:config diff --git a/documentation/config-file.md b/documentation/config-file.md index 64bc6fe..94b60de 100644 --- a/documentation/config-file.md +++ b/documentation/config-file.md @@ -81,8 +81,8 @@ Note: The [**browser** console][browser console] (default Firefox shortcut: ``) is not the same as the [_web_ console][web console] (default Firefox shortcut: ``). It’s easy to mix them up as a beginner! -[browser console]: https://developer.mozilla.org/en-US/docs/Tools/Browser_Console -[web console]: https://developer.mozilla.org/en-US/docs/Tools/Web_Console +[browser console]: https://firefox-source-docs.mozilla.org/devtools-user/browser_console/index.html +[web console]: https://firefox-source-docs.mozilla.org/devtools-user/web_console/index.html [notification]: notifications.md @@ -110,15 +110,16 @@ Both `config.js` and `frame.js` have access to the following variables: `frame.js` also has access to the entire standard Firefox [frame script environment], which might be interesting to advanced users. + [`config.js` API]: api.md#configjs-api [`frame.js` API]: api.md#framejs-api [`console`]: https://developer.mozilla.org/en-US/docs/Web/API/console -[`Components`]: https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components_object -[`Services`]: https://developer.mozilla.org/en-US/docs/Mozilla/JavaScript_code_modules/Services.jsm -[frame script environment]: https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox/Frame_script_environment +[`Components`]: https://web.archive.org/web/20210614111450/https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components_object +[`Services`]: https://web.archive.org/web/20210415055941/https://developer.mozilla.org/en-US/docs/Mozilla/JavaScript_code_modules/Services.jsm +[frame script environment]: https://web.archive.org/web/20201221164134/https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Multiprocess_Firefox/Frame_script_environment [`Window`]: https://developer.mozilla.org/en-US/docs/Web/API/Window -[browser console]: https://developer.mozilla.org/en-US/docs/Tools/Browser_Console -[web console]: https://developer.mozilla.org/en-US/docs/Tools/Web_Console +[browser console]: https://firefox-source-docs.mozilla.org/devtools-user/browser_console/index.html +[web console]: https://firefox-source-docs.mozilla.org/devtools-user/web_console/index.html ## config.js @@ -148,7 +149,7 @@ Object.entries(options).forEach(([option, value]) => vimfx.set(option, value)) ``` [custom-command-shortcuts]: api.md#user-content-custom-command-shortcuts -[e10s]: https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox +[e10s]: https://firefox-source-docs.mozilla.org/dom/ipc/process_model.html ## frame.js @@ -171,7 +172,7 @@ However, that’s a legacy Firefox feature that can stop working at any time, an can even slow Firefox down! Don’t use such methods if you come across them.) [`vimfx.send(...)`]: api.md#vimfxsendvim-message-data--null-callback--null -[e10s]: https://developer.mozilla.org/en-US/Firefox/Multiprocess_Firefox +[e10s]: https://firefox-source-docs.mozilla.org/dom/ipc/process_model.html ## When is the config file executed? diff --git a/documentation/known-bugs.md b/documentation/known-bugs.md index 6ffda99..a785e47 100644 --- a/documentation/known-bugs.md +++ b/documentation/known-bugs.md @@ -24,23 +24,21 @@ the bug. IPC between processes. It is likely that the BootstrapLoader would need to be adapted to handle this, which is not happening unless someone else does it. --> -[bfcache]: https://web.dev/bfcache/ +[bfcache]: https://web.dev/articles/bfcache ## Fission **Affected**: Firefox >= 96 **Workaround**: `fission.webContentIsolationStrategy;0` -With [Fission] enabled, VimFx can't inspect out-of-process iframes. +With [Fission] enabled, VimFx doesn't work in out-of-process iframes. With Fission, sometimes called *Site Isolation*, VimFx cannot place hint markers or detect input elements inside iframes from a different domain to the top document. We will instead enter insert mode whenever such an iframe is active. Hit Escape or click outside the iframe to let VimFx re-gain control. Setting `fission.webContentIsolationStrategy` to `0` in `about:config` only disables the -iframe part of Fission, but is available only since Firefox 94. Some Nightly -installations were opted into Fission earlier; set `fission.autostart` -to `false` if the main workaround is unavailable. +iframe part of Fission. Note that as of now (Firefox 119), when `webContentIsolationStrategy` is set, reloading a webpage causes additional entries in the history and loss of forward diff --git a/documentation/options.md b/documentation/options.md index 0f168cb..d48f082 100644 --- a/documentation/options.md +++ b/documentation/options.md @@ -407,7 +407,7 @@ trigger a keyboard shortcut containing `$`. _With_ this option the result is to trigger keyboard shortcuts such as ``, but ctrl+alt keyboard shortcuts are [discouraged on Windows][wikipedia-altgr] anyway because of this reason. -[wikipedia-altgr]: https://en.wikipedia.org/wiki/AltGr_key#Control_.2B_Alt_as_a_substitute +[wikipedia-altgr]: https://en.wikipedia.org/wiki/AltGr_key#Ctrl.2BAlt ### `prevent_autofocus_modes` diff --git a/documentation/tools.md b/documentation/tools.md index cc8958b..fa30ad5 100644 --- a/documentation/tools.md +++ b/documentation/tools.md @@ -20,7 +20,7 @@ This section describes how to install and use the tools needed to: If you prefer not to install `gulp` globally, you can use `npm run gulp` instead. For example, to create an .xpi file: `npm run gulp -- xpi`. -[Node.js]: http://nodejs.org/ +[Node.js]: https://nodejs.org/ [gulp]: https://github.com/gulpjs/gulp @@ -48,7 +48,7 @@ To test a new verison, open the build directory in the browser and install the XPI from there. Sometimes, you'll have to restart Firefox after installation/upgrade. -[Firefox Profile]: https://support.mozilla.org/en-US/kb/profile-manager-create-and-remove-firefox-profiles +[Firefox Profile]: https://support.mozilla.org/en-US/kb/profile-manager-create-remove-switch-firefox-profiles [LegacyFox]: https://git.gir.st/LegacyFox.git @@ -82,7 +82,7 @@ internally by other tasks.) - `gulp clean` removes the `build/` directory. -[browser console]: https://developer.mozilla.org/en-US/docs/Tools/Browser_Console +[browser console]: https://firefox-source-docs.mozilla.org/devtools-user/browser_console/index.html ### Management -- 2.39.3