diff options
author | Antoine du Hamel <duhamelantoine1995@gmail.com> | 2020-09-14 18:09:13 +0300 |
---|---|---|
committer | Danielle Adams <adamzdanielle@gmail.com> | 2020-10-06 18:54:24 +0300 |
commit | ce789f1ca40289213fa14d024e8f71aa4058353d (patch) | |
tree | 4698cb3981154fcb7421f00dd21d1a949c6c16da | |
parent | f23a0e250cb8aa5867acef64a040989f62216e0e (diff) |
doc: use .md extension for internal links
This helps catch broken links as part of the test suite. This also
improves the user experience when browsing the markdown files.
PR-URL: https://github.com/nodejs/node/pull/35191
Fixes: https://github.com/nodejs/node/issues/35189
Reviewed-By: Derek Lewis <DerekNonGeneric@inf.is>
Reviewed-By: Jiawen Geng <technicalcute@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
55 files changed, 732 insertions, 672 deletions
diff --git a/doc/api/addons.md b/doc/api/addons.md index bfe527cac99..aa71f8726f2 100644 --- a/doc/api/addons.md +++ b/doc/api/addons.md @@ -10,7 +10,7 @@ Addons provide an interface between JavaScript and C/C++ libraries. There are three options for implementing addons: N-API, nan, or direct use of internal V8, libuv and Node.js libraries. Unless there is a need for direct access to functionality which is not exposed by N-API, use N-API. -Refer to [C/C++ addons with N-API](n-api.html) for more information on N-API. +Refer to [C/C++ addons with N-API](n-api.md) for more information on N-API. When not using N-API, implementing addons is complicated, involving knowledge of several components and APIs: @@ -452,7 +452,7 @@ in the N-API are used. Creating and maintaining an addon that benefits from the ABI stability provided by N-API carries with it certain -[implementation considerations](n-api.html#n_api_implications_of_abi_stability). +[implementation considerations](n-api.md#n_api_implications_of_abi_stability). To use N-API in the above "Hello world" example, replace the content of `hello.cc` with the following. All other instructions remain the same. @@ -490,7 +490,7 @@ NAPI_MODULE(NODE_GYP_MODULE_NAME, init) ``` The functions available and how to use them are documented in -[C/C++ addons with N-API](n-api.html). +[C/C++ addons with N-API](n-api.md). ## Addon examples @@ -1356,7 +1356,7 @@ console.log(result); // Prints: 30 ``` -[`Worker`]: worker_threads.html#worker_threads_class_worker +[`Worker`]: worker_threads.md#worker_threads_class_worker [Electron]: https://electronjs.org/ [Embedder's Guide]: https://github.com/v8/v8/wiki/Embedder's%20Guide [Linking to libraries included with Node.js]: #addons_linking_to_libraries_included_with_node_js @@ -1367,5 +1367,5 @@ console.log(result); [installation instructions]: https://github.com/nodejs/node-gyp#installation [libuv]: https://github.com/libuv/libuv [node-gyp]: https://github.com/nodejs/node-gyp -[require]: modules.html#modules_require_id +[require]: modules.md#modules_require_id [v8-docs]: https://v8docs.nodesource.com/ diff --git a/doc/api/assert.md b/doc/api/assert.md index e074107cf56..c8ef843abbc 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -64,7 +64,7 @@ assert.deepEqual([[[1, 2, 3]], 4, 5], [[[1, 2, '3']], 4, 5]); To deactivate the colors, use the `NO_COLOR` or `NODE_DISABLE_COLORS` environment variables. This will also deactivate the colors in the REPL. For more on color support in terminal environments, read the tty -[getColorDepth()](tty.html#tty_writestream_getcolordepth_env) documentation. +[getColorDepth()](tty.md#tty_writestream_getcolordepth_env) documentation. ## Legacy assertion mode @@ -1558,15 +1558,15 @@ argument. [`AssertionError`]: #assert_class_assert_assertionerror [`Class`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes -[`ERR_INVALID_RETURN_VALUE`]: errors.html#errors_err_invalid_return_value -[`Error.captureStackTrace`]: errors.html#errors_error_capturestacktrace_targetobject_constructoropt -[`Error`]: errors.html#errors_class_error +[`ERR_INVALID_RETURN_VALUE`]: errors.md#errors_err_invalid_return_value +[`Error.captureStackTrace`]: errors.md#errors_error_capturestacktrace_targetobject_constructoropt +[`Error`]: errors.md#errors_class_error [`Map`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map [`Object.is()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is [`RegExp`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions [`Set`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set [`Symbol`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol -[`TypeError`]: errors.html#errors_class_typeerror +[`TypeError`]: errors.md#errors_class_typeerror [`WeakMap`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap [`WeakSet`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet [`CallTracker`]: #assert_class_assert_calltracker @@ -1581,7 +1581,7 @@ argument. [`assert.ok()`]: #assert_assert_ok_value_message [`assert.strictEqual()`]: #assert_assert_strictequal_actual_expected_message [`assert.throws()`]: #assert_assert_throws_fn_error_message -[`process.on('exit')`]: process.html#process_event_exit +[`process.on('exit')`]: process.md#process_event_exit [`tracker.calls()`]: #assert_tracker_calls_fn_exact [`tracker.verify()`]: #assert_tracker_verify [strict assertion mode]: #assert_strict_assertion_mode diff --git a/doc/api/async_hooks.md b/doc/api/async_hooks.md index 473467d144f..ada23efd6cc 100644 --- a/doc/api/async_hooks.md +++ b/doc/api/async_hooks.md @@ -1173,10 +1173,10 @@ to associate the asynchronous operation with the correct execution context. [`destroy` callback]: #async_hooks_destroy_asyncid [`init` callback]: #async_hooks_init_asyncid_type_triggerasyncid_resource [`promiseResolve` callback]: #async_hooks_promiseresolve_asyncid -[`EventEmitter`]: events.html#events_class_eventemitter +[`EventEmitter`]: events.md#events_class_eventemitter [Hook Callbacks]: #async_hooks_hook_callbacks [PromiseHooks]: https://docs.google.com/document/d/1rda3yKGHimKIhg5YeoAmCOtyURgsbTH_qaYR79FELlk/edit -[`Stream`]: stream.html#stream_stream -[`Worker`]: worker_threads.html#worker_threads_class_worker +[`Stream`]: stream.md#stream_stream +[`Worker`]: worker_threads.md#worker_threads_class_worker [promise execution tracking]: #async_hooks_promise_execution_tracking -[`util.promisify()`]: util.html#util_util_promisify_original +[`util.promisify()`]: util.md#util_util_promisify_original diff --git a/doc/api/buffer.md b/doc/api/buffer.md index 56449d1a6ec..3f536f3bcf8 100644 --- a/doc/api/buffer.md +++ b/doc/api/buffer.md @@ -3273,9 +3273,9 @@ introducing security vulnerabilities into an application. [`Buffer.from(string)`]: #buffer_static_method_buffer_from_string_encoding [`Buffer.poolSize`]: #buffer_class_property_buffer_poolsize [`DataView`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView -[`ERR_INVALID_BUFFER_SIZE`]: errors.html#ERR_INVALID_BUFFER_SIZE -[`ERR_INVALID_OPT_VALUE`]: errors.html#ERR_INVALID_OPT_VALUE -[`ERR_OUT_OF_RANGE`]: errors.html#ERR_OUT_OF_RANGE +[`ERR_INVALID_BUFFER_SIZE`]: errors.md#ERR_INVALID_BUFFER_SIZE +[`ERR_INVALID_OPT_VALUE`]: errors.md#ERR_INVALID_OPT_VALUE +[`ERR_OUT_OF_RANGE`]: errors.md#ERR_OUT_OF_RANGE [`JSON.stringify()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify [`SharedArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer [`String#indexOf()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf @@ -3300,7 +3300,7 @@ introducing security vulnerabilities into an application. [`buffer.constants.MAX_LENGTH`]: #buffer_buffer_constants_max_length [`buffer.constants.MAX_STRING_LENGTH`]: #buffer_buffer_constants_max_string_length [`buffer.kMaxLength`]: #buffer_buffer_kmaxlength -[`util.inspect()`]: util.html#util_util_inspect_object_options +[`util.inspect()`]: util.md#util_util_inspect_object_options [ASCII]: https://en.wikipedia.org/wiki/ASCII [Base64]: https://en.wikipedia.org/wiki/Base64 [ISO-8859-1]: https://en.wikipedia.org/wiki/ISO-8859-1 diff --git a/doc/api/child_process.md b/doc/api/child_process.md index 3a5f64d6228..6452c881dd0 100644 --- a/doc/api/child_process.md +++ b/doc/api/child_process.md @@ -1580,13 +1580,13 @@ Therefore, this feature requires opting in by setting the or [`child_process.fork()`][]. [Advanced serialization]: #child_process_advanced_serialization -[`'disconnect'`]: process.html#process_event_disconnect +[`'disconnect'`]: process.md#process_event_disconnect [`'error'`]: #child_process_event_error [`'exit'`]: #child_process_event_exit -[`'message'`]: process.html#process_event_message +[`'message'`]: process.md#process_event_message [`ChildProcess`]: #child_process_child_process -[`Error`]: errors.html#errors_class_error -[`EventEmitter`]: events.html#events_class_eventemitter +[`Error`]: errors.md#errors_class_error +[`EventEmitter`]: events.md#events_class_eventemitter [`child_process.exec()`]: #child_process_child_process_exec_command_options_callback [`child_process.execFile()`]: #child_process_child_process_execfile_file_args_options_callback [`child_process.execFileSync()`]: #child_process_child_process_execfilesync_file_args_options @@ -1595,13 +1595,13 @@ or [`child_process.fork()`][]. [`child_process.spawn()`]: #child_process_child_process_spawn_command_args_options [`child_process.spawnSync()`]: #child_process_child_process_spawnsync_command_args_options [`maxBuffer` and Unicode]: #child_process_maxbuffer_and_unicode -[`net.Server`]: net.html#net_class_net_server -[`net.Socket`]: net.html#net_class_net_socket +[`net.Server`]: net.md#net_class_net_server +[`net.Socket`]: net.md#net_class_net_socket [`options.detached`]: #child_process_options_detached -[`process.disconnect()`]: process.html#process_process_disconnect -[`process.env`]: process.html#process_process_env -[`process.execPath`]: process.html#process_process_execpath -[`process.send()`]: process.html#process_process_send_message_sendhandle_options_callback +[`process.disconnect()`]: process.md#process_process_disconnect +[`process.env`]: process.md#process_process_env +[`process.execPath`]: process.md#process_process_execpath +[`process.send()`]: process.md#process_process_send_message_sendhandle_options_callback [`stdio`]: #child_process_options_stdio [`subprocess.connected`]: #child_process_subprocess_connected [`subprocess.disconnect()`]: #child_process_subprocess_disconnect @@ -1611,9 +1611,9 @@ or [`child_process.fork()`][]. [`subprocess.stdin`]: #child_process_subprocess_stdin [`subprocess.stdio`]: #child_process_subprocess_stdio [`subprocess.stdout`]: #child_process_subprocess_stdout -[`util.promisify()`]: util.html#util_util_promisify_original +[`util.promisify()`]: util.md#util_util_promisify_original [Default Windows shell]: #child_process_default_windows_shell [HTML structured clone algorithm]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm [Shell requirements]: #child_process_shell_requirements [synchronous counterparts]: #child_process_synchronous_process_creation -[v8.serdes]: v8.html#v8_serialization_api +[v8.serdes]: v8.md#v8_serialization_api diff --git a/doc/api/cli.md b/doc/api/cli.md index b0ff3fe30c2..a5c678b30cb 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -1554,27 +1554,27 @@ $ node --max-old-space-size=1536 index.js ``` [Chrome DevTools Protocol]: https://chromedevtools.github.io/devtools-protocol/ -[REPL]: repl.html +[REPL]: repl.md [ScriptCoverage]: https://chromedevtools.github.io/devtools-protocol/tot/Profiler#type-ScriptCoverage [Source Map]: https://sourcemaps.info/spec.html [Subresource Integrity]: https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity [V8 JavaScript code coverage]: https://v8project.blogspot.com/2017/12/javascript-code-coverage.html [`--openssl-config`]: #cli_openssl_config_file [`Atomics.wait()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/wait -[`Buffer`]: buffer.html#buffer_class_buffer +[`Buffer`]: buffer.md#buffer_class_buffer [`NODE_OPTIONS`]: #cli_node_options_options -[`SlowBuffer`]: buffer.html#buffer_class_slowbuffer -[`process.setUncaughtExceptionCaptureCallback()`]: process.html#process_process_setuncaughtexceptioncapturecallback_fn -[`tls.DEFAULT_MAX_VERSION`]: tls.html#tls_tls_default_max_version -[`tls.DEFAULT_MIN_VERSION`]: tls.html#tls_tls_default_min_version -[`unhandledRejection`]: process.html#process_event_unhandledrejection -[`worker_threads.threadId`]: worker_threads.html#worker_threads_worker_threadid -[context-aware]: addons.html#addons_context_aware_addons -[customizing ESM specifier resolution]: esm.html#esm_customizing_esm_specifier_resolution_algorithm -[debugger]: debugger.html +[`SlowBuffer`]: buffer.md#buffer_class_slowbuffer +[`process.setUncaughtExceptionCaptureCallback()`]: process.md#process_process_setuncaughtexceptioncapturecallback_fn +[`tls.DEFAULT_MAX_VERSION`]: tls.md#tls_tls_default_max_version +[`tls.DEFAULT_MIN_VERSION`]: tls.md#tls_tls_default_min_version +[`unhandledRejection`]: process.md#process_event_unhandledrejection +[`worker_threads.threadId`]: worker_threads.md#worker_threads_worker_threadid +[context-aware]: addons.md#addons_context_aware_addons +[customizing ESM specifier resolution]: esm.md#esm_customizing_esm_specifier_resolution_algorithm +[debugger]: debugger.md [debugging security implications]: https://nodejs.org/en/docs/guides/debugging-getting-started/#security-implications -[emit_warning]: process.html#process_process_emitwarning_warning_type_code_ctor -[experimental ECMAScript Module loader]: esm.html#esm_experimental_loaders +[emit_warning]: process.md#process_process_emitwarning_warning_type_code_ctor +[experimental ECMAScript Module loader]: esm.md#esm_experimental_loaders [jitless]: https://v8.dev/blog/jitless [libuv threadpool documentation]: https://docs.libuv.org/en/latest/threadpool.html [remote code execution]: https://www.owasp.org/index.php/Code_Injection diff --git a/doc/api/cluster.md b/doc/api/cluster.md index 92e4d42d60e..461b490044e 100644 --- a/doc/api/cluster.md +++ b/doc/api/cluster.md @@ -875,15 +875,15 @@ socket.on('data', (id) => { [`.fork()`]: #cluster_cluster_fork_env [`.setupMaster()`]: #cluster_cluster_setupmaster_settings -[`ChildProcess.send()`]: child_process.html#child_process_subprocess_send_message_sendhandle_options_callback -[`child_process.fork()`]: child_process.html#child_process_child_process_fork_modulepath_args_options -[`child_process` event: `'exit'`]: child_process.html#child_process_event_exit -[`child_process` event: `'message'`]: child_process.html#child_process_event_message +[`ChildProcess.send()`]: child_process.md#child_process_subprocess_send_message_sendhandle_options_callback +[`child_process.fork()`]: child_process.md#child_process_child_process_fork_modulepath_args_options +[`child_process` event: `'exit'`]: child_process.md#child_process_event_exit +[`child_process` event: `'message'`]: child_process.md#child_process_event_message [`cluster.settings`]: #cluster_cluster_settings -[`disconnect()`]: child_process.html#child_process_subprocess_disconnect -[`kill()`]: process.html#process_process_kill_pid_signal -[`process` event: `'message'`]: process.html#process_event_message -[`server.close()`]: net.html#net_event_close +[`disconnect()`]: child_process.md#child_process_subprocess_disconnect +[`kill()`]: process.md#process_process_kill_pid_signal +[`process` event: `'message'`]: process.md#process_event_message +[`server.close()`]: net.md#net_event_close [`worker.exitedAfterDisconnect`]: #cluster_worker_exitedafterdisconnect -[Advanced serialization for `child_process`]: child_process.html#child_process_advanced_serialization -[Child Process module]: child_process.html#child_process_child_process_fork_modulepath_args_options +[Advanced serialization for `child_process`]: child_process.md#child_process_advanced_serialization +[Child Process module]: child_process.md#child_process_child_process_fork_modulepath_args_options diff --git a/doc/api/console.md b/doc/api/console.md index 9e4548581b5..8d05be5e524 100644 --- a/doc/api/console.md +++ b/doc/api/console.md @@ -554,12 +554,12 @@ This method does not display anything unless used in the inspector. The [`console.profileEnd()`]: #console_console_profileend_label [`console.time()`]: #console_console_time_label [`console.timeEnd()`]: #console_console_timeend_label -[`process.stderr`]: process.html#process_process_stderr -[`process.stdout`]: process.html#process_process_stdout -[`util.format()`]: util.html#util_util_format_format_args -[`util.inspect()`]: util.html#util_util_inspect_object_options -[customizing `util.inspect()` colors]: util.html#util_customizing_util_inspect_colors +[`process.stderr`]: process.md#process_process_stderr +[`process.stdout`]: process.md#process_process_stdout +[`util.format()`]: util.md#util_util_format_format_args +[`util.inspect()`]: util.md#util_util_inspect_object_options +[customizing `util.inspect()` colors]: util.md#util_customizing_util_inspect_colors [falsy]: https://developer.mozilla.org/en-US/docs/Glossary/Falsy -[inspector]: debugger.html -[note on process I/O]: process.html#process_a_note_on_process_i_o +[inspector]: debugger.md +[note on process I/O]: process.md#process_a_note_on_process_i_o [truthy]: https://developer.mozilla.org/en-US/docs/Glossary/Truthy diff --git a/doc/api/crypto.md b/doc/api/crypto.md index 8857370d480..3dc96b2c108 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -3544,11 +3544,11 @@ See the [list of SSL OP Flags][] for details. </tr> </table> -[`Buffer`]: buffer.html +[`Buffer`]: buffer.md [`EVP_BytesToKey`]: https://www.openssl.org/docs/man1.1.0/crypto/EVP_BytesToKey.html [`KeyObject`]: #crypto_class_keyobject [`Sign`]: #crypto_class_sign -[`UV_THREADPOOL_SIZE`]: cli.html#cli_uv_threadpool_size_size +[`UV_THREADPOOL_SIZE`]: cli.md#cli_uv_threadpool_size_size [`Verify`]: #crypto_class_verify [`cipher.final()`]: #crypto_cipher_final_outputencoding [`cipher.update()`]: #crypto_cipher_update_data_inputencoding_outputencoding @@ -3586,12 +3586,12 @@ See the [list of SSL OP Flags][] for details. [`hmac.digest()`]: #crypto_hmac_digest_encoding [`hmac.update()`]: #crypto_hmac_update_data_inputencoding [`keyObject.export()`]: #crypto_keyobject_export_options -[`postMessage()`]: worker_threads.html#worker_threads_port_postmessage_value_transferlist +[`postMessage()`]: worker_threads.md#worker_threads_port_postmessage_value_transferlist [`sign.sign()`]: #crypto_sign_sign_privatekey_outputencoding [`sign.update()`]: #crypto_sign_update_data_inputencoding -[`stream.Writable` options]: stream.html#stream_new_stream_writable_options -[`stream.transform` options]: stream.html#stream_new_stream_transform_options -[`util.promisify()`]: util.html#util_util_promisify_original +[`stream.Writable` options]: stream.md#stream_new_stream_writable_options +[`stream.transform` options]: stream.md#stream_new_stream_transform_options +[`util.promisify()`]: util.md#util_util_promisify_original [`verify.update()`]: #crypto_verify_update_data_inputencoding [`verify.verify()`]: #crypto_verify_verify_object_signature_signatureencoding [AEAD algorithms]: https://en.wikipedia.org/wiki/Authenticated_encryption @@ -3612,10 +3612,10 @@ See the [list of SSL OP Flags][] for details. [RFC 3610]: https://www.rfc-editor.org/rfc/rfc3610.txt [RFC 4055]: https://www.rfc-editor.org/rfc/rfc4055.txt [RFC 5208]: https://www.rfc-editor.org/rfc/rfc5208.txt -[encoding]: buffer.html#buffer_buffers_and_character_encodings +[encoding]: buffer.md#buffer_buffers_and_character_encodings [initialization vector]: https://en.wikipedia.org/wiki/Initialization_vector [list of SSL OP Flags]: https://wiki.openssl.org/index.php/List_of_SSL_OP_Flags#Table_of_Options [safe integers]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isSafeInteger [scrypt]: https://en.wikipedia.org/wiki/Scrypt -[stream]: stream.html -[stream-writable-write]: stream.html#stream_writable_write_chunk_encoding_callback +[stream]: stream.md +[stream-writable-write]: stream.md#stream_writable_write_chunk_encoding_callback diff --git a/doc/api/debugger.md b/doc/api/debugger.md index 8253c176e43..2579a72b97a 100644 --- a/doc/api/debugger.md +++ b/doc/api/debugger.md @@ -201,5 +201,5 @@ Chrome DevTools doesn't support debugging [worker threads][] yet. [Chrome DevTools Protocol]: https://chromedevtools.github.io/devtools-protocol/ [V8 Inspector]: #debugger_v8_inspector_integration_for_node_js -[worker threads]: worker_threads.html +[worker threads]: worker_threads.md [ndb]: https://github.com/GoogleChromeLabs/ndb/ diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 261c7fbd911..5ff0c2abfc7 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -2623,127 +2623,127 @@ Type: Documentation-only The [`crypto.Certificate()` constructor][] is deprecated. Use [static methods of `crypto.Certificate()`][] instead. -[`--pending-deprecation`]: cli.html#cli_pending_deprecation -[`--throw-deprecation`]: cli.html#cli_throw_deprecation -[`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_static_method_buffer_allocunsafeslow_size -[`Buffer.from(array)`]: buffer.html#buffer_static_method_buffer_from_array -[`Buffer.from(buffer)`]: buffer.html#buffer_static_method_buffer_from_buffer -[`Buffer.isBuffer()`]: buffer.html#buffer_static_method_buffer_isbuffer_obj -[`Cipher`]: crypto.html#crypto_class_cipher -[`Decipher`]: crypto.html#crypto_class_decipher -[`EventEmitter.listenerCount(emitter, eventName)`]: events.html#events_eventemitter_listenercount_emitter_eventname -[`REPLServer.clearBufferedCommand()`]: repl.html#repl_replserver_clearbufferedcommand -[`ReadStream.open()`]: fs.html#fs_class_fs_readstream -[`Server.connections`]: net.html#net_server_connections -[`Server.getConnections()`]: net.html#net_server_getconnections_callback -[`Server.listen({fd: <number>})`]: net.html#net_server_listen_handle_backlog_callback -[`SlowBuffer`]: buffer.html#buffer_class_slowbuffer -[`WriteStream.open()`]: fs.html#fs_class_fs_writestream -[`assert`]: assert.html -[`asyncResource.runInAsyncScope()`]: async_hooks.html#async_hooks_asyncresource_runinasyncscope_fn_thisarg_args -[`child_process`]: child_process.html -[`clearInterval()`]: timers.html#timers_clearinterval_timeout -[`clearTimeout()`]: timers.html#timers_cleartimeout_timeout -[`console.error()`]: console.html#console_console_error_data_args -[`console.log()`]: console.html#console_console_log_data_args -[`crypto.Certificate()` constructor]: crypto.html#crypto_legacy_api -[`crypto.DEFAULT_ENCODING`]: crypto.html#crypto_crypto_default_encoding -[`crypto.createCipher()`]: crypto.html#crypto_crypto_createcipher_algorithm_password_options -[`crypto.createCipheriv()`]: crypto.html#crypto_crypto_createcipheriv_algorithm_key_iv_options -[`crypto.createDecipher()`]: crypto.html#crypto_crypto_createdecipher_algorithm_password_options -[`crypto.createDecipheriv()`]: crypto.html#crypto_crypto_createdecipheriv_algorithm_key_iv_options -[`crypto.fips`]: crypto.html#crypto_crypto_fips -[`crypto.pbkdf2()`]: crypto.html#crypto_crypto_pbkdf2_password_salt_iterations_keylen_digest_callback -[`crypto.randomBytes()`]: crypto.html#crypto_crypto_randombytes_size_callback -[`crypto.scrypt()`]: crypto.html#crypto_crypto_scrypt_password_salt_keylen_options_callback -[`decipher.final()`]: crypto.html#crypto_decipher_final_outputencoding -[`decipher.setAuthTag()`]: crypto.html#crypto_decipher_setauthtag_buffer -[`domain`]: domain.html -[`ecdh.setPublicKey()`]: crypto.html#crypto_ecdh_setpublickey_publickey_encoding -[`emitter.listenerCount(eventName)`]: events.html#events_emitter_listenercount_eventname -[`fs.FileHandle`]: fs.html#fs_class_filehandle -[`fs.access()`]: fs.html#fs_fs_access_path_mode_callback -[`fs.createReadStream()`]: fs.html#fs_fs_createreadstream_path_options -[`fs.createWriteStream()`]: fs.html#fs_fs_createwritestream_path_options -[`fs.exists(path, callback)`]: fs.html#fs_fs_exists_path_callback -[`fs.lchmod(path, mode, callback)`]: fs.html#fs_fs_lchmod_path_mode_callback -[`fs.lchmodSync(path, mode)`]: fs.html#fs_fs_lchmodsync_path_mode -[`fs.lchown(path, uid, gid, callback)`]: fs.html#fs_fs_lchown_path_uid_gid_callback -[`fs.lchownSync(path, uid, gid)`]: fs.html#fs_fs_lchownsync_path_uid_gid -[`fs.read()`]: fs.html#fs_fs_read_fd_buffer_offset_length_position_callback -[`fs.readSync()`]: fs.html#fs_fs_readsync_fd_buffer_offset_length_position -[`fs.stat()`]: fs.html#fs_fs_stat_path_options_callback -[`http.get()`]: http.html#http_http_get_options_callback -[`http.request()`]: http.html#http_http_request_options_callback -[`https.get()`]: https.html#https_https_get_options_callback -[`https.request()`]: https.html#https_https_request_options_callback -[`module.createRequire()`]: module.html#module_module_createrequire_filename -[`os.networkInterfaces()`]: os.html#os_os_networkinterfaces -[`os.tmpdir()`]: os.html#os_os_tmpdir -[`process.env`]: process.html#process_process_env -[`process.mainModule`]: process.html#process_process_mainmodule -[`punycode`]: punycode.html -[`require.extensions`]: modules.html#modules_require_extensions -[`require.main`]: modules.html#modules_accessing_the_main_module -[`request.abort()`]: http.html#http_request_abort -[`request.socket`]: http.html#http_request_socket -[`request.connection`]: http.html#http_request_connection -[`request.destroy()`]: http.html#http_request_destroy_error -[`response.socket`]: http.html#http_response_socket -[`response.connection`]: http.html#http_response_connection -[`response.end()`]: http.html#http_response_end_data_encoding_callback -[`response.finished`]: http.html#http_response_finished -[`response.writableFinished`]: http.html#http_response_writablefinished -[`response.writableEnded`]: http.html#http_response_writableended -[`script.createCachedData()`]: vm.html#vm_script_createcacheddata -[`setInterval()`]: timers.html#timers_setinterval_callback_delay_args -[`setTimeout()`]: timers.html#timers_settimeout_callback_delay_args -[`socket.bufferSize`]: net.html#net_socket_buffersize -[`timeout.ref()`]: timers.html#timers_timeout_ref -[`timeout.refresh()`]: timers.html#timers_timeout_refresh -[`timeout.unref()`]: timers.html#timers_timeout_unref -[`tls.CryptoStream`]: tls.html#tls_class_tls_cryptostream -[`tls.SecureContext`]: tls.html#tls_tls_createsecurecontext_options -[`tls.SecurePair`]: tls.html#tls_class_tls_securepair -[`tls.TLSSocket`]: tls.html#tls_class_tls_tlssocket -[`tls.checkServerIdentity()`]: tls.html#tls_tls_checkserveridentity_hostname_cert -[`tls.createSecureContext()`]: tls.html#tls_tls_createsecurecontext_options -[`url.format()`]: url.html#url_url_format_urlobject -[`url.parse()`]: url.html#url_url_parse_urlstring_parsequerystring_slashesdenotehost -[`url.resolve()`]: url.html#url_url_resolve_from_to -[`util._extend()`]: util.html#util_util_extend_target_source -[`util.getSystemErrorName()`]: util.html#util_util_getsystemerrorname_err -[`util.inspect()`]: util.html#util_util_inspect_object_options -[`util.inspect.custom`]: util.html#util_util_inspect_custom -[`util.isArray()`]: util.html#util_util_isarray_object -[`util.isBoolean()`]: util.html#util_util_isboolean_object -[`util.isBuffer()`]: util.html#util_util_isbuffer_object -[`util.isDate()`]: util.html#util_util_isdate_object -[`util.isError()`]: util.html#util_util_iserror_object -[`util.isFunction()`]: util.html#util_util_isfunction_object -[`util.isNull()`]: util.html#util_util_isnull_object -[`util.isNullOrUndefined()`]: util.html#util_util_isnullorundefined_object -[`util.isNumber()`]: util.html#util_util_isnumber_object -[`util.isObject()`]: util.html#util_util_isobject_object -[`util.isPrimitive()`]: util.html#util_util_isprimitive_object -[`util.isRegExp()`]: util.html#util_util_isregexp_object -[`util.isString()`]: util.html#util_util_isstring_object -[`util.isSymbol()`]: util.html#util_util_issymbol_object -[`util.isUndefined()`]: util.html#util_util_isundefined_object -[`util.log()`]: util.html#util_util_log_string -[`util.types`]: util.html#util_util_types -[`util`]: util.html -[`worker.exitedAfterDisconnect`]: cluster.html#cluster_worker_exitedafterdisconnect -[`worker.terminate()`]: worker_threads.html#worker_threads_worker_terminate -[`writable.writableLength`]: stream.html#stream_writable_writablelength -[`zlib.bytesWritten`]: zlib.html#zlib_zlib_byteswritten -[Legacy URL API]: url.html#url_legacy_url_api +[`--pending-deprecation`]: cli.md#cli_pending_deprecation +[`--throw-deprecation`]: cli.md#cli_throw_deprecation +[`Buffer.allocUnsafeSlow(size)`]: buffer.md#buffer_static_method_buffer_allocunsafeslow_size +[`Buffer.from(array)`]: buffer.md#buffer_static_method_buffer_from_array +[`Buffer.from(buffer)`]: buffer.md#buffer_static_method_buffer_from_buffer +[`Buffer.isBuffer()`]: buffer.md#buffer_static_method_buffer_isbuffer_obj +[`Cipher`]: crypto.md#crypto_class_cipher +[`Decipher`]: crypto.md#crypto_class_decipher +[`EventEmitter.listenerCount(emitter, eventName)`]: events.md#events_eventemitter_listenercount_emitter_eventname +[`REPLServer.clearBufferedCommand()`]: repl.md#repl_replserver_clearbufferedcommand +[`ReadStream.open()`]: fs.md#fs_class_fs_readstream +[`Server.connections`]: net.md#net_server_connections +[`Server.getConnections()`]: net.md#net_server_getconnections_callback +[`Server.listen({fd: <number>})`]: net.md#net_server_listen_handle_backlog_callback +[`SlowBuffer`]: buffer.md#buffer_class_slowbuffer +[`WriteStream.open()`]: fs.md#fs_class_fs_writestream +[`assert`]: assert.md +[`asyncResource.runInAsyncScope()`]: async_hooks.md#async_hooks_asyncresource_runinasyncscope_fn_thisarg_args +[`child_process`]: child_process.md +[`clearInterval()`]: timers.md#timers_clearinterval_timeout +[`clearTimeout()`]: timers.md#timers_cleartimeout_timeout +[`console.error()`]: console.md#console_console_error_data_args +[`console.log()`]: console.md#console_console_log_data_args +[`crypto.Certificate()` constructor]: crypto.md#crypto_legacy_api +[`crypto.DEFAULT_ENCODING`]: crypto.md#crypto_crypto_default_encoding +[`crypto.createCipher()`]: crypto.md#crypto_crypto_createcipher_algorithm_password_options +[`crypto.createCipheriv()`]: crypto.md#crypto_crypto_createcipheriv_algorithm_key_iv_options +[`crypto.createDecipher()`]: crypto.md#crypto_crypto_createdecipher_algorithm_password_options +[`crypto.createDecipheriv()`]: crypto.md#crypto_crypto_createdecipheriv_algorithm_key_iv_options +[`crypto.fips`]: crypto.md#crypto_crypto_fips +[`crypto.pbkdf2()`]: crypto.md#crypto_crypto_pbkdf2_password_salt_iterations_keylen_digest_callback +[`crypto.randomBytes()`]: crypto.md#crypto_crypto_randombytes_size_callback +[`crypto.scrypt()`]: crypto.md#crypto_crypto_scrypt_password_salt_keylen_options_callback +[`decipher.final()`]: crypto.md#crypto_decipher_final_outputencoding +[`decipher.setAuthTag()`]: crypto.md#crypto_decipher_setauthtag_buffer +[`domain`]: domain.md +[`ecdh.setPublicKey()`]: crypto.md#crypto_ecdh_setpublickey_publickey_encoding +[`emitter.listenerCount(eventName)`]: events.md#events_emitter_listenercount_eventname +[`fs.FileHandle`]: fs.md#fs_class_filehandle +[`fs.access()`]: fs.md#fs_fs_access_path_mode_callback +[`fs.createReadStream()`]: fs.md#fs_fs_createreadstream_path_options +[`fs.createWriteStream()`]: fs.md#fs_fs_createwritestream_path_options +[`fs.exists(path, callback)`]: fs.md#fs_fs_exists_path_callback +[`fs.lchmod(path, mode, callback)`]: fs.md#fs_fs_lchmod_path_mode_callback +[`fs.lchmodSync(path, mode)`]: fs.md#fs_fs_lchmodsync_path_mode +[`fs.lchown(path, uid, gid, callback)`]: fs.md#fs_fs_lchown_path_uid_gid_callback +[`fs.lchownSync(path, uid, gid)`]: fs.md#fs_fs_lchownsync_path_uid_gid +[`fs.read()`]: fs.md#fs_fs_read_fd_buffer_offset_length_position_callback +[`fs.readSync()`]: fs.md#fs_fs_readsync_fd_buffer_offset_length_position +[`fs.stat()`]: fs.md#fs_fs_stat_path_options_callback +[`http.get()`]: http.md#http_http_get_options_callback +[`http.request()`]: http.md#http_http_request_options_callback +[`https.get()`]: https.md#https_https_get_options_callback +[`https.request()`]: https.md#https_https_request_options_callback +[`module.createRequire()`]: module.md#module_module_createrequire_filename +[`os.networkInterfaces()`]: os.md#os_os_networkinterfaces +[`os.tmpdir()`]: os.md#os_os_tmpdir +[`process.env`]: process.md#process_process_env +[`process.mainModule`]: process.md#process_process_mainmodule +[`punycode`]: punycode.md +[`require.extensions`]: modules.md#modules_require_extensions +[`require.main`]: modules.md#modules_accessing_the_main_module +[`request.abort()`]: http.md#http_request_abort +[`request.socket`]: http.md#http_request_socket +[`request.connection`]: http.md#http_request_connection +[`request.destroy()`]: http.md#http_request_destroy_error +[`response.socket`]: http.md#http_response_socket +[`response.connection`]: http.md#http_response_connection +[`response.end()`]: http.md#http_response_end_data_encoding_callback +[`response.finished`]: http.md#http_response_finished +[`response.writableFinished`]: http.md#http_response_writablefinished +[`response.writableEnded`]: http.md#http_response_writableended +[`script.createCachedData()`]: vm.md#vm_script_createcacheddata +[`setInterval()`]: timers.md#timers_setinterval_callback_delay_args +[`setTimeout()`]: timers.md#timers_settimeout_callback_delay_args +[`socket.bufferSize`]: net.md#net_socket_buffersize +[`timeout.ref()`]: timers.md#timers_timeout_ref +[`timeout.refresh()`]: timers.md#timers_timeout_refresh +[`timeout.unref()`]: timers.md#timers_timeout_unref +[`tls.CryptoStream`]: tls.md#tls_class_tls_cryptostream +[`tls.SecureContext`]: tls.md#tls_tls_createsecurecontext_options +[`tls.SecurePair`]: tls.md#tls_class_tls_securepair +[`tls.TLSSocket`]: tls.md#tls_class_tls_tlssocket +[`tls.checkServerIdentity()`]: tls.md#tls_tls_checkserveridentity_hostname_cert +[`tls.createSecureContext()`]: tls.md#tls_tls_createsecurecontext_options +[`url.format()`]: url.md#url_url_format_urlobject +[`url.parse()`]: url.md#url_url_parse_urlstring_parsequerystring_slashesdenotehost +[`url.resolve()`]: url.md#url_url_resolve_from_to +[`util._extend()`]: util.md#util_util_extend_target_source +[`util.getSystemErrorName()`]: util.md#util_util_getsystemerrorname_err +[`util.inspect()`]: util.md#util_util_inspect_object_options +[`util.inspect.custom`]: util.md#util_util_inspect_custom +[`util.isArray()`]: util.md#util_util_isarray_object +[`util.isBoolean()`]: util.md#util_util_isboolean_object +[`util.isBuffer()`]: util.md#util_util_isbuffer_object +[`util.isDate()`]: util.md#util_util_isdate_object +[`util.isError()`]: util.md#util_util_iserror_object +[`util.isFunction()`]: util.md#util_util_isfunction_object +[`util.isNull()`]: util.md#util_util_isnull_object +[`util.isNullOrUndefined()`]: util.md#util_util_isnullorundefined_object +[`util.isNumber()`]: util.md#util_util_isnumber_object +[`util.isObject()`]: util.md#util_util_isobject_object +[`util.isPrimitive()`]: util.md#util_util_isprimitive_object +[`util.isRegExp()`]: util.md#util_util_isregexp_object +[`util.isString()`]: util.md#util_util_isstring_object +[`util.isSymbol()`]: util.md#util_util_issymbol_object +[`util.isUndefined()`]: util.md#util_util_isundefined_object +[`util.log()`]: util.md#util_util_log_string +[`util.types`]: util.md#util_util_types +[`util`]: util.md +[`worker.exitedAfterDisconnect`]: cluster.md#cluster_worker_exitedafterdisconnect +[`worker.terminate()`]: worker_threads.md#worker_threads_worker_terminate +[`writable.writableLength`]: stream.md#stream_writable_writablelength +[`zlib.bytesWritten`]: zlib.md#zlib_zlib_byteswritten +[Legacy URL API]: url.md#url_legacy_url_api [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3 -[WHATWG URL API]: url.html#url_the_whatwg_url_api -[alloc]: buffer.html#buffer_static_method_buffer_alloc_size_fill_encoding -[alloc_unsafe_size]: buffer.html#buffer_static_method_buffer_allocunsafe_size -[from_arraybuffer]: buffer.html#buffer_static_method_buffer_from_arraybuffer_byteoffset_length -[from_string_encoding]: buffer.html#buffer_static_method_buffer_from_string_encoding -[legacy `urlObject`]: url.html#url_legacy_urlobject -[static methods of `crypto.Certificate()`]: crypto.html#crypto_class_certificate +[WHATWG URL API]: url.md#url_the_whatwg_url_api +[alloc]: buffer.md#buffer_static_method_buffer_alloc_size_fill_encoding +[alloc_unsafe_size]: buffer.md#buffer_static_method_buffer_allocunsafe_size +[from_arraybuffer]: buffer.md#buffer_static_method_buffer_from_arraybuffer_byteoffset_length +[from_string_encoding]: buffer.md#buffer_static_method_buffer_from_string_encoding +[legacy `urlObject`]: url.md#url_legacy_urlobject +[static methods of `crypto.Certificate()`]: crypto.md#crypto_class_certificate diff --git a/doc/api/dgram.md b/doc/api/dgram.md index 3ed4e55e2a6..e1c5ace6b05 100644 --- a/doc/api/dgram.md +++ b/doc/api/dgram.md @@ -786,20 +786,20 @@ and `udp6` sockets). The bound address and port can be retrieved using [`socket.address().address`][] and [`socket.address().port`][]. [`'close'`]: #dgram_event_close -[`ERR_SOCKET_BAD_PORT`]: errors.html#errors_err_socket_bad_port -[`ERR_SOCKET_BUFFER_SIZE`]: errors.html#errors_err_socket_buffer_size -[`ERR_SOCKET_DGRAM_IS_CONNECTED`]: errors.html#errors_err_socket_dgram_is_connected -[`ERR_SOCKET_DGRAM_NOT_CONNECTED`]: errors.html#errors_err_socket_dgram_not_connected -[`Error`]: errors.html#errors_class_error -[`System Error`]: errors.html#errors_class_systemerror +[`ERR_SOCKET_BAD_PORT`]: errors.md#errors_err_socket_bad_port +[`ERR_SOCKET_BUFFER_SIZE`]: errors.md#errors_err_socket_buffer_size +[`ERR_SOCKET_DGRAM_IS_CONNECTED`]: errors.md#errors_err_socket_dgram_is_connected +[`ERR_SOCKET_DGRAM_NOT_CONNECTED`]: errors.md#errors_err_socket_dgram_not_connected +[`Error`]: errors.md#errors_class_error +[`System Error`]: errors.md#errors_class_systemerror [`close()`]: #dgram_socket_close_callback -[`cluster`]: cluster.html +[`cluster`]: cluster.md [`connect()`]: #dgram_socket_connect_port_address_callback [`dgram.createSocket()`]: #dgram_dgram_createsocket_options_callback -[`dns.lookup()`]: dns.html#dns_dns_lookup_hostname_options_callback +[`dns.lookup()`]: dns.md#dns_dns_lookup_hostname_options_callback [`socket.address().address`]: #dgram_socket_address [`socket.address().port`]: #dgram_socket_address [`socket.bind()`]: #dgram_socket_bind_port_address_callback [IPv6 Zone Indices]: https://en.wikipedia.org/wiki/IPv6_address#Scoped_literal_IPv6_addresses [RFC 4007]: https://tools.ietf.org/html/rfc4007 -[byte length]: buffer.html#buffer_static_method_buffer_bytelength_string_encoding +[byte length]: buffer.md#buffer_static_method_buffer_bytelength_string_encoding diff --git a/doc/api/dns.md b/doc/api/dns.md index 5d55e33c7d1..7b8c01557d7 100644 --- a/doc/api/dns.md +++ b/doc/api/dns.md @@ -1158,9 +1158,9 @@ processing that happens on libuv's threadpool that [`dns.lookup()`][] can have. They do not use the same set of configuration files than what [`dns.lookup()`][] uses. For instance, _they do not use the configuration from `/etc/hosts`_. -[`Error`]: errors.html#errors_class_error -[`UV_THREADPOOL_SIZE`]: cli.html#cli_uv_threadpool_size_size -[`dgram.createSocket()`]: dgram.html#dgram_dgram_createsocket_options_callback +[`Error`]: errors.md#errors_class_error +[`UV_THREADPOOL_SIZE`]: cli.md#cli_uv_threadpool_size_size +[`dgram.createSocket()`]: dgram.md#dgram_dgram_createsocket_options_callback [`dns.getServers()`]: #dns_dns_getservers [`dns.lookup()`]: #dns_dns_lookup_hostname_options_callback [`dns.resolve()`]: #dns_dns_resolve_hostname_rrtype_callback @@ -1193,8 +1193,8 @@ uses. For instance, _they do not use the configuration from `/etc/hosts`_. [`dnsPromises.resolveTxt()`]: #dns_dnspromises_resolvetxt_hostname [`dnsPromises.reverse()`]: #dns_dnspromises_reverse_ip [`dnsPromises.setServers()`]: #dns_dnspromises_setservers_servers -[`socket.connect()`]: net.html#net_socket_connect_options_connectlistener -[`util.promisify()`]: util.html#util_util_promisify_original +[`socket.connect()`]: net.md#net_socket_connect_options_connectlistener +[`util.promisify()`]: util.md#util_util_promisify_original [DNS error codes]: #dns_error_codes [Domain Name System (DNS)]: https://en.wikipedia.org/wiki/Domain_Name_System [Implementation considerations section]: #dns_implementation_considerations diff --git a/doc/api/documentation.md b/doc/api/documentation.md index 779b02d14c7..bdc3466152c 100644 --- a/doc/api/documentation.md +++ b/doc/api/documentation.md @@ -63,4 +63,4 @@ be unavoidable. [the contributing guide]: https://github.com/nodejs/node/blob/master/CONTRIBUTING.md [the issue tracker]: https://github.com/nodejs/node/issues/new [V8 JavaScript engine]: https://v8.dev/ -[warning]: process.html#process_event_warning +[warning]: process.md#process_event_warning diff --git a/doc/api/domain.md b/doc/api/domain.md index 0b79ec5b37e..ccfbc258504 100644 --- a/doc/api/domain.md +++ b/doc/api/domain.md @@ -478,10 +478,10 @@ Domains will not interfere with the error handling mechanisms for promises. In other words, no `'error'` event will be emitted for unhandled `Promise` rejections. -[`Error`]: errors.html#errors_class_error +[`Error`]: errors.md#errors_class_error [`domain.add(emitter)`]: #domain_domain_add_emitter [`domain.bind(callback)`]: #domain_domain_bind_callback [`domain.exit()`]: #domain_domain_exit -[`setInterval()`]: timers.html#timers_setinterval_callback_delay_args -[`setTimeout()`]: timers.html#timers_settimeout_callback_delay_args +[`setInterval()`]: timers.md#timers_setinterval_callback_delay_args +[`setTimeout()`]: timers.md#timers_settimeout_callback_delay_args [`throw`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/throw diff --git a/doc/api/embedding.md b/doc/api/embedding.md index cb225a1eb9d..d18b3d91411 100644 --- a/doc/api/embedding.md +++ b/doc/api/embedding.md @@ -220,8 +220,8 @@ int RunNodeInstance(MultiIsolatePlatform* platform, } ``` -[`process.memoryUsage()`]: process.html#process_process_memoryusage -[CLI options]: cli.html -[deprecation policy]: deprecations.html +[`process.memoryUsage()`]: process.md#process_process_memoryusage +[CLI options]: cli.md +[deprecation policy]: deprecations.md [embedtest.cc]: https://github.com/nodejs/node/blob/master/test/embedding/embedtest.cc [src/node.h]: https://github.com/nodejs/node/blob/master/src/node.h diff --git a/doc/api/errors.md b/doc/api/errors.md index 108d2a42164..c71f33e2ea6 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -2499,78 +2499,78 @@ removed: v10.0.0 Used when an attempt is made to use a `zlib` object after it has already been closed. -[`'uncaughtException'`]: process.html#process_event_uncaughtexception -[`--disable-proto=throw`]: cli.html#cli_disable_proto_mode -[`--force-fips`]: cli.html#cli_force_fips -[`Class: assert.AssertionError`]: assert.html#assert_class_assert_assertionerror +[`'uncaughtException'`]: process.md#process_event_uncaughtexception +[`--disable-proto=throw`]: cli.md#cli_disable_proto_mode +[`--force-fips`]: cli.md#cli_force_fips +[`Class: assert.AssertionError`]: assert.md#assert_class_assert_assertionerror [`ERR_INVALID_ARG_TYPE`]: #ERR_INVALID_ARG_TYPE -[`EventEmitter`]: events.html#events_class_eventemitter -[`MessagePort`]: worker_threads.html#worker_threads_class_messageport +[`EventEmitter`]: events.md#events_class_eventemitter +[`MessagePort`]: worker_threads.md#worker_threads_class_messageport [`Object.getPrototypeOf`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getPrototypeOf [`Object.setPrototypeOf`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/setPrototypeOf -[`REPL`]: repl.html -[`Writable`]: stream.html#stream_class_stream_writable -[`child_process`]: child_process.html -[`cipher.getAuthTag()`]: crypto.html#crypto_cipher_getauthtag -[`crypto.getDiffieHellman()`]: crypto.html#crypto_crypto_getdiffiehellman_groupname -[`crypto.scrypt()`]: crypto.html#crypto_crypto_scrypt_password_salt_keylen_options_callback -[`crypto.scryptSync()`]: crypto.html#crypto_crypto_scryptsync_password_salt_keylen_options -[`crypto.timingSafeEqual()`]: crypto.html#crypto_crypto_timingsafeequal_a_b -[`dgram.connect()`]: dgram.html#dgram_socket_connect_port_address_callback -[`dgram.createSocket()`]: dgram.html#dgram_dgram_createsocket_options_callback -[`dgram.disconnect()`]: dgram.html#dgram_socket_disconnect -[`dgram.remoteAddress()`]: dgram.html#dgram_socket_remoteaddress +[`REPL`]: repl.md +[`Writable`]: stream.md#stream_class_stream_writable +[`child_process`]: child_process.md +[`cipher.getAuthTag()`]: crypto.md#crypto_cipher_getauthtag +[`crypto.getDiffieHellman()`]: crypto.md#crypto_crypto_getdiffiehellman_groupname +[`crypto.scrypt()`]: crypto.md#crypto_crypto_scrypt_password_salt_keylen_options_callback +[`crypto.scryptSync()`]: crypto.md#crypto_crypto_scryptsync_password_salt_keylen_options +[`crypto.timingSafeEqual()`]: crypto.md#crypto_crypto_timingsafeequal_a_b +[`dgram.connect()`]: dgram.md#dgram_socket_connect_port_address_callback +[`dgram.createSocket()`]: dgram.md#dgram_dgram_createsocket_options_callback +[`dgram.disconnect()`]: dgram.md#dgram_socket_disconnect +[`dgram.remoteAddress()`]: dgram.md#dgram_socket_remoteaddress [`errno`(3) man page]: https://man7.org/linux/man-pages/man3/errno.3.html -[`fs.Dir`]: fs.html#fs_class_fs_dir -[`fs.readFileSync`]: fs.html#fs_fs_readfilesync_path_options -[`fs.readdir`]: fs.html#fs_fs_readdir_path_options_callback -[`fs.symlink()`]: fs.html#fs_fs_symlink_target_path_type_callback -[`fs.symlinkSync()`]: fs.html#fs_fs_symlinksync_target_path_type -[`fs.unlink`]: fs.html#fs_fs_unlink_path_callback -[`fs`]: fs.html -[`hash.digest()`]: crypto.html#crypto_hash_digest_encoding -[`hash.update()`]: crypto.html#crypto_hash_update_data_inputencoding -[`http`]: http.html -[`https`]: https.html +[`fs.Dir`]: fs.md#fs_class_fs_dir +[`fs.readFileSync`]: fs.md#fs_fs_readfilesync_path_options +[`fs.readdir`]: fs.md#fs_fs_readdir_path_options_callback +[`fs.symlink()`]: fs.md#fs_fs_symlink_target_path_type_callback +[`fs.symlinkSync()`]: fs.md#fs_fs_symlinksync_target_path_type +[`fs.unlink`]: fs.md#fs_fs_unlink_path_callback +[`fs`]: fs.md +[`hash.digest()`]: crypto.md#crypto_hash_digest_encoding +[`hash.update()`]: crypto.md#crypto_hash_update_data_inputencoding +[`http`]: http.md +[`https`]: https.md [`libuv Error handling`]: https://docs.libuv.org/en/v1.x/errors.html -[`net`]: net.html -[`new URL(input)`]: url.html#url_new_url_input_base -[`new URLSearchParams(iterable)`]: url.html#url_new_urlsearchparams_iterable -[`process.on('exit')`]: process.html#Event:-`'exit'` -[`process.send()`]: process.html#process_process_send_message_sendhandle_options_callback -[`process.setUncaughtExceptionCaptureCallback()`]: process.html#process_process_setuncaughtexceptioncapturecallback_fn -[`readable._read()`]: stream.html#stream_readable_read_size_1 -[`require('crypto').setEngine()`]: crypto.html#crypto_crypto_setengine_engine_flags -[`require()`]: modules.html#modules_require_id -[`server.close()`]: net.html#net_server_close_callback -[`server.listen()`]: net.html#net_server_listen -[`sign.sign()`]: crypto.html#crypto_sign_sign_privatekey_outputencoding -[`stream.pipe()`]: stream.html#stream_readable_pipe_destination_options -[`stream.push()`]: stream.html#stream_readable_push_chunk_encoding -[`stream.unshift()`]: stream.html#stream_readable_unshift_chunk_encoding -[`stream.write()`]: stream.html#stream_writable_write_chunk_encoding_callback -[`subprocess.kill()`]: child_process.html#child_process_subprocess_kill_signal -[`subprocess.send()`]: child_process.html#child_process_subprocess_send_message_sendhandle_options_callback -[`util.getSystemErrorName(error.errno)`]: util.html#util_util_getsystemerrorname_err -[`zlib`]: zlib.html -[ES Module]: esm.html -[ICU]: intl.html#intl_internationalization_support +[`net`]: net.md +[`new URL(input)`]: url.md#url_new_url_input_base +[`new URLSearchParams(iterable)`]: url.md#url_new_urlsearchparams_iterable +[`process.on('exit')`]: process.md#Event:-`'exit'` +[`process.send()`]: process.md#process_process_send_message_sendhandle_options_callback +[`process.setUncaughtExceptionCaptureCallback()`]: process.md#process_process_setuncaughtexceptioncapturecallback_fn +[`readable._read()`]: stream.md#stream_readable_read_size_1 +[`require('crypto').setEngine()`]: crypto.md#crypto_crypto_setengine_engine_flags +[`require()`]: modules.md#modules_require_id +[`server.close()`]: net.md#net_server_close_callback +[`server.listen()`]: net.md#net_server_listen +[`sign.sign()`]: crypto.md#crypto_sign_sign_privatekey_outputencoding +[`stream.pipe()`]: stream.md#stream_readable_pipe_destination_options +[`stream.push()`]: stream.md#stream_readable_push_chunk_encoding +[`stream.unshift()`]: stream.md#stream_readable_unshift_chunk_encoding +[`stream.write()`]: stream.md#stream_writable_write_chunk_encoding_callback +[`subprocess.kill()`]: child_process.md#child_process_subprocess_kill_signal +[`subprocess.send()`]: child_process.md#child_process_subprocess_send_message_sendhandle_options_callback +[`util.getSystemErrorName(error.errno)`]: util.md#util_util_getsystemerrorname_err +[`zlib`]: zlib.md +[ES Module]: esm.md +[ICU]: intl.md#intl_internationalization_support [Node.js error codes]: #nodejs-error-codes [V8's stack trace API]: https://github.com/v8/v8/wiki/Stack-Trace-API -[WHATWG Supported Encodings]: util.html#util_whatwg_supported_encodings -[WHATWG URL API]: url.html#url_the_whatwg_url_api -[crypto digest algorithm]: crypto.html#crypto_crypto_gethashes -[domains]: domain.html -[event emitter-based]: events.html#events_class_eventemitter -[`package.json`]: packages.html#packages_node_js_package_json_field_definitions -[`"exports"`]: packages.html#packages_exports +[WHATWG Supported Encodings]: util.md#util_whatwg_supported_encodings +[WHATWG URL API]: url.md#url_the_whatwg_url_api +[crypto digest algorithm]: crypto.md#crypto_crypto_gethashes +[domains]: domain.md +[event emitter-based]: events.md#events_class_eventemitter +[`package.json`]: packages.md#packages_node_js_package_json_field_definitions +[`"exports"`]: packages.md#packages_exports [file descriptors]: https://en.wikipedia.org/wiki/File_descriptor -[policy]: policy.html -[stream-based]: stream.html +[policy]: policy.md +[stream-based]: stream.md [syscall]: https://man7.org/linux/man-pages/man2/syscalls.2.html [Subresource Integrity specification]: https://www.w3.org/TR/SRI/#the-integrity-attribute [try-catch]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch -[vm]: vm.html -[self-reference a package using its name]: packages.html#packages_self_referencing_a_package_using_its_name -[define a custom subpath]: packages.html#packages_subpath_exports -[`"imports"`]: packages.html#packages_imports +[vm]: vm.md +[self-reference a package using its name]: packages.md#packages_self_referencing_a_package_using_its_name +[define a custom subpath]: packages.md#packages_subpath_exports +[`"imports"`]: packages.md#packages_imports diff --git a/doc/api/esm.md b/doc/api/esm.md index db77d246287..c24ed61b9bc 100644 --- a/doc/api/esm.md +++ b/doc/api/esm.md @@ -57,7 +57,7 @@ Node.js treats JavaScript code as CommonJS modules by default. Authors can tell Node.js to treat JavaScript code as ECMAScript modules via the `.mjs` file extension, the `package.json` [`"type"`][] field, or the `--input-type` flag. See -[Modules: Packages](packages.html#packages_determining_module_system) for more +[Modules: Packages](packages.md#packages_determining_module_system) for more details. <!-- Anchors to make sure old links find a target --> @@ -78,7 +78,7 @@ details. ## Packages -This section was moved to [Modules: Packages](packages.html). +This section was moved to [Modules: Packages](packages.md). ## `import` Specifiers @@ -1229,8 +1229,8 @@ success! ``` <!-- Note: The cjs-module-lexer link should be kept in-sync with the deps version --> -[CommonJS]: modules.html -[Conditional exports]: packages.html#packages_conditional_exports +[CommonJS]: modules.md +[Conditional exports]: packages.md#packages_conditional_exports [Dynamic `import()`]: https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports [ECMAScript-modules implementation]: https://github.com/nodejs/modules/blob/master/doc/plan-for-new-modules-implementation.md [ECMAScript Top-Level `await` proposal]: https://github.com/tc39/proposal-top-level-await/ @@ -1243,22 +1243,22 @@ success! [`import()`]: #esm_import_expressions [`import.meta.url`]: #esm_import_meta [`import`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import -[`module.createRequire()`]: module.html#module_module_createrequire_filename -[`module.syncBuiltinESMExports()`]: module.html#module_module_syncbuiltinesmexports +[`module.createRequire()`]: module.md#module_module_createrequire_filename +[`module.syncBuiltinESMExports()`]: module.md#module_module_syncbuiltinesmexports [`transformSource` hook]: #esm_transformsource_source_context_defaulttransformsource [`ArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer [`SharedArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer [`string`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String [`TypedArray`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray [`Uint8Array`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array -[`util.TextDecoder`]: util.html#util_class_util_textdecoder +[`util.TextDecoder`]: util.md#util_class_util_textdecoder [cjs-module-lexer]: https://github.com/guybedford/cjs-module-lexer/tree/0.3.1 [special scheme]: https://url.spec.whatwg.org/#special-scheme [the official standard format]: https://tc39.github.io/ecma262/#sec-modules [transpiler loader example]: #esm_transpiler_loader [6.1.7 Array Index]: https://tc39.es/ecma262/#integer-index [Top-Level Await]: https://github.com/tc39/proposal-top-level-await -[Core modules]: modules.html#modules_core_modules -[`package.json`]: packages.html#packages_node_js_package_json_field_definitions -[`"exports"`]: packages.html#packages_exports -[`"type"`]: packages.html#packages_type +[Core modules]: modules.md#modules_core_modules +[`package.json`]: packages.md#packages_node_js_package_json_field_definitions +[`"exports"`]: packages.md#packages_exports +[`"type"`]: packages.md#packages_type diff --git a/doc/api/events.md b/doc/api/events.md index a3b77553bab..1f2f77ef3c5 100644 --- a/doc/api/events.md +++ b/doc/api/events.md @@ -1467,19 +1467,19 @@ and `removeEventListener()` is that `removeListener()` will return a reference to the `EventTarget`. [WHATWG-EventTarget]: https://dom.spec.whatwg.org/#interface-eventtarget -[`--trace-warnings`]: cli.html#cli_trace_warnings +[`--trace-warnings`]: cli.md#cli_trace_warnings [`EventEmitter.defaultMaxListeners`]: #events_eventemitter_defaultmaxlisteners -[`domain`]: domain.html +[`domain`]: domain.md [`emitter.listenerCount()`]: #events_emitter_listenercount_eventname [`emitter.removeListener()`]: #events_emitter_removelistener_eventname_listener [`emitter.setMaxListeners(n)`]: #events_emitter_setmaxlisteners_n [`Event` Web API]: https://dom.spec.whatwg.org/#event [`EventTarget` error handling]: #events_eventtarget_error_handling [`EventTarget` Web API]: https://dom.spec.whatwg.org/#eventtarget -[`fs.ReadStream`]: fs.html#fs_class_fs_readstream -[`net.Server`]: net.html#net_class_net_server -[`process.on('warning')`]: process.html#process_event_warning -[stream]: stream.html +[`fs.ReadStream`]: fs.md#fs_class_fs_readstream +[`net.Server`]: net.md#net_class_net_server +[`process.on('warning')`]: process.md#process_event_warning +[stream]: stream.md [capturerejections]: #events_capture_rejections_of_promises [rejection]: #events_emitter_symbol_for_nodejs_rejection_err_eventname_args [rejectionsymbol]: #events_events_capturerejectionsymbol diff --git a/doc/api/fs.md b/doc/api/fs.md index ece4e5a783b..03998acbbc9 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -5937,15 +5937,15 @@ A call to `fs.ftruncate()` or `filehandle.truncate()` can be used to reset the file contents. [`AHAFS`]: https://www.ibm.com/developerworks/aix/library/au-aix_event_infrastructure/ -[`Buffer.byteLength`]: buffer.html#buffer_static_method_buffer_bytelength_string_encoding -[`Buffer`]: buffer.html#buffer_buffer +[`Buffer.byteLength`]: buffer.md#buffer_static_method_buffer_bytelength_string_encoding +[`Buffer`]: buffer.md#buffer_buffer [`FSEvents`]: https://developer.apple.com/documentation/coreservices/file_system_events [`Number.MAX_SAFE_INTEGER`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER [`ReadDirectoryChangesW`]: https://docs.microsoft.com/en-us/windows/desktop/api/winbase/nf-winbase-readdirectorychangesw [`ReadStream`]: #fs_class_fs_readstream -[Readable Stream]: stream.html#stream_class_stream_readable -[`URL`]: url.html#url_the_whatwg_url_api -[`UV_THREADPOOL_SIZE`]: cli.html#cli_uv_threadpool_size_size +[Readable Stream]: stream.md#stream_class_stream_readable +[`URL`]: url.md#url_the_whatwg_url_api +[`UV_THREADPOOL_SIZE`]: cli.md#cli_uv_threadpool_size_size [`WriteStream`]: #fs_class_fs_writestream [`event ports`]: https://illumos.org/man/port_create [`filehandle.writeFile()`]: #fs_filehandle_writefile_data_options @@ -5959,7 +5959,7 @@ the file contents. [`fs.copyFile()`]: #fs_fs_copyfile_src_dest_mode_callback [`fs.createReadStream()`]: #fs_fs_createreadstream_path_options [`fs.createWriteStream()`]: #fs_fs_createwritestream_path_options -[`fs.exists()`]: fs.html#fs_fs_exists_path_callback +[`fs.exists()`]: fs.md#fs_fs_exists_path_callback [`fs.fstat()`]: #fs_fs_fstat_fd_options_callback [`fs.ftruncate()`]: #fs_fs_ftruncate_fd_len_callback [`fs.futimes()`]: #fs_fs_futimes_fd_atime_mtime_callback @@ -5991,11 +5991,11 @@ the file contents. [`fsPromises.utimes()`]: #fs_fspromises_utimes_path_atime_mtime [`inotify(7)`]: https://man7.org/linux/man-pages/man7/inotify.7.html [`kqueue(2)`]: https://www.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2 -[`net.Socket`]: net.html#net_class_net_socket -[`stat()`]: fs.html#fs_fs_stat_path_options_callback -[`util.promisify()`]: util.html#util_util_promisify_original +[`net.Socket`]: net.md#net_class_net_socket +[`stat()`]: fs.md#fs_fs_stat_path_options_callback +[`util.promisify()`]: util.md#util_util_promisify_original [Caveats]: #fs_caveats -[Common System Errors]: errors.html#errors_common_system_errors +[Common System Errors]: errors.md#errors_common_system_errors [FS constants]: #fs_fs_constants_1 [File access constants]: #fs_file_access_constants [MDN-Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date @@ -6007,4 +6007,4 @@ the file contents. [chcp]: https://ss64.com/nt/chcp.html [inode]: https://en.wikipedia.org/wiki/Inode [support of file system `flags`]: #fs_file_system_flags -[Writable Stream]: stream.html#stream_class_stream_writable +[Writable Stream]: stream.md#stream_class_stream_writable diff --git a/doc/api/globals.md b/doc/api/globals.md index 4e2e362bcde..1da43051ba8 100644 --- a/doc/api/globals.md +++ b/doc/api/globals.md @@ -226,27 +226,27 @@ The object that acts as the namespace for all W3C [WebAssembly][webassembly-org] related functionality. See the [Mozilla Developer Network][webassembly-mdn] for usage and compatibility. -[`TextDecoder`]: util.html#util_class_util_textdecoder -[`TextEncoder`]: util.html#util_class_util_textencoder -[`URLSearchParams`]: url.html#url_class_urlsearchparams -[`URL`]: url.html#url_class_url -[`__dirname`]: modules.html#modules_dirname -[`__filename`]: modules.html#modules_filename -[`clearImmediate`]: timers.html#timers_clearimmediate_immediate -[`clearInterval`]: timers.html#timers_clearinterval_timeout -[`clearTimeout`]: timers.html#timers_cleartimeout_timeout -[`console`]: console.html -[`exports`]: modules.html#modules_exports -[`module`]: modules.html#modules_module -[`process.nextTick()`]: process.html#process_process_nexttick_callback_args -[`process` object]: process.html#process_process -[`require()`]: modules.html#modules_require_id -[`setImmediate`]: timers.html#timers_setimmediate_callback_args -[`setInterval`]: timers.html#timers_setinterval_callback_delay_args -[`setTimeout`]: timers.html#timers_settimeout_callback_delay_args -[buffer section]: buffer.html +[`TextDecoder`]: util.md#util_class_util_textdecoder +[`TextEncoder`]: util.md#util_class_util_textencoder +[`URLSearchParams`]: url.md#url_class_urlsearchparams +[`URL`]: url.md#url_class_url +[`__dirname`]: modules.md#modules_dirname +[`__filename`]: modules.md#modules_filename +[`clearImmediate`]: timers.md#timers_clearimmediate_immediate +[`clearInterval`]: timers.md#timers_clearinterval_timeout +[`clearTimeout`]: timers.md#timers_cleartimeout_timeout +[`console`]: console.md +[`exports`]: modules.md#modules_exports +[`module`]: modules.md#modules_module +[`process.nextTick()`]: process.md#process_process_nexttick_callback_args +[`process` object]: process.md#process_process +[`require()`]: modules.md#modules_require_id +[`setImmediate`]: timers.md#timers_setimmediate_callback_args +[`setInterval`]: timers.md#timers_setinterval_callback_delay_args +[`setTimeout`]: timers.md#timers_settimeout_callback_delay_args +[buffer section]: buffer.md [built-in objects]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects -[module system documentation]: modules.html -[timers]: timers.html +[module system documentation]: modules.md +[timers]: timers.md [webassembly-mdn]: https://developer.mozilla.org/en-US/docs/WebAssembly [webassembly-org]: https://webassembly.org diff --git a/doc/api/http.md b/doc/api/http.md index 038920eb3e2..f1b5ba892ca 100644 --- a/doc/api/http.md +++ b/doc/api/http.md @@ -133,7 +133,7 @@ changes: options are respectively set to `false` and `Infinity`, in which case `Connection: close` will be used. **Default:** `false`. * `keepAliveMsecs` {number} When using the `keepAlive` option, specifies - the [initial delay](net.html#net_socket_setkeepalive_enable_initialdelay) + the [initial delay](net.md#net_socket_setkeepalive_enable_initialdelay) for TCP Keep-Alive packets. Ignored when the `keepAlive` option is `false` or `undefined`. **Default:** `1000`. * `maxSockets` {number} Maximum number of sockets to allow per @@ -2637,23 +2637,23 @@ try { } ``` -[`--insecure-http-parser`]: cli.html#cli_insecure_http_parser -[`--max-http-header-size`]: cli.html#cli_max_http_header_size_size +[`--insecure-http-parser`]: cli.md#cli_insecure_http_parser +[`--max-http-header-size`]: cli.md#cli_max_http_header_size_size [`'checkContinue'`]: #http_event_checkcontinue [`'finish'`]: #http_event_finish [`'request'`]: #http_event_request [`'response'`]: #http_event_response [`'upgrade'`]: #http_event_upgrade [`Agent`]: #http_class_http_agent -[`Buffer.byteLength()`]: buffer.html#buffer_static_method_buffer_bytelength_string_encoding -[`Duplex`]: stream.html#stream_class_stream_duplex -[`HPE_HEADER_OVERFLOW`]: errors.html#errors_hpe_header_overflow -[`TypeError`]: errors.html#errors_class_typeerror -[`URL`]: url.html#url_the_whatwg_url_api +[`Buffer.byteLength()`]: buffer.md#buffer_static_method_buffer_bytelength_string_encoding +[`Duplex`]: stream.md#stream_class_stream_duplex +[`HPE_HEADER_OVERFLOW`]: errors.md#errors_hpe_header_overflow +[`TypeError`]: errors.md#errors_class_typeerror +[`URL`]: url.md#url_the_whatwg_url_api [`agent.createConnection()`]: #http_agent_createconnection_options_callback [`agent.getName()`]: #http_agent_getname_options [`destroy()`]: #http_agent_destroy -[`dns.lookup()`]: dns.html#dns_dns_lookup_hostname_options_callback +[`dns.lookup()`]: dns.md#dns_dns_lookup_hostname_options_callback [`getHeader(name)`]: #http_request_getheader_name [`http.Agent`]: #http_class_http_agent [`http.ClientRequest`]: #http_class_http_clientrequest @@ -2663,11 +2663,11 @@ try { [`http.globalAgent`]: #http_http_globalagent [`http.request()`]: #http_http_request_options_callback [`message.headers`]: #http_message_headers -[`net.Server.close()`]: net.html#net_server_close_callback -[`net.Server`]: net.html#net_class_net_server -[`net.Socket`]: net.html#net_class_net_socket -[`net.createConnection()`]: net.html#net_net_createconnection_options_connectlistener -[`new URL()`]: url.html#url_new_url_input_base +[`net.Server.close()`]: net.md#net_server_close_callback +[`net.Server`]: net.md#net_class_net_server +[`net.Socket`]: net.md#net_class_net_socket +[`net.createConnection()`]: net.md#net_net_createconnection_options_connectlistener +[`new URL()`]: url.md#url_new_url_input_base [`removeHeader(name)`]: #http_request_removeheader_name [`request.end()`]: #http_request_end_data_encoding_callback [`request.destroy()`]: #http_request_destroy_error @@ -2675,7 +2675,7 @@ try { [`request.getHeader()`]: #http_request_getheader_name [`request.setHeader()`]: #http_request_setheader_name_value [`request.setTimeout()`]: #http_request_settimeout_timeout_callback -[`request.socket.getPeerCertificate()`]: tls.html#tls_tlssocket_getpeercertificate_detailed +[`request.socket.getPeerCertificate()`]: tls.md#tls_tlssocket_getpeercertificate_detailed [`request.socket`]: #http_request_socket [`request.writableFinished`]: #http_request_writablefinished [`request.writableEnded`]: #http_request_writableended @@ -2690,16 +2690,16 @@ try { [`response.write(data, encoding)`]: #http_response_write_chunk_encoding_callback [`response.writeContinue()`]: #http_response_writecontinue [`response.writeHead()`]: #http_response_writehead_statuscode_statusmessage_headers -[`server.listen()`]: net.html#net_server_listen +[`server.listen()`]: net.md#net_server_listen [`server.timeout`]: #http_server_timeout [`setHeader(name, value)`]: #http_request_setheader_name_value -[`socket.connect()`]: net.html#net_socket_connect_options_connectlistener -[`socket.setKeepAlive()`]: net.html#net_socket_setkeepalive_enable_initialdelay -[`socket.setNoDelay()`]: net.html#net_socket_setnodelay_nodelay -[`socket.setTimeout()`]: net.html#net_socket_settimeout_timeout_callback -[`socket.unref()`]: net.html#net_socket_unref -[`url.parse()`]: url.html#url_url_parse_urlstring_parsequerystring_slashesdenotehost -[`writable.destroy()`]: stream.html#stream_writable_destroy_error -[`writable.destroyed`]: stream.html#stream_writable_destroyed -[`writable.cork()`]: stream.html#stream_writable_cork -[`writable.uncork()`]: stream.html#stream_writable_uncork +[`socket.connect()`]: net.md#net_socket_connect_options_connectlistener +[`socket.setKeepAlive()`]: net.md#net_socket_setkeepalive_enable_initialdelay +[`socket.setNoDelay()`]: net.md#net_socket_setnodelay_nodelay +[`socket.setTimeout()`]: net.md#net_socket_settimeout_timeout_callback +[`socket.unref()`]: net.md#net_socket_unref +[`url.parse()`]: url.md#url_url_parse_urlstring_parsequerystring_slashesdenotehost +[`writable.destroy()`]: stream.md#stream_writable_destroy_error +[`writable.destroyed`]: stream.md#stream_writable_destroyed +[`writable.cork()`]: stream.md#stream_writable_cork +[`writable.uncork()`]: stream.md#stream_writable_uncork diff --git a/doc/api/http2.md b/doc/api/http2.md index 526a1023955..a461b3ebf73 100644 --- a/doc/api/http2.md +++ b/doc/api/http2.md @@ -3645,13 +3645,13 @@ following additional properties: [ALPN Protocol ID]: https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids [ALPN negotiation]: #http2_alpn_negotiation [Compatibility API]: #http2_compatibility_api -[HTTP/1]: http.html +[HTTP/1]: http.md [HTTP/2 Headers Object]: #http2_headers_object [HTTP/2 Settings Object]: #http2_settings_object [HTTP/2 Unencrypted]: https://http2.github.io/faq/#does-http2-require-encryption [HTTP/2]: https://tools.ietf.org/html/rfc7540 -[HTTPS]: https.html -[Performance Observer]: perf_hooks.html +[HTTPS]: https.md +[Performance Observer]: perf_hooks.md [RFC 7838]: https://tools.ietf.org/html/rfc7838 [RFC 8336]: https://tools.ietf.org/html/rfc8336 [RFC 8441]: https://tools.ietf.org/html/rfc8441 @@ -3660,41 +3660,41 @@ following additional properties: [`'request'`]: #http2_event_request [`'unknownProtocol'`]: #http2_event_unknownprotocol [`ClientHttp2Stream`]: #http2_class_clienthttp2stream -[`Duplex`]: stream.html#stream_class_stream_duplex +[`Duplex`]: stream.md#stream_class_stream_duplex [`Http2ServerRequest`]: #http2_class_http2_http2serverrequest [`Http2ServerResponse`]: #http2_class_http2_http2serverresponse [`Http2Session` and Sockets]: #http2_http2session_and_sockets [`Http2Stream`]: #http2_class_http2stream [`ServerHttp2Stream`]: #http2_class_serverhttp2stream -[`TypeError`]: errors.html#errors_class_typeerror -[`http.ClientRequest#maxHeadersCount`]: http.html#http_request_maxheaderscount -[`http.Server#maxHeadersCount`]: http.html#http_server_maxheaderscount +[`TypeError`]: errors.md#errors_class_typeerror +[`http.ClientRequest#maxHeadersCount`]: http.md#http_request_maxheaderscount +[`http.Server#maxHeadersCount`]: http.md#http_server_maxheaderscount [`http2.SecureServer`]: #http2_class_http2secureserver [`http2.Server`]: #http2_class_http2server [`http2.createSecureServer()`]: #http2_http2_createsecureserver_options_onrequesthandler [`http2.createServer()`]: #http2_http2_createserver_options_onrequesthandler [`http2session.close()`]: #http2_http2session_close_callback [`http2stream.pushStream()`]: #http2_http2stream_pushstream_headers_options_callback -[`net.createServer()`]: net.html#net_net_createserver_options_connectionlistener -[`net.Server.close()`]: net.html#net_server_close_callback -[`net.Socket.bufferSize`]: net.html#net_socket_buffersize -[`net.Socket.prototype.ref()`]: net.html#net_socket_ref -[`net.Socket.prototype.unref()`]: net.html#net_socket_unref -[`net.Socket`]: net.html#net_class_net_socket -[`net.connect()`]: net.html#net_net_connect +[`net.createServer()`]: net.md#net_net_createserver_options_connectionlistener +[`net.Server.close()`]: net.md#net_server_close_callback +[`net.Socket.bufferSize`]: net.md#net_socket_buffersize +[`net.Socket.prototype.ref()`]: net.md#net_socket_ref +[`net.Socket.prototype.unref()`]: net.md#net_socket_unref +[`net.Socket`]: net.md#net_class_net_socket +[`net.connect()`]: net.md#net_net_connect [`request.socket`]: #http2_request_socket -[`request.socket.getPeerCertificate()`]: tls.html#tls_tlssocket_getpeercertificate_detailed +[`request.socket.getPeerCertificate()`]: tls.md#tls_tlssocket_getpeercertificate_detailed [`response.end()`]: #http2_response_end_data_encoding_callback [`response.setHeader()`]: #http2_response_setheader_name_value [`response.socket`]: #http2_response_socket [`response.writableEnded`]: #http2_response_writableended [`response.write()`]: #http2_response_write_chunk_encoding_callback -[`response.write(data, encoding)`]: http.html#http_response_write_chunk_encoding_callback +[`response.write(data, encoding)`]: http.md#http_response_write_chunk_encoding_callback [`response.writeContinue()`]: #http2_response_writecontinue [`response.writeHead()`]: #http2_response_writehead_statuscode_statusmessage_headers -[`tls.Server.close()`]: tls.html#tls_server_close_callback -[`tls.TLSSocket`]: tls.html#tls_class_tls_tlssocket -[`tls.connect()`]: tls.html#tls_tls_connect_options_callback -[`tls.createServer()`]: tls.html#tls_tls_createserver_options_secureconnectionlistener -[`writable.writableFinished`]: stream.html#stream_writable_writablefinished +[`tls.Server.close()`]: tls.md#tls_server_close_callback +[`tls.TLSSocket`]: tls.md#tls_class_tls_tlssocket +[`tls.connect()`]: tls.md#tls_tls_connect_options_callback +[`tls.createServer()`]: tls.md#tls_tls_createserver_options_secureconnectionlistener +[`writable.writableFinished`]: stream.md#stream_writable_writablefinished [error code]: #http2_error_codes_for_rst_stream_and_goaway diff --git a/doc/api/https.md b/doc/api/https.md index c0c60ffce72..b66dd71f428 100644 --- a/doc/api/https.md +++ b/doc/api/https.md @@ -452,27 +452,27 @@ headers: max-age=0; pin-sha256="WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18="; p ``` [`Agent`]: #https_class_https_agent -[`URL`]: url.html#url_the_whatwg_url_api -[`http.Agent`]: http.html#http_class_http_agent -[`http.Agent(options)`]: http.html#http_new_agent_options -[`http.Server#headersTimeout`]: http.html#http_server_headerstimeout -[`http.Server#keepAliveTimeout`]: http.html#http_server_keepalivetimeout -[`http.Server#maxHeadersCount`]: http.html#http_server_maxheaderscount -[`http.Server#requestTimeout`]: http.html#http_server_requesttimeout -[`http.Server#setTimeout()`]: http.html#http_server_settimeout_msecs_callback -[`http.Server#timeout`]: http.html#http_server_timeout -[`http.Server`]: http.html#http_class_http_server -[`http.close()`]: http.html#http_server_close_callback -[`http.createServer()`]: http.html#http_http_createserver_options_requestlistener -[`http.get()`]: http.html#http_http_get_options_callback -[`http.request()`]: http.html#http_http_request_options_callback +[`URL`]: url.md#url_the_whatwg_url_api +[`http.Agent`]: http.md#http_class_http_agent +[`http.Agent(options)`]: http.md#http_new_agent_options +[`http.Server#headersTimeout`]: http.md#http_server_headerstimeout +[`http.Server#keepAliveTimeout`]: http.md#http_server_keepalivetimeout +[`http.Server#maxHeadersCount`]: http.md#http_server_maxheaderscount +[`http.Server#requestTimeout`]: http.md#http_server_requesttimeout +[`http.Server#setTimeout()`]: http.md#http_server_settimeout_msecs_callback +[`http.Server#timeout`]: http.md#http_server_timeout +[`http.Server`]: http.md#http_class_http_server +[`http.close()`]: http.md#http_server_close_callback +[`http.createServer()`]: http.md#http_http_createserver_options_requestlistener +[`http.get()`]: http.md#http_http_get_options_callback +[`http.request()`]: http.md#http_http_request_options_callback [`https.Agent`]: #https_class_https_agent [`https.request()`]: #https_https_request_options_callback -[`net.Server`]: net.html#net_class_net_server -[`new URL()`]: url.html#url_new_url_input_base -[`server.listen()`]: net.html#net_server_listen -[`tls.connect()`]: tls.html#tls_tls_connect_options_callback -[`tls.createSecureContext()`]: tls.html#tls_tls_createsecurecontext_options -[`tls.createServer()`]: tls.html#tls_tls_createserver_options_secureconnectionlistener -[`Session Resumption`]: tls.html#tls_session_resumption +[`net.Server`]: net.md#net_class_net_server +[`new URL()`]: url.md#url_new_url_input_base +[`server.listen()`]: net.md#net_server_listen +[`tls.connect()`]: tls.md#tls_tls_connect_options_callback +[`tls.createSecureContext()`]: tls.md#tls_tls_createsecurecontext_options +[`tls.createServer()`]: tls.md#tls_tls_createserver_options_secureconnectionlistener +[`Session Resumption`]: tls.md#tls_session_resumption [sni wiki]: https://en.wikipedia.org/wiki/Server_Name_Indication diff --git a/doc/api/index.md b/doc/api/index.md index 69746392df6..e32a207c310 100644 --- a/doc/api/index.md +++ b/doc/api/index.md @@ -5,64 +5,64 @@ <!--introduced_in=v0.10.0--> -* [About this documentation](documentation.html) -* [Usage and example](synopsis.html) +* [About this documentation](documentation.md) +* [Usage and example](synopsis.md) <hr class="line"/> -* [Assertion testing](assert.html) -* [Async hooks](async_hooks.html) -* [Buffer](buffer.html) -* [C++ addons](addons.html) -* [C/C++ addons with N-API](n-api.html) -* [C++ embedder API](embedding.html) -* [Child processes](child_process.html) -* [Cluster](cluster.html) -* [Command-line options](cli.html) -* [Console](console.html) -* [Crypto](crypto.html) -* [Debugger](debugger.html) -* [Deprecated APIs](deprecations.html) -* [DNS](dns.html) -* [Domain](domain.html) -* [Errors](errors.html) -* [Events](events.html) -* [File system](fs.html) -* [Globals](globals.html) -* [HTTP](http.html) -* [HTTP/2](http2.html) -* [HTTPS](https.html) -* [Inspector](inspector.html) -* [Internationalization](intl.html) -* [Modules: CommonJS modules](modules.html) -* [Modules: ECMAScript modules](esm.html) -* [Modules: `module` API](module.html) -* [Modules: Packages](packages.html) -* [Net](net.html) -* [OS](os.html) -* [Path](path.html) -* [Performance hooks](perf_hooks.html) -* [Policies](policy.html) -* [Process](process.html) -* [Punycode](punycode.html) -* [Query strings](querystring.html) -* [Readline](readline.html) -* [REPL](repl.html) -* [Report](report.html) -* [Stream](stream.html) -* [String decoder](string_decoder.html) -* [Timers](timers.html) -* [TLS/SSL](tls.html) -* [Trace events](tracing.html) -* [TTY](tty.html) -* [UDP/datagram](dgram.html) -* [URL](url.html) -* [Utilities](util.html) -* [V8](v8.html) -* [VM](vm.html) -* [WASI](wasi.html) -* [Worker threads](worker_threads.html) -* [Zlib](zlib.html) +* [Assertion testing](assert.md) +* [Async hooks](async_hooks.md) +* [Buffer](buffer.md) +* [C++ addons](addons.md) +* [C/C++ addons with N-API](n-api.md) +* [C++ embedder API](embedding.md) +* [Child processes](child_process.md) +* [Cluster](cluster.md) +* [Command-line options](cli.md) +* [Console](console.md) +* [Crypto](crypto.md) +* [Debugger](debugger.md) +* [Deprecated APIs](deprecations.md) +* [DNS](dns.md) +* [Domain](domain.md) +* [Errors](errors.md) +* [Events](events.md) +* [File system](fs.md) +* [Globals](globals.md) +* [HTTP](http.md) +* [HTTP/2](http2.md) +* [HTTPS](https.md) +* [Inspector](inspector.md) +* [Internationalization](intl.md) +* [Modules: CommonJS modules](modules.md) +* [Modules: ECMAScript modules](esm.md) +* [Modules: `module` API](module.md) +* [Modules: Packages](packages.md) +* [Net](net.md) +* [OS](os.md) +* [Path](path.md) +* [Performance hooks](perf_hooks.md) +* [Policies](policy.md) +* [Process](process.md) +* [Punycode](punycode.md) +* [Query strings](querystring.md) +* [Readline](readline.md) +* [REPL](repl.md) +* [Report](report.md) +* [Stream](stream.md) +* [String decoder](string_decoder.md) +* [Timers](timers.md) +* [TLS/SSL](tls.md) +* [Trace events](tracing.md) +* [TTY](tty.md) +* [UDP/datagram](dgram.md) +* [URL](url.md) +* [Utilities](util.md) +* [V8](v8.md) +* [VM](vm.md) +* [WASI](wasi.md) +* [Worker threads](worker_threads.md) +* [Zlib](zlib.md) <hr class="line"/> diff --git a/doc/api/inspector.md b/doc/api/inspector.md index 7dc359a0185..c22dbca03bc 100644 --- a/doc/api/inspector.md +++ b/doc/api/inspector.md @@ -45,7 +45,7 @@ started. If wait is `true`, will block until a client has connected to the inspect port and flow control has been passed to the debugger client. -See the [security warning](cli.html#inspector_security) regarding the `host` +See the [security warning](cli.md#inspector_security) regarding the `host` parameter usage. ## `inspector.url()` diff --git a/doc/api/intl.md b/doc/api/intl.md index 8b7dee489b4..434a06a5dae 100644 --- a/doc/api/intl.md +++ b/doc/api/intl.md @@ -189,26 +189,26 @@ to be helpful: dedicated to ECMA-402. ["ICU Data"]: http://userguide.icu-project.org/icudata -[`--icu-data-dir`]: cli.html#cli_icu_data_dir_file +[`--icu-data-dir`]: cli.md#cli_icu_data_dir_file [`Date.prototype.toLocaleString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString [`Intl.DateTimeFormat`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat [`Intl`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl -[`NODE_ICU_DATA`]: cli.html#cli_node_icu_data_file +[`NODE_ICU_DATA`]: cli.md#cli_node_icu_data_file [`Number.prototype.toLocaleString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString [`RegExp` Unicode Property Escapes]: https://github.com/tc39/proposal-regexp-unicode-property-escapes [`String.prototype.localeCompare()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare [`String.prototype.normalize()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize [`String.prototype.toLowerCase()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase [`String.prototype.toUpperCase()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase -[`require('buffer').transcode()`]: buffer.html#buffer_buffer_transcode_source_fromenc_toenc -[`require('util').TextDecoder`]: util.html#util_class_util_textdecoder +[`require('buffer').transcode()`]: buffer.md#buffer_buffer_transcode_source_fromenc_toenc +[`require('util').TextDecoder`]: util.md#util_class_util_textdecoder [BUILDING.md]: https://github.com/nodejs/node/blob/master/BUILDING.md [ECMA-262]: https://tc39.github.io/ecma262/ [ECMA-402]: https://tc39.github.io/ecma402/ [ICU]: http://site.icu-project.org/ -[REPL]: repl.html#repl_repl +[REPL]: repl.md#repl_repl [Test262]: https://github.com/tc39/test262/tree/master/test/intl402 -[WHATWG URL parser]: url.html#url_the_whatwg_url_api +[WHATWG URL parser]: url.md#url_the_whatwg_url_api [btest402]: https://github.com/srl295/btest402 [full-icu]: https://www.npmjs.com/package/full-icu [internationalized domain names]: https://en.wikipedia.org/wiki/Internationalized_domain_name diff --git a/doc/api/module.md b/doc/api/module.md index 797c50b9d6e..2fb6ca884b4 100644 --- a/doc/api/module.md +++ b/doc/api/module.md @@ -200,14 +200,14 @@ consists of the following keys: * originalLine: {number} * originalColumn: {number} -[CommonJS]: modules.html -[ES Modules]: esm.html +[CommonJS]: modules.md +[ES Modules]: esm.md [Source map v3 format]: https://sourcemaps.info/spec.html#h.mofvlxcwqzej -[`--enable-source-maps`]: cli.html#cli_enable_source_maps +[`--enable-source-maps`]: cli.md#cli_enable_source_maps [`Error.prepareStackTrace(error, trace)`]: https://v8.dev/docs/stack-trace-api#customizing-stack-traces -[`NODE_V8_COVERAGE=dir`]: cli.html#cli_node_v8_coverage_dir +[`NODE_V8_COVERAGE=dir`]: cli.md#cli_node_v8_coverage_dir [`SourceMap`]: #module_class_module_sourcemap [`createRequire()`]: #module_module_createrequire_filename -[`module`]: modules.html#modules_the_module_object -[module wrapper]: modules_cjs.html#modules_cjs_the_module_wrapper +[`module`]: modules.md#modules_the_module_object +[module wrapper]: modules.md#modules_the_module_wrapper [source map include directives]: https://sourcemaps.info/spec.html#h.lmz475t4mvbx diff --git a/doc/api/modules.md b/doc/api/modules.md index 4e7b3da3408..9fad87cfcd4 100644 --- a/doc/api/modules.md +++ b/doc/api/modules.md @@ -952,7 +952,7 @@ in order to be used. ## The `Module` object This section was moved to -[Modules: `module` core module](module.html#module_the_module_object). +[Modules: `module` core module](module.md#module_the_module_object). <!-- Anchors to make sure old links find a target --> * <a id="modules_module_builtinmodules" href="module.html#module_module_builtinmodules">`module.builtinModules`</a> @@ -963,7 +963,7 @@ This section was moved to ## Source map v3 support This section was moved to -[Modules: `module` core module](module.html#module_source_map_v3_support). +[Modules: `module` core module](module.md#module_source_map_v3_support). <!-- Anchors to make sure old links find a target --> * <a id="modules_module_findsourcemap_path_error" href="module.html#module_module_findsourcemap_path_error">`module.findSourceMap(path[, error])`</a> @@ -973,18 +973,18 @@ This section was moved to * <a id="modules_sourcemap_findentry_linenumber_columnnumber" href="module.html#module_sourcemap_findentry_linenumber_columnnumber">`sourceMap.findEntry(lineNumber, columnNumber)`</a> [GLOBAL_FOLDERS]: #modules_loading_from_the_global_folders -[`Error`]: errors.html#errors_class_error +[`Error`]: errors.md#errors_class_error [`__dirname`]: #modules_dirname [`__filename`]: #modules_filename [`module` object]: #modules_the_module_object [`module.id`]: #modules_module_id [`module.children`]: #modules_module_children -[`path.dirname()`]: path.html#path_path_dirname_path -[ECMAScript Modules]: esm.html -[an error]: errors.html#errors_err_require_esm +[`path.dirname()`]: path.md#path_path_dirname_path +[ECMAScript Modules]: esm.md +[an error]: errors.md#errors_err_require_esm [exports shortcut]: #modules_exports_shortcut [module resolution]: #modules_all_together -[native addons]: addons.html +[native addons]: addons.md [`require.main`]: #modules_require_main -[`package.json`]: packages.html#packages_node_js_package_json_field_definitions -[`"main"`]: packages.html#packages_main +[`package.json`]: packages.md#packages_node_js_package_json_field_definitions +[`"main"`]: packages.md#packages_main diff --git a/doc/api/n-api.md b/doc/api/n-api.md index 49e3986b418..b84a62fc5da 100644 --- a/doc/api/n-api.md +++ b/doc/api/n-api.md @@ -5885,7 +5885,7 @@ This API may only be called from the main thread. [ABI Stability]: https://nodejs.org/en/docs/guides/abi-stability/ [AppVeyor]: https://www.appveyor.com -[C++ Addons]: addons.html +[C++ Addons]: addons.md [CMake.js]: https://github.com/cmake-js/cmake-js [CMake]: https://cmake.org [ECMAScript Language Specification]: https://tc39.github.io/ecma262/ @@ -5930,9 +5930,9 @@ This API may only be called from the main thread. [Xcode]: https://developer.apple.com/xcode/ [`Number.MAX_SAFE_INTEGER`]: https://tc39.github.io/ecma262/#sec-number.max_safe_integer [`Number.MIN_SAFE_INTEGER`]: https://tc39.github.io/ecma262/#sec-number.min_safe_integer -[`Worker`]: worker_threads.html#worker_threads_class_worker -[`global`]: globals.html#globals_global -[`init` hooks]: async_hooks.html#async_hooks_init_asyncid_type_triggerasyncid_resource +[`Worker`]: worker_threads.md#worker_threads_class_worker +[`global`]: globals.md#globals_global +[`init` hooks]: async_hooks.md#async_hooks_init_asyncid_type_triggerasyncid_resource [`napi_add_async_cleanup_hook`]: #n_api_napi_add_async_cleanup_hook [`napi_add_env_cleanup_hook`]: #n_api_napi_add_env_cleanup_hook [`napi_add_finalizer`]: #n_api_napi_add_finalizer @@ -5988,14 +5988,14 @@ This API may only be called from the main thread. [`napi_wrap`]: #n_api_napi_wrap [`node-addon-api`]: https://github.com/nodejs/node-addon-api [`node_api.h`]: https://github.com/nodejs/node/blob/master/src/node_api.h -[`process.release`]: process.html#process_process_release +[`process.release`]: process.md#process_process_release [`uv_ref`]: https://docs.libuv.org/en/v1.x/handle.html#c.uv_ref [`uv_unref`]: https://docs.libuv.org/en/v1.x/handle.html#c.uv_unref -[async_hooks `type`]: async_hooks.html#async_hooks_type -[context-aware addons]: addons.html#addons_context_aware_addons +[async_hooks `type`]: async_hooks.md#async_hooks_type +[context-aware addons]: addons.md#addons_context_aware_addons [docs]: https://github.com/nodejs/node-addon-api#api-documentation -[global scope]: globals.html -[module scope]: modules.html#modules_the_module_scope +[global scope]: globals.md +[module scope]: modules.md#modules_the_module_scope [node-gyp]: https://github.com/nodejs/node-gyp [node-pre-gyp]: https://github.com/mapbox/node-pre-gyp [prebuild]: https://github.com/prebuild/prebuild diff --git a/doc/api/net.md b/doc/api/net.md index 28de44d8897..60917b22ca7 100644 --- a/doc/api/net.md +++ b/doc/api/net.md @@ -1248,7 +1248,7 @@ Returns `true` if input is a version 6 IP address, otherwise returns `false`. [IPC]: #net_ipc_support [Identifying paths for IPC connections]: #net_identifying_paths_for_ipc_connections -[Readable Stream]: stream.html#stream_class_stream_readable +[Readable Stream]: stream.md#stream_class_stream_readable [`'close'`]: #net_event_close [`'connect'`]: #net_event_connect [`'connection'`]: #net_event_connection @@ -1258,10 +1258,10 @@ Returns `true` if input is a version 6 IP address, otherwise returns `false`. [`'error'`]: #net_event_error_1 [`'listening'`]: #net_event_listening [`'timeout'`]: #net_event_timeout -[`EventEmitter`]: events.html#events_class_eventemitter -[`child_process.fork()`]: child_process.html#child_process_child_process_fork_modulepath_args_options -[`dns.lookup()` hints]: dns.html#dns_supported_getaddrinfo_flags -[`dns.lookup()`]: dns.html#dns_dns_lookup_hostname_options_callback +[`EventEmitter`]: events.md#events_class_eventemitter +[`child_process.fork()`]: child_process.md#child_process_child_process_fork_modulepath_args_options +[`dns.lookup()` hints]: dns.md#dns_supported_getaddrinfo_flags +[`dns.lookup()`]: dns.md#dns_dns_lookup_hostname_options_callback [`net.Server`]: #net_class_net_server [`net.Socket`]: #net_class_net_socket [`net.connect()`]: #net_net_connect @@ -1274,7 +1274,7 @@ Returns `true` if input is a version 6 IP address, otherwise returns `false`. [`net.createConnection(port, host)`]: #net_net_createconnection_port_host_connectlistener [`net.createServer()`]: #net_net_createserver_options_connectionlistener [`new net.Socket(options)`]: #net_new_net_socket_options -[`readable.setEncoding()`]: stream.html#stream_readable_setencoding_encoding +[`readable.setEncoding()`]: stream.md#stream_readable_setencoding_encoding [`server.close()`]: #net_server_close_callback [`server.getConnections()`]: #net_server_getconnections_callback [`server.listen()`]: #net_server_listen @@ -1294,11 +1294,11 @@ Returns `true` if input is a version 6 IP address, otherwise returns `false`. [`socket.setEncoding()`]: #net_socket_setencoding_encoding [`socket.setTimeout()`]: #net_socket_settimeout_timeout_callback [`socket.setTimeout(timeout)`]: #net_socket_settimeout_timeout_callback -[`writable.writableLength`]: stream.html#stream_writable_writablelength -[`writable.destroyed`]: stream.html#stream_writable_destroyed -[`writable.destroy()`]: stream.html#stream_writable_destroy_error -[`writable.end()`]: stream.html#stream_writable_end_chunk_encoding_callback +[`writable.writableLength`]: stream.md#stream_writable_writablelength +[`writable.destroyed`]: stream.md#stream_writable_destroyed +[`writable.destroy()`]: stream.md#stream_writable_destroy_error +[`writable.end()`]: stream.md#stream_writable_end_chunk_encoding_callback [half-closed]: https://tools.ietf.org/html/rfc1122 -[stream_writable_write]: stream.html#stream_writable_write_chunk_encoding_callback +[stream_writable_write]: stream.md#stream_writable_write_chunk_encoding_callback [unspecified IPv4 address]: https://en.wikipedia.org/wiki/0.0.0.0 [unspecified IPv6 address]: https://en.wikipedia.org/wiki/IPv6_address#Unspecified_address diff --git a/doc/api/os.md b/doc/api/os.md index 9dfe629a97d..ec273dc9a1f 100644 --- a/doc/api/os.md +++ b/doc/api/os.md @@ -1267,9 +1267,9 @@ The following process scheduling constants are exported by </tr> </table> -[`SystemError`]: errors.html#errors_class_systemerror -[`process.arch`]: process.html#process_process_arch -[`process.platform`]: process.html#process_process_platform +[`SystemError`]: errors.md#errors_class_systemerror +[`process.arch`]: process.md#process_process_arch +[`process.platform`]: process.md#process_process_platform [`uname(3)`]: https://linux.die.net/man/3/uname [Android building]: https://github.com/nodejs/node/blob/master/BUILDING.md#androidandroid-based-devices-eg-firefox-os [EUID]: https://en.wikipedia.org/wiki/User_identifier#Effective_user_ID diff --git a/doc/api/packages.md b/doc/api/packages.md index 77183fb23ec..5dccc5e3980 100644 --- a/doc/api/packages.md +++ b/doc/api/packages.md @@ -903,7 +903,7 @@ added: v0.4.0 ``` The `"main"` field defines the script that is used when the [package directory -is loaded via `require()`](modules.html#modules_folders_as_modules). Its value +is loaded via `require()`](modules.md#modules_folders_as_modules). Its value is interpreted as a path. ```js @@ -959,10 +959,10 @@ analogous to the exports field. [Babel]: https://babeljs.io/ [Conditional exports]: #packages_conditional_exports -[CommonJS]: modules.html -[`ERR_PACKAGE_PATH_NOT_EXPORTED`]: errors.html#errors_err_package_path_not_exported -[ES modules]: esm.html -[ES module]: esm.html +[CommonJS]: modules.md +[`ERR_PACKAGE_PATH_NOT_EXPORTED`]: errors.md#errors_err_package_path_not_exported +[ES modules]: esm.md +[ES module]: esm.md [`esm`]: https://github.com/standard-things/esm#readme [`"exports"`]: #packages_exports [`"main"`]: #packages_main @@ -973,5 +973,5 @@ analogous to the exports field. [`package.json`]: #packages_node_js_package_json_field_definitions [self-reference]: #packages_self_referencing_a_package_using_its_name [subpath exports]: #packages_subpath_exports -[the full specifier path]: modules_esm.html#modules_esm_mandatory_file_extensions +[the full specifier path]: esm.md#esm_mandatory_file_extensions [the dual CommonJS/ES module packages section]: #packages_dual_commonjs_es_module_packages diff --git a/doc/api/path.md b/doc/api/path.md index e78850fb7d2..1193d4ca36a 100644 --- a/doc/api/path.md +++ b/doc/api/path.md @@ -575,7 +575,7 @@ added: v0.11.15 The `path.win32` property provides access to Windows-specific implementations of the `path` methods. -[`TypeError`]: errors.html#errors_class_typeerror +[`TypeError`]: errors.md#errors_class_typeerror [`path.parse()`]: #path_path_parse_path [`path.posix`]: #path_path_posix [`path.sep`]: #path_path_sep diff --git a/doc/api/perf_hooks.md b/doc/api/perf_hooks.md index 67f791653f9..d2dde689d23 100644 --- a/doc/api/perf_hooks.md +++ b/doc/api/perf_hooks.md @@ -752,12 +752,12 @@ obs.observe({ entryTypes: ['function'], buffered: true }); require('some-module'); ``` -[`'exit'`]: process.html#process_event_exit -[`process.hrtime()`]: process.html#process_process_hrtime_time -[`child_process.spawnSync()`]: child_process.html#child_process_child_process_spawnsync_command_args_options +[`'exit'`]: process.md#process_event_exit +[`process.hrtime()`]: process.md#process_process_hrtime_time +[`child_process.spawnSync()`]: child_process.md#child_process_child_process_spawnsync_command_args_options [`timeOrigin`]: https://w3c.github.io/hr-time/#dom-performance-timeorigin [`window.performance`]: https://developer.mozilla.org/en-US/docs/Web/API/Window/performance -[Async Hooks]: async_hooks.html +[Async Hooks]: async_hooks.md [High Resolution Time]: https://www.w3.org/TR/hr-time-2 [Performance Timeline]: https://w3c.github.io/performance-timeline/ [Web Performance APIs]: https://w3c.github.io/perf-timing-primer/ diff --git a/doc/api/process.md b/doc/api/process.md index 0f20ade9799..e63193c53bd 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -2585,23 +2585,23 @@ cases: code will be `128` + `6`, or `134`. [`'exit'`]: #process_event_exit -[`'message'`]: child_process.html#child_process_event_message +[`'message'`]: child_process.md#child_process_event_message [`'uncaughtException'`]: #process_event_uncaughtexception -[`--unhandled-rejections`]: cli.html#cli_unhandled_rejections_mode -[`Buffer`]: buffer.html -[`ChildProcess.disconnect()`]: child_process.html#child_process_subprocess_disconnect -[`ChildProcess.send()`]: child_process.html#child_process_subprocess_send_message_sendhandle_options_callback -[`ChildProcess`]: child_process.html#child_process_class_childprocess -[`Error`]: errors.html#errors_class_error -[`EventEmitter`]: events.html#events_class_eventemitter -[`NODE_OPTIONS`]: cli.html#cli_node_options_options -[`Worker`]: worker_threads.html#worker_threads_class_worker -[`console.error()`]: console.html#console_console_error_data_args -[`console.log()`]: console.html#console_console_log_data_args -[`domain`]: domain.html -[`net.Server`]: net.html#net_class_net_server -[`net.Socket`]: net.html#net_class_net_socket -[`os.constants.dlopen`]: os.html#os_dlopen_constants +[`--unhandled-rejections`]: cli.md#cli_unhandled_rejections_mode +[`Buffer`]: buffer.md +[`ChildProcess.disconnect()`]: child_process.md#child_process_subprocess_disconnect +[`ChildProcess.send()`]: child_process.md#child_process_subprocess_send_message_sendhandle_options_callback +[`ChildProcess`]: child_process.md#child_process_class_childprocess +[`Error`]: errors.md#errors_class_error +[`EventEmitter`]: events.md#events_class_eventemitter +[`NODE_OPTIONS`]: cli.md#cli_node_options_options +[`Worker`]: worker_threads.md#worker_threads_class_worker +[`console.error()`]: console.md#console_console_error_data_args +[`console.log()`]: console.md#console_console_log_data_args +[`domain`]: domain.md +[`net.Server`]: net.md#net_class_net_server +[`net.Socket`]: net.md#net_class_net_socket +[`os.constants.dlopen`]: os.md#os_dlopen_constants [`process.argv`]: #process_process_argv [`process.config`]: #process_process_config [`process.execPath`]: #process_process_execpath @@ -2610,34 +2610,34 @@ cases: [`process.hrtime()`]: #process_process_hrtime_time [`process.hrtime.bigint()`]: #process_process_hrtime_bigint [`process.kill()`]: #process_process_kill_pid_signal -[`process.setUncaughtExceptionCaptureCallback()`]: process.html#process_process_setuncaughtexceptioncapturecallback_fn +[`process.setUncaughtExceptionCaptureCallback()`]: process.md#process_process_setuncaughtexceptioncapturecallback_fn [`promise.catch()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/catch [`Promise.race()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/race -[`require()`]: globals.html#globals_require -[`require.main`]: modules.html#modules_accessing_the_main_module -[`require.resolve()`]: modules.html#modules_require_resolve_request_options -[`subprocess.kill()`]: child_process.html#child_process_subprocess_kill_signal -[`v8.setFlagsFromString()`]: v8.html#v8_v8_setflagsfromstring_flags -[Advanced serialization for `child_process`]: child_process.html#child_process_advanced_serialization +[`require()`]: globals.md#globals_require +[`require.main`]: modules.md#modules_accessing_the_main_module +[`require.resolve()`]: modules.md#modules_require_resolve_request_options +[`subprocess.kill()`]: child_process.md#child_process_subprocess_kill_signal +[`v8.setFlagsFromString()`]: v8.md#v8_v8_setflagsfromstring_flags +[Advanced serialization for `child_process`]: child_process.md#child_process_advanced_serialization [Android building]: https://github.com/nodejs/node/blob/master/BUILDING.md#androidandroid-based-devices-eg-firefox-os -[Child Process]: child_process.html -[Cluster]: cluster.html -[Duplex]: stream.html#stream_duplex_and_transform_streams +[Child Process]: child_process.md +[Cluster]: cluster.md +[Duplex]: stream.md#stream_duplex_and_transform_streams [Event Loop]: https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/#process-nexttick [LTS]: https://github.com/nodejs/Release -[Readable]: stream.html#stream_readable_streams -[`readable.read()`]: stream.html#stream_readable_read_size +[Readable]: stream.md#stream_readable_streams +[`readable.read()`]: stream.md#stream_readable_read_size [Signal Events]: #process_signal_events -[Stream compatibility]: stream.html#stream_compatibility_with_older_node_js_versions -[TTY]: tty.html#tty_tty -[Writable]: stream.html#stream_writable_streams -[debugger]: debugger.html -[note on process I/O]: process.html#process_a_note_on_process_i_o +[Stream compatibility]: stream.md#stream_compatibility_with_older_node_js_versions +[TTY]: tty.md#tty_tty +[Writable]: stream.md#stream_writable_streams +[debugger]: debugger.md +[note on process I/O]: process.md#process_a_note_on_process_i_o [process.cpuUsage]: #process_process_cpuusage_previousvalue [process_emit_warning]: #process_process_emitwarning_warning_type_code_ctor [process_warning]: #process_event_warning -[report documentation]: report.html -[terminal raw mode]: tty.html#tty_readstream_setrawmode_mode +[report documentation]: report.md +[terminal raw mode]: tty.md#tty_readstream_setrawmode_mode [uv_rusage_t]: https://docs.libuv.org/en/v1.x/misc.html#c.uv_rusage_t [wikipedia_minor_fault]: https://en.wikipedia.org/wiki/Page_fault#Minor [wikipedia_major_fault]: https://en.wikipedia.org/wiki/Page_fault#Major diff --git a/doc/api/readline.md b/doc/api/readline.md index 8d3eef1ab42..f44c9101b8f 100644 --- a/doc/api/readline.md +++ b/doc/api/readline.md @@ -865,15 +865,15 @@ const { createInterface } = require('readline'); </tr> </table> -[`'SIGCONT'`]: readline.html#readline_event_sigcont -[`'SIGTSTP'`]: readline.html#readline_event_sigtstp +[`'SIGCONT'`]: readline.md#readline_event_sigcont +[`'SIGTSTP'`]: readline.md#readline_event_sigtstp [`'line'`]: #readline_event_line -[`fs.ReadStream`]: fs.html#fs_class_fs_readstream -[`process.stdin`]: process.html#process_process_stdin -[`process.stdout`]: process.html#process_process_stdout +[`fs.ReadStream`]: fs.md#fs_class_fs_readstream +[`process.stdin`]: process.md#process_process_stdin +[`process.stdout`]: process.md#process_process_stdout [`rl.close()`]: #readline_rl_close -[Readable]: stream.html#stream_readable_streams -[TTY]: tty.html +[Readable]: stream.md#stream_readable_streams +[TTY]: tty.md [TTY keybindings]: #readline_tty_keybindings -[Writable]: stream.html#stream_writable_streams +[Writable]: stream.md#stream_writable_streams [reading files]: #readline_example_read_file_stream_line_by_line diff --git a/doc/api/repl.md b/doc/api/repl.md index a194cf05a81..20fffe3fb59 100644 --- a/doc/api/repl.md +++ b/doc/api/repl.md @@ -744,18 +744,18 @@ a `net.Server` and `net.Socket` instance, see: For an example of running a REPL instance over [`curl(1)`][], see: <https://gist.github.com/TooTallNate/2053342>. -[TTY keybindings]: readline.html#readline_tty_keybindings +[TTY keybindings]: readline.md#readline_tty_keybindings [ZSH]: https://en.wikipedia.org/wiki/Z_shell -[`'uncaughtException'`]: process.html#process_event_uncaughtexception -[`--experimental-repl-await`]: cli.html#cli_experimental_repl_await -[`ERR_DOMAIN_CANNOT_SET_UNCAUGHT_EXCEPTION_CAPTURE`]: errors.html#errors_err_domain_cannot_set_uncaught_exception_capture -[`ERR_INVALID_REPL_INPUT`]: errors.html#errors_err_invalid_repl_input +[`'uncaughtException'`]: process.md#process_event_uncaughtexception +[`--experimental-repl-await`]: cli.md#cli_experimental_repl_await +[`ERR_DOMAIN_CANNOT_SET_UNCAUGHT_EXCEPTION_CAPTURE`]: errors.md#errors_err_domain_cannot_set_uncaught_exception_capture +[`ERR_INVALID_REPL_INPUT`]: errors.md#errors_err_invalid_repl_input [`curl(1)`]: https://curl.haxx.se/docs/manpage.html -[`domain`]: domain.html -[`process.setUncaughtExceptionCaptureCallback()`]: process.html#process_process_setuncaughtexceptioncapturecallback_fn -[`readline.InterfaceCompleter`]: readline.html#readline_use_of_the_completer_function +[`domain`]: domain.md +[`process.setUncaughtExceptionCaptureCallback()`]: process.md#process_process_setuncaughtexceptioncapturecallback_fn +[`readline.InterfaceCompleter`]: readline.md#readline_use_of_the_completer_function [`repl.ReplServer`]: #repl_class_replserver [`repl.start()`]: #repl_repl_start_options [`reverse-i-search`]: #repl_reverse_i_search -[`util.inspect()`]: util.html#util_util_inspect_object_options -[stream]: stream.html +[`util.inspect()`]: util.md#util_util_inspect_object_options +[stream]: stream.md diff --git a/doc/api/report.md b/doc/api/report.md index 95d53697f0d..cffa288d9f7 100644 --- a/doc/api/report.md +++ b/doc/api/report.md @@ -598,5 +598,5 @@ The thread which is generating the report will wait for the reports from Worker threads to finish. However, the latency for this will usually be low, as both running JavaScript and the event loop are interrupted to generate the report. -[`process API documentation`]: process.html -[`Worker`]: worker_threads.html +[`process API documentation`]: process.md +[`Worker`]: worker_threads.md diff --git a/doc/api/stream.md b/doc/api/stream.md index 611e98cd8c6..3608bff5bf0 100644 --- a/doc/api/stream.md +++ b/doc/api/stream.md @@ -3031,17 +3031,17 @@ contain multi-byte characters. [`'finish'`]: #stream_event_finish [`'readable'`]: #stream_event_readable [`Duplex`]: #stream_class_stream_duplex -[`EventEmitter`]: events.html#events_class_eventemitter +[`EventEmitter`]: events.md#events_class_eventemitter [`Readable`]: #stream_class_stream_readable [`Symbol.hasInstance`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/hasInstance [`Transform`]: #stream_class_stream_transform [`Writable`]: #stream_class_stream_writable -[`fs.createReadStream()`]: fs.html#fs_fs_createreadstream_path_options -[`fs.createWriteStream()`]: fs.html#fs_fs_createwritestream_path_options -[`net.Socket`]: net.html#net_class_net_socket -[`process.stderr`]: process.html#process_process_stderr -[`process.stdin`]: process.html#process_process_stdin -[`process.stdout`]: process.html#process_process_stdout +[`fs.createReadStream()`]: fs.md#fs_fs_createreadstream_path_options +[`fs.createWriteStream()`]: fs.md#fs_fs_createwritestream_path_options +[`net.Socket`]: net.md#net_class_net_socket +[`process.stderr`]: process.md#process_process_stderr +[`process.stdin`]: process.md#process_process_stdin +[`process.stdout`]: process.md#process_process_stdout [`readable._read()`]: #stream_readable_read_size_1 [`readable.push('')`]: #stream_readable_push [`readable.setEncoding()`]: #stream_readable_setencoding_encoding @@ -3060,19 +3060,19 @@ contain multi-byte characters. [`writable.end()`]: #stream_writable_end_chunk_encoding_callback [`writable.uncork()`]: #stream_writable_uncork [`writable.writableFinished`]: #stream_writable_writablefinished -[`zlib.createDeflate()`]: zlib.html#zlib_zlib_createdeflate_options +[`zlib.createDeflate()`]: zlib.md#zlib_zlib_createdeflate_options [API for stream consumers]: #stream_api_for_stream_consumers [API for stream implementers]: #stream_api_for_stream_implementers [Compatibility]: #stream_compatibility_with_older_node_js_versions -[HTTP requests, on the client]: http.html#http_class_http_clientrequest -[HTTP responses, on the server]: http.html#http_class_http_serverresponse -[TCP sockets]: net.html#net_class_net_socket -[child process stdin]: child_process.html#child_process_subprocess_stdin -[child process stdout and stderr]: child_process.html#child_process_subprocess_stdout -[crypto]: crypto.html -[fs read streams]: fs.html#fs_class_fs_readstream -[fs write streams]: fs.html#fs_class_fs_writestream -[http-incoming-message]: http.html#http_class_http_incomingmessage +[HTTP requests, on the client]: http.md#http_class_http_clientrequest +[HTTP responses, on the server]: http.md#http_class_http_serverresponse +[TCP sockets]: net.md#net_class_net_socket +[child process stdin]: child_process.md#child_process_subprocess_stdin +[child process stdout and stderr]: child_process.md#child_process_subprocess_stdout +[crypto]: crypto.md +[fs read streams]: fs.md#fs_class_fs_readstream +[fs write streams]: fs.md#fs_class_fs_writestream +[http-incoming-message]: http.md#http_class_http_incomingmessage [hwm-gotcha]: #stream_highwatermark_discrepancy_after_calling_readable_setencoding [object-mode]: #stream_object_mode [readable-_destroy]: #stream_readable_destroy_err_callback @@ -3094,4 +3094,4 @@ contain multi-byte characters. [writable-_destroy]: #stream_writable_destroy_err_callback [writable-destroy]: #stream_writable_destroy_error [writable-new]: #stream_new_stream_writable_options -[zlib]: zlib.html +[zlib]: zlib.md diff --git a/doc/api/string_decoder.md b/doc/api/string_decoder.md index 59056b86132..a810462f508 100644 --- a/doc/api/string_decoder.md +++ b/doc/api/string_decoder.md @@ -91,4 +91,4 @@ Returns a decoded string, ensuring that any incomplete multibyte characters at returned string and stored in an internal buffer for the next call to `stringDecoder.write()` or `stringDecoder.end()`. -[encoding]: buffer.html#buffer_buffers_and_character_encodings +[encoding]: buffer.md#buffer_buffers_and_character_encodings diff --git a/doc/api/synopsis.md b/doc/api/synopsis.md index d4b0ffa36cd..cb43312f358 100644 --- a/doc/api/synopsis.md +++ b/doc/api/synopsis.md @@ -86,6 +86,6 @@ Now, open any preferred web browser and visit `http://127.0.0.1:3000`. If the browser displays the string `Hello, World!`, that indicates the server is working. -[Command-line options]: cli.html#cli_command_line_options +[Command-line options]: cli.md#cli_command_line_options [Installing Node.js via package manager]: https://nodejs.org/en/download/package-manager/ -[web server]: http.html +[web server]: http.md diff --git a/doc/api/timers.md b/doc/api/timers.md index c3c0e825815..b710dec8153 100644 --- a/doc/api/timers.md +++ b/doc/api/timers.md @@ -280,12 +280,12 @@ added: v0.0.1 Cancels a `Timeout` object created by [`setTimeout()`][]. [Event Loop]: https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/#setimmediate-vs-settimeout -[`TypeError`]: errors.html#errors_class_typeerror -[`clearImmediate()`]: timers.html#timers_clearimmediate_immediate -[`clearInterval()`]: timers.html#timers_clearinterval_timeout -[`clearTimeout()`]: timers.html#timers_cleartimeout_timeout -[`setImmediate()`]: timers.html#timers_setimmediate_callback_args -[`setInterval()`]: timers.html#timers_setinterval_callback_delay_args -[`setTimeout()`]: timers.html#timers_settimeout_callback_delay_args -[`util.promisify()`]: util.html#util_util_promisify_original -[`worker_threads`]: worker_threads.html +[`TypeError`]: errors.md#errors_class_typeerror +[`clearImmediate()`]: timers.md#timers_clearimmediate_immediate +[`clearInterval()`]: timers.md#timers_clearinterval_timeout +[`clearTimeout()`]: timers.md#timers_cleartimeout_timeout +[`setImmediate()`]: timers.md#timers_setimmediate_callback_args +[`setInterval()`]: timers.md#timers_setinterval_callback_delay_args +[`setTimeout()`]: timers.md#timers_settimeout_callback_delay_args +[`util.promisify()`]: util.md#util_util_promisify_original +[`worker_threads`]: worker_threads.md diff --git a/doc/api/tls.md b/doc/api/tls.md index 19ec9e1aa38..1751b4d0c37 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -1989,22 +1989,22 @@ added: v11.4.0 [`'secureConnect'`]: #tls_event_secureconnect [`'secureConnection'`]: #tls_event_secureconnection [`'session'`]: #tls_event_session -[`--tls-cipher-list`]: cli.html#cli_tls_cipher_list_list -[`NODE_OPTIONS`]: cli.html#cli_node_options_options +[`--tls-cipher-list`]: cli.md#cli_tls_cipher_list_list +[`NODE_OPTIONS`]: cli.md#cli_node_options_options [`SSL_export_keying_material`]: https://www.openssl.org/docs/man1.1.1/man3/SSL_export_keying_material.html [`SSL_get_version`]: https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html -[`crypto.getCurves()`]: crypto.html#crypto_crypto_getcurves -[`Duplex`]: stream.html#stream_class_stream_duplex -[`net.createServer()`]: net.html#net_net_createserver_options_connectionlistener -[`net.Server.address()`]: net.html#net_server_address -[`net.Server`]: net.html#net_class_net_server -[`net.Socket`]: net.html#net_class_net_socket +[`crypto.getCurves()`]: crypto.md#crypto_crypto_getcurves +[`Duplex`]: stream.md#stream_class_stream_duplex +[`net.createServer()`]: net.md#net_net_createserver_options_connectionlistener +[`net.Server.address()`]: net.md#net_server_address +[`net.Server`]: net.md#net_class_net_server +[`net.Socket`]: net.md#net_class_net_socket [`server.addContext()`]: #tls_server_addcontext_hostname_context [`server.getConnections()`]: net.html#net_server_getconnections_callback [`server.getTicketKeys()`]: #tls_server_getticketkeys -[`server.listen()`]: net.html#net_server_listen +[`server.listen()`]: net.md#net_server_listen [`server.setTicketKeys()`]: #tls_server_setticketkeys_keys -[`socket.connect()`]: net.html#net_socket_connect_options_connectlistener +[`socket.connect()`]: net.md#net_socket_connect_options_connectlistener [`tls.DEFAULT_ECDH_CURVE`]: #tls_tls_default_ecdh_curve [`tls.DEFAULT_MAX_VERSION`]: #tls_tls_default_max_version [`tls.DEFAULT_MIN_VERSION`]: #tls_tls_default_min_version @@ -2026,14 +2026,14 @@ added: v11.4.0 [forward secrecy]: https://en.wikipedia.org/wiki/Perfect_forward_secrecy [Mozilla's publicly trusted list of CAs]: https://hg.mozilla.org/mozilla-central/raw-file/tip/security/nss/lib/ckfw/builtins/certdata.txt [OCSP request]: https://en.wikipedia.org/wiki/OCSP_stapling -[OpenSSL Options]: crypto.html#crypto_openssl_options +[OpenSSL Options]: crypto.md#crypto_openssl_options [perfect forward secrecy]: #tls_perfect_forward_secrecy [RFC 2246]: https://www.ietf.org/rfc/rfc2246.txt [RFC 5077]: https://tools.ietf.org/html/rfc5077 [RFC 5929]: https://tools.ietf.org/html/rfc5929 [SSL_METHODS]: https://www.openssl.org/docs/man1.1.1/man7/ssl.html#Dealing-with-Protocol-Methods [Session Resumption]: #tls_session_resumption -[Stream]: stream.html#stream_stream +[Stream]: stream.md#stream_stream [TLS recommendations]: https://wiki.mozilla.org/Security/Server_Side_TLS [asn1.js]: https://www.npmjs.com/package/asn1.js [certificate object]: #tls_certificate_object diff --git a/doc/api/tracing.md b/doc/api/tracing.md index 9350e0b9ca9..9d1c873a3e8 100644 --- a/doc/api/tracing.md +++ b/doc/api/tracing.md @@ -207,7 +207,7 @@ t2.enable(); console.log(trace_events.getEnabledCategories()); ``` -[Performance API]: perf_hooks.html -[V8]: v8.html -[`Worker`]: worker_threads.html#worker_threads_class_worker -[`async_hooks`]: async_hooks.html +[Performance API]: perf_hooks.md +[V8]: v8.md +[`Worker`]: worker_threads.md#worker_threads_class_worker +[`async_hooks`]: async_hooks.md diff --git a/doc/api/tty.md b/doc/api/tty.md index f4a83c290a3..a757b5b3703 100644 --- a/doc/api/tty.md +++ b/doc/api/tty.md @@ -211,10 +211,10 @@ added: v0.7.7 * Returns: {number[]} -`writeStream.getWindowSize()` returns the size of the [TTY](tty.html) +`writeStream.getWindowSize()` returns the size of the [TTY](tty.md) corresponding to this `WriteStream`. The array is of the type `[numColumns, numRows]` where `numColumns` and `numRows` represent the number -of columns and rows in the corresponding [TTY](tty.html). +of columns and rows in the corresponding [TTY](tty.md). ### `writeStream.hasColors([count][, env])` <!-- YAML @@ -293,7 +293,7 @@ The `tty.isatty()` method returns `true` if the given `fd` is associated with a TTY and `false` if it is not, including whenever `fd` is not a non-negative integer. -[`process.stderr`]: process.html#process_process_stderr -[`process.stdin`]: process.html#process_process_stdin -[`process.stdout`]: process.html#process_process_stdout +[`process.stderr`]: process.md#process_process_stderr +[`process.stdin`]: process.md#process_process_stdin +[`process.stdout`]: process.md#process_process_stdout [`writeStream.getColorDepth()`]: #tty_writestream_getcolordepth_env diff --git a/doc/api/url.md b/doc/api/url.md index 55919241b90..fd0703cbfc8 100644 --- a/doc/api/url.md +++ b/doc/api/url.md @@ -1352,14 +1352,14 @@ console.log(myURL.origin); // Prints https://xn--1xa.example.com ``` -[`Error`]: errors.html#errors_class_error +[`Error`]: errors.md#errors_class_error [`JSON.stringify()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify [`Map`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map -[`TypeError`]: errors.html#errors_class_typeerror +[`TypeError`]: errors.md#errors_class_typeerror [`URLSearchParams`]: #url_class_urlsearchparams [`array.toString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toString [`new URL()`]: #url_new_url_input_base -[`querystring`]: querystring.html +[`querystring`]: querystring.md [`require('url').format()`]: #url_url_format_url_options [`url.domainToASCII()`]: #url_url_domaintoascii_domain [`url.domainToUnicode()`]: #url_url_domaintounicode_domain @@ -1371,7 +1371,7 @@ console.log(myURL.origin); [`url.toString()`]: #url_url_tostring [`urlSearchParams.entries()`]: #url_urlsearchparams_entries [`urlSearchParams@@iterator()`]: #url_urlsearchparams_symbol_iterator -[ICU]: intl.html#intl_options_for_building_node_js +[ICU]: intl.md#intl_options_for_building_node_js [Punycode]: https://tools.ietf.org/html/rfc5891#section-4.4 [WHATWG URL Standard]: https://url.spec.whatwg.org/ [WHATWG URL]: #url_the_whatwg_url_api diff --git a/doc/api/util.md b/doc/api/util.md index bc75caa1b7b..7bf16435182 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -2445,15 +2445,15 @@ const util = require('util'); util.log('Timestamped message.'); ``` -[`'uncaughtException'`]: process.html#process_event_uncaughtexception -[`'warning'`]: process.html#process_event_warning +[`'uncaughtException'`]: process.md#process_event_uncaughtexception +[`'warning'`]: process.md#process_event_warning [`Array.isArray()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray [`ArrayBuffer.isView()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/isView [`ArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer -[`Buffer.isBuffer()`]: buffer.html#buffer_static_method_buffer_isbuffer_obj +[`Buffer.isBuffer()`]: buffer.md#buffer_static_method_buffer_isbuffer_obj [`DataView`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView [`Date`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date -[`Error`]: errors.html#errors_class_error +[`Error`]: errors.md#errors_class_error [`Float32Array`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array [`Float64Array`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float64Array [`Int16Array`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Int16Array @@ -2474,10 +2474,10 @@ util.log('Timestamped message.'); [`WeakMap`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap [`WeakSet`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet [`WebAssembly.Module`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Module -[`assert.deepStrictEqual()`]: assert.html#assert_assert_deepstrictequal_actual_expected_message -[`console.error()`]: console.html#console_console_error_data_args +[`assert.deepStrictEqual()`]: assert.md#assert_assert_deepstrictequal_actual_expected_message +[`console.error()`]: console.md#console_console_error_data_args [`target` and `handler`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy#Terminology -[`tty.hasColors()`]: tty.html#tty_writestream_hascolors_count_env +[`tty.hasColors()`]: tty.md#tty_writestream_hascolors_count_env [`util.format()`]: #util_util_format_format_args [`util.inspect()`]: #util_util_inspect_object_options [`util.promisify()`]: #util_util_promisify_original @@ -2486,11 +2486,11 @@ util.log('Timestamped message.'); [`util.types.isDate()`]: #util_util_types_isdate_value [`util.types.isNativeError()`]: #util_util_types_isnativeerror_value [`util.types.isSharedArrayBuffer()`]: #util_util_types_issharedarraybuffer_value -[Common System Errors]: errors.html#errors_common_system_errors +[Common System Errors]: errors.md#errors_common_system_errors [Custom inspection functions on objects]: #util_custom_inspection_functions_on_objects [Custom promisified functions]: #util_custom_promisified_functions [Customizing `util.inspect` colors]: #util_customizing_util_inspect_colors -[Internationalization]: intl.html +[Internationalization]: intl.md [Module Namespace Object]: https://tc39.github.io/ecma262/#sec-module-namespace-exotic-objects [WHATWG Encoding Standard]: https://encoding.spec.whatwg.org/ [async function]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function @@ -2498,7 +2498,7 @@ util.log('Timestamped message.'); [constructor]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/constructor [default sort]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort [global symbol registry]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/for -[list of deprecated APIS]: deprecations.html#deprecations_list_of_deprecated_apis -[`napi_create_external()`]: n-api.html#n_api_napi_create_external +[list of deprecated APIS]: deprecations.md#deprecations_list_of_deprecated_apis +[`napi_create_external()`]: n-api.md#n_api_napi_create_external [semantically incompatible]: https://github.com/nodejs/node/issues/4179 [util.inspect.custom]: #util_util_inspect_custom diff --git a/doc/api/v8.md b/doc/api/v8.md index a70567475f0..5bd28b2673f 100644 --- a/doc/api/v8.md +++ b/doc/api/v8.md @@ -503,11 +503,11 @@ added: v8.0.0 A subclass of [`Deserializer`][] corresponding to the format written by [`DefaultSerializer`][]. -[`Buffer`]: buffer.html +[`Buffer`]: buffer.md [`DefaultDeserializer`]: #v8_class_v8_defaultdeserializer [`DefaultSerializer`]: #v8_class_v8_defaultserializer [`Deserializer`]: #v8_class_v8_deserializer -[`Error`]: errors.html#errors_class_error +[`Error`]: errors.md#errors_class_error [`GetHeapSpaceStatistics`]: https://v8docs.nodesource.com/node-13.2/d5/dda/classv8_1_1_isolate.html#ac673576f24fdc7a33378f8f57e1d13a4 [`Serializer`]: #v8_class_v8_serializer [`deserializer._readHostObject()`]: #v8_deserializer_readhostobject @@ -518,7 +518,7 @@ A subclass of [`Deserializer`][] corresponding to the format written by [`serializer.releaseBuffer()`]: #v8_serializer_releasebuffer [`serializer.transferArrayBuffer()`]: #v8_serializer_transferarraybuffer_id_arraybuffer [`serializer.writeRawBytes()`]: #v8_serializer_writerawbytes_buffer -[`vm.Script`]: vm.html#vm_new_vm_script_code_options +[`vm.Script`]: vm.md#vm_new_vm_script_code_options [HTML structured clone algorithm]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm [V8]: https://developers.google.com/v8/ -[worker threads]: worker_threads.html +[worker threads]: worker_threads.md diff --git a/doc/api/vm.md b/doc/api/vm.md index e540a9f11e4..e25f0c05b10 100644 --- a/doc/api/vm.md +++ b/doc/api/vm.md @@ -1304,19 +1304,19 @@ inside a `vm.Context`, functions passed to them will be added to global queues, which are shared by all contexts. Therefore, callbacks passed to those functions are not controllable through the timeout either. -[`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`]: errors.html#ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING -[`ERR_VM_MODULE_STATUS`]: errors.html#ERR_VM_MODULE_STATUS -[`Error`]: errors.html#errors_class_error -[`URL`]: url.html#url_class_url +[`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`]: errors.md#ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING +[`ERR_VM_MODULE_STATUS`]: errors.md#ERR_VM_MODULE_STATUS +[`Error`]: errors.md#errors_class_error +[`URL`]: url.md#url_class_url [`eval()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval [`script.runInContext()`]: #vm_script_runincontext_contextifiedobject_options [`script.runInThisContext()`]: #vm_script_runinthiscontext_options -[`url.origin`]: url.html#url_url_origin +[`url.origin`]: url.md#url_url_origin [`vm.createContext()`]: #vm_vm_createcontext_contextobject_options [`vm.runInContext()`]: #vm_vm_runincontext_code_contextifiedobject_options [`vm.runInThisContext()`]: #vm_vm_runinthiscontext_code_options [Cyclic Module Record]: https://tc39.es/ecma262/#sec-cyclic-module-records -[ECMAScript Module Loader]: esm.html#esm_modules_ecmascript_modules +[ECMAScript Module Loader]: esm.md#esm_modules_ecmascript_modules [Evaluate() concrete method]: https://tc39.es/ecma262/#sec-moduleevaluation [GetModuleNamespace]: https://tc39.es/ecma262/#sec-getmodulenamespace [HostResolveImportedModule]: https://tc39.es/ecma262/#sec-hostresolveimportedmodule diff --git a/doc/api/worker_threads.md b/doc/api/worker_threads.md index 2a9ce9f2d31..bf38b86688a 100644 --- a/doc/api/worker_threads.md +++ b/doc/api/worker_threads.md @@ -899,59 +899,59 @@ active handle in the event system. If the worker is already `unref()`ed calling [`'close'` event]: #worker_threads_event_close [`'exit'` event]: #worker_threads_event_exit [`ArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer -[`AsyncResource`]: async_hooks.html#async_hooks_class_asyncresource -[`Buffer`]: buffer.html -[`Buffer.allocUnsafe()`]: buffer.html#buffer_static_method_buffer_allocunsafe_size -[ECMAScript module loader]: esm.html#esm_data_imports -[`ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST`]: errors.html#errors_err_missing_message_port_in_transfer_list -[`ERR_WORKER_NOT_RUNNING`]: errors.html#ERR_WORKER_NOT_RUNNING -[`EventEmitter`]: events.html +[`AsyncResource`]: async_hooks.md#async_hooks_class_asyncresource +[`Buffer`]: buffer.md +[`Buffer.allocUnsafe()`]: buffer.md#buffer_static_method_buffer_allocunsafe_size +[ECMAScript module loader]: esm.md#esm_data_imports +[`ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST`]: errors.md#errors_err_missing_message_port_in_transfer_list +[`ERR_WORKER_NOT_RUNNING`]: errors.md#ERR_WORKER_NOT_RUNNING +[`EventEmitter`]: events.md [`EventTarget`]: https://developer.mozilla.org/en-US/docs/Web/API/EventTarget -[`FileHandle`]: fs.html#fs_class_filehandle -[`KeyObject`]: crypto.html#crypto_class_keyobject +[`FileHandle`]: fs.md#fs_class_filehandle +[`KeyObject`]: crypto.md#crypto_class_keyobject [`MessagePort`]: #worker_threads_class_messageport [`SharedArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer [`Uint8Array`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array [`WebAssembly.Module`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Module [`Worker`]: #worker_threads_class_worker -[`cluster` module]: cluster.html -[`fs.open()`]: fs.html#fs_fs_open_path_flags_mode_callback -[`fs.close()`]: fs.html#fs_fs_close_fd_callback +[`cluster` module]: cluster.md +[`fs.open()`]: fs.md#fs_fs_open_path_flags_mode_callback +[`fs.close()`]: fs.md#fs_fs_close_fd_callback [`markAsUntransferable()`]: #worker_threads_worker_markasuntransferable_object [`port.on('message')`]: #worker_threads_event_message [`port.onmessage()`]: https://developer.mozilla.org/en-US/docs/Web/API/MessagePort/onmessage [`port.postMessage()`]: #worker_threads_port_postmessage_value_transferlist -[`process.abort()`]: process.html#process_process_abort -[`process.chdir()`]: process.html#process_process_chdir_directory -[`process.env`]: process.html#process_process_env -[`process.execArgv`]: process.html#process_process_execargv -[`process.exit()`]: process.html#process_process_exit_code -[`process.stderr`]: process.html#process_process_stderr -[`process.stdin`]: process.html#process_process_stdin -[`process.stdout`]: process.html#process_process_stdout -[`process.title`]: process.html#process_process_title +[`process.abort()`]: process.md#process_process_abort +[`process.chdir()`]: process.md#process_process_chdir_directory +[`process.env`]: process.md#process_process_env +[`process.execArgv`]: process.md#process_process_execargv +[`process.exit()`]: process.md#process_process_exit_code +[`process.stderr`]: process.md#process_process_stderr +[`process.stdin`]: process.md#process_process_stdin +[`process.stdout`]: process.md#process_process_stdout +[`process.title`]: process.md#process_process_title [`require('worker_threads').isMainThread`]: #worker_threads_worker_ismainthread [`require('worker_threads').parentPort.on('message')`]: #worker_threads_event_message [`require('worker_threads').parentPort`]: #worker_threads_worker_parentport [`require('worker_threads').parentPort.postMessage()`]: #worker_threads_worker_postmessage_value_transferlist [`require('worker_threads').threadId`]: #worker_threads_worker_threadid [`require('worker_threads').workerData`]: #worker_threads_worker_workerdata -[`trace_events`]: tracing.html -[`v8.getHeapSnapshot()`]: v8.html#v8_v8_getheapsnapshot -[`vm`]: vm.html +[`trace_events`]: tracing.md +[`v8.getHeapSnapshot()`]: v8.md#v8_v8_getheapsnapshot +[`vm`]: vm.md [`Worker constructor options`]: #worker_threads_new_worker_filename_options [`worker.on('message')`]: #worker_threads_event_message_1 [`worker.postMessage()`]: #worker_threads_worker_postmessage_value_transferlist [`worker.SHARE_ENV`]: #worker_threads_worker_share_env [`worker.terminate()`]: #worker_threads_worker_terminate [`worker.threadId`]: #worker_threads_worker_threadid_1 -[Addons worker support]: addons.html#addons_worker_support -[async-resource-worker-pool]: async_hooks.html#async-resource-worker-pool +[Addons worker support]: addons.md#addons_worker_support +[async-resource-worker-pool]: async_hooks.md#async-resource-worker-pool [HTML structured clone algorithm]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm -[Signals events]: process.html#process_signal_events +[Signals events]: process.md#process_signal_events [Web Workers]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API [browser `MessagePort`]: https://developer.mozilla.org/en-US/docs/Web/API/MessagePort -[child processes]: child_process.html -[contextified]: vm.html#vm_what_does_it_mean_to_contextify_an_object -[v8.serdes]: v8.html#v8_serialization_api +[child processes]: child_process.md +[contextified]: vm.md#vm_what_does_it_mean_to_contextify_an_object +[v8.serdes]: v8.md#v8_serialization_api [`data:` URL]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs diff --git a/doc/api/zlib.md b/doc/api/zlib.md index 34adda9788d..5b182530d56 100644 --- a/doc/api/zlib.md +++ b/doc/api/zlib.md @@ -1172,8 +1172,8 @@ Decompress a chunk of data with [`Unzip`][]. [`ArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer [`BrotliCompress`]: #zlib_class_zlib_brotlicompress [`BrotliDecompress`]: #zlib_class_zlib_brotlidecompress -[`Buffer`]: buffer.html#buffer_class_buffer -[`buffer.kMaxLength`]: buffer.html#buffer_buffer_kmaxlength +[`Buffer`]: buffer.md#buffer_class_buffer +[`buffer.kMaxLength`]: buffer.md#buffer_buffer_kmaxlength [`Content-Encoding`]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11 [`DataView`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView [`DeflateRaw`]: #zlib_class_zlib_deflateraw @@ -1185,7 +1185,7 @@ Decompress a chunk of data with [`Unzip`][]. [`TypedArray`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray [`Unzip`]: #zlib_class_zlib_unzip [`deflateInit2` and `inflateInit2`]: https://zlib.net/manual.html#Advanced -[`stream.Transform`]: stream.html#stream_class_stream_transform +[`stream.Transform`]: stream.md#stream_class_stream_transform [`zlib.bytesWritten`]: #zlib_zlib_byteswritten [Brotli parameters]: #zlib_brotli_constants [Memory usage tuning]: #zlib_memory_usage_tuning diff --git a/test/doctool/test-local-md-file-reference-regex.js b/test/doctool/test-local-md-file-reference-regex.js new file mode 100644 index 00000000000..f0fa922d89c --- /dev/null +++ b/test/doctool/test-local-md-file-reference-regex.js @@ -0,0 +1,47 @@ +'use strict'; + +require('../common'); +const assert = require('assert'); + +const { referenceToLocalMdFile } = require('../../tools/doc/markdown.js'); + +{ + const shouldBeSpotted = [ + 'test.md', + 'TEST.MD', + 'test.js.md', + '.test.md', + './test.md', + 'subfolder/test.md', + '../test.md', + 'test.md#anchor', + 'subfolder/test.md#anchor', + '/test.md', + ]; + + shouldBeSpotted.forEach((url) => { + assert.match(url, referenceToLocalMdFile); + }); +} + +{ + const shouldNotBeSpotted = [ + 'https://example.com/test.md', + 'HTTPS://EXAMPLE.COM/TEST.MD', + 'git+https://example.com/test.md', + 'ftp://1.1.1.1/test.md', + 'urn:isbn:9780307476463.md', + 'file://./test.md', + '/dev/null', + 'test.html', + 'test.html#anchor.md', + 'test.html?anchor.md', + 'test.md5', + 'testmd', + '.md', + ]; + + shouldNotBeSpotted.forEach((url) => { + assert.doesNotMatch(url, referenceToLocalMdFile); + }); +} diff --git a/tools/doc/html.js b/tools/doc/html.js index 2e60d078644..b74b8ac1546 100644 --- a/tools/doc/html.js +++ b/tools/doc/html.js @@ -51,7 +51,9 @@ function navClasses() { } const gtocPath = path.join(docPath, 'api', 'index.md'); -const gtocMD = fs.readFileSync(gtocPath, 'utf8').replace(/^<!--.*?-->/gms, ''); +const gtocMD = fs.readFileSync(gtocPath, 'utf8') + .replace(/\(([^#?]+?)\.md\)/ig, (_, filename) => `(${filename}.html)`) + .replace(/^<!--.*?-->/gms, ''); const gtocHTML = unified() .use(markdown) .use(remark2rehype, { allowDangerousHtml: true }) diff --git a/tools/doc/markdown.js b/tools/doc/markdown.js index 97feadbf999..a3b2f0a94ec 100644 --- a/tools/doc/markdown.js +++ b/tools/doc/markdown.js @@ -2,14 +2,25 @@ const visit = require('unist-util-visit'); +const referenceToLocalMdFile = /^(?![+a-z]+:)([^#?]+)\.md(#.+)?$/i; + module.exports = { - replaceLinks + replaceLinks, + referenceToLocalMdFile, }; function replaceLinks({ filename, linksMapper }) { return (tree) => { const fileHtmlUrls = linksMapper[filename]; + visit(tree, (node) => { + if (node.url) { + node.url = node.url.replace( + referenceToLocalMdFile, + (_, filename, hash) => `${filename}.html${hash || ''}` + ); + } + }); visit(tree, 'definition', (node) => { const htmlUrl = fileHtmlUrls && fileHtmlUrls[node.identifier]; |