update docs to address concerns

rust-lang / cfg-if

A if/elif-like macro for Rust #[cfg] statements

Apache License 2.0

557 stars 40 forks source link

update docs to address concerns #27

Closed Lokathor closed 5 years ago

Lokathor commented 5 years ago

Updates the docs to help clarify the macro's operation.

Closes https://github.com/alexcrichton/cfg-if/issues/8
Closes https://github.com/alexcrichton/cfg-if/issues/10
Closes https://github.com/alexcrichton/cfg-if/issues/23

alexcrichton commented 5 years ago

Given a recent idea I think that should be tried out before documenting it only works with items, and I would prefer to not document quirks like "you can use else without anything else", I think it's fine to just leave that there as a nice nugget for anyone willing to figure it out.

Lokathor commented 5 years ago

Ah! The discussion was in a closed issue. Okay.