Merge lp:~kklimonda/sru-server/hacking-file into lp:sru-server

[Krzysztof Klimonda]

Unmerged revisions

4. By Krzysztof Klimonda on 2011-08-31

Wstępna wersja pliku HACKING opisującego sposób pracy z bazaarem.

Plik zawiera zarys pierwszego paragrafu opisującego pracę z repozytorium,
podstatowe komendy służące do skonfigurowania bazaara i ściągnięcia głównej
gałęzi kodu.

=== added file 'HACKING'
--- HACKING	1970-01-01 00:00:00 +0000
+++ HACKING	2011-08-31 20:38:23 +0000
@@ -0,0 +1,37 @@
+Co na początek
+--------------
+Aby korzystać z bazaar na Launchpadzie, potrzebne jest konto, wraz z dodaną
+publiczną częścią klucza ssh. Bez tego nie da się opublikować swoich zmian
+na Launchpadzie, ani poprosić o ich włączenie do głównej gałęzi.
+
+Po założeniu konta należy skonfigurować bazaara tak by wiedział kim jesteśmy.
+Służą do tego dwie komendy: "bzr whoami" oraz "bzr launchpad-login".
+Pierwsza z nich służy do ustawienia imienia, nazwiska, oraz adresu e-mail.
+Powinny być to te same dane których użyliśmy przy rejestracji na Launchpadzie,
+pozwoli to na powiązanie wprowadzanych zmian z naszym kontem. Druga komenta
+(bzr launchpad-login) służy do skonfigurowania powiązania między bazaarem
+a Launchpadem. Przykładowe użycie komend poniżej:
+
+  $ bzr whoami "Jan Kowalski <[e-mail]>"
+  $ bzr launchpad-login jan-kowalski
+
+Kiedy już skonfigurujemy bazaar, możemy przygotować sobie miejsce do pracy
+nad kodem, służy do tego komenda "bzr branch". Na początek, w wybranym przez
+siebie katalogu, tworzymy katalog główny projektu - w nim będziemy umieszczać
+wszystkie gałęzie kodu nad którymi pracujemy. Aby stworzyć ten katalog
+należy użyć komendy "bzr init-repo [nazwa katalogu]", na przykład komenda:
+
+  $ bzr init-repo sru-server
+
+stworzy w bierzącym katalogu podkatalog sru-server, w nim będzie cała nasza
+praca.
+
+Aby pobrać główną gałąź należy skorzystać z komendy "bzr branch" będąc
+w katalogu głównym i wskazać mu adres gałęzi (w tym przypadku lp:sru-server).
+Cała komenda wygląda tak:
+
+  $ bzr branch lp:sru-server trunk
+
+Warto zwrócić uwagę na drugi argument, trunk. Wskazuje on pod jaką nazwą
+zapisać gałąź lokalnie na dysku. trunk to ogólnie przyjęta nazwa dla głównej
+gałęzi kodu.