Commit 52be37c
doc,tools: remove malfunctioning Linux manpage linker
The Linux manpage auto-linking is resulting in extraneous
links with empty text in the docs. Remove it as the only thing it
affects is linked explicitly in the one document that uses it.
PR-URL: #34985
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Mary Marchini <oss@mmarchini.me>1 parent 2ab33c5 commit 52be37c
2 files changed
Lines changed: 6 additions & 11 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -291,7 +291,7 @@ added: v0.3.3 | |||
| 291 | 291 | Returns the operating system as a string. | |
| 292 | 292 | ||
| 293 | 293 | On POSIX systems, the operating system release is determined by calling | |
| 294 | - [uname(3)][]. On Windows, `GetVersionExW()` is used. See | ||
| 294 | + [`uname(3)`][]. On Windows, `GetVersionExW()` is used. See | ||
| 295 | 295 | <https://en.wikipedia.org/wiki/Uname#Examples> for more information. | |
| 296 | 296 | ||
| 297 | 297 | ## `os.setPriority([pid, ]priority)` | |
@@ -348,11 +348,11 @@ added: v0.3.3 | |||
| 348 | 348 | ||
| 349 | 349 | * Returns: {string} | |
| 350 | 350 | ||
| 351 | - Returns the operating system name as returned by [uname(3)][]. For example, it | ||
| 351 | + Returns the operating system name as returned by [`uname(3)`][]. For example, it | ||
| 352 | 352 | returns `'Linux'` on Linux, `'Darwin'` on macOS, and `'Windows_NT'` on Windows. | |
| 353 | 353 | ||
| 354 | 354 | See <https://en.wikipedia.org/wiki/Uname#Examples> for additional information | |
| 355 | - about the output of running [uname(3)][] on various operating systems. | ||
| 355 | + about the output of running [`uname(3)`][] on various operating systems. | ||
| 356 | 356 | ||
| 357 | 357 | ## `os.uptime()` | |
| 358 | 358 | <!-- YAML | |
@@ -401,8 +401,8 @@ added: v13.11.0 | |||
| 401 | 401 | Returns a string identifying the kernel version. | |
| 402 | 402 | ||
| 403 | 403 | On POSIX systems, the operating system release is determined by calling | |
| 404 | - [uname(3)][]. On Windows, `RtlGetVersion()` is used, and if it is not available, | ||
| 405 | - `GetVersionExW()` will be used. See | ||
| 404 | + [`uname(3)`][]. On Windows, `RtlGetVersion()` is used, and if it is not | ||
| 405 | + available, `GetVersionExW()` will be used. See | ||
| 406 | 406 | <https://en.wikipedia.org/wiki/Uname#Examples> for more information. | |
| 407 | 407 | ||
| 408 | 408 | ## OS constants | |
@@ -1270,6 +1270,6 @@ The following process scheduling constants are exported by | |||
| 1270 | 1270 | [`SystemError`]: errors.html#errors_class_systemerror | |
| 1271 | 1271 | [`process.arch`]: process.html#process_process_arch | |
| 1272 | 1272 | [`process.platform`]: process.html#process_process_platform | |
| 1273 | + [`uname(3)`]: https://linux.die.net/man/3/uname | ||
| 1273 | 1274 | [Android building]: https://github.com/nodejs/node/blob/master/BUILDING.md#androidandroid-based-devices-eg-firefox-os | |
| 1274 | 1275 | [EUID]: https://en.wikipedia.org/wiki/User_identifier#Effective_user_ID | |
| 1275 | - [uname(3)]: https://linux.die.net/man/3/uname | ||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -124,7 +124,6 @@ function preprocessText({ nodeVersion }) { | |||
| 124 | 124 | ||
| 125 | 125 | // Syscalls which appear in the docs, but which only exist in BSD / macOS. | |
| 126 | 126 | const BSD_ONLY_SYSCALLS = new Set(['lchmod']); | |
| 127 | - const LINUX_DIE_ONLY_SYSCALLS = new Set(['uname']); | ||
| 128 | 127 | const HAXX_ONLY_SYSCALLS = new Set(['curl']); | |
| 129 | 128 | const MAN_PAGE = /(^|\s)([a-z.]+)\((\d)([a-z]?)\)/gm; | |
| 130 | 129 | ||
@@ -142,10 +141,6 @@ function linkManPages(text) { | |||
| 142 | 141 | return `${beginning}<a href="https://www.freebsd.org/cgi/man.cgi` + | |
| 143 | 142 | `?query=${name}&sektion=${number}">${displayAs}</a>`; | |
| 144 | 143 | } | |
| 145 | - if (LINUX_DIE_ONLY_SYSCALLS.has(name)) { | ||
| 146 | - return `${beginning}<a href="https://linux.die.net/man/` + | ||
| 147 | - `${number}/${name}">${displayAs}</a>`; | ||
| 148 | - } | ||
| 149 | 144 | if (HAXX_ONLY_SYSCALLS.has(name)) { | |
| 150 | 145 | return `${beginning}<a href="https://${name}.haxx.se/docs/manpage.html">${displayAs}</a>`; | |
| 151 | 146 | } | |
0 commit comments