Fix reference to build file with guaranteed build platforms.

(backport <https://github.com/rust-lang/libc/pull/4263>)
(cherry picked from commit 728a5e2ba3ae519347145d206e8aff2de5c8751a)

Drop the `libc_const_extern_fn` conditional

Additionally deprecate the `const-extern-fn` feature. This is possible
since the MSRV was increased to 1.63.

docs: Take documentation from `main`

Just make the docs identical across the two branches. Effectively
backports <https://github.com/rust-lang/libc/pull/4071>.

Document the MSRV of the stable channel as 1.63

Currently this crate maintains the `main` branch (future 1.0) alongside
`libc-0.2` (current stable release). PRs are made against `main` then
cherry p

Document the MSRV of the stable channel as 1.63

Currently this crate maintains the `main` branch (future 1.0) alongside
`libc-0.2` (current stable release). PRs are made against `main` then
cherry picked as applicable to `libc-0.2`.

Usually this flow works okay, but there is a substantial difference in
minimum supported versions: libc-0.2 is tested down to 1.19 and main is
tested with 1.63. This means that supported features differ quite a bit
and as a result, cherry picks get conflict-heavy (e.g. `repr(align)`,
`union`, and `const fn` cannot be used on `libc-0.2`).

In order to make it easier to keep these branches in sync and get us
close to a 1.0 release, raise the MSRV on `libc-0.2` to 1.63. This means
both branches can run the exact same tests.

Future Changes
==============

This still does not establish a MSRV policy, which has been discussed at
great length in [1]. For the purpose of unsticking us this selects 1.63
as the MSRV, which is the version currently available on Debian stable
(a commonly requested reference point in [1], and about the oldest
specific version mentioned).

This is a documentation-only change to keep things simple, cleanup can
follow. Further increases and official policy are not precluded.

History
=======

An attempt to raise the MSRV to 1.57 in 2022 was approved at one point
[2], but never merged due to various failures. Making this a
documentation-only change hopes to avoid this problem.

I brought up a 0.3 release to increase versions in [3], but consensus
there was that we should be able to increase the MSRV in the existing
0.2 release without a semver-breaking change.

Link: https://github.com/rust-lang/libs-team/issues/72 [1]
Link: https://github.com/rust-lang/libc/pull/2845 [2]
Link: https://github.com/rust-lang/libs-team/issues/463 [3]

show more ...

Format all markdown files to rewrap text

Link windows-sys crate (#3915)

WinAPI provides low level libc-like functions but for Windows.
One may expect to find it here, so provide the links.

`windows-sys` is provided by Microsoft. Official,

Link windows-sys crate (#3915)

WinAPI provides low level libc-like functions but for Windows.
One may expect to find it here, so provide the links.

`windows-sys` is provided by Microsoft. Official, looks good.

(backport <https://github.com/rust-lang/libc/pull/3915>)
(cherry picked from commit 433d01944e237d89c786c419bc63fb3368bf9c9a)

show more ...

Prepare docs for libc v0.3

Say goodbye to GH Pages in favor of docs.rs

Signed-off-by: Yuki Okushi <[email protected]>

Change branch references to HEAD where possible or main otherwise

This updates CI, documentation, and similar to work with a `main`
branch. It also renames references to *other* repositories to work

Change branch references to HEAD where possible or main otherwise

This updates CI, documentation, and similar to work with a `main`
branch. It also renames references to *other* repositories to work, as
well, which additionally makes it easier to search for remaining
references.

show more ...

README.md: Clarify (lack of) MSRV policy

MSRV policy is still being discussed on an ongoing basis in
https://github.com/rust-lang/libs-team/issues/72 . In the interim,
clarify in README that libc do

README.md: Clarify (lack of) MSRV policy

MSRV policy is still being discussed on an ongoing basis in
https://github.com/rust-lang/libs-team/issues/72 . In the interim,
clarify in README that libc doesn't currently have an MSRV policy.

show more ...

Enable `libc_const_extern_fn` implicitly from Rust 1.62

Replace all mentions about Pipelines with GHA

Replace CI badge

Fix more typos

There was a missing period and the word "features" instead of "feature" in the section about `const extern fn`s.

Fix typo

In the `no-std` section of the README, there was a typo: "disable this feature remove the dependency". The word "to" was added in this commit to create "disable this feature to remove this

Fix typo

In the `no-std` section of the README, there was a typo: "disable this feature remove the dependency". The word "to" was added in this commit to create "disable this feature to remove this dependency".

show more ...

Add DevkitPPC support

DevkitPPC does not support unix sockets natively, meaning that bindings
to these functions was removed for powerpc targets with "nintendo" as
vendor.

Suggested target json fil

Add DevkitPPC support

DevkitPPC does not support unix sockets natively, meaning that bindings
to these functions was removed for powerpc targets with "nintendo" as
vendor.

Suggested target json files:

Nintendo Gamecube:
```
{
"arch": "powerpc",
"data-layout": "E-m:e-p:32:32-i64:64-n32",
"dynamic-linking": false,
"env": "newlib",
"executables": true,
"has-elf-tls": false,
"has-rpath": true,
"linker-flavor": "gcc",
"llvm-target": "powerpc-eabi",
"max-atomic-width": 32,
"os": "dolphin",
"target-c-int-width": "32",
"target-endian": "big",
"target-family": "unix",
"target-mcount": "_mcount",
"target-pointer-width": "32",
"vendor": "nintendo"
}
```

Nintendo Wii:
```
{
"arch": "powerpc",
"data-layout": "E-m:e-p:32:32-i64:64-n32",
"dynamic-linking": false,
"env": "newlib",
"executables": true,
"has-elf-tls": false,
"has-rpath": true,
"linker-flavor": "gcc",
"llvm-target": "powerpc-eabi",
"max-atomic-width": 32,
"os": "revolution",
"target-c-int-width": "32",
"target-endian": "big",
"target-family": "unix",
"target-mcount": "_mcount",
"target-pointer-width": "32",
"vendor": "nintendo"
}
```

show more ...

Tweak building documentation

Put index.html using unstable rustdoc features

Fix pipelines badge on README

Add support for declaring 'const fn'

Add a new feature to enable this, since `const extern fn`
support is unstable

Readme updates

Remove broken link

Update README Azure badge to rust-lang2 org

Remove Appveyor

Setup Azure Pipelines