Wycofywanie zmian w Subversion można podzielić na dwie kategorie. Pierwsza to wycofywanie zmian lokalnych, jeszcze przed wysłaniem do repozytorium. Druga to odwracanie zmian już zatwierdzonych.

Wycofywanie lokalne

Anulowanie zmian w kopii lokalnej jest w miarę proste i intuicyjne. Wykorzystujemy tutaj podpolecenie revert, po którym podajemy nazwę pliku lub maskę. Opcją którą właściwie trzeba znać jest -R, która włącza wycofywanie rekursywne. Przykłady:

Anulowanie zmian w pliku ‘playground’:

svn revert playground

Anulowanie wszystkich zmian w projekcie (uruchamiane w głównego katalogu):

svn revert -R *

Wycofywanie zmian z repozytorium

W Subversion de facto nie da się wycofać zmiany już zatwierdzonej. Zamiast tego można jednak zatwierdzić zmiany odwrotne do wprowadzonych. Efekt będzie taki jak zamierzony, jednak „wadliwe” zmiany zostaną w historii. Dlatego konieczne jest tutaj użycie podpolecenia merge a nie revert, które, patrząc na nazwę, wydawało by się bardziej intuicyjne.

Zakres zmian do wycofania możemy podać używając dwóch przełączników:

-c Podajemy nr jednego zatwierdzenia, który może być ujemy. Podanie -c 123 jest równoważne z -r 122:123, natomiast -c -64 to to samo co -r 65:64

-r Podajemy zakres zatwierdzeń. Przykładowo -r 100:120.

Podając malejący zakres rewizji lub nr poprzedzony minusem otrzymujemy zmian odwrotne do wprowadzonych, co można sobie fajnie sprawdzić używając podpolecenia diff:

svn diff -r 56:57 testfile 
Index: testfile
===================================================================
--- testfile    (revision 56)
+++ testfile    (revision 57)
@@ -1 +1,3 @@
 Treść początkowa
+
+Wprowadzenie treści błędnej

svn diff -c -57 testfile
Index: testfile
===================================================================
--- testfile    (revision 57)
+++ testfile    (revision 56)
@@ -1,3 +1 @@
 Treść początkowa
-
-Wprowadzenie treści błędnej

Powyższe przykłady prezentują jak podejrzeć wprowadzoną zmianę oraz jak otrzymać patch do jej wycofania. Samo wycofanie polega na scaleniu zmian odwrotnych oraz zatwierdzeniu tej zmiany:

> svn merge -c -57 testfile
--- Reverse-merging r57 into 'testfile':
U    testfile
 
> svn diff testfile 
Index: testfile
===================================================================
--- testfile    (revision 57)
+++ testfile    (working copy)
@@ -1,3 +1 @@
 Treść początkowa
-
-Wprowadzenie treści błędnej
 
> svn ci

Podobne wpisy:

1. Naj- opisy zmian w kodzie

Dość typową sytuacją w każdym projekcie jest fakt, że część plików lub katalogów nie powinna się znajdować pod kontrolą wersji. Przykładami takich plików są:

• generowane pliki tymczasowe,
• logi,
• pliki cache,
• pliki konfiguracyjne, inne dla każdej kopii roboczej,
• pliki tworzone przez edytor tekstu lub IDE,
• zbyt duże pliki, by je wysyłać do repozytorium.

Pliki można ignorować na dwa sposoby.

Ignorowanie globalne

Każdy użytkownik może ustawić sobie dowolne ignorowanie plików według typowych dla konsol linuksowych masek. Aby to zrobić należy wyedytować plik config, który powinien znajdować się w katalogu .subversion w katalogu domowym użytkownika (Linux) lub w jego profilu (Windows). Interesująca nas opcja nazywa się global-ignores. Domyślnie jest ona objęta komentarzem a jej domyślna wartość wygląda następująco:

global-ignores = *.o *.lo *.la #*# .*.rej *.rej .*~ *~ .#* .DS_Store

I właśnie takie pliki są domyślnie ignorowane. Dlatego też, chcąc dodać kolejną maskę, nie powinniśmy raczej kasować początkowych wartości (chociaż oczywiście możemy). Ja tutaj dodałem sobie tylko pliki tymczasowe jakie generuje mi Vim:

global-ignores = *.o *.lo *.la #*# .*.rej *.rej .*~ *~ .#* .DS_Store *.swp *.swo *.swn

Maski lub nazwy plików działają również na katalogi.

Ignorowanie lokalne

Subversion dostarcza mechanizm pozwalający na ustawianie dowolnych właściwości (properties) plikom i katalogom znajdującym się pod jego kontrolą. Kilka właściwości jest zdefiniowanych od razu — każda z nich zaczyna się od svn: (jak np. svn:executable). Prawdopodobnie najpopularniejszą z nich jest svn:ignore, służąca właśnie do ignorowania plików.

Musicie pamiętać, że właściwość svn:ignore można ustawiać tylko na katalogach (tj. plik nie możne przechowywać informacji o tym, że on sam ma być zignorowany). Jej wartością mogą być nazwy plików, nazwy katalogów lub maski oddzielone znakiem nowej linii. Innymi słowy — aby zignorować pojedynczy plik, musimy edytować właściwości katalogu, w którym się znajduje, a nie tegoż pliku. Wg mnie najwygodniejszym sposobem ustawiania ignorowania jest wykorzystanie podpolecenia propedit (skrót pe), które to otwiera nam edytor, dzięki czemu możemy wygodnie wpisać nazwy do ignorowania.

Przykład: zignorowanie plików log1, log2, katalogu test i wszyskich plików kończących się na „a” w bieżącym katalogu

Otwieramy edytor dla właściwości svn:ignore:

svn pe svn:ignore .

Po czym w edytorze wpisujemy:

log1
log2
test
*a

Możemy sprawdzić czy wszystko jest ok:

> svn proplist -v
Properties on '.':
  svn:ignore
    log1
    log2
    test
    *a

Pozostaje tylko zakomitować zmiany:

svn ci -m "Trochę bezsensu, ale dobry jako przykład svn:ignore"

Przykład: zignorowanie istniejącego, niepustego katalogu z cachem

Zakładając, że sam katalog powinien znaleźć się w repozytorium, natomiast jego zawartość nie. Najpierw dodajemy katalog do svn:

svn add cache --depth empty

Gdzie cache jest nazwą katalogu, a parametr --depth empty powoduje, że pliki wewnątrz nie zostaną dodane.
Następnie ustawiamy ignorowanie wszystkich plików w katalogu, za pomocą podpolecenia propset (skrót pe):

svn propset svn:ignore \* cache

Gwiazdka musi być wyeskejpowana, żeby nasz shell jej nie zinterpretował i nie podstawił wszystkich nazw plików z bieżącego katalogu. Teraz pozostaje już tylko zatwierdzenie zmian w repozytorium:

svn ci -m "svn:ignore na zawartość katalogu cache"

Przykład negatywny: ignorowanie dwa lub więcej katalogi niżej

Załóżmy, że chcemy zignorować pliki ./log/2010/*. Może wydawać się intuicyjne ustawienie svn:ignore w bieżącym katalogu na wartość log/2010/*. Jednak taki zapis nie zadziała. Musimy ustawić właściwość na katalog bezpośrednio nadrzędny, czyli:

svn ps svn:ignore \* log/2010

Podobne wpisy:

1. Uprawnienia plików w repo SVN
2. Vim: Znajdowanie plików w podkatalogach
3. Krótko: Vim i powolna edycja plików PHP

$ find . -exec svn propdel svn:executable {} \;

Subversion będzie się czepiał: svn: Próba usunięcia nieistniejącego atrybutu ‘svn:executable’, jednak nie straszne nam takie komunikaty. Atrybuty wykonywalności faktycznie zostaną zdjęte lokalnie, a po commicie nawet i w repozytorium.

Nadmieniam usłużnie, że do find warto dodać jakiś filterek w rodzaju np. -name '*.php', jeśli nie chcemy, żeby nam zmieniał wszystko jak leci.

Podobne wpisy:

1. Ignorowanie plików w SVN
2. Vim: Znajdowanie plików w podkatalogach