Git suite -> Git Suite
[gitman-de.git] / git-rm-de.txt
bloba15f9ff58f7fa31863efb1065955097e777b2fd6
1 git-rm(1)
2 =========
4 NAME
5 ----
6 git-rm - Entferne Dateien aus dem Arbeitsbereich und dem Index
8 SYNOPSIS
9 --------
10 'git rm' [-f] [-n] [-r] [--cached] [--ignore-unmatch] [--quiet] [--] <Datei>...
12 DESCRIPTION
13 -----------
14 Entferne Dateien aus dem Index, oder aus dem Arbeitsbereich und dem Index.
15 'git-rm' wird die Datei immer auch aus dem Index entfernen - es gibt keine
16 Möglichkeit die Datei lediglich aus dem Arbeitsbereich zu löschen
17 (zu diesem Zweck kann das normale '/bin/rm' verwendet werden).
18 Die zu entfernende Datei muß identisch mit der letzten Version im 
19 Projektarchiv sein, und es können gleichzeitig keine Änderungen im Index
20 bereitgestellt werden (staging). Dieses Standardverhalten kann jedoch mit 
21 der '-f' Option übersteuert werden. Wird '--cached' angegeben, so muß der 
22 bereitgestellte Inhalt entweder der letzten Version im Projektarchiv 
23 entsprechen oder der Datei im Arbeitsbereich. Die Datei wird bei Verwendung
24 von '--cached' ausschließlich aus dem Index entfernt.
27 OPTIONS
28 -------
29 <Datei>...::
30         Dateien die entfernt werden sollen. Dateisuchkriterien (z.B. '*.c')
31         können verwendet werden um alle passenden Dateien zu entfernen.
32         Soll sich git selbst um die Erweiterung der Dateisuchkriterien
33         kümmern, so muß dies dem Befehlsprozessor angegeben werden 
34         (z.B. Documentation/\\*.txt).
35         Es kann auch ein Pfadname angegeben werden, um rekursiv alle in 
36         diesem Pfad befindlichen Dateien (auch in den Unterordnern) zu
37         entfernen (z.B. 'dir' für 'dir/datei1' und 'dir/datei2'). 
38         Allerdings muß dazu die '-r' Option explizit angegeben werden.
40 -f::
41         Ignoriere das Ergebnis der Prüfung auf Aktualität der Dateien.
43 -n::
44 --dry-run::
45         Entferne die Datei(en) nicht wirklich, sondern zeige nur ob sie
46         im Index existieren und gegebenenfalls durch den Befehl entfernt 
47         werden würden.
49 -r::
50         Ermögliche rekursives Entfernen wenn ein führender Verzeichnisname
51         angegeben wurde.
53 \--::
54         Diese Option kann dazu verwendet werden, Befehlszeilenoptionen
55         von der Liste von Dateien zu trennen. Dies ist sinnvoll, wenn
56         Dateinamen mit Befehlszeilenoptionen verwechselt werden könnten.
58 --cached::
59         Diese Option kann verwendet werden um Dateien ausschließlich aus 
60         dem Index zu entfernen. Dateien im Arbeitsbereich bleiben unberührt, 
61         unabhängig davon ob sie verändert wurden oder nicht.
63 --ignore-unmatch::
64         Der Befehl wird mit einem Fehlerwert von 0 beendet, selbst wenn 
65         keine Dateien verarbeitet wurden.
67 -q::
68 --quiet::
69         'git-rm' gibt normalerweise für jeden entfernte Datei eine Zeile 
70         (in Form eines "rm" Befehls) aus. Mit dieser Option wird diese
71         Ausgabe unterdrückt.
72         
74 DISCUSSION
75 ----------
77 Die <Datei> Liste die an den Befehl übergeben wird, kann genaue Dateinamen,
78 Dateisuchkriterien oder führende Verzeichnisnamen beinhalten. 'git-rm'
79 wird allerdings nur jene Dateien entfernen, von deren Existenz git weiß.
80 Wird eine Datei angegeben die von git noch nicht verwaltet wird, so wird
81 sie nicht entfernt.
83 Dateisuchkrierien können verzeichnisübergreifend verwendet werden. Nehmen 
84 wir zwei Verzeichnisse 'd' und 'd2' an, so besteht ein Unterschied in der
85 Verwendung von `git rm \'d\*\'` und `git rm \'d/\*\'`, da der erstere 
86 Befehl auch alles aus dem Verzeichnis 'd2' entfernen wird.
88 EXAMPLES
89 --------
90 git rm Documentation/\\*.txt::
91         Entfernt alle `\*.txt` Dateien aus dem Index die im `Documentation`
92         Verzeichnis oder dessen Unterverzeichnissen liegen.
94 Anmerkung: das Sternchen `\*` wird in diesem Beispiel vom Befehlsprozessor
95 (shell) nicht automatisch erweitert, wodurch der 'git-rm' Befehl auch
96 Unterverzeichnisse des `Documentation/` Verzeichnisses erfassen kann.
98 git rm -f git-*.sh::
100 Dieses Beispiel läßt dem Befehlsprozessor (shell) die Erweiterung des
101 Sternchens durchführen (git erhält bereits eine explizite Dateiliste
102 übergeben), und so wird zB `subdir/git-foo.sh` nicht entfernt werden.
104 SEE ALSO
105 --------
106 linkgit:git-add[1]
108 Author
109 ------
110 Geschrieben von Linus Torvalds <torvalds@osdl.org>
112 Documentation
113 --------------
114 Dokumentiert durch Junio C Hamano und der git-list <git@vger.kernel.org>.
118 Teil der linkgit:git[1] suite