Skip to content
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.

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

Update wifi event monitor documentation #1889

Merged
merged 4 commits into from
Mar 31, 2017

Conversation

dnc40085
Copy link
Contributor

@dnc40085 dnc40085 commented Mar 29, 2017

Update wifi event monitor documentation.

Fixes #1737.

  • This PR is compliant with the other contributing guidelines as well (if not, please describe why).
  • This PR is for the dev branch rather than for master.

A lack of information about when the wifi event monitor callbacks should be registered is causing confusion, the new information provided should help to clarify the function of the event monitor .

Added a note to `wifi.eventmon.register()` and `wifi.sta.eventmonreg()`
@dnc40085 dnc40085 force-pushed the dev_eventmon_doc_update branch from 9615615 to 62206e5 Compare March 29, 2017 20:56
@@ -398,6 +398,9 @@ none

Registers callbacks for WiFi station status events.

!!! note
Please update your program to use the [`wifi.eventmon`](#wifieventmon-module) API, as the `wifi.sta.eventmon___()` API is to be depreciated.
Copy link
Member

Choose a reason for hiding this comment

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

is to be depreciated

  1. That should be "deprecated" I guess?
  2. "to be" confuses me a little here, is it deprecated or not?

Copy link
Contributor Author

@dnc40085 dnc40085 Mar 30, 2017

Choose a reason for hiding this comment

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

That should be "deprecated" I guess?
"to be" confuses me a little here, is it deprecated or not?

You're right, I found this Wikipedia page about deprecation, and it is indeed "deprecated".

@marcelstoer marcelstoer added this to the 2.0.0-follow-up milestone Mar 29, 2017
@marcelstoer
Copy link
Member

So, it seems those functions really are deprecated (sorry, didn't know). How about adding platform_print_deprecation_note to them in code?

Example usage:

@dnc40085
Copy link
Contributor Author

How about adding platform_print_deprecation_note to them in code?

Done

@marcelstoer marcelstoer merged commit 50a5c02 into nodemcu:dev Mar 31, 2017
@dnc40085 dnc40085 deleted the dev_eventmon_doc_update branch April 7, 2017 01:07
eiselekd pushed a commit to eiselekd/nodemcu-firmware that referenced this pull request Jan 7, 2018
* Update wifi event monitor documentation

Added a note to `wifi.eventmon.register()` and `wifi.sta.eventmonreg()`
* Add deprecation note to `wifi.sta.eventMonReg()`
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants