Skip to content

docs: document pkg/corewlan in the package table - #10

Merged
krisarmstrong merged 1 commit into
mainfrom
docs/readme-corewlan
Aug 24, 2026
Merged

docs: document pkg/corewlan in the package table#10
krisarmstrong merged 1 commit into
mainfrom
docs/readme-corewlan

Conversation

@krisarmstrong

Copy link
Copy Markdown
Contributor

The ## Packages table still listed only license and csrf, three PRs after the CoreWLAN binding shipped — #5 (scanning), #6 (interface control, saved networks, power) and #8 (Location Services authorization state).

Adds a row covering the current surface: Scan, Current, Interfaces, SavedNetworks, Associate/Disassociate, SetPower, Forget, and the AuthorizationStatus/RequestAuthorization pair.

Two things called out on the row because they are the non-obvious ones:

  • Why it exists — the airport CLI every product used to shell out to was removed in macOS 26.
  • darwin-only — this is the one package in foundation whose import does nothing useful off macOS; the !darwin stub returns ErrUnsupported.

The Location Services nuance (CoreWLAN redacts SSID/BSSID without the TCC grant, surfaced as ErrLocationDenied) is left to the package godoc, which covers it in full — the table is an index, and the neighbouring rows are one to two sentences.

Docs only, no code change. Also the first PR through the CI Complete gate added in #9.

The Packages table still listed only license and csrf, three PRs after the
CoreWLAN binding shipped (#5 scanning, #6 interface control and power, #8
Location Services authorization state).

Note the darwin-only constraint on the row: the package is the one place in
foundation where the import does nothing useful off macOS, since the !darwin
stub returns ErrUnsupported.
@krisarmstrong
krisarmstrong merged commit bf9a2f6 into main Aug 24, 2026
4 checks passed
@krisarmstrong
krisarmstrong deleted the docs/readme-corewlan branch August 24, 2026 21:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant