Skip to content

Commit ffe1f80

Browse files
sam-githubrvagg
authored andcommitted
doc: sort bottom-of-file markdown links
Backport of #24679 PR-URL: #24682 Reviewed-By: Vse Mozhet Byt <[email protected]>
1 parent a8402fe commit ffe1f80

23 files changed

+69
-71
lines changed

doc/api/assert.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -863,16 +863,16 @@ For more information, see
863863
[`assert.notDeepStrictEqual()`]: #assert_assert_notdeepstrictequal_actual_expected_message
864864
[`assert.notStrictEqual()`]: #assert_assert_notstrictequal_actual_expected_message
865865
[`assert.ok()`]: #assert_assert_ok_value_message
866+
[`assert.rejects()`]: #assert_assert_rejects_block_error_message
866867
[`assert.strictEqual()`]: #assert_assert_strictequal_actual_expected_message
867868
[`assert.throws()`]: #assert_assert_throws_block_error_message
868-
[`assert.rejects()`]: #assert_assert_rejects_block_error_message
869869
[`strict mode`]: #assert_strict_mode
870870
[Abstract Equality Comparison]: https://tc39.github.io/ecma262/#sec-abstract-equality-comparison
871+
[Object wrappers]: https://developer.mozilla.org/en-US/docs/Glossary/Primitive#Primitive_wrapper_objects_in_JavaScript
871872
[Object.prototype.toString()]: https://tc39.github.io/ecma262/#sec-object.prototype.tostring
872873
[SameValueZero]: https://tc39.github.io/ecma262/#sec-samevaluezero
873874
[Strict Equality Comparison]: https://tc39.github.io/ecma262/#sec-strict-equality-comparison
874875
[caveats]: #assert_caveats
875876
[enumerable "own" properties]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Enumerability_and_ownership_of_properties
876877
[mdn-equality-guide]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Equality_comparisons_and_sameness
877878
[prototype-spec]: https://tc39.github.io/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots
878-
[Object wrappers]: https://developer.mozilla.org/en-US/docs/Glossary/Primitive#Primitive_wrapper_objects_in_JavaScript

doc/api/buffer.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2742,9 +2742,9 @@ This value may depend on the JS engine that is being used.
27422742
[`buf.length`]: #buffer_buf_length
27432743
[`buf.slice()`]: #buffer_buf_slice_start_end
27442744
[`buf.values()`]: #buffer_buf_values
2745-
[`buffer.kMaxLength`]: #buffer_buffer_kmaxlength
27462745
[`buffer.constants.MAX_LENGTH`]: #buffer_buffer_constants_max_length
27472746
[`buffer.constants.MAX_STRING_LENGTH`]: #buffer_buffer_constants_max_string_length
2747+
[`buffer.kMaxLength`]: #buffer_buffer_kmaxlength
27482748
[`util.inspect()`]: util.html#util_util_inspect_object_options
27492749
[RFC1345]: https://tools.ietf.org/html/rfc1345
27502750
[RFC4648, Section 5]: https://tools.ietf.org/html/rfc4648#section-5

