Update README.md

This commit is contained in:
Timon 2018-08-06 23:06:21 +02:00 committed by GitHub
parent f4d2ab4feb
commit b01a2e5bee
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -30,8 +30,12 @@ This crate supports all unix and windows terminals down to windows XP (not not a
- [License](https://github.com/TimonPost/crossterm#license)
## IMPORTANT When updating to version `0.3.0`
1.
Version `0.3.0` of Crossterm will have API braking changes. If you are reading this and your version was automatically incremented to the new version, there will be some broken code. A Quiqe solution? no, unless you did not use this crate that much. If it is important to keep running your code and you don't want to spend some time to fix the errors I recommend you to keep using version `0.2.2` because in version `0.3.0` alternate screen and some other features are introduced. And if you are not using any of these features just downgrade. If however, you want to have the newest version you can check the [upgrade manual](https://github.com/TimonPost/crossterm/blob/master/docs/UpgradeManual.md) on how to upgrade to the new version. Check [release node](https://github.com/TimonPost/crossterm/blob/master/docs/ReleaseNotesVersion%200.3.0.md) why these API breaking changes where necessary.
2. The next realase 0.4.0 will also have braking changes so to be honnest you could better do'nt upgrade unless you realy want to have the alternate screen and raw screen functionalities. Otherwise you will have dubble work.
## Getting Started
This documentation is only for Crossterm version `0.3.0` if you have an older version of Crossterm I suggest you check the [Upgrade Manual](https://github.com/TimonPost/crossterm/blob/master/docs/UpgradeManual.md) for more information about how to upgrade to a newer version or check the [examples](https://github.com/TimonPost/crossterm/tree/master/examples) folders which contains a readme for every specific version. Also, you could take a look at the [examples](https://github.com/TimonPost/crossterm/tree/master/examples) from the previous versions of Crossterm.