What is what

SVN = Subversion = a tool for file repository with full change history.

Trac = web application that includes a wiki, SVN view and tickets.

Ticket = submitted bug or idea, e.g. jhusak submitted ticket:1 for putting ASMA in the SVN and pfusik did it.

Language

Make sure Trac interface is in English. Polish translation is incomplete.

On the top click Preferences, Language, English (United States), Save changes.

Trac navigation

On the top bar:

• Wiki
• Timeline - Traca + SVNa history, e.g.
  • wiki page edit
  • ticket - bug or idea
  • changeset is a change in SVN (e.g. in changeset:4 I have uploaded ASMA 3.4)
• Roadmap - our goals and how far we are according to tickets
• Browse Source - read-only view on the SVN
• View Tickets
• New Ticket
• Search

SVN Basics

SVN (subversion) is a version control system. In such systems nothing is ever lost, the history of changes is always available with the author, you can always revert to a previous version and fix any problem (see below).

As you can see in the Browse Source tab, there are three top directories in SVN:

• branches - for the more advanced users, we don't use it yet
• tags - contains tagged versions, for example I have put ASMA 3.4 here, we can put here all releases and betas, but we don't edit files directly here
• trunk - it's the main work space, you can browse it from Trac, but it's much more comfortable to have a copy on your disk (see below)

Every write to SVN is registered in its history - which you see in Timeline. A write is a "changeset". A changeset has the following attributes:

• ordinal number
• author's login
• timestamp
• log message - short text written by the author to summarize the change
• the changes - added/changed/removed files or directories

SVN can be browsed from Trac. To make changes, you need an SVN client. The most popular SVN client for Windows is TortoiseSVN.

TortoiseSVN Installation

​http://tortoisesvn.net/downloads.html Choose 32-bit or 64-bit to match your Windows version. Any installation is fine, you can uncheck the unnecessary things such as extra icons, command-line tools and dictionaries. After the installation the context menu of Windows Explorer has additional TortoiseSVN commands.

Getting a local copy of SVN

Tworzymy na swoim dysku zwykły pusty katalog, gdzie będzie nasza kopia SVN. Dla ustalenia uwagi nazwę go asma-trunk (nazwa i położenie mogą być dowolne). Wchodzimy do tego katalogu, klikamy puste miejsce i TortoiseSVN / Checkout. W URL of repository wklejamy: svn://84.201.216.109/test/trunk Upewniamy się, że Checkout directory to dokładnie nasz pusty katalog. OK. Czekamy, aż się ściągnie.

Możemy normalnie używać ściągniętych plików - otwierać w playerach i edytować. Z kasowaniem, zmianą nazwy i przenoszeniem trzeba ostrożnie (patrz niżej).

Podstawowe operacje SVN

Prawo-klik na naszym katalogu daje następujące operacje:

• SVN Update - ściągnięcie nowych zmian, jeśli jakieś były
• SVN Show Log - historia (to samo co w Tracu, tylko tutaj same zmiany w SVN)
• SVN Commit - wrzucenie naszych zmian na serwer; w przypadku problemów zrobić najpierw SVN Update (inni wykonali zmianę na tym samym pliku co my. W przypadku konfliktów, bo 2 osoby zmieniły ten sam plik w tym samym miejscu, rozwiązujemy je samodzielnie lub przy udziale kolegów).
• SVN Revert - odzyskanie przypadkowo skasowanego lub przeniesionego pliku zgodnie ze strukturą repozytorium SVN

Jest jeszcze mnóstwo innych poleceń, ale są one używane dużo rzadziej.

Wprowadzanie zmian

Potraktujcie to, co jest, jako piaskownicę. Po oswojeniu się wszystkich zrobimy porządek i będziemy wprowadzać zmiany na poważnie.

jhusak: proponuję zrobić brancha z piaskownicą i tam się bawić, a w trunku niech siedzą rzeczy "już na poważnie".

Najprościej jest zmienić plik, który jest już w SVN. Zmieniamy pliki normalnie - np. możecie przeedytować pliki tekstowe w notatniku. Następnie wybieramy SVN Commit - wyświetli się lista zmienionych plików. Wpisujemy na górze opis i zatwierdzamy (opis jest ważny bo wtedy wiadomo, co było zmienione). Wpisujemy swój login i hasło. Po chwili zmiany są widoczne dla wszystkich (muszą oni zrobić SVN Update).

Aby dodać plik, normalnie umieszczamy go w katalogu, prawo-klik na nim i TortoiseSVN / Add. Następnie, aby wysłać dodane pliki, używamy SVN Commit jak wyżej.

Aby usunąć plik, nie usuwamy go normalnie. Zamiast tego TortoiseSVN / Delete, potem SVN Commit.

Aby zmienić nazwę pliku, TortoiseSVN / Rename, potem SVN Commit.

Aby skopiować/przenieść plik, przesuwamy go prawym klawiszem - pojawi się menu z możliwością kopiowania, przenoszenia i ew. zmiany nazwy przy tej okazji. Potem SVN Commit.

Tylko SVN Commit powoduje wysłanie naszych zmian na serwer. Inne operacje działają lokalnie na naszym komputerze.

Na początek to wystarczy. Są pytania?