English ▾ Themen ▾ Neueste Version ▾ gitmailmap zuletzt aktualisiert in 2.32.0

NAME

gitmailmap - Author-/Committer-Namen und/oder E-Mail-Adressen zuordnen

SYNOPSIS

$GIT_WORK_TREE/.mailmap

BESCHREIBUNG

Wenn die Datei .mailmap auf der obersten Ebene des Repositorys existiert oder an dem Ort, auf den die Konfigurationsoptionen mailmap.file oder mailmap.blob zeigen (siehe git-config[1]), wird sie verwendet, um Author- und Committer-Namen und E-Mail-Adressen auf kanonische Realnamen und E-Mail-Adressen abzubilden.

SYNTAX

Das Zeichen # leitet einen Kommentar bis zum Ende der Zeile ein. Leerzeilen werden ignoriert.

In der einfachen Form besteht jede Zeile in der Datei aus dem kanonischen Realnamen eines Autors, Leerzeichen und einer im Commit verwendeten E-Mail-Adresse (eingeschlossen von < und >), zu der der Name zugeordnet wird. Zum Beispiel

Proper Name <commit@email.xx>

Die komplexeren Formen sind

<proper@email.xx> <commit@email.xx>

wodurch mailmap nur den E-Mail-Teil eines Commits ersetzen kann, und

Proper Name <proper@email.xx> <commit@email.xx>

wodurch mailmap sowohl den Namen als auch die E-Mail eines Commits ersetzen kann, der der angegebenen Commit-E-Mail-Adresse entspricht, und

Proper Name <proper@email.xx> Commit Name <commit@email.xx>

wodurch mailmap sowohl den Namen als auch die E-Mail eines Commits ersetzen kann, der sowohl dem angegebenen Commit-Namen als auch der Commit-E-Mail-Adresse entspricht.

Sowohl E-Mails als auch Namen werden nicht case-sensitiv abgeglichen. Zum Beispiel würde dies auch Commit Name <commit@email.xx> oben abgleichen

Proper Name <proper@email.xx> CoMmIt NaMe <CoMmIt@EmAiL.xX>

ANMERKUNGEN

Git folgt keinen symbolischen Links beim Zugriff auf eine .mailmap-Datei im Arbeitsverzeichnis. Dies hält das Verhalten konsistent, wenn die Datei aus dem Index oder einem Baum im Gegensatz zum Dateisystem abgerufen wird.

BEISPIELE

Ihre Historie enthält Commits von zwei Autoren, Jane und Joe, deren Namen in verschiedenen Formen im Repository erscheinen

Joe Developer <joe@example.com>
Joe R. Developer <joe@example.com>
Jane Doe <jane@example.com>
Jane Doe <jane@laptop.(none)>
Jane D. <jane@desktop.(none)>

Nehmen wir nun an, Joe möchte, dass sein mittlerer Initial verwendet wird, und Jane bevorzugt ihren Nachnamen ausgeschrieben. Eine .mailmap-Datei zur Korrektur der Namen würde so aussehen

Joe R. Developer <joe@example.com>
Jane Doe <jane@example.com>
Jane Doe <jane@desktop.(none)>

Beachten Sie, dass es nicht notwendig ist, den Namen für <jane@laptop.(none)> zuzuordnen, um nur die Namen zu korrigieren. Die offensichtlich fehlerhaften <jane@laptop.(none)> und <jane@desktop.(none)> E-Mails so zu belassen, wie sie sind, ist normalerweise nicht das, was Sie wollen. Eine .mailmap-Datei, die auch diese korrigiert, ist

Joe R. Developer <joe@example.com>
Jane Doe <jane@example.com> <jane@laptop.(none)>
Jane Doe <jane@example.com> <jane@desktop.(none)>

Schließlich, sagen wir, Joe und Jane teilten sich eine E-Mail-Adresse, aber nicht einen Namen, z.B. indem diese beiden Commits in der Historie, die von einem Bug-Reporting-System generiert wurde, vorkommen. D.h., Namen erscheinen in der Historie als

Joe <bugs@example.com>
Jane <bugs@example.com>

Eine vollständige .mailmap-Datei, die auch diese Fälle behandelt (eine Ergänzung von zwei Zeilen zum obigen Beispiel), wäre

Joe R. Developer <joe@example.com>
Jane Doe <jane@example.com> <jane@laptop.(none)>
Jane Doe <jane@example.com> <jane@desktop.(none)>
Joe R. Developer <joe@example.com> Joe <bugs@example.com>
Jane Doe <jane@example.com> Jane <bugs@example.com>

SIEHE AUCH

git-check-mailmap[1]

GIT

Teil der git[1] Suite