doc: prepare js code for eslint-plugin-markdown

This is an initial step to eliminate most of parsing errors.

PR-URL: https://github.com/nodejs/node/pull/12563
Refs: https://github.com/nodejs/node/pull/12557#issuecomment-296015032
Reviewed-By: Teddy Katz <teddy.katz@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Timothy Gu <timothygu99@gmail.com>
Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com>
Reviewed-By: Yuta Hiroto <hello@about-hiroppy.com>
This commit is contained in:
Vse Mozhet Byt 2017-04-21 07:53:00 +03:00
parent 26047c39c8
commit b6d293d215
9 changed files with 44 additions and 36 deletions

View File

@ -101,7 +101,9 @@ bat.stderr.on('data', (data) => {
bat.on('exit', (code) => { bat.on('exit', (code) => {
console.log(`Child exited with code ${code}`); console.log(`Child exited with code ${code}`);
}); });
```
```js
// OR... // OR...
const exec = require('child_process').exec; const exec = require('child_process').exec;
exec('my.bat', (err, stdout, stderr) => { exec('my.bat', (err, stdout, stderr) => {
@ -195,14 +197,14 @@ The `options` argument may be passed as the second argument to customize how
the process is spawned. The default options are: the process is spawned. The default options are:
```js ```js
{ const defaults = {
encoding: 'utf8', encoding: 'utf8',
timeout: 0, timeout: 0,
maxBuffer: 200*1024, maxBuffer: 200*1024,
killSignal: 'SIGTERM', killSignal: 'SIGTERM',
cwd: null, cwd: null,
env: null env: null
} };
``` ```
If `timeout` is greater than `0`, the parent will send the signal If `timeout` is greater than `0`, the parent will send the signal
@ -362,10 +364,10 @@ trigger arbitrary command execution.**
A third argument may be used to specify additional options, with these defaults: A third argument may be used to specify additional options, with these defaults:
```js ```js
{ const defaults = {
cwd: undefined, cwd: undefined,
env: process.env env: process.env
} };
``` ```
Use `cwd` to specify the working directory from which the process is spawned. Use `cwd` to specify the working directory from which the process is spawned.

View File

@ -69,6 +69,9 @@ or `console.Console`:
```js ```js
const Console = require('console').Console; const Console = require('console').Console;
```
```js
const Console = console.Console; const Console = console.Console;
``` ```

View File

@ -217,7 +217,7 @@ synchronous counterparts are of this type.
For a regular file [`util.inspect(stats)`][] would return a string very For a regular file [`util.inspect(stats)`][] would return a string very
similar to this: similar to this:
```js ```txt
Stats { Stats {
dev: 2114, dev: 2114,
ino: 48064969, ino: 48064969,
@ -630,13 +630,13 @@ default value of 64 kb for the same parameter.
`options` is an object or string with the following defaults: `options` is an object or string with the following defaults:
```js ```js
{ const defaults = {
flags: 'r', flags: 'r',
encoding: null, encoding: null,
fd: null, fd: null,
mode: 0o666, mode: 0o666,
autoClose: true autoClose: true
} };
``` ```
`options` can include `start` and `end` values to read a range of bytes from `options` can include `start` and `end` values to read a range of bytes from
@ -696,13 +696,13 @@ Returns a new [`WriteStream`][] object. (See [Writable Stream][]).
`options` is an object or string with the following defaults: `options` is an object or string with the following defaults:
```js ```js
{ const defaults = {
flags: 'w', flags: 'w',
defaultEncoding: 'utf8', defaultEncoding: 'utf8',
fd: null, fd: null,
mode: 0o666, mode: 0o666,
autoClose: true autoClose: true
} };
``` ```
`options` may also include a `start` option to allow writing data at `options` may also include a `start` option to allow writing data at

View File

@ -558,7 +558,8 @@ object, it is common to also reassign `exports`, for example:
```js ```js
module.exports = exports = function Constructor() { module.exports = exports = function Constructor() {
// ... etc. // ... etc.
};
``` ```
To illustrate the behavior, imagine this hypothetical implementation of To illustrate the behavior, imagine this hypothetical implementation of

View File

@ -529,7 +529,7 @@ running the `./configure` script.
An example of the possible output looks like: An example of the possible output looks like:
```js ```txt
{ {
target_defaults: target_defaults:
{ cflags: [], { cflags: [],
@ -1708,7 +1708,7 @@ to load modules that were compiled against a different module ABI version.
console.log(process.versions); console.log(process.versions);
``` ```
Will generate output similar to: Will generate an object similar to:
```js ```js
{ {

View File

@ -1246,7 +1246,7 @@ stream.
`tls.TLSSocket()`. For example, the code: `tls.TLSSocket()`. For example, the code:
```js ```js
pair = tls.createSecurePair( ... ); pair = tls.createSecurePair(/* ... */);
pair.encrypted.pipe(socket); pair.encrypted.pipe(socket);
socket.pipe(pair.encrypted); socket.pipe(pair.encrypted);
``` ```

View File

@ -84,7 +84,9 @@ request.on('response', (response) => {
break; break;
} }
}); });
```
```js
// server example // server example
// Running a gzip operation on every request is quite expensive. // Running a gzip operation on every request is quite expensive.
// It would be much more efficient to cache the compressed buffer. // It would be much more efficient to cache the compressed buffer.
@ -159,7 +161,7 @@ For example, to reduce the default memory requirements from 256K to 128K, the
options should be set to: options should be set to:
```js ```js
{ windowBits: 14, memLevel: 7 } const options = { windowBits: 14, memLevel: 7 };
``` ```
This will, however, generally degrade compression. This will, however, generally degrade compression.

View File

@ -52,7 +52,7 @@ and appending the new error codes to the end using the utility `E()` method.
```js ```js
E('EXAMPLE_KEY1', 'This is the error value'); E('EXAMPLE_KEY1', 'This is the error value');
E('EXAMPLE_KEY2', (a, b) => return `${a} ${b}`); E('EXAMPLE_KEY2', (a, b) => `${a} ${b}`);
``` ```
The first argument passed to `E()` is the static identifier. The second The first argument passed to `E()` is the static identifier. The second

View File

@ -23,27 +23,27 @@ Add tests when:
Let's analyze this basic test from the Node.js test suite: Let's analyze this basic test from the Node.js test suite:
```javascript ```javascript
1 'use strict'; 'use strict'; // 1
2 const common = require('../common'); const common = require('../common'); // 2
3 // 3
4 // This test ensures that the http-parser can handle UTF-8 characters // This test ensures that the http-parser can handle UTF-8 characters // 4
5 // in the http header. // in the http header. // 5
6 // 6
7 const assert = require('assert'); const assert = require('assert'); // 7
8 const http = require('http'); const http = require('http'); // 8
9 // 9
10 const server = http.createServer(common.mustCall((req, res) => { const server = http.createServer(common.mustCall((req, res) => { // 10
11 res.end('ok'); res.end('ok'); // 11
12 })); })); // 12
13 server.listen(0, () => { server.listen(0, () => { // 13
14 http.get({ http.get({ // 14
15 port: server.address().port, port: server.address().port, // 15
16 headers: {'Test': 'Düsseldorf'} headers: {'Test': 'Düsseldorf'} // 16
17 }, common.mustCall((res) => { }, common.mustCall((res) => { // 17
18 assert.strictEqual(res.statusCode, 200); assert.strictEqual(res.statusCode, 200); // 18
19 server.close(); server.close(); // 19
20 })); })); // 20
21 }); }); // 21
``` ```
### **Lines 1-2** ### **Lines 1-2**