doc: remove em dashes

Our documentation uses em dashes inconsistently. They are treated inconsistently typographically too. (For example, they are sometimes surrounded by spaces and sometimes not.) They are also often confused with ordinary hyphens such as in the CHANGELOG, where they are inadvertently mixed together in a single list. The difference is not obvious in the raw markdown but is very noticeable when rendered, appearing to be a typographical error (which it in fact is). The em dash is never needed. There are always alternatives. Remove em dashes entirely. PR-URL: #32080 Reviewed-By: Richard Lau <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>

Author: Trott

CHANGELOG.md

@@ -2,19 +2,19 @@
 
 Select a Node.js version below to view the changelog history:
 
-*[Node.js 13](doc/changelogs/CHANGELOG_V13.md)- **Current**
-*[Node.js 12](doc/changelogs/CHANGELOG_V12.md)- **Long Term Support**
-*[Node.js 11](doc/changelogs/CHANGELOG_V11.md)- End-of-Life
-*[Node.js 10](doc/changelogs/CHANGELOG_V10.md)— Long Term Support
-*[Node.js 9](doc/changelogs/CHANGELOG_V9.md)— End-of-Life
-*[Node.js 8](doc/changelogs/CHANGELOG_V8.md)— Long Term Support
-*[Node.js 7](doc/changelogs/CHANGELOG_V7.md)— End-of-Life
-*[Node.js 6](doc/changelogs/CHANGELOG_V6.md)— End-of-Life
-*[Node.js 5](doc/changelogs/CHANGELOG_V5.md)— End-of-Life
-*[Node.js 4](doc/changelogs/CHANGELOG_V4.md)— End-of-Life
-*[io.js](doc/changelogs/CHANGELOG_IOJS.md)— End-of-Life
-*[Node.js 0.12](doc/changelogs/CHANGELOG_V012.md)— End-of-Life
-*[Node.js 0.10](doc/changelogs/CHANGELOG_V010.md)— End-of-Life
+*[Node.js 13](doc/changelogs/CHANGELOG_V13.md)**Current**
+*[Node.js 12](doc/changelogs/CHANGELOG_V12.md)**Long Term Support**
+*[Node.js 11](doc/changelogs/CHANGELOG_V11.md) End-of-Life
+*[Node.js 10](doc/changelogs/CHANGELOG_V10.md) Long Term Support
+*[Node.js 9](doc/changelogs/CHANGELOG_V9.md) End-of-Life
+*[Node.js 8](doc/changelogs/CHANGELOG_V8.md)End-of-Life
+*[Node.js 7](doc/changelogs/CHANGELOG_V7.md) End-of-Life
+*[Node.js 6](doc/changelogs/CHANGELOG_V6.md) End-of-Life
+*[Node.js 5](doc/changelogs/CHANGELOG_V5.md) End-of-Life
+*[Node.js 4](doc/changelogs/CHANGELOG_V4.md) End-of-Life
+*[io.js](doc/changelogs/CHANGELOG_IOJS.md) End-of-Life
+*[Node.js 0.12](doc/changelogs/CHANGELOG_V012.md) End-of-Life
+*[Node.js 0.10](doc/changelogs/CHANGELOG_V010.md) End-of-Life
 *[Archive](doc/changelogs/CHANGELOG_ARCHIVE.md)
 
 Please use the following table to find the changelog for a specific Node.js

doc/api/addons.md

@@ -313,7 +313,7 @@ require('./build/Release/addon');
 Once the source code has been written, it must be compiled into the binary
 `addon.node` file. To do so, create a file called `binding.gyp` in the
 top-level of the project describing the build configuration of the module
