Skip to content

doc: add note to tty.WriteStream event 'resize' on Windows #13576

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Dean-Coakley wants to merge 9 commits into from
Closed

doc: add note to tty.WriteStream event 'resize' on Windows #13576

Changes from 2 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
6da59fe
doc: note 'resize' event unreliability on Windows
Dean-Coakley Jun 9, 2017
a45bd1d
doc: correct 'resize' event note
Dean-Coakley Jun 9, 2017
84db75d
doc: add more detail on note
Dean-Coakley Jun 15, 2017
63fa375
doc: correct char limit
Dean-Coakley Jun 15, 2017
86dfd24
doc: add more detail on note
Dean-Coakley Jul 7, 2017
192a56f
doc: fix details on note
Dean-Coakley Jul 7, 2017
784055f
doc: fix err on resume note
Dean-Coakley Jul 7, 2017
05ce78a
doc: remove backslash
Dean-Coakley Jul 7, 2017
5944bf0
doc: merge note paragraphs
Dean-Coakley Jul 9, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions doc/api/tty.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,8 @@ process.stdout.on('resize', () => {
});
```

*Note:* Unrealiable event handler execution on all Windows platforms.
Copy link
Member

@tniessen tniessen Jun 9, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. Unrealiable → Unreliable
  2. What exactly do you want to say? Please try to use whole sentences if possible. Do you mean that the execution of this event is unreliable on Windows?

Copy link
Member

@gibfahn gibfahn Jun 9, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about something like:

*Note:*  Terminal window resize events are unreliable on Windows.

Copy link
Member

@tniessen tniessen Jun 9, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@gibfahn As per your comment I would suggest to include a note about having to use setRawMode on Windows.

Copy link
Contributor Author

@Dean-Coakley Dean-Coakley Jun 9, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That seems much better. Is it ok as 2 commits or do I need to squash/rebase?

Copy link
Member

@jasnell jasnell Jun 9, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a bit terse... can you expand this just a bit more?

Copy link
Contributor Author

@Dean-Coakley Dean-Coakley Jun 9, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I could add something like
Event handler only is only executed when the width is changed

It was also suggested here that raw mode must be enabled but I did not find this in my own testing.


### writeStream.columns
<!-- YAML
added: v0.7.7
Expand Down