Bazaar ohjeet
=============

Uuden bazaar-haaran luonti päähaarasta
--------------------------------------

1. Haetaan päähaara ja nimetään se uudelleen halutuksi haaraksi:

    $ cd ~/projekti/branches

    $ bzr branch lp:tarkisto pdf-import

    $ cd pdf-import

2. Tehdään muutokset ja lisätään ne versionhallintaan:

    $ bzr status
      modified:
        .bzrignore
      unknown:
        lib/greatest_pdf_import_ever.rb

    $ bzr add lib/greatest_pdf_import_ever.rb

    $ bzr status
      added:
        lib/greatest_pdf_import_ever.rb
      modified:
        .bzrignore

3. Kun tarvittavat muutokset on lisätty, luodaan yhteenveto muutoksista:

    $ bzr commit

    Yhteenveto vaatii itselleen _kuvaavan_ viestin:

        Added greatest pdf import ever. This does all the required actions.

4. Työnnetään paikalliset yhteenvedot launchpadiin:

    $ bzr push lp:~samitheberber/tarkisto/pdf-import

    Jos haarassa ei ole aiempaa sisältö, niin tässä kohtaa tulee valitus siitä.
    Valituksessa on ohje eli lisätään komennon loppuun: --use-existing-dir

    Jottei aina tarvitsisi kirjoittaa koko polkua, niin käsketään bazaarin
    muistaa määränpää:

    $ bzr push lp:~samitheberber/tarkisto/pdf-import --remember

    Jatkossa riittää vain pelkkä työntäminen ilman määränpäätä:

    $ bzr push

5. Vedetään tuoreimmat muutokset:

    $ bzr pull lp:~samitheberber/tarkisto/pdf-import

    Tässäkin on sama --remeber määre.


Anna on tekee parannuksen Samin PDF-import haaraan
--------------------------------------------------

1. Anna tekee bugiraportin huomattuaan Samin koodissa virheen.

2. Haetaan Samin haara:

    $ cd ~/projekti/bugfixes

    $ bzr branch lp:~samitheberber/tarkisto/pdf-import pdf-import-fix

    $ cd pdf-import-fix

3. Tehdään muutokset, tarkistetaan tila ja luodaan yhteenveto:

    $ bzr status
      modified:
        lib/greatest_pdf_import_ever.rb

    $ bzr commit

        Fix for bug #32.
        Fixed one typing error, which caused exception.

4. Luodaan korjaustiedosto:

    $ bzr send -o ~/projekti/patches/bugfix_32_1.patch

5. Kokeillaan korjauksen toimivuutta:

    $ cd ~/projekti/bugfixtests

    $ bzr branch lp:~samitheberber/tarkisto/pdf-import pdf-import-fix-test

    $ bzr merge ~/projekti/patches/bugfix_32_1.patch

    Jos korjaus toimii, niin edetään kohtaan 6, muuten palataan kohtaan 3.

6. Anna lisää bugiraportiin tekemänsä korjaustiedoston.

7. Lisättyään korjausen Anna poistaa turhat tiedostot sotkemasta:

    $ cd ~/projekti

    $ rm  ~/projekti/patches/bugfix_32_1.patch

    $ rm -r ~/projekti/bugfixes/pdf-import-fix ~/projekti/bugfixtests/pdf-import-fix-test


Sami huomaa haaraansa koskevan bugin ja lisää korjauksen
--------------------------------------------------------

1. Sami lataa Annan muutoksen launchpadista työpöydälleen.

2. Yhdistetään muutos haaraan:

    $ cd ~/projekti/branches/pdf-import

    $ bzr merge ~/Desktop/bugfix_32_1.patch

    $ bzr status
      modified:
        lib/greatest_pdf_import_ever.rb

3. Muutos korjasi ongelman, joten luodaan siitä yhteenveto:

    $ bzr commit

        We have now working pdf import. There was a minor bug in previous
        revision, but Anna's patch fixed that problem.

4. Työnnetään muutosten yhteenvedot lauchpadiin:

    $ bzr push


Samin pdf-tuonti toimii ja se on valmis liitettäväksi päähaaraan
----------------------------------------------------------------

1.