Skip to content

Commit e8b73c2

Browse files
authored
docs: fix missing options objects and descriptions (#1504)
1 parent 557afa4 commit e8b73c2

28 files changed

+1598
-602
lines changed

.eslintrc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@
3131
"prefer-template": 2,
3232
"semi": [2, "always", {"omitLastInOneLineBlock": true}],
3333
"space-before-function-paren": [2, "never"],
34-
"standard/object-curly-even-spacing": 0
34+
"standard/object-curly-even-spacing": 0,
35+
"valid-jsdoc": [0]
3536
}
3637
}

docs/BaseBinding.html

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
<label for="nav-trigger" class="overlay"></label>
2323

2424
<nav>
25-
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BaseBinding.html">BaseBinding</a><ul class='methods'><li data-type='method'><a href="BaseBinding.html#.list">list</a></li><li data-type='method'><a href="BaseBinding.html#close">close</a></li><li data-type='method'><a href="BaseBinding.html#drain">drain</a></li><li data-type='method'><a href="BaseBinding.html#flush">flush</a></li><li data-type='method'><a href="BaseBinding.html#get">get</a></li><li data-type='method'><a href="BaseBinding.html#getBaudRate">getBaudRate</a></li><li data-type='method'><a href="BaseBinding.html#open">open</a></li><li data-type='method'><a href="BaseBinding.html#read">read</a></li><li data-type='method'><a href="BaseBinding.html#set">set</a></li><li data-type='method'><a href="BaseBinding.html#update">update</a></li><li data-type='method'><a href="BaseBinding.html#write">write</a></li></ul></li><li><a href="ByteLengthParser.html">ByteLengthParser</a></li><li><a href="CCTalkParser.html">CCTalkParser</a></li><li><a href="DelimiterParser.html">DelimiterParser</a></li><li><a href="Poller.html">Poller</a><ul class='methods'><li data-type='method'><a href="Poller.html#once">once</a></li><li data-type='method'><a href="Poller.html#poll">poll</a></li><li data-type='method'><a href="Poller.html#stop">stop</a></li></ul></li><li><a href="ReadLineParser.html">ReadLineParser</a></li><li><a href="ReadyParser.html">ReadyParser</a></li><li><a href="RegexParser.html">RegexParser</a></li><li><a href="SerialPort.html">SerialPort</a><ul class='members'><li data-type='member'><a href="SerialPort.html#.Binding">Binding</a></li><li data-type='member'><a href="SerialPort.html#.parsers">parsers</a></li></ul><ul class='methods'><li data-type='method'><a href="SerialPort.html#.list">list</a></li><li data-type='method'><a href="SerialPort.html#close">close</a></li><li data-type='method'><a href="SerialPort.html#drain">drain</a></li><li data-type='method'><a href="SerialPort.html#flush">flush</a></li><li data-type='method'><a href="SerialPort.html#get">get</a></li><li data-type='method'><a href="SerialPort.html#open">open</a></li><li data-type='method'><a href="SerialPort.html#set">set</a></li><li data-type='method'><a href="SerialPort.html#update">update</a></li></ul></li></ul><h3>Events</h3><ul><li><a href="module-serialport.html#event:close">close</a></li><li><a href="module-serialport.html#event:data">data</a></li><li><a href="module-serialport.html#event:error">error</a></li><li><a href="module-serialport.html#event:open">open</a></li></ul><h3>Global</h3><ul><li><a href="global.html#EVENTS">EVENTS</a></li></ul>
25+
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BaseBinding.html">BaseBinding</a><ul class='methods'><li data-type='method'><a href="BaseBinding.html#.list">list</a></li><li data-type='method'><a href="BaseBinding.html#close">close</a></li><li data-type='method'><a href="BaseBinding.html#drain">drain</a></li><li data-type='method'><a href="BaseBinding.html#flush">flush</a></li><li data-type='method'><a href="BaseBinding.html#get">get</a></li><li data-type='method'><a href="BaseBinding.html#getBaudRate">getBaudRate</a></li><li data-type='method'><a href="BaseBinding.html#open">open</a></li><li data-type='method'><a href="BaseBinding.html#read">read</a></li><li data-type='method'><a href="BaseBinding.html#set">set</a></li><li data-type='method'><a href="BaseBinding.html#update">update</a></li><li data-type='method'><a href="BaseBinding.html#write">write</a></li></ul></li><li><a href="ByteLengthParser.html">ByteLengthParser</a></li><li><a href="CCTalkParser.html">CCTalkParser</a></li><li><a href="DelimiterParser.html">DelimiterParser</a></li><li><a href="Poller.html">Poller</a><ul class='methods'><li data-type='method'><a href="Poller.html#once">once</a></li><li data-type='method'><a href="Poller.html#poll">poll</a></li><li data-type='method'><a href="Poller.html#stop">stop</a></li></ul></li><li><a href="ReadLineParser.html">ReadLineParser</a></li><li><a href="ReadyParser.html">ReadyParser</a></li><li><a href="RegexParser.html">RegexParser</a></li><li><a href="SerialPort.html">SerialPort</a><ul class='members'><li data-type='member'><a href="SerialPort.html#.Binding">Binding</a></li><li data-type='member'><a href="SerialPort.html#.parsers">parsers</a></li></ul><ul class='methods'><li data-type='method'><a href="SerialPort.html#.list">list</a></li><li data-type='method'><a href="SerialPort.html#close">close</a></li><li data-type='method'><a href="SerialPort.html#drain">drain</a></li><li data-type='method'><a href="SerialPort.html#flush">flush</a></li><li data-type='method'><a href="SerialPort.html#get">get</a></li><li data-type='method'><a href="SerialPort.html#open">open</a></li><li data-type='method'><a href="SerialPort.html#pause">pause</a></li><li data-type='method'><a href="SerialPort.html#read">read</a></li><li data-type='method'><a href="SerialPort.html#resume">resume</a></li><li data-type='method'><a href="SerialPort.html#set">set</a></li><li data-type='method'><a href="SerialPort.html#update">update</a></li><li data-type='method'><a href="SerialPort.html#write">write</a></li></ul></li></ul><h3>Events</h3><ul><li><a href="global.html#event:close">close</a></li><li><a href="global.html#event:data">data</a></li><li><a href="global.html#event:error">error</a></li><li><a href="global.html#event:open">open</a></li></ul><h3><a href="global.html">Global</a></h3>
2626
</nav>
2727

2828
<div id="main">
@@ -214,7 +214,7 @@ <h5>Parameters:</h5>
214214

215215

216216

217-
<td class="description last"></td>
217+
<td class="description last"><p>options for the biding</p></td>
218218
</tr>
219219

220220

@@ -1069,7 +1069,7 @@ <h5>Returns:</h5>
10691069

10701070

10711071

1072-
<h4 class="name" id="open"><span class="type-signature"></span>open<span class="signature">(path, openOptions)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
1072+
<h4 class="name" id="open"><span class="type-signature"></span>open<span class="signature">(path, options)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
10731073

10741074

10751075

@@ -1175,20 +1175,20 @@ <h5>Parameters:</h5>
11751175

11761176

11771177

1178-
<td class="description last"></td>
1178+
<td class="description last"><p>the path or com port to open</p></td>
11791179
</tr>
11801180

11811181

11821182

11831183
<tr>
11841184

1185-
<td class="name"><code>openOptions</code></td>
1185+
<td class="name"><code>options</code></td>
11861186

11871187

11881188
<td class="type">
11891189

11901190

1191-
<span class="param-type">module:serialport~openOptions</span>
1191+
<span class="param-type"><a href="global.html#openOptions">openOptions</a></span>
11921192

11931193

11941194

@@ -1198,7 +1198,7 @@ <h5>Parameters:</h5>
11981198

11991199

12001200

1201-
<td class="description last"></td>
1201+
<td class="description last"><p>openOptions for the serialport</p></td>
12021202
</tr>
12031203

12041204

@@ -1276,7 +1276,7 @@ <h5>Returns:</h5>
12761276

12771277

12781278

1279-
<h4 class="name" id="read"><span class="type-signature"></span>read<span class="signature">(data, offset, length)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
1279+
<h4 class="name" id="read"><span class="type-signature"></span>read<span class="signature">(buffer, offset, length)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
12801280

12811281

12821282

@@ -1367,7 +1367,7 @@ <h5>Parameters:</h5>
13671367

13681368
<tr>
13691369

1370-
<td class="name"><code>data</code></td>
1370+
<td class="name"><code>buffer</code></td>
13711371

13721372

13731373
<td class="type">
@@ -1687,7 +1687,7 @@ <h6>Properties</h6>
16871687
</td>
16881688

16891689

1690-
<td class="description last"></td>
1690+
<td class="description last"><p>flag for brk</p></td>
16911691
</tr>
16921692

16931693

@@ -1726,7 +1726,7 @@ <h6>Properties</h6>
17261726
</td>
17271727

17281728

1729-
<td class="description last"></td>
1729+
<td class="description last"><p>flag for cts</p></td>
17301730
</tr>
17311731

17321732

@@ -1765,7 +1765,7 @@ <h6>Properties</h6>
17651765
</td>
17661766

17671767

1768-
<td class="description last"></td>
1768+
<td class="description last"><p>flag for dsr</p></td>
17691769
</tr>
17701770

17711771

@@ -1804,7 +1804,7 @@ <h6>Properties</h6>
18041804
</td>
18051805

18061806

1807-
<td class="description last"></td>
1807+
<td class="description last"><p>flag for dtr</p></td>
18081808
</tr>
18091809

18101810

@@ -1843,7 +1843,7 @@ <h6>Properties</h6>
18431843
</td>
18441844

18451845

1846-
<td class="description last"></td>
1846+
<td class="description last"><p>flag for rts</p></td>
18471847
</tr>
18481848

18491849

@@ -2185,7 +2185,7 @@ <h5>Returns:</h5>
21852185

21862186

21872187

2188-
<h4 class="name" id="write"><span class="type-signature"></span>write<span class="signature">(data)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
2188+
<h4 class="name" id="write"><span class="type-signature"></span>write<span class="signature">(buffer)</span><span class="type-signature"> &rarr; {Promise}</span></h4>
21892189

21902190

21912191

@@ -2276,7 +2276,7 @@ <h5>Parameters:</h5>
22762276

22772277
<tr>
22782278

2279-
<td class="name"><code>data</code></td>
2279+
<td class="name"><code>buffer</code></td>
22802280

22812281

22822282
<td class="type">
@@ -2383,7 +2383,7 @@ <h5>Returns:</h5>
23832383
<br class="clear">
23842384

23852385
<footer>
2386-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Feb 15 2018 16:36:25 GMT-0500 (EST) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
2386+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Tue Feb 27 2018 22:46:41 GMT-0500 (EST) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
23872387
</footer>
23882388

23892389
<script>prettyPrint();</script>

docs/ByteLengthParser.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
<label for="nav-trigger" class="overlay"></label>
2323

2424
<nav>
25-
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BaseBinding.html">BaseBinding</a><ul class='methods'><li data-type='method'><a href="BaseBinding.html#.list">list</a></li><li data-type='method'><a href="BaseBinding.html#close">close</a></li><li data-type='method'><a href="BaseBinding.html#drain">drain</a></li><li data-type='method'><a href="BaseBinding.html#flush">flush</a></li><li data-type='method'><a href="BaseBinding.html#get">get</a></li><li data-type='method'><a href="BaseBinding.html#getBaudRate">getBaudRate</a></li><li data-type='method'><a href="BaseBinding.html#open">open</a></li><li data-type='method'><a href="BaseBinding.html#read">read</a></li><li data-type='method'><a href="BaseBinding.html#set">set</a></li><li data-type='method'><a href="BaseBinding.html#update">update</a></li><li data-type='method'><a href="BaseBinding.html#write">write</a></li></ul></li><li><a href="ByteLengthParser.html">ByteLengthParser</a></li><li><a href="CCTalkParser.html">CCTalkParser</a></li><li><a href="DelimiterParser.html">DelimiterParser</a></li><li><a href="Poller.html">Poller</a><ul class='methods'><li data-type='method'><a href="Poller.html#once">once</a></li><li data-type='method'><a href="Poller.html#poll">poll</a></li><li data-type='method'><a href="Poller.html#stop">stop</a></li></ul></li><li><a href="ReadLineParser.html">ReadLineParser</a></li><li><a href="ReadyParser.html">ReadyParser</a></li><li><a href="RegexParser.html">RegexParser</a></li><li><a href="SerialPort.html">SerialPort</a><ul class='members'><li data-type='member'><a href="SerialPort.html#.Binding">Binding</a></li><li data-type='member'><a href="SerialPort.html#.parsers">parsers</a></li></ul><ul class='methods'><li data-type='method'><a href="SerialPort.html#.list">list</a></li><li data-type='method'><a href="SerialPort.html#close">close</a></li><li data-type='method'><a href="SerialPort.html#drain">drain</a></li><li data-type='method'><a href="SerialPort.html#flush">flush</a></li><li data-type='method'><a href="SerialPort.html#get">get</a></li><li data-type='method'><a href="SerialPort.html#open">open</a></li><li data-type='method'><a href="SerialPort.html#set">set</a></li><li data-type='method'><a href="SerialPort.html#update">update</a></li></ul></li></ul><h3>Events</h3><ul><li><a href="module-serialport.html#event:close">close</a></li><li><a href="module-serialport.html#event:data">data</a></li><li><a href="module-serialport.html#event:error">error</a></li><li><a href="module-serialport.html#event:open">open</a></li></ul><h3>Global</h3><ul><li><a href="global.html#EVENTS">EVENTS</a></li></ul>
25+
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BaseBinding.html">BaseBinding</a><ul class='methods'><li data-type='method'><a href="BaseBinding.html#.list">list</a></li><li data-type='method'><a href="BaseBinding.html#close">close</a></li><li data-type='method'><a href="BaseBinding.html#drain">drain</a></li><li data-type='method'><a href="BaseBinding.html#flush">flush</a></li><li data-type='method'><a href="BaseBinding.html#get">get</a></li><li data-type='method'><a href="BaseBinding.html#getBaudRate">getBaudRate</a></li><li data-type='method'><a href="BaseBinding.html#open">open</a></li><li data-type='method'><a href="BaseBinding.html#read">read</a></li><li data-type='method'><a href="BaseBinding.html#set">set</a></li><li data-type='method'><a href="BaseBinding.html#update">update</a></li><li data-type='method'><a href="BaseBinding.html#write">write</a></li></ul></li><li><a href="ByteLengthParser.html">ByteLengthParser</a></li><li><a href="CCTalkParser.html">CCTalkParser</a></li><li><a href="DelimiterParser.html">DelimiterParser</a></li><li><a href="Poller.html">Poller</a><ul class='methods'><li data-type='method'><a href="Poller.html#once">once</a></li><li data-type='method'><a href="Poller.html#poll">poll</a></li><li data-type='method'><a href="Poller.html#stop">stop</a></li></ul></li><li><a href="ReadLineParser.html">ReadLineParser</a></li><li><a href="ReadyParser.html">ReadyParser</a></li><li><a href="RegexParser.html">RegexParser</a></li><li><a href="SerialPort.html">SerialPort</a><ul class='members'><li data-type='member'><a href="SerialPort.html#.Binding">Binding</a></li><li data-type='member'><a href="SerialPort.html#.parsers">parsers</a></li></ul><ul class='methods'><li data-type='method'><a href="SerialPort.html#.list">list</a></li><li data-type='method'><a href="SerialPort.html#close">close</a></li><li data-type='method'><a href="SerialPort.html#drain">drain</a></li><li data-type='method'><a href="SerialPort.html#flush">flush</a></li><li data-type='method'><a href="SerialPort.html#get">get</a></li><li data-type='method'><a href="SerialPort.html#open">open</a></li><li data-type='method'><a href="SerialPort.html#pause">pause</a></li><li data-type='method'><a href="SerialPort.html#read">read</a></li><li data-type='method'><a href="SerialPort.html#resume">resume</a></li><li data-type='method'><a href="SerialPort.html#set">set</a></li><li data-type='method'><a href="SerialPort.html#update">update</a></li><li data-type='method'><a href="SerialPort.html#write">write</a></li></ul></li></ul><h3>Events</h3><ul><li><a href="global.html#event:close">close</a></li><li><a href="global.html#event:data">data</a></li><li><a href="global.html#event:error">error</a></li><li><a href="global.html#event:open">open</a></li></ul><h3><a href="global.html">Global</a></h3>
2626
</nav>
2727

2828
<div id="main">
@@ -171,7 +171,7 @@ <h5>Parameters:</h5>
171171

172172

173173

174-
<td class="description last">
174+
<td class="description last"><p>parser options object</p>
175175
<h6>Properties</h6>
176176

177177

@@ -285,7 +285,7 @@ <h3 class="subsection-title">Extends</h3>
285285
<br class="clear">
286286

287287
<footer>
288-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Feb 15 2018 16:36:25 GMT-0500 (EST) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
288+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Tue Feb 27 2018 22:46:41 GMT-0500 (EST) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
289289
</footer>
290290

291291
<script>prettyPrint();</script>

0 commit comments

Comments
 (0)