python / python/cpython

Clarify `select.kqueue` and `select.kevent` also available on macOS

Offen
#143,293 0 Kommentare 1 Reaktion 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

docs OS-mac
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
35.9k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

The document says kqueue() and kevent() are only supported on BSD, but macOS also fully supports them:

https://github.com/python/cpython/blob/7e3a5a7e791b742a74c64810f221854191b94c1f/Doc/library/select.rst?plain=1#L103
https://github.com/python/cpython/blob/7e3a5a7e791b742a74c64810f221854191b94c1f/Doc/library/select.rst?plain=1#L114

While macOS uses a userland from BSD (FreeBSD in these days I guess?), our documentation consistently treats macOS as a distinct platform from BSD, for example:

https://github.com/python/cpython/blob/7e3a5a7e791b742a74c64810f221854191b94c1f/Doc/library/socket.rst?plain=1#L651

Linked PRs
  • gh-143294

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne bei den im Issue verlinkten Einträgen zu kqueue() und kevent() in Doc/library/select.rst und vergleiche anschließend die Plattformbeschreibung mit dem Beispiel in socket.rst. Als erledigt gilt die Aufgabe, wenn die select-Dokumentation die Unterstützung für macOS korrekt angibt; der verlinkte PR gh-143294 zeigt, dass diese Arbeit bereits begonnen hat.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.