python / python/cpython

`shutil.move` documentation conflicts with `shutil.copy2` documentation

Offen
#125,676 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

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

Beschreibung

Documentation

https://github.com/python/cpython/blob/a0f5c8e6272a1fd5422892d773923b138e77ae5f/Doc/library/shutil.rst?plain=1#L381-L384

https://github.com/python/cpython/blob/a0f5c8e6272a1fd5422892d773923b138e77ae5f/Doc/library/shutil.rst?plain=1#L199-L202

Which is it? Does copy2 sometimes fail to copy files, or does move work fine even with copy2 on systems that cannot copy all metadata?

Linked PRs
  • gh-137792

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

Lies die beiden verlinkten Abschnitte in Doc/library/shutil.rst und prüfe den verlinkten PR gh-137792, um die vorgeschlagene Lösung zu verstehen. Kläre den Zusammenhang zwischen shutil.move und shutil.copy2, wenn Metadaten nicht kopiert werden können, und aktualisiere anschließend die Dokumentation, sodass sich die beiden Beschreibungen nicht mehr widersprechen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

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