From 09369a05a44b9c185031ea443e44c756cb998fac Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Sat, 29 Aug 2020 23:40:04 -0700
Subject: [PATCH] doc,tools: remove malfunctioning Linux manpage linker
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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: https://github.com/nodejs/node/pull/34985
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Mary Marchini <oss@mmarchini.me>
---
 doc/api/os.md     | 12 ++++++------
 tools/doc/html.js |  5 -----
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/doc/api/os.md b/doc/api/os.md
index 83681cdedfad04..9dfe629a97d2f8 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -291,7 +291,7 @@ added: v0.3.3
 Returns the operating system as a string.
 
 On POSIX systems, the operating system release is determined by calling
-[uname(3)][]. On Windows, `GetVersionExW()` is used. See
+[`uname(3)`][]. On Windows, `GetVersionExW()` is used. See
 <https://en.wikipedia.org/wiki/Uname#Examples> for more information.
 
 ## `os.setPriority([pid, ]priority)`
@@ -348,11 +348,11 @@ added: v0.3.3
 
 * Returns: {string}
 
-Returns the operating system name as returned by [uname(3)][]. For example, it
+Returns the operating system name as returned by [`uname(3)`][]. For example, it
 returns `'Linux'` on Linux, `'Darwin'` on macOS, and `'Windows_NT'` on Windows.
 
 See <https://en.wikipedia.org/wiki/Uname#Examples> for additional information
-about the output of running [uname(3)][] on various operating systems.
+about the output of running [`uname(3)`][] on various operating systems.
 
 ## `os.uptime()`
 <!-- YAML
@@ -401,8 +401,8 @@ added: v13.11.0
 Returns a string identifying the kernel version.
 
 On POSIX systems, the operating system release is determined by calling
-[uname(3)][]. On Windows, `RtlGetVersion()` is used, and if it is not available,
-`GetVersionExW()` will be used. See
+[`uname(3)`][]. On Windows, `RtlGetVersion()` is used, and if it is not
+available, `GetVersionExW()` will be used. See
 <https://en.wikipedia.org/wiki/Uname#Examples> for more information.
 
 ## OS constants
@@ -1270,6 +1270,6 @@ The following process scheduling constants are exported by
 [`SystemError`]: errors.html#errors_class_systemerror
 [`process.arch`]: process.html#process_process_arch
 [`process.platform`]: process.html#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
-[uname(3)]: https://linux.die.net/man/3/uname
diff --git a/tools/doc/html.js b/tools/doc/html.js
index 8428fb9f3cf66f..53d20a57cc3b7e 100644
--- a/tools/doc/html.js
+++ b/tools/doc/html.js
@@ -124,7 +124,6 @@ function preprocessText({ nodeVersion }) {
 
 // Syscalls which appear in the docs, but which only exist in BSD / macOS.
 const BSD_ONLY_SYSCALLS = new Set(['lchmod']);
-const LINUX_DIE_ONLY_SYSCALLS = new Set(['uname']);
 const HAXX_ONLY_SYSCALLS = new Set(['curl']);
 const MAN_PAGE = /(^|\s)([a-z.]+)\((\d)([a-z]?)\)/gm;
 
@@ -142,10 +141,6 @@ function linkManPages(text) {
         return `${beginning}<a href="https://www.freebsd.org/cgi/man.cgi` +
           `?query=${name}&sektion=${number}">${displayAs}</a>`;
       }
-      if (LINUX_DIE_ONLY_SYSCALLS.has(name)) {
-        return `${beginning}<a href="https://linux.die.net/man/` +
-                `${number}/${name}">${displayAs}</a>`;
-      }
       if (HAXX_ONLY_SYSCALLS.has(name)) {
         return `${beginning}<a href="https://${name}.haxx.se/docs/manpage.html">${displayAs}</a>`;
       }