diff options
Diffstat (limited to 'third_party/rust/winapi-util/README.md')
| -rw-r--r-- | third_party/rust/winapi-util/README.md | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/third_party/rust/winapi-util/README.md b/third_party/rust/winapi-util/README.md new file mode 100644 index 0000000000..145eede1a0 --- /dev/null +++ b/third_party/rust/winapi-util/README.md @@ -0,0 +1,51 @@ +winapi-util +=========== +This crate provides a smattering of safe wrappers around various parts of the +[winapi](https://crates.io/crates/winapi) crate. + +[](https://travis-ci.org/BurntSushi/winapi-util) +[](https://ci.appveyor.com/project/BurntSushi/winapi-util) +[](https://crates.io/crates/winapi-util) + +Dual-licensed under MIT or the [UNLICENSE](http://unlicense.org). + + +### Documentation + +https://docs.rs/winapi-util + + +### Usage + +Add this to your `Cargo.toml`: + +```toml +[dependencies] +winapi-util = "0.1" +``` + +and this to your crate root: + +```rust +extern crate winapi_util; +``` + + +### Notes + +This crate was born out of frustration with having to write lots of little +ffi utility bindings in a variety of crates in order to get Windows support. +Eventually, I started needing to copy & paste a lot of those utility routines. +Since they are utility routines, they often don't make sense to expose directly +in the crate in which they are defined. Instead of continuing this process, +I decided to make a crate instead. + +Normally, I'm not a huge fan of "utility" crates like this that don't have a +well defined scope, but this is primarily a practical endeavor to make it +easier to isolate Windows specific ffi code. + +While I don't have a long term vision for this crate, I will welcome additional +PRs that add more high level routines/types on an as-needed basis. + +**WARNING:** I am not a Windows developer, so extra review to make sure I've +got things right is most appreciated. |