Apply suggestions on doc & comments

Author: Berrysoft

.github/workflows/build.yml

@@ -94,6 +94,9 @@ jobs:
           x86_64-wrs-vxworks,
           x86_64-unknown-dragonfly,
           x86_64-unknown-haiku,
+          # TODO: once libstd support for cygwin is added
+          # https://github.com/rust-lang/rust/pull/137621
+          # x86_64-pc-cygwin,
         ]
     steps:
       - uses: actions/checkout@v4

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `.cargo/config.toml` example in the crate-level docs [#591]
 - `getrandom_test_linux_without_fallback` configuration flag to test that file fallback
   is not triggered in the `linux_android_with_fallback` backend [#605]
+- Cygwin support [#626]
 
 ### Changed
 - Remove `windows-targets` dependency and use [`raw-dylib`] directly [#627]
@@ -37,6 +38,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#605]: https://github.com/rust-random/getrandom/pull/605
 [#610]: https://github.com/rust-random/getrandom/pull/610
 [#614]: https://github.com/rust-random/getrandom/pull/614
+[#626]: https://github.com/rust-random/getrandom/pull/626
 [#627]: https://github.com/rust-random/getrandom/pull/627
 [`raw-dylib`]: https://doc.rust-lang.org/reference/items/external-blocks.html?highlight=link#dylib-versus-raw-dylib
 

Cargo.toml

@@ -87,7 +87,7 @@ check-cfg = [
   'cfg(getrandom_test_linux_fallback)',
   'cfg(getrandom_test_linux_without_fallback)',
   'cfg(getrandom_test_netbsd_fallback)',
-  'cfg(target_os, values("cygwin"))'
+  'cfg(target_os, values("cygwin"))', # TODO(MSRV 1.86): Remove this.
 ]
 
 [package.metadata.docs.rs]

README.md

@@ -69,6 +69,7 @@ fn get_random_u128() -> Result<u128, getrandom::Error> {
 | PS Vita            | `*-vita-*`         | [`getentropy`][19]
 | QNX Neutrino       | `*‑nto-qnx*`       | [`/dev/urandom`][14] (identical to `/dev/random`)
 | AIX                | `*-ibm-aix`        | [`/dev/urandom`][15]
+| Cygwin             | `*-cygwin`         | [`getrandom`][20] (based on [`RtlGenRandom`])
 
 Pull Requests that add support for new targets to `getrandom` are always welcome.
 
@@ -351,6 +352,7 @@ dual licensed as above, without any additional terms or conditions.
 [17]: https://www.gnu.org/software/libc/manual/html_mono/libc.html#index-getrandom
 [18]: https://github.com/rust3ds/shim-3ds/commit/b01d2568836dea2a65d05d662f8e5f805c64389d
 [19]: https://github.com/vitasdk/newlib/blob/2d869fe47aaf02b8e52d04e9a2b79d5b210fd016/newlib/libc/sys/vita/getentropy.c
+[20]: https://github.com/cygwin/cygwin/blob/main/winsup/cygwin/libc/getentropy.cc
 
 [`ProcessPrng`]: https://learn.microsoft.com/en-us/windows/win32/seccng/processprng
 [`RtlGenRandom`]: https://learn.microsoft.com/en-us/windows/win32/api/ntsecapi/nf-ntsecapi-rtlgenrandom