doc/api/child_process.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -1378,13 +1378,6 @@ unavailable.
13781378
[`ChildProcess`]: #child_process_child_process
13791379
[`Error`]: errors.html#errors_class_error
13801380
[`EventEmitter`]: events.html#events_class_eventemitter
1381-
[`subprocess.connected`]: #child_process_subprocess_connected
1382-
[`subprocess.disconnect()`]: #child_process_subprocess_disconnect
1383-
[`subprocess.kill()`]: #child_process_subprocess_kill_signal
1384-
[`subprocess.send()`]: #child_process_subprocess_send_message_sendhandle_options_callback
1385-
[`subprocess.stderr`]: #child_process_subprocess_stderr
1386-
[`subprocess.stdin`]: #child_process_subprocess_stdin
1387-
[`subprocess.stdout`]: #child_process_subprocess_stdout
13881381
[`child_process.exec()`]: #child_process_child_process_exec_command_options_callback
13891382
[`child_process.execFile()`]: #child_process_child_process_execfile_file_args_options_callback
13901383
[`child_process.execFileSync()`]: #child_process_child_process_execfilesync_file_args_options
@@ -1403,6 +1396,13 @@ unavailable.
14031396
[`process.on('message')`]: process.html#process_event_message
14041397
[`process.send()`]: process.html#process_process_send_message_sendhandle_options_callback
14051398
[`stdio`]: #child_process_options_stdio
1399+
[`subprocess.connected`]: #child_process_subprocess_connected
1400+
[`subprocess.disconnect()`]: #child_process_subprocess_disconnect
1401+
[`subprocess.kill()`]: #child_process_subprocess_kill_signal
1402+
[`subprocess.send()`]: #child_process_subprocess_send_message_sendhandle_options_callback
1403+
[`subprocess.stderr`]: #child_process_subprocess_stderr
1404+
[`subprocess.stdin`]: #child_process_subprocess_stdin
1405+
[`subprocess.stdout`]: #child_process_subprocess_stdout
14061406
[`util.promisify()`]: util.html#util_util_promisify_original
14071407
[Default Windows Shell]: #child_process_default_windows_shell
14081408
[Shell Requirements]: #child_process_shell_requirements

doc/api/cluster.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -873,6 +873,7 @@ socket.on('data', (id) => {
873873

874874
[`ChildProcess.send()`]: child_process.html#child_process_subprocess_send_message_sendhandle_options_callback
875875
[`child_process.fork()`]: child_process.html#child_process_child_process_fork_modulepath_args_options
876+
[`cluster.settings`]: #cluster_cluster_settings
876877
[`disconnect`]: child_process.html#child_process_subprocess_disconnect
877878
[`kill`]: process.html#process_process_kill_pid_signal
878879
[`process` event: `'message'`]: process.html#process_event_message
@@ -881,4 +882,3 @@ socket.on('data', (id) => {
881882
[Child Process module]: child_process.html#child_process_child_process_fork_modulepath_args_options
882883
[child_process event: 'exit']: child_process.html#child_process_event_exit
883884
[child_process event: 'message']: child_process.html#child_process_event_message
884-
[`cluster.settings`]: #cluster_cluster_settings

doc/api/crypto.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2324,8 +2324,8 @@ the `crypto`, `tls`, and `https` modules and are generally specific to OpenSSL.
23242324
[`hmac.update()`]: #crypto_hmac_update_data_inputencoding
23252325
[`sign.sign()`]: #crypto_sign_sign_privatekey_outputformat
23262326
[`sign.update()`]: #crypto_sign_update_data_inputencoding
2327-
[`stream.transform` options]: stream.html#stream_new_stream_transform_options
23282327
[`stream.Writable` options]: stream.html#stream_constructor_new_stream_writable_options
2328+
[`stream.transform` options]: stream.html#stream_new_stream_transform_options
23292329
[`tls.createSecureContext()`]: tls.html#tls_tls_createsecurecontext_options
23302330
[`verify.update()`]: #crypto_verify_update_data_inputencoding
23312331
[`verify.verify()`]: #crypto_verify_verify_object_signature_signatureformat

doc/api/dgram.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -639,6 +639,7 @@ and `udp6` sockets). The bound address and port can be retrieved using
639639
[`'close'`]: #dgram_event_close
640640
[`Error`]: errors.html#errors_class_error
641641
[`EventEmitter`]: events.html
642+
[`System Error`]: errors.html#errors_class_systemerror
642643
[`close()`]: #dgram_socket_close_callback
643644
[`cluster`]: cluster.html
644645
[`dgram.Socket#bind()`]: #dgram_socket_bind_options_callback
@@ -647,7 +648,6 @@ and `udp6` sockets). The bound address and port can be retrieved using
647648
[`socket.address().address`]: #dgram_socket_address
648649
[`socket.address().port`]: #dgram_socket_address
649650
[`socket.bind()`]: #dgram_socket_bind_port_address_callback
650-
[`System Error`]: errors.html#errors_class_systemerror
651-
[byte length]: buffer.html#buffer_class_method_buffer_bytelength_string_encoding
652651
[IPv6 Zone Indices]: https://en.wikipedia.org/wiki/IPv6_address#Scoped_literal_IPv6_addresses
653652
[RFC 4007]: https://tools.ietf.org/html/rfc4007
653+
[byte length]: buffer.html#buffer_class_method_buffer_bytelength_string_encoding

doc/api/documentation.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -93,9 +93,9 @@ relative to Linux and macOS. For an example of the subtle ways in which it's
9393
sometimes impossible to replace Unix syscall semantics on Windows, see [Node.js
9494
issue 4760](https://github.com/nodejs/node/issues/4760).
9595

96+
[`fs.lchown()`]: fs.html#fs_fs_lchown_path_uid_gid_callback
97+
[`fs.open()`]: fs.html#fs_fs_open_path_flags_mode_callback
98+
[`process.on('warning')`]: process.html#process_event_warning
99+
[`stderr`]: process.html#process_process_stderr
96100
[submit an issue]: https://github.com/nodejs/node/issues/new
97101
[the contributing guide]: https://github.com/nodejs/node/blob/master/CONTRIBUTING.md
98-
[`stderr`]: process.html#process_process_stderr
99-
[`process.on('warning')`]: process.html#process_event_warning
100-
[`fs.open()`]: fs.html#fs_fs_open_path_flags_mode_callback
101-
[`fs.lchown()`]: fs.html#fs_fs_lchown_path_uid_gid_callback

doc/api/errors.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1240,8 +1240,6 @@ entry types were found.
12401240
A given value is out of the accepted range.
12411241

12421242
[`ERR_INVALID_ARG_TYPE`]: #ERR_INVALID_ARG_TYPE
1243-
[`subprocess.kill()`]: child_process.html#child_process_subprocess_kill_signal
1244-
[`subprocess.send()`]: child_process.html#child_process_subprocess_send_message_sendhandle_options_callback
12451243
[`fs.readFileSync`]: fs.html#fs_fs_readfilesync_path_options
12461244
[`fs.readdir`]: fs.html#fs_fs_readdir_path_options_callback
12471245
[`fs.unlink`]: fs.html#fs_fs_unlink_path_callback
@@ -1254,9 +1252,12 @@ A given value is out of the accepted range.
12541252
[`new URLSearchParams(iterable)`]: url.html#url_constructor_new_urlsearchparams_iterable
12551253
[`process.on('uncaughtException')`]: process.html#process_event_uncaughtexception
12561254
[`process.send()`]: process.html#process_process_send_message_sendhandle_options_callback
1255+
[`subprocess.kill()`]: child_process.html#child_process_subprocess_kill_signal
1256+
[`subprocess.send()`]: child_process.html#child_process_subprocess_send_message_sendhandle_options_callback
12571257
[ICU]: intl.html#intl_internationalization_support
12581258
[Node.js Error Codes]: #nodejs-error-codes
12591259
[V8's stack trace API]: https://github.com/v8/v8/wiki/Stack-Trace-API
1260+
[WHATWG Supported Encodings]: util.md#whatwg-supported-encodings
12601261
[WHATWG URL API]: url.html#url_the_whatwg_url_api
12611262
[domains]: domain.html
12621263
[event emitter-based]: events.html#events_class_eventemitter
@@ -1266,4 +1267,3 @@ A given value is out of the accepted range.
12661267
[syscall]: http://man7.org/linux/man-pages/man2/syscall.2.html
12671268
[try-catch]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch
12681269
[vm]: vm.html
1269-
[WHATWG Supported Encodings]: util.md#whatwg-supported-encodings

doc/api/fs.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -3218,8 +3218,8 @@ The following constants are meant for use with the [`fs.Stats`][] object's
32183218
[MDN-Date]: https://developer.mozilla.org/en-US/JavaScript/Reference/Global_Objects/Date
32193219
[MDN-Number]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type
32203220
[MSDN-Rel-Path]: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247.aspx#fully_qualified_vs._relative_paths
3221+
[MSDN-Using-Streams]: https://msdn.microsoft.com/en-us/library/windows/desktop/bb540537.aspx
3222+
[Naming Files, Paths, and Namespaces]: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx
32213223
[Readable Stream]: stream.html#stream_class_stream_readable
32223224
[Writable Stream]: stream.html#stream_class_stream_writable
32233225
[inode]: https://en.wikipedia.org/wiki/Inode
3224-
[Naming Files, Paths, and Namespaces]: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx
3225-
[MSDN-Using-Streams]: https://msdn.microsoft.com/en-us/library/windows/desktop/bb540537.aspx

doc/api/http.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2019,8 +2019,8 @@ not abort the request or do anything besides add a `timeout` event.
20192019
[`removeHeader(name)`]: #http_request_removeheader_name
20202020
[`request.end()`]: #http_request_end_data_encoding_callback
20212021
[`request.setTimeout()`]: #http_request_settimeout_timeout_callback
2022-
[`request.socket`]: #http_request_socket
20232022
[`request.socket.getPeerCertificate()`]: tls.html#tls_tlssocket_getpeercertificate_detailed
2023+
[`request.socket`]: #http_request_socket
20242024
[`request.write(data, encoding)`]: #http_request_write_chunk_encoding_callback
20252025
[`response.end()`]: #http_response_end_data_encoding_callback
20262026
[`response.setHeader()`]: #http_response_setheader_name_value

doc/api/http2.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -3367,20 +3367,20 @@ following additional properties:
33673367
`Http2Session`.
33683368

33693369

3370-
[ALPN negotiation]: #http2_alpn_negotiation
33713370
[ALPN Protocol ID]: https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
3371+
[ALPN negotiation]: #http2_alpn_negotiation
33723372
[Compatibility API]: #http2_compatibility_api
33733373
[HTTP/1]: http.html
3374-
[HTTP/2]: https://tools.ietf.org/html/rfc7540
3375-
[HTTP/2 Unencrypted]: https://http2.github.io/faq/#does-http2-require-encryption
33763374
[HTTP/2 Headers Object]: #http2_headers_object
33773375
[HTTP/2 Settings Object]: #http2_settings_object
3376+
[HTTP/2 Unencrypted]: https://http2.github.io/faq/#does-http2-require-encryption
3377+
[HTTP/2]: https://tools.ietf.org/html/rfc7540
33783378
[HTTPS]: https.html
33793379
[Http2Session and Sockets]: #http2_http2session_and_sockets
33803380
[Performance Observer]: perf_hooks.html
3381-
[Readable Stream]: stream.html#stream_class_stream_readable
33823381
[RFC 7838]: https://tools.ietf.org/html/rfc7838
33833382
[RFC 8336]: https://tools.ietf.org/html/rfc8336
3383+
[Readable Stream]: stream.html#stream_class_stream_readable
33843384
[Using options.selectPadding]: #http2_using_options_selectpadding
33853385
[Writable Stream]: stream.html#stream_writable_streams
33863386
[`'checkContinue'`]: #http2_event_checkcontinue
@@ -3394,15 +3394,15 @@ following additional properties:
33943394
[`ServerHttp2Stream`]: #http2_class_serverhttp2stream
33953395
[`TypeError`]: errors.html#errors_class_typeerror
33963396
[`http2.SecureServer`]: #http2_class_http2secureserver
3397-
[`http2.createSecureServer()`]: #http2_http2_createsecureserver_options_onrequesthandler
33983397
[`http2.Server`]: #http2_class_http2server
3398+
[`http2.createSecureServer()`]: #http2_http2_createsecureserver_options_onrequesthandler
33993399
[`http2.createServer()`]: #http2_http2_createserver_options_onrequesthandler
34003400
[`http2session.close()`]: #http2_http2session_close_callback
34013401
[`http2stream.pushStream()`]: #http2_http2stream_pushstream_headers_options_callback
34023402
[`net.Server.close()`]: net.html#net_server_close_callback
3403-
[`net.Socket`]: net.html#net_class_net_socket
34043403
[`net.Socket.prototype.ref`]: net.html#net_socket_ref
34053404
[`net.Socket.prototype.unref`]: net.html#net_socket_unref
3405+
[`net.Socket`]: net.html#net_class_net_socket
34063406
[`net.connect()`]: net.html#net_net_connect
34073407
[`request.socket.getPeerCertificate()`]: tls.html#tls_tlssocket_getpeercertificate_detailed
34083408
[`response.end()`]: #http2_response_end_data_encoding_callback

doc/api/https.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -263,8 +263,8 @@ const req = https.request(options, (res) => {
263263
[`http.Server#setTimeout()`]: http.html#http_server_settimeout_msecs_callback
264264
[`http.Server#timeout`]: http.html#http_server_timeout
265265
[`http.Server`]: http.html#http_class_http_server
266-
[`http.createServer()`]: http.html#httpcreateserveroptions-requestlistener
267266
[`http.close()`]: http.html#http_server_close_callback
267+
[`http.createServer()`]: http.html#httpcreateserveroptions-requestlistener
268268
[`http.get()`]: http.html#http_http_get_options_callback
269269
[`http.request()`]: http.html#http_http_request_options_callback
270270
[`https.Agent`]: #https_class_https_agent

doc/api/inspector.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -162,8 +162,8 @@ session.post('Profiler.enable', () => {
162162
```
163163

164164

165-
[`session.connect()`]: #inspector_session_connect
166165
[`Debugger.paused`]: https://chromedevtools.github.io/devtools-protocol/v8/Debugger/#event-paused
167166
[`EventEmitter`]: events.html#events_class_eventemitter
168-
[Chrome DevTools Protocol Viewer]: https://chromedevtools.github.io/devtools-protocol/v8/
167+
[`session.connect()`]: #inspector_session_connect
169168
[CPU Profiler]: https://chromedevtools.github.io/devtools-protocol/v8/Profiler
169+
[Chrome DevTools Protocol Viewer]: https://chromedevtools.github.io/devtools-protocol/v8/

doc/api/intl.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -193,18 +193,18 @@ to be helpful:
193193
["ICU Data"]: http://userguide.icu-project.org/icudata
194194
[`--icu-data-dir`]: cli.html#cli_icu_data_dir_file
195195
[`Date.prototype.toLocaleString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString
196-
[`Intl`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl
197196
[`Intl.DateTimeFormat`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat
197+
[`Intl`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl
198198
[`NODE_ICU_DATA`]: cli.html#cli_node_icu_data_file
199199
[`Number.prototype.toLocaleString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString
200-
[`require('buffer').transcode()`]: buffer.html#buffer_buffer_transcode_source_fromenc_toenc
201-
[`require('util').TextDecoder`]: util.html#util_class_util_textdecoder
202200
[`String.prototype.localeCompare()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare
203201
[`String.prototype.normalize()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize
204202
[`String.prototype.toLowerCase()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase
205203
[`String.prototype.toUpperCase()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase
206-
[BUILDING.md]: https://github.com/nodejs/node/blob/master/BUILDING.md
204+
[`require('buffer').transcode()`]: buffer.html#buffer_buffer_transcode_source_fromenc_toenc
205+
[`require('util').TextDecoder`]: util.html#util_class_util_textdecoder
207206
[BUILDING.md#full-icu]: https://github.com/nodejs/node/blob/master/BUILDING.md#build-with-full-icu-support-all-locales-supported-by-icu
207+
[BUILDING.md]: https://github.com/nodejs/node/blob/master/BUILDING.md
208208
[ECMA-262]: https://tc39.github.io/ecma262/
209209
[ECMA-402]: https://tc39.github.io/ecma402/
210210
[ICU]: http://icu-project.org/

doc/api/modules.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -859,9 +859,9 @@ added: v8.10.0
859859
A list of the names of all modules provided by Node.js. Can be used to verify
860860
if a module is maintained by a third-party module or not.
861861

862+
[`Error`]: errors.html#errors_class_error
862863
[`__dirname`]: #modules_dirname
863864
[`__filename`]: #modules_filename
864-
[`Error`]: errors.html#errors_class_error
865865
[`module` object]: #modules_the_module_object
866866
[`path.dirname()`]: path.html#path_path_dirname_path
867867
[exports shortcut]: #modules_exports_shortcut

0 commit comments

Comments
 (0)