-using a JSON-like format. This file is used by [node-gyp][] — a tool written
+using a JSON-like format. This file is used by [node-gyp][], a tool written
 specifically to compile Node.js Addons.
 
 ```json

doc/api/errors.md

@@ -533,14 +533,14 @@ program. For a comprehensive list, see the [`errno`(3) man page][].
 `ulimit -n 2048` in the same shell that will run the Node.js process.
 
 *`ENOENT` (No such file or directory): Commonly raised by [`fs`][] operations
- to indicate that a component of the specified pathname does not exist — no
+ to indicate that a component of the specified pathname does not exist. No
  entity (file or directory) could be found by the given path.
 
 *`ENOTDIR` (Not a directory): A component of the given pathname existed, but
  was not a directory as expected. Commonly raised by [`fs.readdir`][].
 
 *`ENOTEMPTY` (Directory not empty): A directory with entries was the target
- of an operation that requires an empty directory — usually [`fs.unlink`][].
+ of an operation that requires an empty directory, usually [`fs.unlink`][].
 
 *`ENOTFOUND` (DNS lookup failed): Indicates a DNS failure of either
 `EAI_NODATA` or `EAI_NONAME`. This is not a standard POSIX error.
@@ -555,7 +555,7 @@ program. For a comprehensive list, see the [`errno`(3) man page][].
 
 *`ETIMEDOUT` (Operation timed out): A connect or send request failed because
  the connected party did not properly respond after a period of time. Usually
- encountered by [`http`][] or [`net`][] — often a sign that a `socket.end()`
+ encountered by [`http`][] or [`net`][]. Often a sign that a `socket.end()`
  was not properly called.
 
 ## Class: `TypeError`

doc/api/http.md

@@ -9,7 +9,7 @@ To use the HTTP server and client one must `require('http')`.
 The HTTP interfaces in Node.js are designed to support many features
 of the protocol which have been traditionally difficult to use.
 In particular, large, possibly chunk-encoded, messages. The interface is
-careful to never buffer entire requests or responses — the
+careful to never buffer entire requests or responses, so the
 user is able to stream data.
 
 HTTP message headers are represented by an object like this:
@@ -882,7 +882,7 @@ added: v0.1.29
 
 Sends a chunk of the body. By calling this method
 many times, a request body can be sent to a
-server — in that case it is suggested to use the
+server. In that case, it is suggested to use the
 `['Transfer-Encoding', 'chunked']` header line when
 creating the request.
 
@@ -1214,7 +1214,7 @@ added: v0.1.17
 
 * Extends:{Stream}
 
-This object is created internally by an HTTP server — not by the user. It is
+This object is created internally by an HTTP server, not by the user. It is
 passed as the second parameter to the [`'request'`][] event.
 
 ### Event: `'close'`

doc/api/http2.md

@@ -3008,7 +3008,7 @@ added: v8.4.0
 
 * Extends:{Stream}
 
-This object is created internally by an HTTP server — not by the user. It is
+This object is created internally by an HTTP server, not by the user. It is
 passed as the second parameter to the [`'request'`][] event.
 
 #### Event: `'close'`

doc/api/modules.md

@@ -945,7 +945,7 @@ added: v0.3.7
 *{Object}
 
 Provides general utility methods when interacting with instances of
-`Module` — the `module` variable often seen in file modules. Accessed
+`Module`, the `module` variable often seen in file modules. Accessed
 via `require('module')`.
 
 ### `module.builtinModules`

doc/api/net.md

@@ -939,7 +939,7 @@ added: v0.1.90
 * Returns:{boolean}
 
 Sends data on the socket. The second parameter specifies the encoding in the
-case of a string — it defaults to UTF8 encoding.
+case of a string. It defaults to UTF8 encoding.
 
 Returns `true` if the entire data was flushed successfully to the kernel
 buffer. Returns `false` if all or part of the data was queued in user memory.

doc/api/path.md

@@ -389,7 +389,7 @@ path.parse('/home/user/dir/file.txt');
 │ root │ │ name │ ext │
 " / home/user/dir / file .txt "
 └──────┴──────────────┴──────┴─────┘
-(all spaces in the "" line should be ignored — they are purely for formatting)
+(All spaces in the "" line should be ignored. They are purely for formatting.)
 ```
 
 On Windows:
@@ -411,7 +411,7 @@ path.parse('C:\\path\\dir\\file.txt');
 │ root │ │ name │ ext │
 " C:\ path\dir \ file .txt "
 └──────┴──────────────┴──────┴─────┘
-(all spaces in the "" line should be ignored — they are purely for formatting)
+(All spaces in the "" line should be ignored. They are purely for formatting.)
 ```
 
 A [`TypeError`][] is thrown if `path` is not a string.

doc/api/process.md

@@ -190,7 +190,7 @@ rejection handler.
 
 There is no notion of a top level for a `Promise` chain at which rejections can
 always be handled. Being inherently asynchronous in nature, a `Promise`
-rejection can be handled at a future point in time — possibly much later than
+rejection can be handled at a future point in time, possibly much later than
 the event loop turn it takes for the `'unhandledRejection'` event to be emitted.
 
 Another way of stating this is that, unlike in synchronous code where there is

doc/api/url.md

@@ -47,7 +47,7 @@ WHATWG URL's `origin` property includes `protocol` and `host`, but not
 ├─────────────┴─────────────────────┴────────────────────────┴──────────┴────────────────┴───────┤
 │ href │
 └────────────────────────────────────────────────────────────────────────────────────────────────┘
-(all spaces in the "" line should be ignored — they are purely for formatting)
+(All spaces in the "" line should be ignored. They are purely for formatting.)
 ```
 
 Parsing the URL string using the WHATWG API: