From 333eda8d03bef36cf951bf54b33c7bbf2c0ef75c Mon Sep 17 00:00:00 2001
From: Igor Mikhalev <mr.igor.mikhalev@gmail.com>
Date: Sat, 8 Aug 2020 10:01:36 +0300
Subject: [PATCH] doc: add a note about possible missing lines to
 readline.asyncIterator

Fixes: https://github.com/nodejs/node/issues/33463

PR-URL: https://github.com/nodejs/node/pull/34675
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Anto Aravinth <anto.aravinth.cse@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: Rich Trott <rtrott@gmail.com>
---
 doc/api/readline.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/api/readline.md b/doc/api/readline.md
index c5829bf746629f..40c9f8fd08ed63 100644
--- a/doc/api/readline.md
+++ b/doc/api/readline.md
@@ -352,6 +352,10 @@ async function processLineByLine() {
 }
 ```
 
+`readline.createInterface()` will start to consume the input stream once
+invoked. Having asynchronous operations between interface creation and
+asynchronous iteration may result in missed lines.
+
 ### rl.line
 <!-- YAML
 added: v0.1.98